home *** CD-ROM | disk | FTP | other *** search
/ ftp.freefriends.org / ftp.freefriends.org.tar / ftp.freefriends.org / arnold / Source / mush.rstevens.tar.gz / mush.tar / README-7.1 < prev    next >
Text File  |  1990-05-03  |  11KB  |  208 lines
  1. This is release 7.1.0 of the SunView implementation of mush.
  2.  
  3. Version 7.1.0 differs from 7.0.4 mostly in the appearance of the screen
  4. and the additional functionality that is allowed to show through to the
  5. tool from the underlying interpreter.  This is a significant enough change
  6. in "look and feel" that the revision number was increased from 0 to 1.
  7.  
  8. Thanks to Bill Randle <billr@saab.cna.tek.com> for extensive SunOS 3.5
  9. testing, and to Bill and also Don Lewis <del@mlb.semi.harris.com> for
  10. their contributions to the new toolmode composition features and function
  11. key handling.
  12.  
  13. Tool mode changes include:
  14.     * Compilation now keys on definitions of SUN_4_1, SUN_4_0 or SUN_3_5
  15.       in makefile.sun, rather than assuming SunOS4.0 when SIGRET=void.
  16.       You still have to define SUNTOOL to get the tool mode capability.
  17.       If you define SUNTOOL but not the others, SUN_4_0 is assumed.
  18.     * The header summary display window has a scrollbar; the <Prev> and
  19.       <Next> buttons for scrolling are gone.
  20.     * The placement of buttons and items has changed a lot.  Buttons and
  21.       items dealing with folders and general setup have moved to the top
  22.       of the frame, and items dealing with individual messages and with
  23.       composition have been placed in a single row between the headers
  24.       and messsage display subwindows.
  25.     * The <Folders> and <Save> buttons each have a text entry item.
  26.       Furthermore, file completion with the ESC key works in those items.
  27.     * The <Sort> menu has been unscrambled, so you actually get the sort
  28.       criteria that you select.  (Don't ask.)
  29.     * The <Aliases> and <Headers> buttons have moved into a menu under
  30.       the <Options> button.  This clears up some confusion about exactly
  31.       what it was that <Headers> meant, and provides a hook for future
  32.       addition of a window for defining your own outgoing message headers.
  33.     * The <Display> button is gone; its operations are now handled by
  34.       opening the <Options> frame and toggling show_deleted or no_reverse.
  35.     * The small one-line print window is gone; messages previously shown
  36.       there now go to the scrollable status window.  There may be some
  37.       remaining bugs with missing newlines here.  This frees up some more
  38.       file descriptors in SunOS 3.5, to keep other things working longer.
  39.     * Function keys are recognized in most parts of the main frame.  In
  40.       anticipation of the day when window manager function keys can be
  41.       redefined, the messages about "L7 not defined" etc. are still shown
  42.       unless suppressed through $quiet (see below).
  43.     * The composition frame has more control buttons, providing more of
  44.       the functions of line and curses mode message composition.  Some
  45.       of the "chattiness" of message composition has gone away.  In fact,
  46.       the whole chatty subwindow in the compose frame has gone away,
  47.       possibly to return in a later patch when a better way to decide
  48.       what frame a message should go to has been worked out.  In the
  49.       meantime, all messages go to the main frame.
  50.     * Tilde escapes are supported in the tool mode composition textsw,
  51.       with a few minor exceptions accessible from the control buttons.
  52.     * Typing a <return> while entering header field text in tool mode
  53.       will move automatically to the next header when this is sensible.
  54.       The cursor becomes a bent arrow to indicate that this will happen.
  55.     * User-definable icons can be installed through the $mail_icon and
  56.       $newmail_icon variables, and $quiet has a field to suppress the
  57.       message-number label so your pretty pictures won't be trashed.
  58.     * Files that are not readable as folders are left out of the menus
  59.       for the <Folder> and <Save> items.
  60.  
  61. General changes include:
  62.  
  63.     * There is a new defined constant, DIRECTORY, which indicates whether
  64.       your system has BSD-compatible directory-access routines.  It turns
  65.       out to be much too hard to figure this out on an OS-by-OS basis.  
  66.       DIRECTORY is automatically defined when BSD is defined, and is in
  67.       the default CFLAGS in makefile.hpux; you others are on your own.
  68.     * Some compilers were confused by "/*" appearing in the META string
  69.       defined in glob.h.  The characters in META have been rearranged.
  70.     * Using "exit" in a nested "if" in a source/init file no longer
  71.       causes error messages about "missing endif".
  72.     * Redefining "folder" via a "cmd" in .mushrc no longer causes the
  73.       initial folder load to bomb.  Similarly with "sort".
  74.     * Date parsing and sorting now understand timezones.  There may
  75.       still be some rough edges in date parsing on some of the less
  76.       common date formats, but RFC-822 and ctime (From_ line) dates
  77.       are handled correctly.  If the dates mush displays are really
  78.       off the wall, the order of the sscanf's in parse_date() may need
  79.       to be changed, or we may need to add some cases rather than
  80.       using partial matches to skip missing timezone fields.  There
  81.       are also some strange nonstandard abbreviations out there (what,
  82.       for example, is ECT?) which will all be treated as GMT unless
  83.       you hack them into the tables in dates.c.  Missing timezones are
  84.       treated as the local zone to get the date-received right (the
  85.       From_ line ctime-date almost never has a timezone).
  86.     * Mush now warns you if a file you attempt to load does not "look
  87.       like" a folder (i.e. no messages can be read).  If you are already
  88.       in the shell, this leaves you in an empty folder as it did before.
  89.       If you are just starting up (e.g. with "mush -f"), mush will exit.
  90.     * Additional checking is now done when collecting new mail and when
  91.       updating folders to detect corruptions, warn the user, and allow
  92.       a chance to recover.  Mush still reinitializes the spool folder if
  93.       it shrinks, but if this is detected at update time (as opposed to
  94.       new-mail-check time), the user is allowed to abort the update and
  95.       salvage the current folder contents.
  96.     * Curses mode now respects the user's presetting of $crt, unless the
  97.       user's value is larger than the actual screen size.  This allows
  98.       "set crt=2" to be used to force use of $pager.
  99.  
  100. Changes in commands:
  101.  
  102. mush -h -
  103.     The -h (-draft) option will now accept "-" as a filename indicating
  104.     standard input.  Note that this causes the input message to be sent
  105.     immediately; interactive use cannot be combined with redirected input.
  106.     The internal "mail -h" command will NOT interpret "-" as standard in.
  107.  
  108. alts *user
  109.     This syntax, analogous to the $autosign2 syntax, allows you to specify
  110.     any user name anywhere as "you" for purposes of $metoo, etc.
  111.  
  112. folder -n
  113.     This command changes folders without updating; it replaces the old
  114.     "folder !" notation, though the old form is still supported.  See
  115.     also the general notes above for behavior on attempts to load files
  116.     that are not folders.
  117.  
  118. from pattern
  119.     Given an argument that is not parseable as a message list, "from" will
  120.     automatically invoke "pick -f pattern".  Mixing message lists and
  121.     patterns is slightly counter-intuitive; if the message list precedes
  122.     the pattern, it will restrict the pattern search to that list, e.g.
  123.     "from 3-7 johnsmith" will show those messages in the range 3-7 that
  124.     are from johnsmith.  If the message list follows the pattern, it will
  125.     not be detected at all, but will be considered part of the pattern.
  126.     Also, "from jim bob sally" will treat the entire "jim bob sally" list
  127.     as a single pattern, as "pick" would; this may change in the future.
  128.  
  129. pipe -p /pat1/,/pat2/
  130.     The pattern supplied may now have the form /pat1/,/pat2/ to indicate
  131.     that extraction should begin at pat1 and end at pat2, inclusive.
  132.     Patterns are still matched literally at beginning-of-line (no regex
  133.     matching), and there is not currently any way to imbed a slash in
  134.     patterns of this form.  To allow searching for file paths, slashes
  135.     are significant only if the second slash is followed by a comma.
  136.  
  137. save/copy
  138.     Unless told to clobber the file (-f), these commands now check that
  139.     the file to which they are appending "looks like" a folder.  If the
  140.     file seems to be something else, the user is prompted to confirm the
  141.     save or copy.
  142.  
  143. set
  144.     Several minor fixes.  Piping to "set" now clears the variable if the
  145.     input message list is empty, rather than leaving the old value.  For
  146.     backwards compatibility, however, an unset variable does not become
  147.     set when an empty message list is piped to it.  Also, some of the
  148.     more esoteric abuses of the variable=value syntax have either been
  149.     made legal (`set var=' is the same as `set var') or made illegal
  150.     (`set var=value = value' won't create a variable named "var=value").
  151.  
  152. sort
  153.     Sorting by multiple criteria at once is now supported.  The flags to
  154.     sort have changed; "-" to reverse sorting is now obsolete, replaced
  155.     by "-r", and all the sort criteria should now be prefixed with a "-"
  156.     (-a,-d,-l,-R,-s,-S) like options to any other command.  A significant
  157.     subset of the old syntax is still recognized as a special case.
  158.  
  159. New/changed variables:
  160.  
  161.     $cmd_help
  162.     (Also $tool_help)  The path given for this variable may contain
  163.     the usual filename metacharacters (~+).
  164.  
  165.     $hangup
  166.     When set, mush updates the folder on SIGHUP instead of saving
  167.     the tempfile.  This is a bit dangerous -- in rare circumstances
  168.     (mainly when two or more MUAs are modifying the same folder)
  169.     some new mail could be lost.  Old mail should never be lost.
  170.  
  171.     $hdr_format
  172.     The format spec %Z returns the time zone part of the date.
  173.  
  174.     $mail_icon
  175.     Names an icon file to be used in the normal case, when no new
  176.     mail is present.  This icon will replace the mailbox with the
  177.     flag down.
  178.  
  179.     $newmail_icon
  180.     Names an icon file to be used when new mail is present, replacing
  181.     the mailbox with the flag up.
  182.  
  183.     $output
  184.     The message-list output of the last successful command is stored
  185.     in this variable.  This allows easy recovery from broken pipes
  186.     etc.  Note that any successful command that does not produce a
  187.     message list will clear $output (e.g. "echo").
  188.  
  189.     $quiet
  190.     If the field "newmail" is present in the multi-value, the usual
  191.     "New mail (#X): ..." messages are not displayed.  The new mail
  192.     is still automatically incorporated into the mailbox.  In tool
  193.     mode, this shuts off the new mail bell (the "tool" field still
  194.     silences ALL tool mode bells).
  195.  
  196.     If the field "fkey" is present in tool mode, warning messages
  197.     about unbound keys are not printed.
  198.  
  199.     If the field "iconlabel" is present in tool mode, the current
  200.     number of messages is not displayed in the mush icon.
  201.     
  202.     $status
  203.     This is set to the success (0) or failure (-1) status of the
  204.     previously executed command.  Note that some curses-mode commands
  205.     return a failure status to indicate that the display has been
  206.     corrupted even if the command itself succeeded, so this variable
  207.     is mostly useful in scripts.
  208.