User Commands                                             pico(1)
NNNNaaaammmmeeee
     pico - simple text editor in the style of the Pine Composer
SSSSyyyynnnnttttaaaaxxxx
     ppppiiiiccccoooo [ _o_p_t_i_o_n_s ] [ _f_i_l_e ]
DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
     _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.
OOOOppppttttiiiioooonnnnssss
     ++++_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)
     ----bbbb   Enable the option to Replace text matches  found  using
          the "Where is" command.
     ----dddd   Rebind the "delete" key so the character the cursor  is
          on is rubbed out rather than the character to its left.
     ----eeee   Enable file name completion.
     ----ffff   Use function keys for commands.  This option  supported
          only in conjunction with UW Enhanced NCSA telnet.
     ----hhhh   List valid command line options.
     ----jjjj   Enable  "Goto"  command  in  the  file  browser.   This
          enables  the command to permit explicitly telling _p_i_l_o_t
          which directory to visit.
     ----gggg   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.
     ----kkkk   Causes "Cut Text" command to remove characters from the
          cursor  position  to  the  end  of the line rather than
          remove the entire line.
     ----mmmm   Enable mouse functionality.  This only works when  _p_i_c_o
          is run from within an X Window System "xterm" window.
     ----nnnn_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)
     ----oooo _d_i_r
          Sets  operating  directory.   Only  files  within  this
          directory  are  accessible.  Likewise, the file browser
          is limited to the specified directory subtree.
     ----rrrr_n  Sets column used to limit the "Justify" command's right
          margin
     ----ssss _s_p_e_l_l_e_r
          Specify an alternate program _s_p_e_l_l to  use  when  spell
          checking.
     ----tttt   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.
     ----vvvv   View the file only, disallowing any editing.
     ----wwww   Disable word wrap (thus allow editing of long lines).
     ----xxxx   Disable keymenu at the bottom of the screen.
     ----zzzz   Enable ^Z suspension of _p_i_c_o.
     ----qqqq   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".
BBBBuuuuggggssss
     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.
FFFFiiiilllleeeessss
     pico.save        Unnamed interrupted work saved here.
     *.save           Interrupted work on a named file is saved here.
AAAAuuuutttthhhhoooorrrrssss
     Michael Seibel <mikes@cac.washington.edu>
     Laurence Lundblade <lgl@cac.washington.edu>
     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.
SSSSeeeeeeee AAAAllllssssoooo
     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