<HTML><HEAD><TITLE>Pine Technical Notes: Command Line Arguments</TITLE></HEAD><BODY>
<H1>Command Line Arguments</H1>

<H2><A NAME="pine">Pine</A></H2>
  
<EM>Pine</EM> and <EM>PC-Pine</EM> can accept quite a few
command-line arguments.
Many of these arguments overlap with variables
in the <EM>Pine</EM> configuration file.
If there is a difference, then a flag set in the command line takes precedence.
Both <EM>Pine</EM> and <EM>PC-Pine</EM> expect command line arguments (other
than addresses) to be
preceded by the "-" (dash) as normally used by UNIX programs.  <P>

<DL COMPACT>

<DT> <EM>[address]</EM>

<DD> Send-to:  If you put a string (or strings) without a preceding dash in the
command line, <EM>Pine</EM> reads them as email addresses.  <EM>Pine</EM> will startup in
the composer with a message started to the person/people specified.  Once
the message is sent, the <EM>Pine</EM> session closes.  <P>

<DT> &LT; <EM>file</EM>

<DD> <EM>Pine</EM> will startup in the composer with <EM>file</EM> read into the
body of the message.  Once the message is sent, the <EM>Pine</EM> session closes. 
<P>

<DT> -a

<DD> Special anonymous mode for UWIN*.  <P>

<DT> -attach <EM>file</EM>

<DD> Go directly into composer with given file attached.
<P>

<DT> -attach_and_delete <EM>file</EM>

<DD> Go directly into composer with given file attached, delete when finished.
<P>

<DT> -attachlist <EM>file-list</EM>

<DD> Go directly into composer with given files attached.
This must be the last option on the command line.
<P>

<DT> -bail

<DD> If the personal configuration file doesn't already exist, exit.
<P>

<DT> -c <EM>n</EM>

<DD> When used with the <CODE>-f</CODE> option, apply the <EM>n</EM>th 
context.  This is used when there are multiple folder collections and you 
want to open a folder not in the primary collection. <P>

<DT> -conf

<DD> Configuration:  Prints a sample system configuration file to the
screen or standard output.  To generate an initial system configuration 
file, execute

<PRE><CODE>
		pine -conf > /usr/local/lib/pine.conf
</CODE></PRE>
<P>

To generate a system configuration file using settings from an old
system configuration file, execute

<PRE><CODE>
		pine -P old-pine.conf -conf > /usr/local/lib/pine.conf
</CODE></PRE>
<P>

<DT> -create_lu <EM>addrbook sort-order</EM>

<DD> Create auxiliary index (LookUp) file for <EM>addrbook</EM> and sort
<EM>addrbook</EM> in <EM>sort-order,</EM> which may be <EM>dont-sort</EM>,
<EM>nickname</EM>, <EM>fullname</EM>, <EM>nickname-with-lists-last</EM>,
or <EM>fullname-with-lists-last</EM>. Only useful when creating global or
shared address books.
See <A HREF="low-level.html#addrbook-lu">Address Book Lookup File</A>
for more information, especially the warning about copying the
address book after creating the lookup file.<P>

<DT> -d <EM>debug-level</EM>

<DD> Debug Level:  Sets the level of debugging information written by
<EM>Pine</EM>.  <EM>debug-level</EM> can be set to any integer 0-9.  A debug level
of 0 turns off debugging for the session.  (Actually there are some levels
higher than 9, now, but you probably don't want to see them.) <P>

<DT> -d <EM>keywords</EM>

<DD> You may use a more detailed version of the debugging flag to set
the debug level in separate parts of <EM>Pine</EM>.
The possibilities are flush, timestamp, imap=0..4, numfiles=0..31,
verbose=0..9.
<EM>Flush</EM> causes debugging information to be flushed immediately to
the debug file as it is written.
<EM>Verbose</EM> is the general debugging verbosity level.
<EM>Timestamp</EM> causes timestamps to be added to the debug file, which
is useful when you are trying to figure out who is responsible for delays.
<EM>Numfiles</EM> sets the number of debug files saved.
<EM>Imap</EM> sets the debug level for the debugging statements related
to the conversation with the IMAP server, and more generally, for the
debugging related to <EM>Pine</EM>'s interaction with the C-Client library.  <P>

<DT> -f <EM>folder</EM>

<DD> Startup folder:  <EM>Pine</EM> will open this folder in place of the standard
INBOX.  <P>

<DT> -F <EM>file</EM>

<DD> Open named text file and view with <EM>Pine</EM>'s browser.  <P>

<DT> -h

<DD> Help:  Prints the list of available command-line arguments to the
screen.  <P>

<DT> -i

<DD> <EM>Pine</EM> will start up in the FOLDER INDEX screen instead of the MAIN
MENU.  <P>

Configuration equivalent:  <EM>initial-keystroke-list=i</EM> <P>

<DT> -I <EM>a,b,c,...</EM>

<DD> Initial Keystrokes:  <EM>Pine</EM> will execute this comma-separated sequence
of commands upon startup.  This allows users to get <EM>Pine</EM> to start in any
of its menus/screens.  You cannot include any input to the composer in the
initial keystrokes.  The key &lt;Return&gt; is represented by a ``CR'' in
the keystroke list; the spacebar is designated by the letters ``SPACE''.
Control keys are two character sequences beginning with ``^'', such as
``^I''. A tab character is ``TAB''. Function keys are ``F1'' - ``F12'' and
the arrow keys are ``UP'', ``DOWN'', ``LEFT'', and ``RIGHT''. A
restriction is that you can't mix function keys and character keys in this
list even though you can, in some cases, mix them when running <EM>Pine</EM>.  A
user can always use only <EM>character</EM> keys in the startup list even
if he or she is using <EM>function</EM> keys normally, or vice versa. If
an element in this list is a string surrounded by double quotes (")
then it will be expanded into the individual characters in the string,
excluding the double quotes. <P>

Configuration equivalent:  <EM>initial-keystroke-list</EM> <P>

<DT> -k

<DD> Function-Key Mode:  When invoked in this way, <EM>Pine</EM> expects the input
of commands to be function-keys.  Otherwise, commands are linked to the
regular character keys. <I>This option supported only in conjunction with
UW Enhanced NCSA telnet.</I> <P>

Configuration equivalent:  <EM>use-function-keys</EM> included in
<EM>feature-list</EM>.  <P>

<DT> -n <EM>n</EM>

<DD> Message-Number:  When specified, <EM>Pine</EM> starts up in the FOLDER INDEX
screen with the current message being the designated message number.  <P>

<DT> -nr

<DD> Special mode for UWIN*.  <P>

<DT> -o <EM>folder</EM>

<DD> Opens the INBOX (or a folder specified via the -f argument) ReadOnly. 
<P>

<DT> -p <EM>file</EM>

<DD> Uses the named file as the personal configuration file instead of
<EM>~/.pinerc</EM> or the default PINERC search sequence <EM>PC-Pine</EM> uses.  
<P>

<DT> -P <EM>file</EM>

<DD> Uses the named file as the system wide configuration file instead of
<EM>/usr/local/lib/pine.conf</EM>.  <I>UNIX <EM>Pine</EM> only.</I>  <P>

<DT> -pinerc <EM>file</EM>

<DD> Output fresh pinerc configuration to <EM>file,</EM> preserving the
settings of variables that the user has made.  Use <EM>file</EM> set to
``-'' to make output go to standard out.  <P>

<DT> -r

<DD> Restricted Mode:  For UNIX <EM>Pine</EM> only.  <EM>Pine</EM> in restricted mode can
only send email to itself.  Save and export are limited.  <P>

<DT> -sort <EM>key</EM>

<DD> Sort-Key:  Specifies the order messages will be displayed in for the
FOLDER INDEX screen.  <EM>Key</EM> can have the following values: 
arrival, date, subject, orderedsubj, from, size, score, to, cc,
arrival/reverse, date/reverse, subject/reverse, orderedsubj/reverse, from/reverse, size/reverse, score/reverse, to/reverse, and cc/reverse.
The default value is "arrival". The <EM>key</EM>
value reverse is equivalent to arrival/reverse. <P>

Configuration equivalent:  <EM>sort-key</EM>.  <P>

<DT> -url <EM>url</EM>

<DD> Open the given URL.
<P>

<DT> -z

<DD> Enable Suspend:  When run with this flag, the key sequence ctrl-z
will suspend the <EM>Pine</EM> session.  <P>

Configuration equivalent:  <EM>enable-suspend</EM> included in
<EM>feature-list</EM>.  <P>

<DT> -<EM>option</EM>=<EM>value</EM>

<DD> Assign <EM>value</EM> to the config option <EM>option.</EM> For
example, <EM>-signature-file=sig1</EM> or
<EM>-feature-list=signature-at-bottom</EM> (Note:  feature-list values are
additive and features may be preceded with no- to turn them off).  <P>

</DL> <P>

* UWIN = University of Washington Information Navigator <P>

<H2><A NAME="pico">Pico</A></H2>

The following command line options are supported in <EM>Pico</EM>:

<DL>

<DT> +<EM>n</EM>

<DD> Causes <EM>Pico</EM> to be started with the cursor located <EM>n</EM>
lines into the file. (Note: no space between "+" sign and number) <P>

<DT> -d

<DD> Rebind the "delete" key so the character the cursor is on is rubbed
out rather than the character to its left.  <P>

<DT> -e

<DD>Enable file name completion. <P>

<DT> -f

<DD> Use function keys for commands.  <I>This option supported only in
conjunction with UW Enhanced NCSA telnet.</I> <P>

<DT> -g

<DD> Enable "Show Cursor" mode in file browser.  Cause cursor to be
positioned before the current selection rather than placed at the lower
left of the display. <P>

<DT> -k

<DD>Causes "Cut Text" command to remove characters from the cursor
position to the end of the line rather than remove the entire line. <P>

<DT> -m

<DD> Enable mouse functionality.  This only works when <EM>Pico</EM> is
run from within an X Window System "xterm" window. <P>

<DT>-n<EM>n</EM>

<DD> The -n<EM>n</EM> option enables new mail notification.  The
<EM>n</EM> argument is optional, and specifies how often, in seconds, your
mailbox is checked for new mail.  For example, -n60 causes <EM>Pico</EM>
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) <P>

<DT> -o <EM>dir</EM>

<DD> Sets operating directory.  Only files within this directory are
accessible.  Likewise, the file browser is limited to the specified
directory subtree. <P>

<DT> -r<EM>n</EM>

<DD> Sets column used to limit the "Justify" command's right margin. <P>

<DT> -t

<DD> Enable "tool" mode.  Intended for when <EM>Pico</EM> is used as the
editor within other tools (e.g., Elm, Pnews).  <EM>Pico</EM> will not
prompt for save on exit, and will not rename the buffer during the "Write
Out" command. <P>

<DT> -v

<DD> View the file only, disallowing any editing. <P>

<DT> -w

<DD> Disable word wrap (thus allow editing of long lines).  <P>

<I>Note: <EM>Pico</EM> will break any lines over 255 characters when reading a
file, regardless of word wrapping.</I> <P>

<DT> -x

<DD> Disable keymenu at the bottom of the screen. <P>

<DT> -z

<DD> Enable ^Z suspension of <EM>Pico</EM>. <P>

</DL>

<H2><A NAME="pilot">Pilot</A></H2>

The following command line options are supported in <EM>Pilot</EM>:

<DL>

<DT> -a

<DD> Display all files including those beginning with a period (.). <P>

<DT> -f

<DD> Use function keys for commands.  <I>This option supported only in
conjunction with UW Enhanced NCSA telnet.</I> <P>

<DT> -g

<DD> Enable "Show Cursor" mode.  Cause cursor to be positioned before the
current selection rather than placed at the lower left of the display. <P>

<DT> -m

<DD> Enable mouse functionality.  This only works when <EM>Pilot</EM> is
run from within an X Window System "xterm" window. <P>

<DT> -n<EM>n</EM>

<DD> The -n<EM>n</EM> option enables new mail notification.  The
<EM>n</EM> argument is optional, and specifies how often, in seconds, your
mailbox is checked for new mail.  For example, -n60 causes <EM>Pilot</EM>
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) <P>

<DT> -o <EM>dir</EM>

<DD>Sets operating directory.  Only files within the specified directory
are accessible and browsing is limited to the specified directory subtree.
<P>

<DT> -v

<DD> Enable single vertical column display. <P>

<DT> -x

<DD> Disable keymenu at the bottom of the screen. <P>

<DT> -z

<DD> Enable ^Z suspension of <EM>Pilot</EM>.

</DL>

<!-- pnuts -->

</BODY>
</HTML>
