
                            Potato Remailer Utility

                              -  User's Manual  -


                                 Version 2.2.0

Contents
========

    Overview
    Potato's Features
    Nym Editor's Features
    Example Uses
    Files
    Installation
    PGP
    POT.INI
    Installing Mixmaster
    Using Potato
    Commands
    Running Potato
    Nym Editor                --UPDATED--
    Book Files
    Security
    Securing the INI File
    Advanced Features
        Command Line
        The From Field
        Hidden-To Headers
        X-Headers
        Attachments           --NEW--
        RichMail              --UPDATED--
        Log File              --NEW--
        Message Archive       --NEW--
        Cutmarks
        Garbage               --NEW--
        Nym Replay Cache
        Using More Remailers
        Diagnostic Mode
        Book File Templates
        Probability Driven Reply Blocks
        Generating Random Passphrases
        Updating dec.ini from Nym Editor
        Reply Blocks: Subjects, Newsgroups and Bit Buckets
        More Reply Blocks
    Additional INI Features
        Secret-Key Passphrases
        Long Passphrases
        Wiping
        Secured INI filewiping
        Output File
        Workpath
        PGP Command           --UPDATED--
        Default Book File
        Editors
        Shell
        Including the To Address In the Output File
        UNIX Message File
        Net-Tamer
        Sequential Output Files

Overview
========

    Potato is a freeware DOS utility for remailers designed to integrate with
    Windows environments.  It provides support for Cypherpunk, Mixmaster, and
    pseudo-anonymous "newnym" remailers, including encrypted attachments, UUE
    attachments, MIME mail, and extensive header support.  Potato also includes
    a Nym Editor for easy editing and maintenance of nym accounts and multiple
    reply blocks, and a Decrypt utility for automatic decryption of nym mail.

    The Potato Remailer Utility is comprised of three programs:

        Potato      for creating outgoing messages
        Nym Editor  for creating and configuring nym accounts and reply blocks
        Decrypt     for automatic decryption of incoming nym messages


    This document details the use and installation of Potato and the Nym Editor.
    For information on Decrypt, which may be used independently, please consult
    Decrypt.txt.

Potato's Features
=================

    Chaining through multiple remailers
    Latency times for each remailer
    Anonymous messages with Subject, CC, BCC, Reply-To, Post-To, Anon-Post-To,
     Newsgroups, References, and custom headers
    PGP encryption to remailer (required)
    Cutmarks headers
    Garbage function for inflating message size
    Mixmaster messages with Subject, Reply-To, Newsgroups, and custom headers

    Nym messages with Subject, CC, Bcc, Newsgroups, References, Reply-To and
      Hidden-To and custom headers
    Nym-Commands control over each message
    Chaining nym messages through remailers with latency
    Automatic entry of secret key passphrases for signing
    Support for nym-server replay cache

    Up to 5 attachments with automatic encoding
    Control over each attachment's encryption/signing/UUE/MIME
    Unlimited text/attachment size
    UUEncoded attachments
    MIME support for nym and remailer messages including attachments
            MIME image attachments
            MIME application/octet attachments
            MIME Alternate text/HTML (Richmail) attachments

    Control over temp path used (workpath)
    Control over command used to del/wipe intermediate files
    Control over output path and file.

    INI file containing customizable choice lists and preferences
    Inclusion of external (address book) files in choice lists
    Searchable fields using choice lists
    Optional encryption of INI file
    Book files to maintain records and templates of message configurations
    Export of messages to Netscape, Agent, Net-Tamer, Eudora, and others

    Editor support for primary (text) attachment
    Shell support DOS shell or utility
    Archiving of all sent messages with optional encryption
    Log file capability

    Windows95 Installation Program
    WindowsNT compatible version available
    Detailed User's Manual

Nym Editor's Features
=====================

    Nym account creation and maintenance
    Triple reply block chains of up to four remailers each, including latent
     times and encryption at each remailer.
    Support for Subject headers and reply blocks to newsgroups and bit buckets
    Full support for nym reconfiguration requests
    Support for nym probability driven reply blocks
    Book file support to maintain records of nym accounts

Example Uses
============

    You wish to send an encrypted text message and several encrypted jpg files
    from your nym account, chaining the message through several remailers, to
    a PGP user.

    You wish to send a text message and attached zip file to a user of Netscape
    Mail, from your nym account or an anonymous remailer, using MIME.

    You wish to send an HTML MIME message to a newsgroup with a zip file
    attachment.

    You wish to create a nym account with a triple reply block, adding latency
    times and encryption at each remailer.  (A multiple reply block is a nym
    feature which sends redundant copies of each message through separate chains
    of remailers.  If one remailer fails, you still get your mail.)

Files
=====

    The Potato program is comprised of two required files:
        pot.exe
        pot.ini

    Additionally, The Potato Nym Editor consists of one file:
        nym.exe

    From wherever pot.exe and nym.exe are run, they must be able to find
    pot.ini.  This can be accomplished three ways:

        1) Change to the directory containing these files, and run the program.
           (If using Windows this will be done automatically.)
        or
        2) Specify the path to pot.ini on the command line. i.e.:
                pot.exe -p c:\pot
           where c:\pot is the directory containing pot.ini
        or
        3) Set the DOS environment variable POTATO=yourinipath  (This variable
           may alternatively be used to allow Nym Editor to find Potato.)

    In addition, this beta version comes with the following optional accessory
    files:

        Potato.txt    This help file.
        Install.bat   The Windows95 installation program.
        *.pif, *.lnk  Windows95 shortcuts
        pot.bak       A clean copy of pot.ini, in case the original becomes
                      corrupt.
        pot.old       If you reinstall Potato using Install.bat, your previous
                      pot.ini file will be renamed pot.old.
        zapfile.com   A secure file-wiping utility.  (Like DOS del but with
                      wiping.)
        mpack.exe     A MIME utility used by Potato.
        uuencode.exe  A UUEncode utility used by Potato.
        accessry.zip  Contains several optional accessory files including the
                      complete Mpack program and documentation, which includes a
                      utility for decoding MIME files, and the UUDecode program.
                      This file may be discarded if unneeded.
        dec.exe       The Decrypt Utility.  (See Decrypt.txt for instructions.)
        udec.exe      Required by dec.exe.
        dec.ini       The Decrypt ini file.

    While running, Potato and Nym Editor may create these files:

        default.bk    File containing previous session's field values (Do not
                      edit!) This file may be deleted.  (Also default.nbk)  Note
                      that these files contain the program information from your
                      last run.  If you use the program in a non-secure location
                      you should wipe these files each time with zapfile.
        *.tmp         Normally these files are deleted automatically.  If errors
                      occur and they remain, they may be deleted.  These files
                      will be located in the path you specify in 'workpath'.
        pot.pgp       If you have secured pot.ini with a passphrase it will be
                      encrypted to pot.pgp.
        mail.out      This is the default output file, which should be mailed to
                      the address indicated, then may be deleted.  (The name of
                      this file can be changed to any [path]name.
        nym.out       This is the default output file of the Nym Editor, and
                      should be encrypted/signed and mailed to a nym-server,
                      preferably through several remailers.
        config.bk     This book file, created by the Nym Editor, is prepared for
                      encrypting/signing nym.out, and sending it through
                      remailers to the nym-server.

Installation
============

    Windows95:
    Unzip the files to a temporary directory using WinZip.

    Run Install.bat.  This will create the directory "c:\pot", will copy files,
    and will add shortcuts to your Start Menu.  (You may also use Install.bat to
    reinstall over a previous copy of Potato.  Your existing pot.ini file will
    be renamed to pot.old.)

    If you wish to install to a different directory, or if your windows
    directory is not c:\windows, you can specify these on the command line:
        install [programdirectory windowsdirectory]

    For example:
        install d:\Pot c:\win

    would install the program in d:\Pot and add shortcuts to Windows located in
    c:\win.  If you specify one you must specify both. NOTE: If you use this
    option you will need to edit the shortcut properties after installation,
    entering the new directory and workpath.

    Windows 3.1:
    If using Windows 3.1, or if you do not wish to use Install.bat, simply unzip
    the files to a directory such as c:\Potato or c:\pot, and create shortcuts
    (program items) to pot.exe, nym.exe, and dec.exe.  (You may wish to locate
    the Decrypt files dec.exe, dec.ini, Decrypt.txt, in a subdirectory.)  When
    you run it the first time, adjust the window size and font to your liking.
    If using Windows95, turn on QuickEdit and Close On Exit.

    DOS:
    Unzip the files to the directory c:\pot or c:\potato.  (You may wish to
    locate the Decrypt files dec.exe, dec.ini, Decrypt.txt, in a subdirectory.)
    To run the program, change to the directory and run pot.exe or nym.exe.

    You may create a batch file to pot.exe or place pot.exe in your path.
    Please see the note above concerning pot.exe finding pot.ini.

    ALL Installations:
    Mpack.exe and uuencode.exe may be stored in the Potato directory, or may be
    in any directory specified in your path variable.  These are required only
    if using MIME/UUEncode features.

    ***In general, it is wise to use short directory structures with Potato.  If
    you have long filenames and long directory names, the shell to PGP may
    exceed the length limit imposed by DOS and will fail.

    Optional: (All Installations)
    Run CheckSig.bat to check the authenticity of the exe files.


PGP
===

    PGP (2.6.2 or 2.6.3) must be installed properly on your system for Potato to
    function.  Particularly, PGP must be in your PATH variable, and PGPPATH
    should be set properly.

    ***It is highly recommended that you set armorlines=0 in your PGP config.txt
    file.  Then set ---pgp=pgp in pot.ini.  This will give you more room
    on the command line to PGP.  For more details see the Advanced Features
    section.

POT.INI
=======

    The pot.ini file is used by both Potato and the Nym Editor.  You will need
    to customize the pot.ini file to your liking, and provide your nym addresses
    and other lists as you require them.

    The ini file is a plain text file, and should be edited using a plain text
    editor (not a word processor) such as Notepad.  It contains settings for
    several preferences.  It also contains several lists, which may be set any
    way you like. The lists are accessible and searchable from within Potato.

    You can use Potato without changing the ini, just to see how it works, but
    adjusting the ini file to your needs will make it much more able.

    Rules: Blank lines are ignored, as are lines which begin with a semicolon
    (;).  The lists and preferences may be in any order.

    Addresses: The first list in the ini is the list of addresses for the To,
    CC, and Bcc headers.  (Your address book.)

    If you use Private Idaho, you can have Potato include your address book (or
    any plain text file of addresses) with the following:

    ; To
    ---lst=1
    person1@address.com
    person2@address.com
    ---fil=c:\pidaho\address.txt
    ---end

    Any (or any number) of files may be included with "---fil=" lines as shown
    above.  The file included should have one address per line.  It's contents,
    as well as other addresses specified in lst=1, will be available for use in
    the To, CC, and Bcc fields.

    Nym Addresses:
    If you tell Potato your nym addresses, you will not need to type them in
    each time you send mail.  The default is:

    ; From
    ---lst=3
    yournym@nym.alias.net
    yournym@weasel.owl.de
    yournym@anon.efga.org
    ---end

    You should change this list to reflect each of your accounts.  Note:  You
    MUST include the FULL nym address, as shown above.

    For additional features of the From list, please see the Advanced Features
    section.

    Remailers:
    Likewise, the list of remailers will need to be updated.  If you wish, you
    may store the list in a separate text file (let's say remailer.txt). Include
    the following line within the remailer list:

    ---fil=c:\pot\remailer.txt

    For example:

    ; Remailers
    ---lst=4
    ---fil=c:\pot\remailer.txt
    ---end

    Alternatively, you can simply list the remailers inside the ini file:

    ; Remailers
    ---lst=4
    remailer@replay.com
    mix@squirrel.owl.de   (Squirrel)
    mixmaster@remail.obscura.com
    remailer@bureau42.ml.org
    ---end

    You may also combine the two methods.
    You can specify the common name of the remailer in parenthesis.  This will
    not affect the UserID for encryption, which is the email address of the
    remailer.

    All lists can be customized to your preferences.  Just be sure each ends
    with a "---end" line.  In some cases the first entry in a list is used as a
    default value, when needed.

    The uses of the lists will become more apparent as you use Potato.

Installing Mixmaster
====================

    Use of Mixmaster is optional.
    Potato supports Type II Mixmaster remailers.  You will need to download and
    install the files in MIXMASTE.ZIP, which can be obtained from various sites
    worldwide.

    Do one of the following:

        Create the directory C:\MIX and unzip the MIXMASTE.ZIP files to it,

        or, unzip the files into the Potato directory,

        or, if you already have Mixmaster installed elsewhere, leave it there.

    Once you know where Mixmaster is, you need to tell Potato where to find it.
    This can be done with any one of the following:

        Add the line "---mix=c:\mix" (or wherever it is) to pot.ini,

        or, set the environment variable MIXPATH=c:\mix (or wherever),

        or, if the above variable is already set for another program, you need
        do nothing,

        or, if you have unzipped the Mixmaster files to the same directory as
        you run Potato from, you need do nothing.

    Updating type2.lis and pubring.mix:
    These files contain the list of current mixmaster remailers and their keys.
    You will need to update them periodically.  You can download the current
    files at http://kiwi.cs.berkeley.edu/mixmaster-list.html

    After downloading, rename "type2.list" to "type2.lis".

Using Potato
============

    These instructions are not meant to be exhaustive, but to get you started.

    Run pot.exe.
    The program is simple to use.  You fill out the form telling the program
    what files you wish to mail, etc.  Finally you press Alt-r to run, which
    makes the output file.

 To: ____________________________________________ cc:  ________________________

 Subject: _______________________________________ Bcc: ________________________

 From: __________________________________________ Nym-Commands: _______________

 R1: _________________________________________________________ L1: ____________
 R2: _________________________________________________________ L2: ____________
 R3: _________________________________________________________ L3: ____________
 R4: _________________________________________________________ L4: ____________
 R5: _________________________________________________________ L5: ____________
                                       Encrypt           Sign            Encode
 A1: _________________________________ _________________ _______________ ______
 A2: _________________________________ _________________ _______________ ______
 A3: _________________________________ _________________ _______________ ______
 A4: _________________________________ _________________ _______________ ______
 A5: _________________________________ _________________ _______________ ______

 Newsgroups: __________________________________________________________________

 References: _____________________________________________ Delwith: ___________

 Output: __________________________________ Workpath: _________________________

    To:
    Place the address you want to send to in the To header.  If the address is
    in your list, you do not need to type all of it.  Just type a few characters
    (from the beginning or the middle of the address) then press Enter.  Potato
    will search your list for the address.  For example, "cat" would find
    "cat@nym.alias.net" and "dog@cat.net"  If you wish to search progressively,
    use Ctrl-Enter instead of Enter.  Note that only the characters to the left
    of the cursor are used in the search.

    To display the list, press Page Up and Page Down.
    To add several names from your list, use Ctrl-] to search.  This will add
    the address to the one already there, placing a comma between them.

    CC and Bcc:
    The lists for these fields operate like To.  Note that not all anonymous
    remailers support these headers.

    Subject:
    May be used with both nym and remailer messages.

    Nym-Commands:
    nym-servers allow you to specify certain commands with each message, such as
    +acksend.  This is an optional field.

    From:
    Type a portion of your nym name and press Enter.  Your nym address will
    appear. If you type it manually, you must use the FULL address, for example,
    yournym@nym.alias.net. If you leave the From field blank, the message will
    be sent only through anonymous remailers, and will not be a nym message.

    Please see the Advanced Features section for other uses of the From field.

    R1-R5:
    These are the remailers you wish to chain through.  You may type a partial
    name of a remailer (for example, "replay") and press enter to search, or you
    may pan through the list with PageUp and PageDown.

    L1-L5:
    These are the latent times to be used for each of the remailers.  They may
    be left blank.  Use Page Up and Page Down to select from the list.

    M1-M5:
    If you have Mixmaster installed, pressing Alt-m will change R1-R5 to M1-M5.
    Select the mixmaster remailer(s) you wish to chain through.  You can search
    in the usual fashion, or use Page Up and Page Down.  However, unlike cpunk
    remailers, you cannot enter a name which is not on the list.  This list is
    derived from type2.lis.

    Note that Mixmaster messages produced by Potato have a 10K limitation.
    Files larger than 10,000 bytes will not work.  This includes text added by
    nym headers and encoding.  If the file is too large you will receive a
    Mixmaster failure message.  Also note that Mixmaster remailers (used
    directly) has an 80 character header limitation.

    Also, Mixmaster supports more than one recipient in the To field.  Addresses
    should be separated by commas, with no spaces.

    Hd:
    These fields will only appear if you have mixmaster enabled.  These are
    additional headers you may add to your mail.  They can be anything you like.
    For example, typing
    From: me@myaddress.com

    would add a second From header.  (The first being From the remailer itself.)

    A1-A5:
    These are the files you wish to mail (attach).  Normally, the first file in
    A1 would be a text file (the "body" of your message).  You may specify any
    DOS filename or full pathname.  A1 defaults to pot.txt.  If you activate the
    editor with Alt-e, it will automatically load the file specified in A1.

    Encrypt:
    This specifies what UserID you want the corresponding file encrypted to.
    You may choose to leave any encrypt field blank, in which case the file will
    not be encrypted.

    Sign:
    This optional field indicates what UserID you want the corresponding file
    signed with.  If you specify a UserID in the Sign field and leave the
    Encrypt field blank, the attachment will be clearsigned.

    Encode:
    This field indicates how the attachment should be encoded.  For most
    purposes, you should set this field to "Auto" using the PageUp key.  For
    other encode settings, and information on how Potato encodes files, please
    consult the Advanced Features section.

    Newsgroups:
    This header may be included for usenet posts for both nym and anonymous
    messages.  Generally, spaces should NOT be included.

    The Newsgroups field also contains three hidden headers which may be used.

        If you enter in the Newsgroup field:
        Post-To: alt.your.favorite.group,alt.another.group
        or
        Anon-Post-To: alt.your.favorite.group,alt.another.group

        the Post-To (Anon-Post-To) header will be added instead of the
        Newsgroups header.  Post-To headers are used by some anonymous remailers
        for posting to Usenet.  (Those supporting the "post" option.)  You must
        type "Post-To: " exactly, or select it with Page Down.  ("post-to: "
        will also work.)  Normally if you use a Post-To header, the To header
        should be left blank.  The effect of including both is uncertain.

        The Newsgroups field may also contain a Hidden-To header, which is
        described in the Advanced Features section.

    References:
    This header may be used with anonymous and nym messages.  It is intended for
    replying to (usenet) messages.  For example, if the post you are replying to
    has the header: Message-ID: <wJJVBzeZjlXgWRv3XA3WVQ==@JawJaCrakR> you
    would enter <wJJVBzeZjlXgWRv3XA3WVQ==@JawJaCrakR> under References.

    If you are using Windows95, you can paste to and copy from the Potato
    screen. Place the cursor in the References field and select paste from the
    toolbar. (Quick Edit must be turned on in the window properties.)

    Delwith:
    This specifies how you want temporary files deleted, with del or with a
    wiping utility.  It defaults to the first entry in the ini list.  If left
    blank, del is used.

    Output:
    This is the file (or pathname) you want the output message written to.  It
    defaults to the first entry in the ini list.

    Workpath:
    This is the directory you wish used for temporary files.  It defaults to the
    first entry in the ini list.

Commands
========

    Here is a summary of commands.  This screen can be displayed at any time by
    pressing F2.

                         Potato Remailer Utility v2.2
Enter   Smart key; searches list using the text from the cursor left, then
        moves the cursor to the next logical position.  (Ctrl-Enter searches
        progressively.)
Ctrl-Arrows Moves cursor to previous or next position. (Tab also moves to next.)
U/D Arrows  Moves cursor up and down.
Ctrl-]  Searches and adds string to current string, placing a comma between.
Ctrl-BS (Ctrl-Backspace)  Clears a field.
Ctrl-\  Restores field's previous value.
PgUp,Dn Steps through the list of choices for the current field, if any.
Ctrl-c  Copies text to Potato's clipboard.  Ctrl v to paste, Ctrl x to cut.
The left and right arrow keys, backspace, Ins, Del, Home, and End work normally
Ctrl-z  Undo changes to current field.
Alt-c   Clear All Fields.  (Resets some to default values.)
Alt-m   Toggle Mixmaster/Cypherpunk remailers
Alt-l   Load Saved Book            Alt-s  Save Current Book.
Alt-f   Enable Log File            Alt-v  Message Archive
Alt-d   Shell to DOS               Alt-e  Shell to Edit file in A1
Alt-h   Edit X-HEADER.TXT          Alt-x  Enable x-headers.
Alt-t   Add cutmarks header        Alt-b  Add Garbage  (Cypherpunk only)
Alt-g   Enable Diagnostic mode     Alt-u  Enable UNIX     Alt-i Include Address
Alt-r   Run - Make Output File     Alt-a  Run with Replay Alt-q  Multiple run
F1      Display current DOS screen.  (Useful for observing errors.)
Esc     Exit  (Does not save book.)

Running Potato
==============

    Once you have completed the form, press Alt-r to run.  Potato will shell to
    DOS and PGP as required.  If successful, the output file will be created and
    you will be told where to mail it.

    If any errors occur, you will need to modify the book and run again.

    To send the message, you must *insert* the text contained in the output file
    (normally mail.out) into the body of a message in your mail software.  Under
    To, enter or copy/paste the address of the first remailer the message is
    going to.

    You CANNOT ATTACH the file.  Remailers will not read attachments.  The "::"
    must be the first line of your outgoing message.

    Some mail software, such as Agent, allows you to insert text files into your
    mail message.  Others do not.  In that case, you must load the output file
    (mail.out) into Notepad, then copy and paste the text into your mail
    program. If using this method, you may have a size limitation.

    Additionally, Potato can save messages in UNIX Message File Format, suitable
    for import by Agent, or write them directly to Netscape's outbox.  For
    information on these features, please consult MailApps.txt.

    Potato can generate extremely large files.  However, most remailers will
    lose messages that are larger than some limit, which varies from 50K to
    1 Meg+. Nym-servers, used without anonymous remailers, generally handle
    messages as large as 1 Meg.

Nym Editor
==========

    The Nym Editor (nym.exe) may be used to create and maintain nym accounts.
    Before using Nym Editor it is recommended that you read the help file for
    nym accounts.  You can get a copy of this file by sending a message to
    help@nym.alias.net or help@anon.efga.org, or any other nym-server in
    operation.

    Run nym.exe. The editor will allow you to create multiple reply blocks, each
    block chaining from zero to four remailers, including encryption and latent
    times.  (A multiple reply block is a nym-server feature which sends multiple
    copies of each message through different chains of remailers.  That way if
    one remailer fails, you still get your mail.)

    To create an account, first create a PGP key for the account.  It is
    recommended that you include the full address of the nym in the UserID of
    the key.  (e.g., YourNym <yournym@nym.alias.net>)  IMPORTANT:  The
    UserID of the key should be entered in the Key field only when creating a
    new account or changing your key.  Otherwise the Key field should be left
    blank.

    When creating an account, the nym command "create" or "create?" must be in
    the Nym-Commands field.  You can see default values by pressing Page Down
    and Page Up.

    When editing an existing account, you may leave some sections blank.  For
    example, if you are simply changing your reply block, you may leave the
    Nym-Commands and Key fields blank.

    When filling out the From field, it is vital that you type the FULL nym name
    and address.  (ie yournym@nym.alias.net)  The Nym Editor needs the entire
    address to determine where the message should be sent.

    Each reply block, A-C, contains the following fields:
        To:     The final terminating address of the reply block.  (Your email
                address.)  (Also may be used to specify a Subject or Newsgroup -
                see Advanced Features section.)
        L(A-C): The latent time assigned to the message as it leaves the
                nym-server and goes to the nym-server's remailer.  (Optional)
        P(A-C): The passphrase the nym-server will use to conventionally encrypt
                the message to this reply block.  (Optional)
        R1-R4:  The remailers your message will be sent through, first to last.
                (You can use from 0 to 4 remailers for each reply block.
                Leave unused R fields blank.)
        L1-L4:  The latent time each remailer should assign to the message.
                (Optional)  Use Page Up and Page Down for the list, or enter
                your own.
        P1-P4:  The passphrase each remailer should use to conventionally
                encrypt the message.  (Optional)


    You do not need to use all three reply blocks (A-C).  Any number from 1 to 3
    is valid.

    Pressing Alt-r will cause the Output file (specified in "Output", normally
    nym.out) to be created.  If successful, the Nym Editor will create the
    output file, as well as a Potato book file: Config.bk.  This book file is
    used to Encrypt/Sign the configuration request, and send it to the
    nym-server through remailers.  After running Nym Editor, run Potato by
    pressing Enter.  (Or type 'pot config')  Select the remailers you wish to
    use and press Alt-r again, which will create mail.out, which can then be
    mailed. You must leave the From field in Potato blank.

    Note:  nym.out, produced by the Nym Editor, is not encrypted/signed.  It is
    plaintext, and the nym-server will not process it as-is.

Book Files
==========
    If this section confuses you, you may ignore it for now.  This information
    is not required.  Once you are familiar with the program you may wish to
    come back and read this section.  Book files can be very convenient to
    manage nym accounts and message templates.

    Each time Potato runs, it loads the file default.bk (or file specified in
    pot.ini) which contains all the information on the screen the last time the
    program ran: To, From, Subject, etc.  When you press Alt-r to make the
    output file, Potato first updates default.bk.

    You can manually save the information on the screen at any time by pressing
    Alt-s.  You will be prompted for a book pathname.  You can use default.bk or
    any name you wish.

    This information can be loaded at any time by pressing Alt-l (L), and
    entering the appropriate book name.  You can also press Page Down to see a
    list of book files in the current directory.  Or, tell Potato to load a book
    other than default.bk on the command line.  For example:
        pot.exe mybook.bk
    would run Potato and load the book file.  You can also abbreviate this
    command as:
        pot mybook

    Book files can be used to save templates, allowing you to keep track of
    settings for various message types, such as Usenet posting through a
    mail2news gateway, or a template for sending from your nym account.

    They can also be used to keep a record of messages sent, such as test
    messages. When you get a test message back you can load the book back to see
    exactly how it was sent.

    In addition, the Potato Nym Editor uses books.  The default book is
    default.nbk. (Nym Editor book files have an ".nbk" extension.)  When you
    create a nym or submit a new reply block, you can save a book file for that
    nym, which will contain a record of the reply blocks and passphrases used.
    When you want to edit that account you can load the book, make changes, and
    run.

    Any book file loaded into Potato or the Nym Editor is automatically updated
    when you press Alt-r to run.  However, pressing Esc to exit does not update
    the book.

    It is NOT advisable to edit book files except by running Potato.  However,
    they may be deleted at will, including default.bk.

Security
========

    Because the pot.ini file may contain personal information, you should be
    aware of its location and contents.  (You can also secure it with encryption
    as explained below.)  Also, default.bk and other book files may contain
    addresses and/or passphrases.  (To turn off book file loading and saving,
    see the Advanced Features section.)

    These files may be stored in a directory or drive different from pot.exe and
    nym.exe.  When you run the program, you must tell it where to find pot.ini
    using the -p switch.  For example:
        pot -p a:\
    You can do this while loading a book file at the same time like so:
        pot -p a:\ c:\mybook.bk
    or
        pot c:\mybook.bk -p a:\

    The default book files will also be read from and written to this path.

    While running, Potato creates temporary files, such as pot*.tmp.  If an
    error occurs, these files may be left behind in the "Workpath" directory.
    (See below.)  You can delete these files or they will automatically be
    erased the next time Potato runs.

    If you have specified your passphrases in pot.ini, and you're using
    longphrase=yes or longphrase=extra, be aware that your passphrase is written
    to a temporary file during execution.  Normally this file is wiped with the
    command specified in "---wipewith" (default is PGP.)  However, if errors
    occur this file may be left in the workpath.  You may manually wipe it with
    PGP -w or zapfile. It will be named either "pot*.tmp" or "pot*.bat",
    depending on the longphrase setting.  One way to avoid this problem is to
    use a RAM drive.

    PGP also writes temporary files necessary during encryption.  These are
    saved into the path specified by your TMP variable, or if none is set, in
    the TMP specified in PGP's config.txt.  If execution is terminated
    prematurely, it may leave temporary files containing plaintext.

Securing the INI File
=====================

    Potato can secure your ini file so that your passphrases and addresses are
    not vulnerable. It encrypts the file with a passphrase you specify.  Each
    time you run the program, you will be prompted for this passphrase.  This
    passphrase does not need to be the same as your account phrases.

    To secure your INI file, enter DOS and type
    pot +secure

    (or use the shortcut)
    You will be prompted for a passphrase to use.  The ini file will be
    encrypted as pot.pgp.

    If you need to desecure your ini file (to edit it), enter
    pot -secure

    and the procedure will be reversed.

    If you ever forget the passphrase, there is a clean copy of the ini file in
    pot.bak.
    copy pot.bak pot.ini

    Because the Nym Editor shares pot.ini, you will need to enter your
    passphrase when running it as well.

Advanced Features
=================

Command Line
------------

    Potato's command line usage is as follows:
    Usage: pot.exe [-z"passphrase"] [-diag] [-p inipath] [file.bk]

        where file.bk is a saved potato book (the bk extension may be omitted)
        and inipath is the directory containing pot.ini and other accessory
        files.

        The passphrase, if specified, is used to access a secured ini file, or
        may also specify a default passphrase for signing.

    Or:    pot.exe [-z"passphrase"] [-p inipath] +secure|-secure

        In this case the passphrase, if specified, will be used to
        secure/desecure pot.ini.

    Nym Editor's command line usage is as follows:
    Usage: nym.exe [-z"passphrase"] [-diag] [-p inipath] [file.nbk]

        where file.nbk is a saved nym book (the nbk extension may be omitted)
        and inipath is the directory containing pot.ini and other accessory
        files.

        The passphrase may be used to access a secured ini file.

The From Field
--------------
    As stated above, you full nym address must be entered in the From field when
    you are sending a nym message.  If sending an anonymous message, you may
    leave it blank.

    The From field also contains a hidden header, Reply-To:, which may be used
    with both nym and anonymous messages.  To add this header to your mail:

        If sending an anonymous message, enter in the From field:
        Reply-To: youraddress@yours.com

        If sending a nym message, enter in the From field:
        yournym@nym.alias.net Reply-To: youraddress@yours.com

        Notes:  There MUST be a space after your nym address, and after the
        colon. You must type "Reply-To:" EXACTLY as shown, or it will be
        ignored.  (Lower case is okay.)  (Press Page Down to see examples.)

    Additionally, when sending a nym message, you may specify what UserID should
    be sent to PGP for signing.  This should be done as:

        yournym@weasel.owl.de (yourid)

    The UserID must be in parenthesis.  You may also add a Reply-To: header:

        yournym@weasel.owl.de (yourid) Reply-To: myaddress@my.isp

    In addition, you may specify a default passphrase using the From field:
        {default_phrase_here}

    It must be in curly brackets.  It will be used to access keys for which no
    passphrase has been defined in the INI file.  You may also enter it at the
    end of an address while in Potato:
        yournym@weasel.owl.de (yourid) Reply-To: myaddress@my.isp {my_phrase}

    The passphrase will disappear once you move the cursor, but will remain in
    memory until the program terminates.

Hidden-To Headers
-----------------
    The Newsgroups field may be used to enter a Hidden-To header for a nym
    message. Enter:
        Hidden-To: the@address.com

    in the Newsgroups field.  You must type "Hidden-To: " exactly or it will be
    seen as a Newsgroups header.  This optional nym header overrides the To, CC,
    and Bcc headers.  Your nym message is mailed only to the addresses in the
    Hidden-To header, and the other headers appear but have no affect.  The
    Hidden-To header is not seen by recipients.

X-Headers
---------
    You may include additional headers of any kind in Cypherpunk, Mixmaster, and
    nym messages by adding them to the file "x-header.txt", located in the same
    directory as pot.ini.  Any headers contained in that file will be added if
    X-headers are enabled.  Blank lines in x-header.txt, and any lines which do
    not contain a colon are ignored.

    You can have Potato load this file into an editor by pressing Alt-h.  Before
    running, use Alt-x to enable/disable the X-header feature.  A capital "X"
    will appear on the bottom line of Potato's screen.  If x-header.txt is not
    found, a lower case "x" will appear.

Attachments
-----------
    Potato supports a variety of methods for attaching and encoding files.  For
    most purposes, the "Auto" setting is sufficient.

    Auto - This setting tells Potato to determine the type and encoding to be
    used.  Potato proceeds as follows:

        The first 1000 bytes of the file are examined.  If the file appears to
        be plain text, it is attached as MIME T (text).  (Or MIME H (HTML), if
        it has an "HTM" extension.)

        If the file is not plain text, it is attached as MIME J (JPEG) if it has
        a "JPG" extension, MIME G (GIF) if it has a "GIF" extension, or MIME X
        (BINARY) if it has any other extension.

    Note:  If you are attaching a file which is unusual in that the first part
    of the file is plaintext while later portions are binary, you must attach it
    as "MIME X".  If you use "Auto" the file will be sent as binary data, which
    not only will arrive corrupted, but may crash a mail server enroute.


    MIME T - This specifies the file as MIME plain ascii.  Use this setting only
        for 7 bit ascii text.  If your text contains extended characters, you
        must use MIME X.  (Potato does not support "quoted printable" encoding.)

    MIME J - A JPEG image file.

    MIME G - A GIF image file.

    MIME H - An HTML plain ascii file.

    MIME X - Any other file, including ZIP, EXE, COM, WAV, AVI, etc.

    MIME A - An alternative plain text file for RichMail.  (See RichMail section
        below.)

    UUE - File will be UUEncoded.  Note that if you encode a file with UUE in a
        message which contains MIME parts, the UUE section will be embedded in a
        MIME plain text section.  (Which is generally acceptable.)

    PGP Ar - File will be ascii armored by PGP.  It can be converted back to the
        original file by any PGP user.  No passphrase or key is required.

    PGP Cv - File will be PGP conventionally encrypted and armored.  You will be
        prompted for a passphrase.

    None - No encoding is used.  If you attach a binary file (which has not been
        encrypted or signed) with None encoding, it will result in binary mail.
        Use this setting with discretion.  Note that if you specify None in a
        message which contains MIME parts, the None section will be embedded in
        a MIME plain text section.

    Notes:

        If you encrypt or sign a file, (add a UserID to the encrypt or sign
        field), this automatically converts the file to plain text.  Thus, it
        should be encoded as Auto, MIME T, or None.

        When sending mail to nym accounts, it is generally easier for the
        recipient if you simply encrypt the file, and use Auto (MIME T)
        encoding.


RichMail
--------
    MIME supports a "mixed/alternative" header for Richmail (HTML capable mail).
    If the recipient's mail program supports Richmail, an HTML file is
    displayed.  If not, a plain text version is displayed, and the HTML file is
    seen as an attachment.  Some mail programs will show both the plaintext and
    the HTML, and some will not show the plaintext if the HTML is displayed.

    If you wish to use this feature, you should write a plain text version of
    your message, and save it.  Also, write your HTML version, and save that as
    an HTML file.  (It should begin and end with the usual ).  In
    Potato, set the encode field to "MIME A" next to the plaintext version, and
    "MIME H" next to the HTML version.

    Note:  If a "MIME A" attachment is specified, there must be a corresponding
    "MIME H" attachment. Only ONE "MIME A" field may be specified per message.
    If there are more than one "MIME H" attachments, the first one will be used
    as the alternative counterpart - the others will simply be attached.

Log File
--------
    Potato's Log File feature records information about each message created,
    including headers, attachments, and remailers.  The Log File may be enabled
    by pressing Alt-f.  The log will be written to the file Potato.log in the
    inipath.

    In addition, you can set the pathname of the Log File in pot.ini.  For
    example:

    ---logfile=c:\stuff\mymail.log

    Also, set
    ---writelog=yes

    to enable the Log File feature as your default.

Message Archive
---------------
    When Potato runs, it can add a copy the message being run to a Message
    Archive.  A Message Archive is simply a plain text file containing one or
    more messages.  The headers will be included, as will the first attachment
    (normally pot.txt), provided it is plain ascii text.

    To set the archive file for a given book, press Alt-v.  Type the pathname of
    the file, such as c:\default.txt.  The archive file will be displayed in the
    upper right corner of the screen.  You may specify a different archive file
    for each book.

    Additionally, Potato can encrypt each addition to the archive using a PGP
    UserID you specify.  (Presumably your own UserID, so you have access to the
    archive.)  To specify a UserID, include it in parenthesis after the archive
    filename.  For example:
    c:\default.txt (myUserID)


Cutmarks
--------
    If you are using cypherpunk remailers, you may press Alt-t to include a
    cutmarks header.  The header will be added to each remailer in the chain.

Garbage
--------
    The Garbage feature adds random garbage to each remailer stage.  (Cypherpunk
    remailers only.)  This garbage is stripped away by the remailer after
    decryption.  Thus, when the message emerges from the remailer, it is
    significantly smaller, making traffic analysis very difficult.

    To use the Garbage feature:

        Add a cutmarks header using Alt-t, such as ==== or ++++  (do not use
        dashes)

        Set Garbage to the maximum amount you want added to each stage.  For
        example, "10" would specify 10K.

        Select remailers which support the "cut" option.

        Run your message normally.

    Potato will add 50%-100% (random) of the amount of garbage you specified to
    each remailer.  For example, if you set Garbage to 10, it will add between
    5K and 10K to each remailer.

Nym Replay Cache
----------------
    Quoting from the nymserver help file:
        REPLAY
        The remailer keeps a replay cache, and will not accept the same message
        twice unless each copy has been separately signed. Thus, it is safe to
        send multiple copies of outgoing E-mail messages through very long
        remailer chains if you are worried about one copy not getting through.
        Whether one or more copies actually make it through, only one copy will
        go out.

        One side effect of this is, however, that if you PGP sign a test message
        and mail it in multiple times, it will only work the first time.

        Note that signatures are only considered valid for a week. Thus, if mail
        comes to send@nym.alias.net more than a week after you signed it, that
        mail will be dropped.

    Potato will allow you to send the same nym message through multiple chains
    of remailers.  Follow this procedure:

    Prepare your nym message.  Instead of pressing Alt-r to run, press Alt-a.
    As Potato creates the usual output file, it will also save a copy of the
    signed nym message to the file "bookfile.asc", where 'bookfile' is the
    pathname of the current book file.  For example, if the current book file is
    "e:\default.bk", the replay file will be named "e:\default.asc".

    Next Potato will return you to the message composition screen, prepared for
    sending the replay copy again.  Simply fill in the remailers you wish to use
    and press Alt-r.  You can repeat this as many times as you wish.  No matter
    how many copies you send, only one will be mailed by the nymserver.

    Note that when you press Alt-a, Potato saves the book file as usual.
    However, it then turns off book file saving for future runs.  To reenable
    it, use Alt-s and specify a book pathname.

Using More Remailers
--------------------
    If you wish to chain a message through more than five remailers, or if you
    wish to mix cypherpunk with mixmaster remailers, you can attach Potato's
    output file as input, and add additional remailers.

    If you press Alt-q to run, (rather than Alt-r), Potato will create the
    output file, and will then prepare for chaining it through additional
    remailers. Choose your remailers, then press Alt-q again.  Repeat this as
    many times as necessary.

    When Alt-q is used, the following functions are disabled: IncAddr, Unix
    Message File, X-Headers, and Net-Tamer.  If you wish to enable these
    functions on the last run, use Alt-r instead of Alt-q.  However the
    attachment in A1 may not have the same name as the output file when using
    Alt-r.  This means you will need to change the name of the output file
    before using Alt-r.

    Note that this method cannot be used to chain more than the usual five
    mixmaster remailers.

Diagnostic Mode
---------------
    Potato may be placed in diagnostic mode by modifying the appropriate line in
    the ini file or by including the "-diag" switch on the command line.

    You can also enable diagnostic mode by pressing Alt-g, or by pressing Esc
    once while Potato is running (making the output file).

    Diagnostic mode gives the user the opportunity to step through each DOS
    command. It also display passphrases.  Note that diagnostic prompts appear
    *after* a command has executed.

Book File Templates
-------------------
    Any book file saved with the extension ".tbk" becomes a book file template.
    When Potato is instructed to load a book file (from the command line or
    using Alt-l), if the name specified is not found, and if the name specified
    has no extension, Potato then searches for a ".tbk" file with the same name,
    and then for a standard ".bk" book file.

    If Potato loads a template file, it changes the resident book file's name to
    ".bk" after loading.  In this way, Potato will not overwrite the template
    file when running (or saving), but will instead write a ".bk" file with the
    same name.

    To create a template file, simply save a book file with the extension
    ".tbk".

    If you save a book file named "default.tbk", Potato will load that template
    on startup, rather than default.bk.

Probability Driven Reply Blocks
-------------------------------
    When using the Nym Editor, if you wish to associate probability variables
    with your reply blocks, you may specify them in the Qa, Qb, and Qc fields.
    For example:
        p=0.75

Generating Random Passphrases
-----------------------------
    If you wish to use a random conventional passphrase for your nym account,
    place the cursor in a passphrase field and press Alt-n.  This will generate
    a random 24 character (radix-64) phrase.  (22 characters is sufficient for
    the MD5 hash to produce 128 random bits for the IDEA key.  Using more adds
    no security *with RANDOM passphrases*.)

    Nym Editor derives the random bits using the characters you've typed, the
    millisecond timing between your keystrokes, and the number of milliseconds
    since midnight (or system boot).  If you receive the message "Need more
    random input", move the cursor around or type some characters, or simply
    hold down Alt-n.  The best method is to add the passphrases after you've
    filled out the rest of the form.

Updating dec.ini from Nym Editor
--------------------------------
    Nym Editor has two functions which update Decrypt's dec.ini file.  The
    first, Alt-o, exports passphrases to dec.ini.  All passphrases on Nym
    Editor's screen will be added to "---block" sets in dec.ini.  If there are
    any previous block sets for this account, you will be prompted for whether
    they should be removed.

    The second function, Alt-p, strips block sets for the account.  You will be
    prompted for each block set encountered.

    Thus when updating a nym account's passphrases, you can load the nym book
    and press Alt-o to export the new phrases to dec.ini.  When the reply-block
    has been confirmed and the prior passphrases are no longer required, you may
    use Alt-p to strip them out.

Reply Blocks: Subjects, Newsgroups and Bit Buckets
--------------------------------------------------
    Nym Editor includes several features to allow you to terminate a reply block
    at a mail2news gateway, or simply to add a subject to the final stage of
    your reply block.

    The following are valid uses of Nym Editor's "To:" fields:
    myaddress@xyz.net Subject: This is a reply block message

    or
    mail2news@rmlr.com Subject: This is a reply message Newsgroups: alt.test

    or
    Anon-Post-To: alt.test Subject: This is another reply block message

    Additionally, to generate cover traffic, Nym Editor supports the Null:
    header used by Freedom 2.0 remailers.  Enter in Nym Editor's "To:" field:
    Null: nowhere@xyz.net

    The message will be discarded by the final remailer.

    Note, the above uses require that you type the header's name (ie "Subject:
    ", "Newsgroups: ", "Anon-Post-To: ", etc.) EXACTLY.  Otherwise it will be
    treated as a standard To header.

    Additionally, the Newsgroups header REQUIRES a Subject header before it, or
    it will not be included correctly.

    You can include these examples in pot.ini's "To" list.  However, they will
    only work with Nym Editor.  Potato's "To:" does not use these features.

More Reply Blocks
-----------------
    If you wish to use more than three reply blocks for an account, run nym
    editor twice, saving each output to a different file, such as nym.out and
    nym2.out.

    Load these into your editor and concatenate the reply blocks into a single
    message.

Additional INI Features
=======================

Secret-Key Passphrases
----------------------
    You may include the secret key passphrases for you nym keys when listing
    your nym addresses in the From list of the INI file.  This way you will not
    have to type them each time a messages is sent (signed).  For example:

        nyma@nym.alias.net {Secret_Key_Passphrase_For_Nym_A}

    The passphrase must be contained within {curly brackets}.  (It may also
    contain curly brackets.)

    Here are additional examples:
        nymb@weasel.owl.de (myUserID) {My_Passphrase}
        nymc@anon.efga.org Reply-To: yourname@my.net {My Other Passphrase}
        nymd@nym.alias.net (myUserID) Reply-To: myaddr@my.net {My_Pasphrase}

    Note that the parenthesis and curly brackets are NOT interchangeable.  Your
    passphrase may contain spaces.

    If you include passphrases with your nyms, it is recommended that you change
    the "longphrase" setting below to either "yes" or "extra".

Long Passphrases
----------------
    Potato has several methods for sending your secret key passphrase (if
    specified in your list of nyms) to PGP.  The simplest and default method is
    ---longphrase=no

    This works with all versions of PGP.  However, the passphrase must be short
    because it is passed on the PGP command line, which in total cannot exceed
    123 characters.

    If you get a warning that the DOS limit has been exceeded, you will need to
    shorten either pathnames, UserIDs, or send your passphrase a different way.

    If you specify
    ---longphrase=yes

    you can use *any* length passphrase.  However, "---longphrase=yes" will not
    work with some versions of PGP, such as the 32 bit PGP 2.6.3i.  If your
    passphrase is not entered as you expect, try

    ---longphrase=extra

    In this case, the environment variable PGPPASS will be used via a temporary
    batch file execution.  "extra" will work with all versions of PGP.  Your
    passphrase may be any length your available environment space allows.

Wiping
------
    ; When Potato needs to wipe sensitive files like a secured ini file, or a
    ; temporary file containing your passphrase, it uses this command.  The
    ; default is "---wipewith=pgp +v=0 -w".  You may also use zapfile (which is
    ; faster and possibly more secure) or other software.
    ---wipewith=pgp +v=0 -w

    Even if you set the delwith variable to simply "del", you should use a true
    file wiping utility in "---wipewith".  The default uses PGP.  However, this
    is slow, so if zapfile works well on your system, that will increase the
    speed.

Secured INI filewiping
----------------------
    ; The following preference only applies if pot.ini is secured.  If you set
    ; wpini to no, the ini file will not be wiped after it is read. The main use
    ; for this is if you have it located on a RAMdrive, and you only want to
    ; enter your passphrase once per session.
    ---wpini=yes

Output File
-----------
    You can specify the default output file by making it the first entry in the
    "Output" list.

Workpath
--------
    You can specify the default workpath by making it the first entry in the
    "Workpath" list.

PGP Command
-----------
    You can control the command Potato uses to run PGP.  Normally this may be
    left at the default.

    ; Specify the PGP command here.  The default is ---pgp=pgp
    ; NOTE: +armorlines=0 is REQUIRED unless it is set in PGP's config.txt
    ; If it is in config.txt, then enter "---pgp=pgp"
    ; A trailing space is NOT required.
    ---pgp=pgp +armorlines=0

    It is *highly* recommended that you set armorlines=0 in PGP's config.txt.
    Doing so will allow you to enter "---pgp=pgp" above, which will save you
    valuable space on the limited PGP command line.  Armorlines=0 tells PGP to
    create output files of unlimited size.  Otherwise it breaks larger files
    into pieces, which is not compatible with Potato.

Default Book File
-----------------
    Potato and Nym Editor, by default, use the book files default.bk and
    default.nbk.  This can be changed with the following ini command:
    ---dbk=mybook

    You should not include an extension.

    If you wish to turn default book loading and saving off, insert the command:
    ---dbk=

    Any book file specified on the command line overrides the ini setting.

Editors
-------
    Potato can shell to your editor.  (Alt-e) It will load the file specified in
    A1. (Or will default to pot.txt.)  This allows you to easily edit the file
    you are mailing.  The default editor is DOS's edit.com.  This may be
    adjusted by adding the following line to the top of pot.ini (after
    "---ver"):

    ---edt=e4.exe

    This would specify that e4.exe be used as the default editor.

Shell
-----
    You can shell to DOS from Potato.  (Alt-a) The default shell is command.com.
    (To return from a shell type 'exit' is necessary.)  This can be changed to
    any program you wish with the following line:

    ---shl=az.exe

    This would allow Potato to shell to az.exe, for example.

Including the To Address In the Output File
-------------------------------------------
    If you specify
    ---incaddr=yes

    a line will be prepended to the output file which shows what address the
    message must be mailed to.  This feature is mainly useful if your software
    supports such a header, or if you wish to create several output files to be
    mailed later. Note that cypherpunk remailers require the first line of a
    message to be "::", so you must remove the To line and blank line before
    sending.

    You can also include the To header by using Alt-i to run, rather than Alt-r.

UNIX Message File
-----------------
    Potato can copy its output file to a UNIX message file.  The UNIX message
    file format is compatible with some email software, such as Netscape Mail,
    Eudora, and Agent.

    The line
    ---unixform=standard
    turns on the UNIX message file feature, and tells Potato what format the
    file should be.  Valid values are "netscape3", "netscape4", and "standard".

    The line
    ---unixfile=
    tells Potato the pathname of the UNIX message file.  If none is specified,
    the default used is "unixfile.txt" in the inipath.  Note: Windows95 long
    filenames/pathnames are NOT valid.

    Finally, lst=14 specifies additional headers to be included in the UNIX
    format messages.  At the very least, you should specify your real From
    address.  Some remailers require a valid From address.

    ; UNIX Message Headers
    ---lst=14
    From: your.real@address
    ---end

    Additionally, you may add the line
    ---unixdef=append
    or
    ---unixdef=overwrite
    or
    ---unixdef=disable
    to determine the default enable state when Potato starts.  If not specified
    the default is "disable".  If set to "overwrite", only the first run will
    overwrite the output, and the mode will switch to "append" for subsequent
    runs.  This is particularly useful with programs that import but do not
    erase the UNIX file, such as Agent.

    To toggle the default enable state from within Potato, press Alt-u.

    For additional information on integrating Potato with email apps, please
    consult MailApps.txt.

Net-Tamer
---------
    Adding the line
    ---nettamer=yes

    to pot.ini will cause Potato's output mail file to be in the format used by
    Net-Tamer software.  Note that this function overrides the "incaddr"
    function.

    Also, the output mail files will be generated using the Sequence feature
    detailed below, unless it is turned off explicitly.

    You may define the default output mail filename and pathname in the pot.ini
    "Output" list (lst=7).  The first entry in the list is used as the default.
    For Net-Tamer compatibility, you should enter:

    ; Output
    ; Set this list to your preferences for the output file name and location.
    ---lst=7
    c:\msgs\mail.xxx
    ---end

    where "c:\msgs\" should be replaced with your default Net-Tamer mail
    directory. Note that any extension is replaced by $nn.

Sequential Output Files
-----------------------
    If you include the line
    ---sequence=yes

    in pot.ini (or have nettamer set to yes) output mail files will be given the
    name: filename.$nn, where "filename" is the name specified in the output
    field, and nn is a value from 20 to 99.  Subsequent runs will increment nn.
    Potato always looks for the lowest nn it can use, from 20 to 99.  It will
    not overwrite an existing file.

--------------------------------------------------------------------------------
Additional information and version updates available at
http://www.geocities.com/SiliconValley/Bay/4362

A German translation of this document is available at
http://www.fen.baynet.de/~na1321/security/potato.htm


