User Commands pico(1) NNNNaaaammmmeeee pico - simple text editor in the style of the Pine Composer SSSSyyyynnnnttttaaaaxxxx ppppiiiiccccoooo [ _o_p_t_i_o_n_s ] [ _f_i_l_e ] DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn _P_i_c_o is a simple, display-oriented text editor based on the Pine message system composer. As with Pine, commands are displayed at the bottom of the screen, and context-sensitive help is provided. As characters are typed they are immedi- ately inserted into the text. Editing commands are entered using control-key combinations. As a work-around for communications programs that swallow certain control characters, you can emulate a control key by pressing ESCAPE twice, followed by the desired control char- acter, e.g. "ESC ESC c" would be equivalent to entering a ctrl-c. The editor has five basic features: paragraph jus- tification, searching, block cut/paste, a spelling checker, and a file browser. Paragraph justification (or filling) takes place in the paragraph that contains the cursor, or, if the cursor is between lines, in the paragraph immediately below. Para- graphs are delimited by blank lines, or by lines beginning with a space or tab. Unjustification can be done immedi- ately after justification using the control-U key combina- tion. String searches are not sensitive to case. A search begins at the current cursor position and wraps around the end of the text. The most recent search string is offered as the default in subsequent searches. Blocks of text can be moved, copied or deleted with creative use of the command for mark (ctrl-^), delete (ctrl-k) and undelete (ctrl-u). The delete command will remove text between the "mark" and the current cursor position, and place it in the "cut" buffer. The undelete command effects a "paste" at the current cursor position. The spell checker examines all words in the text. It then offers, in turn, each misspelled word for correction while highlighting it in the text. Spell checking can be can- celled at any time. Alternatively, _p_i_c_o will substitute for the default spell checking routine a routine defined by the SPELL environment variable. The replacement routine should read standard input and write standard output. The file browser is offered as an option in the "Read File" and "Write Out" command prompts. It is intended to help in SunOS 5.6 Last change: Version 3.4 1 User Commands pico(1) searching for specific files and navigating directory hierarchies. Filenames with sizes and names of directories in the current working directory are presented for selec- tion. The current working directory is displayed on the top line of the display while the list of available commands takes up the bottom two. Several basic file manipulation functions are supported: file renaming, copying, and dele- tion. More specific help is available in _p_i_c_o's online help. OOOOppppttttiiiioooonnnnssss ++++_n Causes _p_i_c_o to be started with the cursor located _n lines into the file. (Note: no space between "+" sign and number) ----bbbb Enable the option to Replace text matches found using the "Where is" command. ----dddd Rebind the "delete" key so the character the cursor is on is rubbed out rather than the character to its left. ----eeee Enable file name completion. ----ffff Use function keys for commands. This option supported only in conjunction with UW Enhanced NCSA telnet. ----hhhh List valid command line options. ----jjjj Enable "Goto" command in the file browser. This enables the command to permit explicitly telling _p_i_l_o_t which directory to visit. ----gggg Enable "Show Cursor" mode in file browser. Cause cur- sor to be positioned before the current selection rather than placed at the lower left of the display. ----kkkk Causes "Cut Text" command to remove characters from the cursor position to the end of the line rather than remove the entire line. ----mmmm Enable mouse functionality. This only works when _p_i_c_o is run from within an X Window System "xterm" window. ----nnnn_n The -n_n option enables new mail notification. The _n argument is optional, and specifies how often, in seconds, your mailbox is checked for new mail. For example, -n60 causes _p_i_c_o to check for new mail once every minute. The default interval is 180 seconds, while the minimum allowed is 30. (Note: no space between "n" and the number) SunOS 5.6 Last change: Version 3.4 2 User Commands pico(1) ----oooo _d_i_r Sets operating directory. Only files within this directory are accessible. Likewise, the file browser is limited to the specified directory subtree. ----rrrr_n Sets column used to limit the "Justify" command's right margin ----ssss _s_p_e_l_l_e_r Specify an alternate program _s_p_e_l_l to use when spell checking. ----tttt Enable "tool" mode. Intended for when _p_i_c_o is used as the editor within other tools (e.g., Elm, Pnews). _P_i_c_o will not prompt for save on exit, and will not rename the buffer during the "Write Out" command. ----vvvv View the file only, disallowing any editing. ----wwww Disable word wrap (thus allow editing of long lines). ----xxxx Disable keymenu at the bottom of the screen. ----zzzz Enable ^Z suspension of _p_i_c_o. ----qqqq Termcap or terminfo definition for input escape sequences are used in preference to sequences defined by default. This option is only available if _p_i_c_o was compiled with the TERMCAP_WINS define turned on. Lastly, when a running _p_i_c_o is disconnected (i.e., receives a SIGHUP), _p_i_c_o will save the current work if needed before exiting. Work is saved under the current filename with ".save" appended. If the current work is unnamed, it is saved under the filename "pico.save". BBBBuuuuggggssss The manner in which lines longer than the display width are dealt is not immediately obvious. Lines that continue beyond the edge of the display are indicated by a '$' char- acter at the end of the line. Long lines are scrolled hor- izontally as the cursor moves through them. FFFFiiiilllleeeessss pico.save Unnamed interrupted work saved here. *.save Interrupted work on a named file is saved here. AAAAuuuutttthhhhoooorrrrssss Michael Seibel Laurence Lundblade Pico was originally derived from MicroEmacs 3.6, by Dave G. Conroy. SunOS 5.6 Last change: Version 3.4 3 User Commands pico(1) Pico is a trademark of the University of Washington. Copyright 1989-1996 by the University of Washington. SSSSeeeeeeee AAAAllllssssoooo pine(1) Source distribution (part of the Pine Message System): ftp://ftp.cac.washington.edu/mail/pine.tar.Z 98.05.06 SunOS 5.6 Last change: Version 3.4 4