home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / unix / volume18 / mush6.4 / part01 / README-6.3 < prev    next >
Text File  |  1989-03-12  |  10KB  |  223 lines
  1. The file, "README" is always being updated for brand new users on how
  2. to install mush for the first time.  It can be referenced for earlier
  3. info as well as previous README's.  A new README-<versionID> file (like
  4. this one) will accompany each new upgrade.
  5.  
  6. For those who wish to be on the mush-users mailing list, please
  7. send requests to:
  8.     mush-users-request@garp.mit.edu
  9. I do not maintain this list, so don't mail me.
  10. This mailing list discusses mush usage, internals, portability to new
  11. hardware or non-standard unix systems, future updates/enhancements,
  12. and exchange of general info.  Since mush works on all flavors of
  13. unix from bsd to sys-v and has three different user interfaces, the
  14. group of subscribers is quite diverse.  For those who are very
  15. interested in influencing the X interface, now is the time to get
  16. your opinions in for discussion before it's too late.
  17.  
  18. New compiler defines:
  19.     DOT_LOCK
  20.     Define this if you want mush to use .lock to lock your mbox for
  21.     updates.  See very last section of this file for detailed info.
  22.  
  23.     UUCP
  24.     This should be defined if your MTA does not automatically create a
  25.     From: header *and* your machine talks to other computers via uucp
  26.     (probably true for default xenix/sys-v systems).
  27.  
  28.     NO_COMMAS
  29.     This should be defined if your mailer does *NOT* like commas
  30.     between addresses on its command line.  Last I heard, smail is
  31.     like this as well as default xenix/sys-v mail transport agents.
  32.     (This used to be defined by OLD_MAILER.)
  33.  
  34.     Note: if your MTA is "smail", OLD_MAILER should _not_ be set, but
  35.     NO_COMMAS should be set.  That is as of this release date.
  36.  
  37.     SIGRET
  38.     This is defined to be "int" by default.  If your signal() returns
  39.     void, SIGRET should be defined to be "void".  This mostly applies
  40.     to SVR3.
  41.  
  42.     For any of these defines, you do one of two things:
  43.     (UUCP used as example)
  44.     1) add -DUUCP in your makefile
  45.     2) In config.h, add a line which reads:
  46.        #define UUCP
  47.  
  48.     For SIGRET, use either "-DSIGRET=void" or "#define SIGRET void"
  49.  
  50. New variables:
  51.     realname (string)
  52.     Set to the user's real name by:
  53.     1) The user's real name is gotten from the environment variable NAME.
  54.     2) The gecos field in the password file
  55.     Once mush has been started, this name can only be reset by changing
  56.     the value of realname -- not by changing 1 or 2 above.
  57.  
  58.     hostname (string)
  59.     The hostname is automatically set by the system, but if circumstances
  60.     make this impossible or the hostname is wrong, the user can reset this.
  61.     See the manual under the VARIABLES section for more info.
  62.     Important Note to sys-v'ers who can't get their hostname from utsname(2)
  63.     (xenix, more?), the hostname should probably be set in the default Mailrc
  64.     defined in config.h.   "set hostname=whatever"
  65.  
  66.     save_empty (boolean)
  67.     If set, folders which have all messages deleted are not removed on
  68.     updates or change folder commands.  The folder is left at zero length.
  69.     Note, this does not affect the spool mailbox; it is never removed on
  70.     updates.
  71.  
  72.     date_received (boolean)
  73.     If set, message headers are printed with the date received rather than
  74.     the date sent.  This affects the sorting command; when sorting by date,
  75.     this variable is checked.
  76.  
  77. Misc:
  78.     Addresses that have long uucp paths from the sender would be so long
  79.     that the "important" part of the path --which includes the sender's
  80.     login and machine name, found at the tail end of the address, would
  81.     be cut off.  Such addresses are now shifted to the right if the whole
  82.     address cannot fit in the specified padding requested by the user.
  83.     This affects the hdr_format modifiers %a and %f.  If the addresses
  84.     are shorter than the specified width, there is no change:
  85.     set hdr_format = "%11a"  # show no more than 11 chars of address
  86.     If the address is:
  87.     sun!island!argv
  88.     then the result will be:
  89.     island!argv
  90.     (previously, you'd get "sun!island!" losing the "argv" at the end.)
  91.  
  92.     Initialization file now understands:
  93.     if -e filename
  94.     and
  95.     if -z filename
  96.     to test to see if a filename (folder) exists (-e) or zero-length (-z).
  97.  
  98.     Added SAVED flag to message status.  If a message is saved,
  99.     this flag is set rather than the DELETE flag.  Messages which
  100.     have been saved are marked with an 'S' in the status field.
  101.     All commands which deal with message status have been modified
  102.     to support this new flag (sort, headers (-H:s), etc...)
  103.  
  104.     $cdpath can now be read from the environment.  that is, it understands
  105.     the ':' as a path separator now.
  106.  
  107.     ":p" can be used to select "preserved" messages.  This adds to the
  108.     list of :c commands which select messages of status "c". headers -?
  109.     for more info.
  110.  
  111. main.c --
  112.     fixed up helpfile assignments for toolmode and removed useless
  113.     warning messages.
  114.  
  115.     ignore sigpipe in main() instead of in do_loop().  This fixes the
  116.     bug where you mail someone without entering the shell and ~p to
  117.     page your message.
  118.  
  119. mail.c --
  120.     Some mailers don't add the From: header.  Previous versions of
  121.     mush would add for these machines:
  122.     From: login
  123.     Now, the user's real name is added in parens.  Also, if UUCP is
  124.     defined, the From: line will look like:
  125.     From: host!user (Real Name)
  126.     If uucp is not defined:
  127.     From: user@host (Real Name)
  128.     This is mostly for uucp systems, so when the user mails to remote
  129.     sites, the From: line should be correct for accurate replies.
  130.  
  131.     If fork() failed in toolmode, the error message is no longer
  132.     overwritten before the user knew the mail couldn't not be sent.
  133.  
  134.     ~? now uses the internal pager so the help doesn't scroll off the screen.
  135.  
  136.     The command: "r addr" to reply to a message and add a new address
  137.     at the same time no longer removes the last character in the first address
  138.     before adding the new address.
  139.  
  140.     If autosign has \n's or \t's embedded in the string, they are now
  141.     expanded to newlines and tabs respectively.  This is also true for
  142.     using ~$variable to print a variable's value into a letter buffer.
  143.     For example, the command:
  144.     set autosign = "\Dan Heller\nisland!argv@sun.com"
  145.     will cause all outgoing letters to be signed with:
  146.  
  147.     -- 
  148.     Dan Heller
  149.     island!argv@sun.com
  150.  
  151. curses.c --
  152.     fixed scrn_line() (screen-line: get a line from the screen) so
  153.     that the following expression is evaluated correctly:
  154.     changed:
  155.         if ((buf = mvinch(line, n) & A_CHARTEXT) == '\0')
  156.     to:
  157.         if ((buf[n] = (mvinch(line, n) & A_CHARTEXT)) == '\0')
  158.  
  159. loop.c --
  160.     disp_hist() (display history) no longer core dumps if the history
  161.     command was given from the curses mode using ':' and there was no
  162.     history created yet.
  163.  
  164. doproc.c (suntools only) --
  165.     The save menu item would prompt to save in ~/mbox for both the
  166.     first and second menu items rather than just the first menu item.
  167.     The result was that you couldn't save to the file described by
  168.     the second menu item.
  169.  
  170. commands.c --
  171.     save_msg() modified to support SAVED flag.  Messages are not
  172.     deleted, but marked saved.  When updating folder, keep_save is
  173.     checked, and if not set, saved messages are deleted.
  174.  
  175. msgs.c --
  176.     changed lockf()'s last argument from 0 to 0L.
  177.  
  178. misc.c --
  179.     Sprintf() (for SYSV) has been modified to correctly deal with
  180.     varargs.  Sorry, the stuff in print.c still isn't, but someday...
  181.     Nevertheless, there are currently no bugs known or reported that
  182.     concern anything in print.c
  183.  
  184.     The internal pager now works with the -e flag (happy _now_ Dave?)
  185.  
  186. pick.c --
  187.     picking patterns no longer requires the pattern to be in quotes
  188.     if it contains spaces.  You may now specify:
  189.     pick -f -i dan heller
  190.     This example will find messages from "Dan Heller" (-i ignores case).
  191.  
  192.  
  193. What "dot-lock" is and why you may need it...
  194.  
  195.     When mush updates your mailbox, it needs to lock it so that if new
  196.     mail is being delivered at the same time, it will wait till mush
  197.     is done.  Or, if the mail is there first, mush should wait before
  198.     attempting to lock the file.  This should theoretically prevent new
  199.     mail from getting lost.  But...
  200.       Different systems use different locking mechanisms.  By default,
  201.     mush uses one of flock(), locking(), or lockf() (depending on your
  202.     system).  Some  systems use a file called the same name as the file
  203.     you're locking with an appended ".lock" at the end (some Xenix's use
  204.     /tmp/$USER.mlk).
  205.       If you define DOT_LOCK, mush will try to lock the mailbox using
  206.     first check for the .lock file.  If it exists, it loops until it
  207.     goes away and then it creates it mode 600.  Regardless of whether you
  208.     use dot-locking, mush will continue to try to use flock(), or whatever.
  209.       dot-locking requires mush to have write access to the directory where
  210.     your mailbox exists.  Normally, this directory isn't writable by the
  211.     average user, so you may have to sgid mush to do this to the group id
  212.     of the owner of that directory. Mush will get the effective gid at the
  213.     beginning of the program and immediately reset it to your real gid until
  214.     the time it needs to lock the file occurs.  It changes back to the sgid,
  215.     locks, then returns to normal.  There shouldn't be a security problem.
  216.       If you don't know what I'm talking about here, ignore DOT_LOCK
  217.     as this is the first attempt at such locking methods and is likely
  218.     to change.
  219.       Another warning is that some MTA's don't even follow their own protocol.
  220.     System V, it has been reported, creates the .lock file without checking
  221.     to see if it exists (therefore ruining someone else's lock).
  222.  
  223.