XPOSTIT(1) USER COMMANDS XPOSTIT(1) NAME xpostit - X window system Post-it8r9 notes SYNOPSIS xpostit [ -_t_o_o_l_k_i_t_o_p_t_i_o_n_s ... ] [ -_o_p_t_i_o_n_s ... ] DESCRIPTION _X_p_o_s_t_i_t provides a mechanism for manipulating on-screen Post-it8r9 notes. All three 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). OPTIONS _X_p_o_s_t_i_t accepts all of the standard X Toolkit command line options along with the additional options listed below. -bs _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. -dir _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. -sb Enables scroll-bars. If specified, a scroll bar will be attached to each Post-it note. -so Enables scroll-on-overflow. When specified, this option tells _x_p_o_s_t_i_t to scroll the text of a Post-it note upward when the bottom of the window is reached. -sv Enables 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 RIACS/X11R3 Last change: 2 January 1989 1 XPOSTIT(1) USER COMMANDS XPOSTIT(1) only be saved to disk files when saved manually by the user. WIDGET USAGE _X_p_o_s_t_i_t uses several widget types to construct the objects it uses. The control window is made up of a Plaid widget called ``plaid''. The menu is a pop-up shell called ``Menu'', containing a List widget called ``menu''. Each Post-it note is a pop-up shell called ``PostItNote'', containing a Form widget called ``form'' which contains a Text widget called ``text'', and three Command widgets called ``save'', ``erase'', and ``destroy''. The confirmation box is a pop-up shell called ``Confirm'', containing a Form widget called ``form'' which contains two Command widgets called ``confirm'' and ``cancel''. X DEFAULTS _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 XPostit. .bufSize Specifies the size of the character buffer used to store a Post-it note. The default is 1024. .noteDir Specifies 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. .saveNotes Controls the state of the save-on-exit option. The default is false. .scrollBar Controls placing scroll bars on Post-it notes. The default is false. .scrollOnOverflow Controls whether or not a note window should be scrolled when the bottom of the window is reached. The default is false. Because of the large amount of widget nesting in _x_p_o_s_t_i_t , the following constructions are recommended for setting resources on the various widgets: RIACS/X11R3 Last change: 2 January 1989 2 XPOSTIT(1) USER COMMANDS XPOSTIT(1) *XPostit._r_e_s_o_u_r_c_e *XPostit.plaid*_r_e_s_o_u_r_c_e *XPostit.Confirm*_r_e_s_o_u_r_c_e *XPostit.Confirm*confirm*_r_e_s_o_u_r_c_e *XPostit.Confirm*cancel*_r_e_s_o_u_r_c_e *XPostit.Menu*_r_e_s_o_u_r_c_e *XPostit.PostItNote*_r_e_s_o_u_r_c_e *XPostit.PostItNote*save*_r_e_s_o_u_r_c_e *XPostit.PostItNote*erase*_r_e_s_o_u_r_c_e *XPostit.PostItNote*destroy*_r_e_s_o_u_r_c_e *XPostit.PostItNote*text*_r_e_s_o_u_r_c_e THE CONTROL WINDOW _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 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. THE MENU The _x_p_o_s_t_i_t menu provides the following selections: Create 1.5x2 Note Create 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. Create 3x3 Note Create a new Post-it note, 3 inches square. Create 3x5 Note Create a new Post-it note, 3 inches tall by 5 inches wide. Raise All Notes Raise all Post-it notes to the top. This is equivalent to pressing the left mouse button in the control window. Lower All Notes Lower all Post-it notes to the bottom. This is equivalent to pressing the middle mouse button in the control window. Save All Notes RIACS/X11R3 Last change: 2 January 1989 3 XPOSTIT(1) USER COMMANDS XPOSTIT(1) Save all Post-it notes to disk files in the save directory. Exit Exit _x_p_o_s_t_i_t . If the -sv command line option was given, or the saveNotes resource is true , all Post-it notes will be saved to disk first. To select an item from the menu, move the mouse cursor to that item and press the left mouse button. If the mouse cursor exits the menu window, the menu will be lowered automatically. THE POST-IT NOTE Each 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. 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. NOTE: 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. NOTE: 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 RIACS/X11R3 Last change: 2 January 1989 4 XPOSTIT(1) USER COMMANDS XPOSTIT(1) 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. SEE ALSO X(1) BUGS The sizes of the Post-it notes are only as acurrate as the display dimension and resolution returned by the server. On 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. AUTHOR David A. Curry, Research Institute for Advanced Computer Science ``Post-it'' and the plaid design are registered trademarks of 3M. RIACS/X11R3 Last change: 2 January 1989 5