[0m


XPOSTIT(1)	    UNIX Programmer's Manual	       XPOSTIT(1)



[1mNAME
     [0mxpostit - X window system Post-it(R) notes

[1mSYNOPSIS
     xpostit [0m[ -_t_o_o_l_k_i_t_o_p_t_i_o_n_s ... ] [ -_o_p_t_i_o_n_s ... ]

[1mDESCRIPTION
     [0m_X_p_o_s_t_i_t provides a mechanism for manipulating on-screen
     Post-it(R) notes.	All six sizes of Post-it notes may be
     displayed, edited, and saved to disk files.  In addition,
     any on-screen note may be resized to any arbitrary size
     either when it is created or at a later time.

     When _x_p_o_s_t_i_t is first invoked, it creates a small window
     with a plaid background.  This is the control window for
     _x_p_o_s_t_i_t.  Additionally, if any notes were stored in the save
     directory (see below), these will be placed on the screen at
     their last locations.  Each Post-it note, when created,
     makes another window on the screen.  _X_p_o_s_t_i_t is controlled
     using the mouse buttons and a menu.  The Post-it notes are
     controlled using buttons (Command widgets).

[1mOPTIONS
     [0m_X_p_o_s_t_i_t accepts all of the standard X Toolkit command line
     options along with the additional options listed below.

     [1m-bs [0m_n_u_m_b_e_r
	     Specifies the size of the character buffer in which
	     to save each Post-it note.  A note may not contain
	     more than this number of characters, including new-
	     lines.  The default is 1024.

     [1m-dir [0m_p_a_t_h
	     Specifies the path name of the directory in which to
	     store saved Post-it notes.  If _p_a_t_h begins with a
	     `/' it is taken as-is; if it does not begin with a
	     `/', the path is taken relative to the home direc-
	     tory.  The named directory must already exist if
	     notes are to be saved in it.  The default is ._p_o_s_-
	     _t_i_t_n_o_t_e_s.

     [1m-sb     [0mEnables scroll-bars.  If specified, a scroll bar
	     will be attached to each Post-it note.

     [1m-sv     [0mEnables save-on-exit.  When specified, this option
	     tells _x_p_o_s_t_i_t to save all Post-it notes to disk
	     files when exiting.  If not specified, notes will
	     only be saved to disk files when saved manually by
	     the user.

[1mWIDGET USAGE




[0mPrinted 26/2/92           13 June 1990				1






XPOSTIT(1)	    UNIX Programmer's Manual	       XPOSTIT(1)



     _X_p_o_s_t_i_t uses several widget types to construct the objects
     it uses.

     The control window is a Plaid widget called ``Plaid''.

     The menu is a pop-up shell called ``Menu'' containing a Sim-
     pleMenu widget.

     Each Post-it note is a pop-up shell called ``PostItNote'',
     containing a Form widget called ``Note'' which contains a
     Text widget called ``NoteText'', and three Command widgets
     called ``Save'', ``Erase'', and ``Destroy''.

     The confirmation box is a pop-up shell called ``Confirm'',
     containing a Form widget called ``Buttons'' which contains
     two Command widgets called ``Confirm'' and ``Cancel''.

[1mRESOURCES
     [0m_X_p_o_s_t_i_t understands all of the core X Toolkit resource names
     and classes as well as those listed below, which are all of
     class [1mXpostit[0m.

     [1m.bufSize
	     [0mSpecifies the size of the character buffer used to
	     store a Post-it note.  The default is 1024.

     [1m.noteDir
	     [0mSpecifies the path name of the directory in which to
	     store saved notes.  The default is ._p_o_s_t_i_t_n_o_t_e_s.

     [1m.saveNotes
	     [0mControls the state of the save-on-exit option.  The
	     default is [1mfalse[0m.

     [1m.scrollBar
	     [0mControls placing scroll bars on Post-it notes.  The
	     default is [1mfalse[0m.

[1mACTIONS
     [0mIt is possible to rebind the mouse buttons in the Plaid
     widget to perform different functions by changing the
     widget's translations.  The _r_a_i_s_e() action, normally bound
     to the left mouse button, raises all notes.  The _l_o_w_e_r()
     action, normally bound to the middle mouse button, lowers
     all notes.  The menu raising function, normally bound to the
     right mouse button, is performed by calling the actions
     _X_a_w_P_o_s_i_t_i_o_n_S_i_m_p_l_e_M_e_n_u(_M_e_n_u) and _M_e_n_u_P_o_p_u_p(_M_e_n_u).

[1mTHE CONTROL WINDOW
     [0m_X_p_o_s_t_i_t allows three operations to be performed from its
     control window.  Pressing the left mouse button in the con-
     trol window will cause all Post-it notes on the screen to be



Printed 26/2/92           13 June 1990				2






XPOSTIT(1)	    UNIX Programmer's Manual	       XPOSTIT(1)



     raised to the top.  Pressing the middle mouse button in the
     control window will cause all Post-it notes on the screen to
     be lowered to the bottom.	Pressing the right mouse button
     in the control window raises the _x_p_o_s_t_i_t menu.

[1mTHE MENU
     [0mThe _x_p_o_s_t_i_t menu provides the following selections:

     [1mCreate 1.5x2 Note
	     [0mCreate a new Post-it note, 1.5 inches tall by 2
	     inches wide.  The window will normally need to be
	     positioned using the window manager.

     [1mCreate 2x3 Note
	     [0mCreate a new Post-it note, 2 inches tall by 3 inches
	     wide.

     [1mCreate 3x3 Note
	     [0mCreate a new Post-it note, 3 inches square.

     [1mCreate 3x4 Note
	     [0mCreate a new Post-it note, 3 inches tall by 4 inches
	     wide.

     [1mCreate 3x5 Note
	     [0mCreate a new Post-it note, 3 inches tall by 5 inches
	     wide.

     [1mCreate 4x6 Note
	     [0mCreate a new Post-it note, 4 inches tall by 6 inches
	     wide.

     [1mRaise All Notes
	     [0mRaise all Post-it notes to the top.  This is
	     equivalent to pressing the left mouse button in the
	     control window.

     [1mLower All Notes
	     [0mLower all Post-it notes to the bottom.  This is
	     equivalent to pressing the middle mouse button in
	     the control window.

     [1mSave All Notes
	     [0mSave all Post-it notes to disk files in the save
	     directory.

     [1mExit    [0mExit _x_p_o_s_t_i_t . If the [1m-sv [0mcommand line option was
	     given, or the [1msaveNotes [0mresource is [1mtrue , [0mall
	     Post-it notes will be saved to disk first.

     To select an item from the menu, drag the mouse cursor to
     that item and release the mouse button.



Printed 26/2/92           13 June 1990				3






XPOSTIT(1)	    UNIX Programmer's Manual	       XPOSTIT(1)



[1mTHE POST-IT NOTE
     [0mEach Post-it note is made up of four parts (plus an optional
     scroll bar): a text window where the text of the note is
     stored, and three buttons labeled ``Save'', ``Erase'', and
     ``Destroy''.

     To enter text into a Post-it note, simply move the mouse
     cursor into the text window and start typing.  Since the
     text window is actually a Text widget, all the Text widget
     translations are accepted.  Essentially, this means you can
     use most of the EMACS control keys in the window.	Addition-
     ally, the various mouse buttons used for manipulating the
     selections and cut buffer are understood.

     After entering text in the Post-it note, you may wish to
     save the note in a disk file.  This way, if the machine goes
     down, or if you exit _x_p_o_s_t_i_t, the Post-it note can be
     restored when you restart _x_p_o_s_t_i_t.  (Post-it notes are also
     saved automatically (if [1msaveNotes [0mis true) if a SIGHUP, SIG-
     INT, SIGTERM, or SIGQUIT signal is received.) To save the
     note to a disk file, move the mouse cursor to the button
     labeled ``Save'' and press the left mouse button.	The note
     will be saved as the file ``note_n'' in your save directory,
     where _n is some sequence number.  [1mNOTE[0m: it is important to
     remember that until you have pressed the ``Save'' button,
     the data stored in the Post-it note is not saved on disk and
     can be lost if the system goes down or _x_p_o_s_t_i_t exits.

     To erase the entire contents of the text window, you can
     press the left mouse button in the ``Erase'' button.  This
     will bring up a confirmation window, which has two buttons
     labeled ``Confirm'' and ``Cancel''.  If you press the ``Con-
     firm'' button, the text will be erased.  If you press the
     ``Cancel'' button, the operation is canceled, and nothing
     will happen.  [1mNOTE[0m: erasing the text in the window does not
     affect any contents of the note you have saved on disk
     unless you press the ``Save'' button again.

     To destroy a Post-it note, getting rid of its window on the
     screen and the disk file it is saved in, move the mouse cur-
     sor to the ``Destroy'' button and press the left mouse but-
     ton.  This will bring up a confirmation window as described
     above.  If you confirm the operation, the Post-it note will
     disappear from the screen and the disk file it was saved in
     will be deleted.

[1mSEE ALSO
     [0mX(1)

[1mBUGS
     [0mThe sizes of the Post-it notes are only as accurate as the
     display dimension and resolution returned by the server.  On



Printed 26/2/92           13 June 1990				4






XPOSTIT(1)	    UNIX Programmer's Manual	       XPOSTIT(1)



     the Sun server and possibly others, this means they aren't
     all that accurate.

     Without a color display for canary yellow notes and red
     plaid, the aesthetic value of _x_p_o_s_t_i_t cannot be fully appre-
     ciated.

[1mAUTHOR
     [0mDavid A. Curry, SRI International

     ``Post-it'' and the plaid design are registered trademarks
     of 3M.











































Printed 26/2/92           13 June 1990				5



[0m