home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / mmos2036.zip / mm.txt < prev    next >
Text File  |  2000-04-28  |  38KB  |  991 lines

  1.  
  2.  
  3.  
  4. MultiMail(1)                                         MultiMail(1)
  5.  
  6.  
  7. NAME
  8.        mm - offline mail reader for Blue Wave, QWK, OMEN and SOUP
  9.        packets
  10.  
  11. SYNOPSIS
  12.        mm [filename1] [filename2] [...]
  13.  
  14. DESCRIPTION
  15.        MultiMail is an offline mail packet reader, supporting the
  16.        Blue  Wave,  QWK,  OMEN and SOUP formats. It uses a simple
  17.        curses-based interface.
  18.  
  19.        SOUP is used for Internet email and Usenet. The others are
  20.        used  primarily  by dialup (or telnet) BBSes, to save con-
  21.        nect time, and to provide a better interface to  the  mes-
  22.        sage base.
  23.  
  24.        Not  all packet formats may be available, depending on how
  25.        the program was compiled.
  26.  
  27.        This manpage is for version 0.36.
  28.  
  29. USAGE
  30.        On most screens, the available keystroke commands are dis-
  31.        played  in  the  lower  part  of  the screen. In the mail-
  32.        reading window, pressing F1 or '?'  will show the commands
  33.        available there.
  34.  
  35.        The  navigation  keys,  most  of which work throughout the
  36.        program, are briefly summarized only on the packet screen,
  37.        for  lack  of  space.  :-)  Basically, they consist of the
  38.        standard cursor and keypad keys, with <Enter>  to  select.
  39.        For terminals without full support for these keys, aliases
  40.        are available for some of them:
  41.  
  42.        ESC   = Q
  43.        PgDn  = B
  44.        PgUp  = F
  45.        Right = +
  46.        Left  = -
  47.  
  48.        (Although  shown  in  capitals,  these  may   be   entered
  49.        unshifted.)
  50.  
  51.        With  "Lynx-style  navigation", activated by the "UseLynx-
  52.        Nav" option, the Left arrow key backs out from any screen,
  53.        while  the  Right  arrow  key  selects. It also makes Left
  54.        equivalent to selecting ".." in the packet list, except at
  55.        the  top  level  (where it's equivalent to Quit). The plus
  56.        and minus keys are no longer aliases for Right  and  Left,
  57.        but perform the same functions as in the traditional navi-
  58.        gation system.
  59.  
  60.        Of special note is the space bar. In  most  areas  of  the
  61.  
  62.  
  63.  
  64.                           April 28, 2000                        1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MultiMail(1)                                         MultiMail(1)
  71.  
  72.  
  73.        program,  it  functions  as  an alias for PgDn; but in the
  74.        mail-reading window, it works as a combination  PgDn/Enter
  75.        key, allowing you to page through an area with one key.
  76.  
  77.        In  the  area  list,  the  default view (selectable in the
  78.        .mmailrc) is of Subscribed areas only. By pressing L,  you
  79.        can  toggle  first  to a view of Active areas (i.e., those
  80.        with messages), and then to All areas. (Some formats, like
  81.        plain  QWK,  don't  have  any  way  to indicate subscribed
  82.        areas, so the Active and  Subscribed  views  will  be  the
  83.        same. In other cases, you may have received an abbreviated
  84.        area list, so that the Subscribed and All  views  are  the
  85.        same.)  In  all  modes,  areas with replies always appear,
  86.        flagged with an 'R' in the leftmost column.
  87.  
  88.        In the letter list, only unread messages are displayed, by
  89.        default;  but  you can toggle this by pressing L. If there
  90.        are any marked messages, L first switches to a marked-only
  91.        mode,  then to all messages, then back to unread-only. The
  92.        marked-only view is new in 0.36. Also, the default mode --
  93.        unread or all -- can now be set in the .mmailrc.
  94.  
  95.        Multiple sort modes are available in the packet and letter
  96.        lists; you can cycle through them  by  pressing  '$'.  The
  97.        default sort modes are set in the .mmailrc.
  98.  
  99.        Packet names may be specified on the command line, bypass-
  100.        ing the  packet  menu.  If  multiple  packets  are  named,
  101.        they'll  be  opened sequentially. If a directory is speci-
  102.        fied instead of a file, the packet window will  by  opened
  103.        on  that directory, and no further items will be read from
  104.        the command line. (This is new in 0.36.)
  105.  
  106.        You can abort the program immediately from any screen with
  107.        CTRL-X. You won't be prompted to confirm the exit, but you
  108.        will still  be  prompted  to  save  replies  and  pointers
  109.        (unless  autosaving is set). Note that if you've specified
  110.        multiple packets on the command line, this is the only way
  111.        to terminate the sequence prematurely.
  112.  
  113.        You  can  obtain  a  temporary  command  shell anywhere by
  114.        pressing  CTRL-Z.  In  the  DOSish  ports  (MS-DOS,  OS/2,
  115.        Win32),  it spawns a command shell, and you return to Mul-
  116.        tiMail via the "exit" command. In Unix, it relies  on  the
  117.        shell  to put MultiMail in the background; you return with
  118.        "fg". (This has always been available  in  the  Unix  ver-
  119.        sions; however, it won't work if MultiMail wasn't launched
  120.        from an interactive shell, or if the shell doesn't support
  121.        it.)
  122.  
  123. SEARCHING
  124.        A  case-insensitive  search  function  is available on all
  125.        screens. Press '/' to specify the text to look for, or '>'
  126.        or '.' to repeat the last search.
  127.  
  128.  
  129.  
  130.                           April 28, 2000                        2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. MultiMail(1)                                         MultiMail(1)
  137.  
  138.  
  139.        New  searches  (specified  with  '/')  always start at the
  140.        beginning of the list or message.  Repeat  searches  (with
  141.        '>' or '.') start with the line below the current one. You
  142.        can take advantage of this to manually adjust the starting
  143.        point for the next search.
  144.  
  145.        Searches started in the letter, area or packet lists allow
  146.        the searches to extend below the current list. "Full text"
  147.        searches  all  the  way  through the text of each message;
  148.        "Headers" searches only the message  headers  (the  letter
  149.        list), "Areas" only the area list, and "Pkt list" only the
  150.        packet list. So, a "Full text"  search  started  from  the
  151.        packet list will search every message in every packet (but
  152.        only in the current directory).
  153.  
  154.        When scanning "Full text", the automatic  setting  of  the
  155.        "Read"  marker  is disabled. However, if you find a search
  156.        string in the header of a message and then select it manu-
  157.        ally,  the  marker  will be set. But if you start scanning
  158.        from the packet list, and exit the  packet  via  a  repeat
  159.        search, the last-read markers won't be saved.
  160.  
  161.        Scans of "Headers" or "Full text" that start from the area
  162.        list or packet list will automatically expand  the  letter
  163.        lists  they  descend into.  Similarly, scans that start at
  164.        the packet list will expand the area lists.  Otherwise, if
  165.        you're  viewing  the  short  list, that's all that will be
  166.        searched.
  167.  
  168.        I hope the above makes some sense. :-) The searching func-
  169.        tions are difficult to explain, but easy to use.
  170.  
  171. OFFLINE CONFIGURATION
  172.        At  present,  offline config is limited to subscribe (add)
  173.        and unsubscribe (drop) functions.  The  Blue  Wave,  OMEN,
  174.        QWKE,  and  QWK  Add/Drop  (with DOOR.ID) methods are sup-
  175.        ported. (The QMAIL "CONFIG" method is not supported  yet.)
  176.        Offline config is not yet available in SOUP mode.
  177.  
  178.        In  the  area list, press 'U' or 'Del' to unsubscribe from
  179.        the highlighted area. To subscribe to  a  new  conference,
  180.        first  expand the list ('L'), then highlight the appropri-
  181.        ate area and press 'S' or 'Ins'. Dropped areas are  marked
  182.        with  a  minus sign ('-') in the first column; added areas
  183.        with a plus ('+'). In the  expanded  area  list,  already-
  184.        subscribed  areas are marked with an asterisk ('*'). (This
  185.        and also applies to the little area list.  With plain  QWK
  186.        packets,  the  asterisk  should  not be relied upon; other
  187.        areas may also be subscribed.) Added or dropped areas  are
  188.        highlighted  in the "Area_Reply" color. Yeah, I'll have to
  189.        change that name now. ;-)
  190.  
  191.        Pressing 'S' on an area marked with '-', or 'U' on an area
  192.        marked '+' turns the flag off again.
  193.  
  194.  
  195.  
  196.                           April 28, 2000                        3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. MultiMail(1)                                         MultiMail(1)
  203.  
  204.  
  205.        In  Blue  Wave,  OMEN  or QWKE mode, the list of added and
  206.        dropped areas is read back in when  the  reply  packet  is
  207.        reopened.  If  the reply packet has already been uploaded,
  208.        and you're reading a packet with the  altered  area  list,
  209.        this is benign. If it's an older packet, you can alter the
  210.        list before uploading, as  with  reply  messages.  In  QWK
  211.        Add/Drop  mode,  the  changed  area flags are converted to
  212.        reply messages when  the  reply  packet  is  saved.  Note:
  213.        Adding  or dropping areas sets the "unsaved replies" flag,
  214.        like entering a reply message, but does not  invoke  auto-
  215.        matic reply packet saving until you exit the packet.
  216.  
  217.        Unfortunately, the OMEN mode has not actually been tested;
  218.        but I believe it conforms to the specs. Reports welcome.
  219.  
  220. HIDDEN LINES AND ROT13
  221.        In the letter window, you can toggle  viewing  of  Fidonet
  222.        "hidden" lines (marked with a ^A in the first position) by
  223.        pressing 'x'. The lines are shown as part of the text, but
  224.        in  a different color. In Internet email and Usenet areas,
  225.        the full headers of the messages are available in the same
  226.        way  (if provided in the packet -- generally, full headers
  227.        are available in SOUP, and partial extra headers  in  Blue
  228.        Wave).
  229.  
  230.        Pressing  'd'  toggles  rot13 encoding, the crude "encryp-
  231.        tion" method used for spoiler warnings and such, primarily
  232.        on Usenet.
  233.  
  234. ANSI VIEWER
  235.        If a message contains ANSI color codes, you may be able to
  236.        view it as originally  intended  by  activating  the  ANSI
  237.        viewer.  Press  'v'  to  start it.  Press 'q' to leave the
  238.        ANSI viewer; the navigation keys are the same  as  in  the
  239.        mail-reading window.
  240.  
  241.        The  ANSI  viewer  includes  support  for animation. While
  242.        within the ANSI viewer, press 'v'  again  to  animate  the
  243.        picture. Press any key to abort the animation.
  244.  
  245.        The ANSI viewer is also used to display the new files list
  246.        and bulletins, if any are present.
  247.  
  248. CHARACTER SETS
  249.        MultiMail supports automatic translation between two char-
  250.        acter  sets:  the  IBM PC set (Code Page 437), and Latin-1
  251.        (ISO 8859-1). Messages can be in either character set; the
  252.        set  is  determined by the area attributes -- Internet and
  253.        Usenet areas default to Latin-1, while all others  default
  254.        to  IBM -- and by a CHRS or CHARSET kludge, if one is pre-
  255.        sent. OMEN packets indicate their  character  set  in  the
  256.        INFOxy.BBS file. MultiMail translates when displaying mes-
  257.        sages and creating replies.
  258.  
  259.  
  260.  
  261.  
  262.                           April 28, 2000                        4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. MultiMail(1)                                         MultiMail(1)
  269.  
  270.  
  271.        The Unix versions of MultiMail  assume  that  the  console
  272.        uses  Latin-1,  while  the DOSish versions (DOS, OS/2, and
  273.        Win32) assume the IBM PC set. You can  override  this  via
  274.        the  .mmailrc option "Charset", or on a temporary basis by
  275.        pressing 'c'.
  276.  
  277.        You can also use a different character  set  by  disabling
  278.        the  conversion  in  MultiMail,  and letting your terminal
  279.        handle it. For SOUP packets, and for  Internet  or  Usenet
  280.        areas  in other packets, everything will be passed through
  281.        unchanged if you set  MultiMail  to  "Latin-1".  For  most
  282.        other packet types, setting MultiMail to "CP437" will have
  283.        the same effect.
  284.  
  285.        Beginning with version 0.33, a new character set  variable
  286.        is  available: "outCharset". This is a string which Multi-
  287.        Mail puts into the MIME identifier lines in  SOUP  replies
  288.        if the text includes 8-bit characters.  It's also used for
  289.        the pseudo-QP headers which are generated under  the  same
  290.        conditions;  and  when  displaying such headers, MultiMail
  291.        only converts text back to  8-bit  if  the  character  set
  292.        matches. The default is "iso-8859-1".
  293.  
  294.        By  default,  if  a  header  line in a SOUP reply contains
  295.        8-bit characters, MultiMail now writes  it  out  with  RFC
  296.        2047  (pseudo-QP)  encoding. You can disable this for mail
  297.        and/or news replies via the "UseQPMailHead" and "UseQPNew-
  298.        sHead"  options,  though  I don't recommend it. The bodies
  299.        can also be encoded in quoted-printable; this is now on by
  300.        default  for  mail,  and off for news. The options "UseQP-
  301.        Mail" and "UseQPNews" toggle QP encoding. (The headers and
  302.        bodies  of  received  messages  will still be converted to
  303.        8-bit.)
  304.  
  305.        QP decoding is temporarily disabled when  you  toggle  the
  306.        display  of  hidden  lines  ('x') in the letter window, so
  307.        that you can see the raw text of the message.
  308.  
  309. REPLY SPLITTING
  310.        Replies may be split, either  automatically,  or  manually
  311.        via CTRL-B in the reply area. For automatic splitting, the
  312.        default maximum number of lines per part  is  set  in  the
  313.        .mmailrc.  The  split  occurs whenever the reply packet is
  314.        saved. This allows you to defer the split  and  still  re-
  315.        edit  the  whole  reply as one. However, with autosave on,
  316.        the split will occur immediately after  entering  a  reply
  317.        (because  the  save  does,  too).  Setting MaxLines in the
  318.        .mmailrc to 0 disables automatic splitting; manual  split-
  319.        ting  is  still allowed. Attempts to split at less than 20
  320.        lines are assumed to be mistakes and are ignored.
  321.  
  322. ENVIRONMENT
  323.        MultiMail uses the HOME or MMAIL environment  variable  to
  324.        find  its configuration file, .mmailrc; and EDITOR for the
  325.  
  326.  
  327.  
  328.                           April 28, 2000                        5
  329.  
  330.  
  331.  
  332.  
  333.  
  334. MultiMail(1)                                         MultiMail(1)
  335.  
  336.  
  337.        default editor. MMAIL takes precedence over HOME  if  it's
  338.        defined.  If  neither is defined, the startup directory is
  339.        used.
  340.  
  341.        Depending on the implementation, TMP and/or TEMP may  also
  342.        be  used to specify the directory for temporary files. The
  343.        use of EDITOR can  be  overridden  in  .mmailrc;  however,
  344.        environment variables can't be used within .mmailrc.
  345.  
  346.        You  should also make sure that your time zone is set cor-
  347.        rectly. On many systems, that means setting the  TZ  envi-
  348.        ronment  variable. A typical value for this variable is of
  349.        the form "EST5EDT" (that one's for the east coast  of  the
  350.        U.S.A.).
  351.  
  352. FILES
  353.        The   only  hardwired  file  is  the  configuration  file:
  354.        .mmailrc (mmail.rc in DOS, OS/2 or Win32).  It's  used  to
  355.        specify  the pathnames to MultiMail's other files, and the
  356.        command lines for external programs (the  editor  and  the
  357.        archivers).
  358.  
  359.        By  default,  the  other permanent files are placed in the
  360.        MultiMail home directory  ($HOME/mmail  or  $MMAIL/mmail).
  361.        For  temporary  directories  and files, MultiMail uses the
  362.        tmpnam()  function  (the  location  is  system-dependent).
  363.        Directories specified in the .mmailrc are created automat-
  364.        ically; the default values are shown here:
  365.  
  366.  
  367.        ~/mmail
  368.               To store the  tagline  file,  netmail  addressbook,
  369.               etc.
  370.  
  371.        taglines
  372.               A plain text file, one tagline per line.
  373.  
  374.        addressbook (address.bk in DOS, OS/2 or Win32)
  375.               A  list  of names and corresponding Fido netmail or
  376.               Internet  email  addresses.  Note   that   Internet
  377.               addresses are prefaced with an 'I'.
  378.  
  379.        colors Specifies the colors to use. (See README.col.)
  380.  
  381.        ~/mmail/down
  382.               To store the packets as they came from the bbs.
  383.  
  384.        ~/mmail/up
  385.               To  store  the  reply  packet(s)  which you have to
  386.               upload to the bbs.
  387.  
  388.        ~/mmail/save
  389.               The default directory for saving messages.
  390.  
  391.  
  392.  
  393.  
  394.                           April 28, 2000                        6
  395.  
  396.  
  397.  
  398.  
  399.  
  400. MultiMail(1)                                         MultiMail(1)
  401.  
  402.  
  403. CONFIG FILE
  404.        The config file (see above) is a plain text  file  with  a
  405.        series  of  values,  one  per  line, in the form "KeyWord:
  406.        Value". The case of the keywords is not signifigant. Addi-
  407.        tional,  comment  lines  may  be  present,  starting  with
  408.        replaced by the defaults when you upgrade to  a  new  ver-
  409.        sion.)  If any of the keywords are missing, default values
  410.        will be used. Here are the keywords and their functions:
  411.  
  412.  
  413.        Version
  414.               Specifies  the  version  of  MultiMail  which  last
  415.               updated the file. This is used to check whether the
  416.               file should be updated and the "new version" prompt
  417.               displayed.  Note that old values are preserved when
  418.               the file is updated; the  update  merely  adds  any
  419.               keywords that are new. This keyword is also used in
  420.               the colors file.
  421.  
  422.        UserName
  423.               Your name in plain text, e.g.,  "UserName:  William
  424.               McBrine".  This  is  used together with InetAddr to
  425.               create a default "From:" line for SOUP replies; and
  426.               by  itself in OMEN for display purposes (the actual
  427.               From name is set on upload), and for matching  per-
  428.               sonal messages.
  429.  
  430.        InetAddr
  431.               Your   Internet  email  address,  e.g.,  "InetAddr:
  432.               wmcbrine@clark.net".  This  is  combined  with  the
  433.               UserName   in   the   form   "UserName  <InetAddr>"
  434.               ("William McBrine <wmcbrine@clark.net>") to  create
  435.               a  default "From:" line for SOUP replies. Note that
  436.               if neither value is specified, and nothing is typed
  437.               manually  into the From: field when creating a mes-
  438.               sage, no From: line will be generated --  which  is
  439.               perfectly  acceptable  to  at  least some SOUP pro-
  440.               grams, like UQWK.
  441.  
  442.        QuoteHead, InetQuote
  443.               These strings are placed at the  beginning  of  the
  444.               quoted  text  when  replying  in  normal  or Inter-
  445.               net/Usenet areas, respectively. (The distinction is
  446.               made  because the quoting conventions for BBSes and
  447.               the Internet are different.)   Replaceable  parame-
  448.               ters  are  indicated  with a '%' character, as fol-
  449.               lows:
  450.  
  451.               %f = "From" in original message
  452.               %t = To
  453.               %d = Date (of original message)
  454.               %s = Subject
  455.               %a = Area
  456.               %n = newline (for multi-line headers)
  457.  
  458.  
  459.  
  460.                           April 28, 2000                        7
  461.  
  462.  
  463.  
  464.  
  465.  
  466. MultiMail(1)                                         MultiMail(1)
  467.  
  468.  
  469.               %% = insert an actual percent character
  470.  
  471.               Note that you can't put white space at the start of
  472.               one  of these strings (it will be eaten by the con-
  473.               fig parser), but you can get around that by putting
  474.               a newline first.
  475.  
  476.        homeDir
  477.               User's home directory.
  478.  
  479.        mmHomeDir
  480.               MultiMail's home directory.
  481.  
  482.        signature
  483.               Path  to optional signature file, which should be a
  484.               simple text file. If specified, it will be appended
  485.               to  every  message  you  write. You should give the
  486.               full path, not just the name.
  487.  
  488.        editor The editor MultiMail uses for replies,  along  with
  489.               any  command-line  options. This may also be a good
  490.               place to insert spell-checkers, etc., by specifying
  491.               a  batch  file here. Note that the default value is
  492.               just the editor that's (almost)  guaranteed  to  be
  493.               available,  for a given OS (although the Unix "EDI-
  494.               TOR" environment variable is checked first), and is
  495.               in  no  way  a preferred editor; you can and should
  496.               change it.
  497.  
  498.        PacketDir
  499.               Default packet directory.
  500.  
  501.        ReplyDir
  502.               Default reply packet directory.
  503.  
  504.        SaveDir
  505.               Default directory for saved messages.
  506.  
  507.        AddressBook
  508.               Path and filename of the address book.  (You  might
  509.               change  this to share it with another installation,
  510.               but basically this keyword isn't too useful.)
  511.  
  512.        TaglineFile
  513.               Path and filename of the tagline file.  This  could
  514.               be  altered  from a batch file to swap between dif-
  515.               ferent sets of taglines. (But note that this  value
  516.               is  only  read  at  startup.)  You could also share
  517.               taglines with another program, but be careful  with
  518.               that;  MultiMail  truncates the lines at 76 charac-
  519.               ters.
  520.  
  521.        ColorFile
  522.               Path  and  filename  of  the   colors   file.   See
  523.  
  524.  
  525.  
  526.                           April 28, 2000                        8
  527.  
  528.  
  529.  
  530.  
  531.  
  532. MultiMail(1)                                         MultiMail(1)
  533.  
  534.  
  535.               README.col.
  536.  
  537.        *UncompressCommand, *CompressCommand
  538.               Command  lines  (program name, options, and option-
  539.               ally the path) for the archivers  to  compress  and
  540.               uncompress packets and reply packets. ZIP, ARJ, RAR
  541.               and LHA are recognized. The "unknown" values are  a
  542.               catch-all, attempted for anything that's not recog-
  543.               nized as one of the other four types; if  you  have
  544.               to deal with ARC or ZOO files, you might define the
  545.               archiver for them here.
  546.  
  547.        PacketSort
  548.               The packet list can be  sorted  either  in  inverse
  549.               order  of  packet  date and time (the newest at the
  550.               top), or in alphabetical order by filename.  "Time"
  551.               specifies the former, and "Name" the latter. (Actu-
  552.               ally only the first letter is checked, and case  is
  553.               not signifigant. This applies to the other keywords
  554.               of this type (the kind that have  a  fixed  set  of
  555.               values  to  choose  from)  as  well.) The sort type
  556.               specified here is only the default, and can be tog-
  557.               gled from the packet window by pressing '$'.
  558.  
  559.        AreaMode
  560.               The  default  mode  for the area list: "All", "Sub-
  561.               scribed", or "Active". This is the mode  that  will
  562.               be  used  on  first opening a packet, but it can be
  563.               changed by pressing L while in  the  area  list  or
  564.               little  area  list. For a description of the modes,
  565.               see USAGE.
  566.  
  567.        LetterSort
  568.               The sort used by default in the letter list. Can be
  569.               "Subject"  (subjects  sorted alphabetically, with a
  570.               case-insensitive compare), "Number" (sorted by mes-
  571.               sage number), "From" or "To". (This can be overrid-
  572.               den, as in the packet list.)
  573.  
  574.        LetterMode
  575.               The default mode for  the  letter  list:  "All"  or
  576.               "Unread". This is the mode used on first opening an
  577.               area; it can be toggled by pressing L. (The  Marked
  578.               view is also available in the letter list, but can-
  579.               not be set as the default here.)
  580.  
  581.        Charset
  582.               The character set that the console  is  assumed  to
  583.               use.  Either "CP437" (code page 437, the U.S. stan-
  584.               dard for the IBM PC and clones) or  "Latin-1"  (aka
  585.               ISO-8859-1,  the  standard for most other systems).
  586.               Note that the character set of messages  is  deter-
  587.               mined separately (q.v.).
  588.  
  589.  
  590.  
  591.  
  592.                           April 28, 2000                        9
  593.  
  594.  
  595.  
  596.  
  597.  
  598. MultiMail(1)                                         MultiMail(1)
  599.  
  600.  
  601.        UseTaglines
  602.               Yes/No.  If no, the tagline window is not displayed
  603.               at all when composing a message.
  604.  
  605.        AutoSaveReplies
  606.               Yes/No. If yes, the reply packet is saved automati-
  607.               cally -- the equivalent of pressing F2, but without
  608.               a confirmation prompt -- whenver  the  contents  of
  609.               the reply area are changed. This can be convenient,
  610.               and even a safety feature if your power  supply  is
  611.               irregular, but it provides less opportunity to take
  612.               back a change (like deleting  a  message).  If  no,
  613.               you're  prompted  whether  to  save  the changes on
  614.               exiting the packet. Note that if you say no to that
  615.               prompt,  nothing that you wrote during that session
  616.               will be saved (unless you saved  it  manually  with
  617.               F2).
  618.  
  619.        AutoSaveRead
  620.               Yes/No. If yes, the read/marked/etc. indicators are
  621.               saved automatically when exiting a packet.  If  no,
  622.               you'll be prompted whether to save them; if you say
  623.               no, the indicators will remain as they were  before
  624.               you opened the packet.
  625.  
  626.        StripSoftCR
  627.               Yes/No. Some messages on Fido-type networks contain
  628.               spurious instances of character 141, which  appears
  629.               as  an  accented  'i'  in  code page 437. These are
  630.               really so-called "soft returns", where the  message
  631.               was wrapped when composing it, but not indicating a
  632.               paragraph break. Unfortunately, the  character  can
  633.               also  appear  legitimately as that accented 'i', so
  634.               this option defaults to no. It can be toggled  tem-
  635.               porarily  via the 'I' key in the letter window, and
  636.               it doesn't apply to messages in the Latin-1 charac-
  637.               ter  set.  This  is  now  applied only in Blue Wave
  638.               mode.
  639.  
  640.        BeepOnPers
  641.               Yes/No. If yes, MultiMail beeps  when  you  open  a
  642.               message addressed to or from yourself in the letter
  643.               window. (These are  the  same  messages  which  are
  644.               highlighted in the letter list.)
  645.  
  646.        UseLynxNav
  647.               Yes/No. See the description under USAGE.
  648.  
  649.        UseScrollBars
  650.               Yes/No.  In  list windows, when the number of items
  651.               in the list exceeds the number of lines in the win-
  652.               dow,  MultiMail  puts  a  "scroll bar" on the right
  653.               border of the window, showing the  highlight  bar's
  654.               position   relative   to  the  entire  list.  Older
  655.  
  656.  
  657.  
  658.                           April 28, 2000                       10
  659.  
  660.  
  661.  
  662.  
  663.  
  664. MultiMail(1)                                         MultiMail(1)
  665.  
  666.  
  667.               versions of MultiMail (pre-0.29)  didn't  do  this,
  668.               and  I  figure  some people may not like it, so you
  669.               can disable it here.
  670.  
  671.        BuildPersArea
  672.               Yes/No. By default, MultiMail now  builds  a  "per-
  673.               sonal"  area  automatically, consisting of messages
  674.               addressed to you, for every  packet  format  except
  675.               SOUP.  But  there's  some  overhead associated with
  676.               this, so if you have a very slow computer -- or  if
  677.               you  just  don't  want  to see this area -- you can
  678.               disable it here.  Note  that  this  option  doesn't
  679.               apply  to  QWK  packets  with  .NDX  files in them;
  680.               there, the  area  only  appears  if  "personal.ndx"
  681.               exists in the packet.
  682.  
  683.        MakeOldFlags
  684.               Yes/No.  With  Blue Wave packets, this makes Multi-
  685.               Mail store its last-read flags in the  ".xti"  file
  686.               format  rather  than  in  its  native  ".red". This
  687.               allows interoperation with some other  readers  and
  688.               utilities,  but  it  takes  slightly longer to read
  689.               back in. Also note that  the  old-style  flags  can
  690.               take  precedence  over  a  .RED  file  in  the same
  691.               packet, if the packet is future-dated (as, e.g., if
  692.               you're  in  the  U.S., and DL'ing from a BBS in the
  693.               U.K.), resulting in lost markers. You can fix  this
  694.               by  extracting  the packet and setting the files to
  695.               the current time. But if you always  use  "MakeOld-
  696.               Flags: Yes", this won't be a problem.
  697.  
  698.        ReOnReplies
  699.               Yes/No. By popular demand. :-) Setting this to "No"
  700.               will disable the automatic prefixing of "Re:  "  to
  701.               the  Subject  when  replying  --  except  in  areas
  702.               flagged as Internet email or Usenet, where this  is
  703.               the standard, and is still upheld.
  704.  
  705.        QuoteWrapCols
  706.               Numeric.  The  right  margin for quoted material in
  707.               replies (including the quote indicator).
  708.  
  709.        MaxLines
  710.               Numeric. See the description under REPLY SPLITTING.
  711.  
  712.        outCharset
  713.               String. See the description under CHARACTER SETS.
  714.  
  715.        UseQPMailHead
  716.               Yes/No.  Controls  the  use of RFC 2047 encoding in
  717.               outgoing mail headers.
  718.  
  719.        UseQPNewsHead
  720.               Yes/No. Controls the use of RFC  2047  encoding  in
  721.  
  722.  
  723.  
  724.                           April 28, 2000                       11
  725.  
  726.  
  727.  
  728.  
  729.  
  730. MultiMail(1)                                         MultiMail(1)
  731.  
  732.  
  733.               outgoing news headers.
  734.  
  735.        UseQPMail
  736.               Yes/No. Controls the use of quoted-printable encod-
  737.               ing in outgoing mail.
  738.  
  739.        UseQPNews
  740.               Yes/No. Controls the use of quoted-printable encod-
  741.               ing in outgoing news.
  742.  
  743. UPGRADING
  744.        When  you  run  a new version of MultiMail (0.19 or later)
  745.        for the first time, it automatically updates your .mmailrc
  746.        and  ColorFile  with  any new keywords. (Old keywords, and
  747.        the values you've set for them,  are  preserved.  However,
  748.        comments are lost.) Some notes on specific upgrades:
  749.  
  750.        Version  0.36  adds  the .mmailrc options "LetterMode" and
  751.        "AreaMode".
  752.  
  753.        Version 0.33 adds the options "ReOnReplies", "outCharset",
  754.        "UseQPMailHead",  "UseQPNewsHead", "UseQPMail" and "UseQP-
  755.        News", and changes some default values.
  756.  
  757.        Version 0.32 adds "BuildPersArea" and "MakeOldFlags".
  758.  
  759.        Version 0.30  adds  "UserName",  "InetAddr",  "QuoteHead",
  760.        "InetQuote", and "QuoteWrapCols".
  761.  
  762.        Version 0.29 adds "UseScrollBars" and "UseLynxNav".
  763.  
  764.        Version  0.28 adds "MaxLines", "StripSoftCR", and "BeepOn-
  765.        Pers".
  766.  
  767.        Version 0.26 adds "AutoSaveReplies",  "AutoSaveRead",  and
  768.        "UseTaglines".
  769.  
  770.        Version  0.25  adds  "Charset", "PacketSort", and "Letter-
  771.        Sort". The default packet sort is now by time  instead  of
  772.        name.
  773.  
  774.        If  you're  upgrading  from 0.19 to 0.20 or later, and you
  775.        have a customized ColorFile,  be  sure  to  note  the  new
  776.        options.
  777.  
  778.        The   ColorFile   is   new   in   0.19.   Check   it   out
  779.        (~/mmail/colors, by default).
  780.  
  781.        As of 0.16, the HOME environment variable can be  overrid-
  782.        den with MMAIL, or omitted altogether.
  783.  
  784.        If  you're  upgrading  from  a version before 0.9, and you
  785.        have existing reply packets (.rep or .new) whose names are
  786.        partly  or  wholly  in  uppercase, you must rename them to
  787.  
  788.  
  789.  
  790.                           April 28, 2000                       12
  791.  
  792.  
  793.  
  794.  
  795.  
  796. MultiMail(1)                                         MultiMail(1)
  797.  
  798.  
  799.        lowercase before version  0.9  or  higher  will  recognize
  800.        them. (Downloaded packets are not at issue.)
  801.  
  802.        If you're upgrading from a version below 0.8, you may want
  803.        to manually delete the /tmp/$LOGNAME directory created  by
  804.        previous  versions.  (0.8  and  higher clean out their own
  805.        temp directories, and use different names  for  each  ses-
  806.        sion.)
  807.  
  808.        If  you're  upgrading  from a version prior to 0.7, please
  809.        note the changes in the  default  directories;  previously
  810.        they were "~/mmail/bwdown", etc.
  811.  
  812. NOTES
  813.        SOUP  reply  packets  are  created  with  the  name "base-
  814.        name.rep", where basename is  the  part  of  the  original
  815.        packet  name  before the first period.  (Unlike other for-
  816.        mats, there's no actual standard for  this  in  SOUP,  but
  817.        this seems to be the most common form among the SOUP read-
  818.        ers I surveyed.)  Also, not that I expect  anyone  to  try
  819.        this,  but  currently MultiMail is only able to read reply
  820.        packets generated by other SOUP readers if the replies are
  821.        in  'b'  or  'B'  mode,  and  are one to a file within the
  822.        packet.  Most readers meet the first criterion,  but  some
  823.        of them batch all mail and news replies into a single file
  824.        for each type. A future version of MultiMail will be  able
  825.        to read these, too.
  826.  
  827.        When re-editing a reply, it gets pushed to end of the list
  828.        of replies.
  829.  
  830.        The R)ename function in the packet window can also be used
  831.        to  move  files between directories; however, the destina-
  832.        tion filename must still be specified along with the path.
  833.  
  834.        If  you're  using the XCurses (PDCurses) version, and your
  835.        editor isn't an X app, it will work better if you set Mul-
  836.        tiMail's  "editor" keyword to "xterm -e filename" (instead
  837.        of just "filename"). I decided not to  do  this  automati-
  838.        cally because someone might actually use it with an X edi-
  839.        tor.
  840.  
  841.        Editing and deletion of old replies are available  through
  842.        the  REPLY  area,  which  always appears at the top of the
  843.        area list. This differs from  Blue  Wave  and  some  other
  844.        readers.
  845.  
  846.        The  Escape  key  works to back out from most screens, but
  847.        after you press it, you'll have to wait a bit for it to be
  848.        sensed (with ncurses; not true with PDCurses).
  849.  
  850.        Only  Blue  Wave style taglines (beginning with "...") are
  851.        recognized by the tagline stealer.  The  tagline  must  be
  852.        visible on the screen to be taken.
  853.  
  854.  
  855.  
  856.                           April 28, 2000                       13
  857.  
  858.  
  859.  
  860.  
  861.  
  862. MultiMail(1)                                         MultiMail(1)
  863.  
  864.  
  865.        Netmail  only  works  in  Blue Wave and OMEN modes, and is
  866.        still slightly limited. Netmail from points  now  includes
  867.        the  point  address.  Internet  email is available in Blue
  868.        Wave mode, for those doors that support it,  and  in  SOUP
  869.        mode, using the same interface as Fido netmail.
  870.  
  871. AUTHORS
  872.        MultiMail  was originally developed under Linux by Koloss-
  873.        vary Tamas and Toth Istvan. John Zero was  the  maintainer
  874.        for versions 0.2 through 0.6; since version 0.7, the main-
  875.        tainer is William McBrine <wmcbrine@clark.net>.
  876.  
  877.        Additional code has been  contribued  by  Peter  Karlsson,
  878.        Mark D. Rejhon, Ingo Brueckl, and Robert Vukovic.
  879.  
  880. BUGS AND KNOWN PROBLEMS
  881.        If your editor produces automatic backup files, you should
  882.        disable this feature, if possible, or wrap it with a batch
  883.        file  to  delete  them when done. MultiMail will erase the
  884.        temporary files it creates itself, but it doesn't know  to
  885.        erase the backup files from an editor.
  886.  
  887.        The  RSX/NT  version  is  reported to be incompatible with
  888.        4DOS: shelling to external programs (archivers or editors)
  889.        fails.  Thanks  to  Tony  Summerfelt for figuring this one
  890.        out. You can set the MultiMail session to use  COMMAND.COM
  891.        while retaining 4DOS elsewhere.
  892.  
  893.        On some platforms, specifying a packet on the command line
  894.        fails if the filename  is  exactly  10  characters.  (Both
  895.        shorter  and longer names are OK.)  This appears to be due
  896.        to strange bugs in the standard  library,  and  I  haven't
  897.        found  a  satisfactory  solution. I noticed it now because
  898.        all OMEN packets fit this description. :-( Packets  chosen
  899.        from the packet menu are unaffected.
  900.  
  901.        Red  Hat  Linux 6.0 (and possibly 6.x) comes with a defec-
  902.        tive installation of ncurses. When linked to this,  Multi-
  903.        Mail  mostly works, but odd effects appear when scrolling.
  904.        (Users describe it as double-spaced.) The problem  can  be
  905.        fixed  by  reinstalling ncurses from the source -- not the
  906.        source RPM that comes  with  Red  Hat,  but  the  original
  907.        source from the ncurses site (see INSTALL).
  908.  
  909.        SOUP  area type 'M' is not recognized yet. First I have to
  910.        find a program that can generate one. :-)
  911.  
  912.        The ANSI viewer eats a lot less memory than  it  used  to,
  913.        though   it   can   still  be  a  problem.  (Each  charac-
  914.        ter/attribute pair takes up  four  bytes  in  memory.  But
  915.        lines  which have the same attribute throughout are stored
  916.        as plain text.)
  917.  
  918.        The new file list and bulletin viewer is, as yet, a  hack.
  919.  
  920.  
  921.  
  922.                           April 28, 2000                       14
  923.  
  924.  
  925.  
  926.  
  927.  
  928. MultiMail(1)                                         MultiMail(1)
  929.  
  930.  
  931.        A  better  means  of  selecting which ones to view will be
  932.        forthcoming, if I can ever decide just how it should look.
  933.        (Your opinion is welcome.)
  934.  
  935.        If  you  find  any  bugs,  or  have ideas for improvement,
  936.        please write to me.
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.                           April 28, 2000                       15
  989.  
  990.  
  991.