[comp.mail.mh] Changes to MH 6.7

mh@beanie.ICS.UCI.EDU (John Romine) (04/14/90)

A number of people have asked exactly what are the changes made from
MH 6.6 to MH 6.7.  I'll give you a quick summary which is sure to
omit some things, and include the document which descibes the changes
below (in roff and formatted versions).

- All known bugs are fixed.
- Sun OS 4.0 support.  You can also make "libmh.a" into a shared library.
- SYS5 support has been brought up to R3.  If you have the BSD socket()
  interface on your SYS5 system (like HPUX), MH can use it.
- ANSI C compilers should be happy with the source.
- "bbc" can read netnews via NNTP
- "sortm" can sort by arbitrary text fields (like "subject", etc.)
- Configuration: made more flexible to support more versions of UNIX.
- Documentation: many man pages have been expanded to give more detail.
- TeX papers: these can now be formatted on any system with TeX.

There were lots of little changes to MH programs as well.  Check the
changes document for complete details.

/JLR

: This is a shar archive.  Extract with sh, not csh.
: This archive ends with exit, so do not worry about trailing junk.
echo 'Extracting mh6.7.ms'
sed 's/^X//' > mh6.7.ms << '+ END-OF-FILE mh6.7.ms'
X.\" @(#)$Id: mh6.7.ms,v 1.10 90/04/10 13:23:45 sources Exp $
X.\" Standard -ms macros
X.\" with the following changes
X.ds lq \\*Q
X.ds rq \\*U
X.DA "April 9, 1990"
X.if n \{\
X.nr PO 1i
X.po 1i
X.\}
X.EH ''Changes to MH 6.7'%'
X.OH ''Changes to MH 6.7'%'
X.TL
XChanges to
X.br
XThe RAND MH Message Handling System:
X.br
XUCI version MH 6.7
X.AU
XJohn L. Romine
X.AI
XComputing Support Group
XDepartment of Information and Computer Science
XUniversity of California, Irvine
XIrvine, CA  92717
X.AB
X.PP
XThis document describes the user\-visible and internal changes to the
XUCI version of the RAND MH system from MH 6.6
Xto MH 6.7.  The first part should be of interest to all users
Xof MH, while the latter part is of interest only to MH
XAdministrators.
X.PP
XThis document is meant to supplement,
Xnot supersede,
Xthe standard MH User's manual and MH Administrator's manual.
X.PP
XComments concerning this documentation should be addressed to the
Xmailbox \fBBug\-MH@ICS.UCI.EDU\fP, or \fBucbvax!ucivax!bug-mh\fP.
X.AE
X.SH
XACKNOWLEDGEMENTS
X.LP
XThe \fIMH\fP system described herein is
Xbased on the original RAND \fIMH\fP system.
XIt has been extensively developed (perhaps too much so) by Marshall T. Rose
Xand John L. Romine at the University of California, Irvine.
XEinar A. Stefferud, Jerry N. Sweet,
Xand Terry P. Domae provided numerous suggestions
Xto improve the UCI version of \fIMH\fP.
X.PP
XOf course,
Xa large number of people have helped \fIMH\fP along.
XThe list of \*(lq\fIMH\fP immortals\*(rq is too long to list here.
XFor this release, numerous \fIMH\-Workers\fP sent in fixes and other
Xchanges.  A handful of courageous \fIMH\-Workers\fP volunteered
Xto beta\-test these changes; their help is particularly appreciated.
X.SH
XDISCLAIMER
X.LP
XThe Regents of the University of California wish to make it known that:
X.QP
XAlthough each program has been tested by its contributor,
Xno warranty, express or implied,
Xis made by the contributor or the University of California,
Xas to the accuracy and functioning of the program
Xand related program material,
Xnor shall the fact of distribution constitute any such warranty,
Xand no responsibility is assumed by the contributor
Xor the University of California in connection herewith.
X.KS
X.SH
XCONVENTIONS
X.LP
XIn this document,
Xcertain formatting conventions are adhered to:
X.IP
XThe names of
X\s-2UNIX\s+2
Xcommands, such as \fIcomp\fP
Xare presented in \fIitalics\fP.
X.IP
XArguments to programs, such as `msgs' and `\-nobell' are
Xdelimited by single\-quotes.
X.IP
XText that should be typed exactly as\-is, such as
Xcommand lines (e.g., \*(lqfolder \-pack\*(rq),
Xare delimited by double\-quotes.
X.IP
X\s-2UNIX\s+2
Xpathnames and envariables,
Xsuch as \fB/usr/uci\fP and \fB$SIGNATURE\fP,
Xare presented in \fBbold font\fP.
X.KE
X.SH
XGENERAL CHANGES
X.LP
XThe author is pleased to announce that there are very few
Xuser\-visible
Xchanges to \fIMH\fP 6.7 from the previous \fIMH\fP 6.6 distribution.
XThe majority of development was in the form of bug fixes and
Xslight enhancements.
XIn addition, this release is slightly faster than the
Xprevious release.
XWith a few minor exceptions,
Xit is backward\-compatible with the previous release.
X.PP
XThe changes were made mainly to generalize the source code to
Xbe compatible with a larger range of systems and compilers.
XThere were many small changes to add declarations for ANSI C compliance.
XThe System 5 support has been brought up to SYS5 R3, and there is
Xsupport for Sun OS 4.0.
X.SH
XUser\-Visible Changes
X.LP
XHere a quick summary of the
Xchanges that were made which are not backward\-compatible with the
Xprevious release of \fIMH\fP:
X.IP repl \w'sortm'u+2n
XThe `\-format' and `\-noformat' switches
Xhave not been functional since \fIMH\fP 5, and have been removed.
XAny users who have these switches in their \fB\&.mh\(ruprofile\fP,
Xwill have to remove them.
X.IP sortm
XPreviously, in most cases \fIsortm\fP would fill\-in any
Xgaps in the numbering of a folder,
Xby renumbering the messages starting with `1'.
XThis will no longer occur; for this behavior,
Xuse \*(lqfolder \-pack\*(rq.
X.PP
X.SH
XUsing Aliases
X.LP
XA new profile entry `Aliasfile:' has been added.  The
X\fIali\fP\^, \fIsend\fP\^, and \fIwhom\fP programs will look for
Xthis profile entry and treat it as they would an argument to
X`\-alias'.
XThis should make it easier for novice \fIMH\fP users to begin
Xusing aliases.
X.PP
X.SH
XReading Network News & BBoards
X.LP
XThe UCI BBoards facility can read local BBoards, and if compiled
Xwith the `bboards: pop' and `pop: on' options, can also read remote
XBBoards using the Post Office Protocol (POP ver. 3).
XWith this release,
X\fIMH\fP can instead be compiled to read the Network News
X(i.e., USENET) using the Network News Transfer Protocol (NNTP).
X.PP
XThis capability is enabled by compiling \fIMH\fP with
Xthe `bboards: nntp' and `pop: on' options.
XUnfortunately, reading remote BBoards via the POP and reading the Network
XNews via the NNTP are mutually exclusive options.
X.PP
XTo support the NNTP,
Xa new module, \fBuip/pshsbr.c\fP, is compiled and loaded into
X\fIbbc\fP and \fImsh\fP instead of \fBuip/popsbr.c\fP.
XThe default BBoard is changed from \*(lqsystem\*(rq to \*(lqgeneral\*(rq
Xfor the NNTP.
X.PP
XWhen reading BBoards,
X\fIbbc\fP will first look for local BBoards, and then contact the
XNNTP server to read the Network News.  The location of the
XNNTP server should be specified with the `nntphost:'
Xentry in the \fBmtstailor\fP file
X(see the \fIMH\fP Administrator's Guide for details),
Xor may be specified on
Xthe command line with the `\-host' switch.
X.PP
X.SH
XFormat Strings
X.LP
XThe manual page \fImh\-format\fP\0(5) has
Xbeen rewritten to give a better explanation of how to write format strings,
Xand how they are interpreted by \fIMH\fP.
XA line\-by\-line
Xdescription of the
Xdefault \fIrepl\fP form file (\fBreplcomps\fP)
Xis now included in that manual page.
X.PP
X.KS
XSome new format functions were added, and others were augmented:
X.IP trim \w'date2local'u+2n
XStrips any leading and trailing white\-space from the current string value.
X.IP date2local
XWill coerce the date to the local timezone.
X.IP date2gmt
XWill coerce the date to GMT.
X.IP divide
XDivides the current numeric value by its argument.
XThis could be useful for
Xbuilding \fIscan\fP format strings which print large
Xmessage sizes in \*(lqKb\*(rq or \*(lqMb\*(rq.
X.IP friendly
XIf the address field cannot be parsed,
Xthis function will return the text of the address header,
Xinstead of a null string.
X.IP szone
XA flag indicating whether the timezone was explicit
Xin the date string.
X.KE
X.SH
XPROGRAM CHANGES
X.LP
XIn addition to the general changes mentioned above,
Xmany programs have specific new features added,
Xeither by new switches or by expanded functionality.
XEach command's manual page gives complete information about
Xits new options.  Here is a short summary.
X.SH
XUser Interface Programs
X.IP anno \w'prompter'u+2n
XAccepts a `\-nodate' switch which inhibits the date annotation,
Xleaving only the body annotation.
X.IP folder
XWhen invoked with the `\-pack' switch
Xand the new `\-verbose' switch, \fIfolder\fP will
Xgive information about the actions taken to renumber the folder.
X.IP
XOn most systems, \fIfolder\fP can now create any non\-existing
Xparent folders of a new sub\-folder.
X.IP forw
XWhen making digests, \fIforw\fP\^
Xwill put the issue and volume numbers
Xin addition to the digest list name, in the digest trailer.
X.IP inc
XDetects NFS write failures, and will
Xnot zero your maildrop in that event.
X.IP msh
XSupports a variant of the new \fIsortm\fP\^.
X.IP prompter
XConsiders a period on a line by itself to signify end\-of\-file
Xwhen the `\-doteof' switch is specified.
X.IP repl
XThe `\-[no]format' switches
Xhave not been used since \fIMH\fP 5 and have been deleted. \fIrepl\fP
Xwill now find filter files in the \fIMH\fP library area.
X.IP scan
XWith the `\-file msgbox' switch, \fIscan\fP\^
Xcan list a \fIpackf\fP\|'d\-format file directly
X(without using \fImsh\fP\^).
X.IP
XLists messages in reverse order with the `\-reverse' switch.
XThis should be considered a bug.
X.IP sortm
XNow has the options:
X`\-textfield field', `\-notextfield',
X`\-limit days', and `\-nolimit'.
X.IP
XWith these options, \fIsortm\fP can be instructed to sort a
Xfolder based on the contents of an arbitrary header such
Xas \*(lqsubject\*(rq.
X.IP
X\fIsortm\fP minimizes renaming messages, and
Xwill no longer arbitrarily pack folders; for this behavior,
Xuse \*(lqfolder \-pack\*(rq.
X.IP whatnow
XDeletes the draft by renaming it with leading comma, instead
Xof unlinking it.
X.SH
X\fIMH\fP Support Programs
X.LP
X.KS
XThe following support programs also have changes or enhancements:
X.IP mhl \w'rcvtty'u+2n
XWill now accept a format string on any component, not just on
Xaddresses and dates.
X.KE
X.IP popd
XWill use \fIshadow\fP passwords if compiled with the
X\fBSHADOW\fP option.  It can now also
Xread UUCP\-style maildrops directly.
X.IP rcvtty
XIf given no arguments, \fIrcvtty\fP will produce a \fBscan\fP
Xlisting as specified by a format string or file; a default
Xformat string is used if one is not specified.
X.IP
XBefore the listing is written to the users terminal, the
Xterminal's bell is rung and a newline is output.
XThe `\-nobell' and the `\-nonewline' options
Xinhibit these functions.
X.IP
X\fIrcvtty\fP will obey terminal write
Xnotification set by \fImesg\fP.
XWith the `\-biff' switch, \fIrcvtty\fP will
Xalso obey the mail notification status set by
X\fIbiff\fP.
X.IP
XOn \fBBSD43\fP systems, as with \fIwrite\fP,
X\fIrcvtty\fP will be installed set\-group\-id to the group \*(lqtty\*(rq.
X.IP slocal
XUnderstands UUCP\-style \*(lqFrom \*(rq lines and will write
Xoutput files using this format if appropriate.
XBefore invoking a delivery program, \fIslocal\fP will strip
Xsuch lines unless compiled with the \fBRPATHS\fP option,
Xin which case it will will convert such lines into
X\*(lqReturn\-Path:\*(rq headers.
X.IP
X\fIslocal\fP has a new result code \*(lqN\*(rq,
Xfor use in \fB.maildelivery\fP files.
XWith this result code,
X\fIslocal\fP will
Xperform the action only if the message has not been delivered
Xand the previous action succeeded.  This allows for performing
Xan action only if multiple conditions are true.
X.SH
XDOCUMENTATION
X.LP
XSeveral of the older \fIMH\fP papers have been difficult to format
Xbecause they depended on an older version of
XPhDTeX which was
Xnot supplied.  These papers have been updated, and some TeX
Xlibrary files are supplied in \fBpapers/doclib/\fP, so that
Xthese papers may be generated on any system with TeX.
X.PP
XMany of the manual pages have been revised to include documentation
Xof new command options, and some have been expanded to give more detail.
XAll are now slightly reformatted at installation time
Xto make them more compatible with programs like \fImakewhatis\fP\^.
X.PP
X.SH
X\fIMH\fP ADMINISTRATION
X.LP
XThis section describes changes in configuring, compiling and
Xinstalling \fIMH\fP 6.7 and should not
Xbe of interest to casual \fIMH\fP users.
XThe \fBREAD\-ME\fP file has been
Xconsiderably revised and expanded to give more detail
Xabout the configuration and compilation options which
Xhave been included in this release.  Some compilation options
Xhave been removed, and many new options have been added.
X.PP
XAll \fIMH\fP \fBMakefile\fPs have been updated to work around some
Xincompatibilities introduced in newer versions of \fImake\fP\^.
X\fIMH\fP programs will no longer be installed with the sticky\-bit
Xturned on.
X.PP
XReading this section not a substitute for carefully
Xreading the \fBREAD\-ME\fP file before attempting to compile \fIMH\fP
X.PP
X.KS
X.SH
XBug Fixes
X.LP
XSome bugs were fixed which in general were not user\-visible:
X.IP "address parser" \w'dynamicnmemory'u+2n
XFixed to allow use of the \*(lqAT\*(rq domain, and some
Xminor bugs were fixed pertaining to address groups.
X.IP "date parser"
XImproved to accept more forms of illegal dates.  Military
Xtimezones were removed.
X.IP "dynamic memory"
XMany problems with corruption of the dynamic memory pool
Xhave been fixed.
X.IP locking
XWill open files for write, if necessary to enable locking.
X.IP "nil pointers"
XAll reported nil pointer problems have been fixed.
X.IP replcomps
XThe \*(lqIn\-Reply\-To:\*(rq header had quotes added
Xaround the date field to comply with RFC822.
X.KE
X.SH
XWhite Pages
X.LP
XIf \fIMH\fP is compiled with the \fBWP\fP option,
X\fIsend\fP recognizes an address between \*(lq<<\*(rq and \*(lq>>\*(rq characters
Xsuch as:
X.DS
XTo: << rose \-org psi >>
X.DE
Xto be a name meaningful to a whitepages service.  In order to expand the
Xname, \fIsend\fP must be invoked interactively
X(i.e., not from \fIpush\fP\^).  For each
Xname, \fIsend\fP will invoke a command called \fIfred\fP\^
Xin a special mode asking to expand the name.
X.PP
XTo get a copy of the white pages service, contact wpp\-manager@psi.com.
X.SH
XConfiguration Options
X.LP
XSome configuration options have been added or changed:
X.IP cc \w'bbdelivery'u+2n
XTo specify an alternate C compiler.
X.IP ccoptions
XDefaults to `\-O'.
X.IP bboards
XMay now be defined as \*(lqon\*(rq,
X\*(lqoff\*(rq, \*(lqpop\*(rq, or \*(lqnntp\*(rq.
X.IP bbdelivery
XDetermines whether the bboard delivery agent
Xand library files should be installed.
X.IP lex
XTo specify an alternate version of \fIlex\fP\^.
X.IP mailgroup
XIf defined, \fIinc\fP will be made set\-group\-id to this group.
X.IP sharedlib
XFor \fBSUN40\fP systems; if \*(lqon\*(rq, makes \fBlibmh.a\fP
Xinto a shared library.
X.IP slibdir
XThe directory where the above shared library should be installed.
X.IP sprintf
XSet this to \*(lqint\*(rq if that's what your \fIsprintf\fP\0(3) library
Xroutine returns.
X.SH
XCompilation Options
X.LP
XFor different configurations,
Xseveral `\-D' options to \fIcc\fP have been added or changed:
X.IP BERK \w'SENDMAILBUG'u+1n
XThis disables the address and date parsing routines.  If you
Xwant to do much with \fImh\-format\fP\0(5), don't enable this.
X.IP BSD43
XWill make \fIrcvtty\fP set\-group\-id to the group \*(lqtty\*(rq.
X.IP DBM
XFor sites with a dbm\-style password file (such as with Yellow
XPages), \fIMH\fP will not read the entire passwd file into a cache.
XAt one site that runs YP on a large passwd file, using this
Xshowed a 6:1 performance improvement.
X.IP NETWORK
XThis option has been deleted.  See \fBSOCKETS\fP.
X.IP NOIOCTLH
XTells \fIMH\fP not to include the file \fBsys/ioctl.h\fP.  Use this
Xif this file is not present on your system.
X.IP NTOHLSWAP
XOn systems with TCP/IP networking,
X\fImsh\fP will try to use the \fBntohl()\fP macro from the
Xfile \fBnetinet/in.h\fP to byte\-swap the binary map files
Xit writes.
X.IP SENDMAILBUG
XSome versions of \fIsendmail\fP return a \fB451\fP (failure) reply code
Xwhen they don't mean to indicate failure.  This option considers
Xthat code to be equivalent to \fB250\fP (OK).
X.IP SHADOW
XCauses \fIpopd\fP to read the file \fB/etc/shadow\fP for
Xencrypted passwords instead of \fB/etc/passwd\fP.  Use this if you
Xhave a shadow password file (such as on newer versions of SYSTEM 5).
X.IP SOCKETS
XEnable this if you are on a non\-BSD system with a
Xsocket interface for TCP/IP networking compatible with 4.2BSD
X.SM
XUNIX.
X.NL
X.IP SUN40
XUse on Suns running Sun OS 4.0 and later.
X.IP SYS5
XThis option has been updated to refer to SYS5 R3 and later systems.
X.IP SYS5DIR
XUse this if your system uses \*(lqstruct dirent\*(rq instead of
X\*(lqstruct direct\*(rq.  This should be true for systems based
Xon SYS5 R3 and later.
X.IP TYPESIG
XDefines the base type for the \fIsignal\fP system call.  This
Xdefaults to \*(lqint\*(rq, but should be defined as \*(lqvoid\*(rq
Xif appropriate for your system.
X.IP WP
XEnables support for the White Pages service.
X.SH
XInstallation
X.LP
X\fIMH\fP will now
Xexplicitly set the protection mode on every file it installs.
X.PP
XPreviously any existing file installed by \fIMH\fP
Xwould be backed up into
Xthe source tree, and then overwritten.
XNow, a few system\-dependent files will not be overwritten, and your
Xchanges will have to be merged in by hand.
XSee the \fBREAD\-ME\fP file for more details.
+ END-OF-FILE mh6.7.ms
chmod 'u=r,g=r,o=r' 'mh6.7.ms'
echo '	-r--r--r--  1 sources     15858 Apr 10 13:33 mh6.7.ms        (as sent)'
echo -n '	'
/bin/ls -l mh6.7.ms
echo 'Extracting mh6.7.doc'
sed 's/^X//' > mh6.7.doc << '+ END-OF-FILE mh6.7.doc'
X
X
X
X
X
X
X
X
X
X                                   Changes to
X                      The RAND MH Message Handling System:
X                               UCI version MH 6.7
X
X
X                                 John L. Romine
X
X                            Computing Support Group
X                 Department of Information and Computer Science
X                        University of California, Irvine
X                               Irvine, CA  92717
X
X
X                                    _A_B_S_T_R_A_C_T
X
X
X                    This document describes the user-visible  and
X               internal changes to the UCI version of the RAND MH
X               system from MH 6.6 to  MH  6.7.   The  first  part
X               should  be  of  interest to all users of MH, while
X               the latter part is of interest only to MH Adminis-
X               trators.
X
X                    This document is  meant  to  supplement,  not
X               supersede,  the  standard  MH User's manual and MH
X               Administrator's manual.
X
X                    Comments concerning this documentation should
X               be addressed to the mailbox Bug-MH@ICS.UCI.EDU, or
X               ucbvax!ucivax!bug-mh.
X
X
X
X          _A_C_K_N_O_W_L_E_D_G_E_M_E_N_T_S
X
X          The _M_H system described herein is based on the original RAND
X          _M_H  system.   It has been extensively developed (perhaps too
X          much so) by Marshall T. Rose  and  John  L.  Romine  at  the
X          University of California, Irvine.  Einar A. Stefferud, Jerry
X          N. Sweet, and Terry P. Domae provided  numerous  suggestions
X          to improve the UCI version of _M_H.
X
X               Of course, a large number  of  people  have  helped  _M_H
X          along.  The list of "_M_H immortals" is too long to list here.
X          For this release, numerous  _M_H-_W_o_r_k_e_r_s  sent  in  fixes  and
X          other  changes.   A  handful of courageous _M_H-_W_o_r_k_e_r_s volun-
X          teered to beta-test these changes; their  help  is  particu-
X          larly appreciated.
X
X
X
X
X
X
X                                April 9, 1990
X
X
X
X
X
X                               Changes to MH 6.7                     2
X
X
X          _D_I_S_C_L_A_I_M_E_R
X
X          The Regents of the University of California wish to make  it
X          known that:
X
X               Although each program has been tested by its  con-
X               tributor, no warranty, express or implied, is made
X               by the contributor or the University  of  Califor-
X               nia,  as  to  the  accuracy and functioning of the
X               program and related program  material,  nor  shall
X               the  fact of distribution constitute any such war-
X               ranty, and no responsibility  is  assumed  by  the
X               contributor  or  the  University  of California in
X               connection herewith.
X
X          _C_O_N_V_E_N_T_I_O_N_S
X
X          In this document, certain formatting conventions are adhered
X          to:
X
X               The names of UNIX commands, such as _c_o_m_p are  presented
X               in _i_t_a_l_i_c_s.
X
X               Arguments to programs, such as `msgs' and `-nobell' are
X               delimited by single-quotes.
X
X               Text that should be typed exactly as-is, such  as  com-
X               mand  lines  (e.g.,  "folder  -pack"), are delimited by
X               double-quotes.
X
X               UNIX pathnames and envariables, such  as  /usr/uci  and
X               $SIGNATURE, are presented in bold font.
X
X          _G_E_N_E_R_A_L _C_H_A_N_G_E_S
X
X          The author is pleased to announce that there  are  very  few
X          user-visible changes to _M_H 6.7 from the previous _M_H 6.6 dis-
X          tribution.  The majority of development was in the  form  of
X          bug  fixes  and  slight  enhancements.   In  addition,  this
X          release is slightly faster than the previous release.   With
X          a  few  minor exceptions, it is backward-compatible with the
X          previous release.
X
X               The changes were made mainly to generalize  the  source
X          code  to  be  compatible  with a larger range of systems and
X          compilers.  There were many small changes  to  add  declara-
X          tions  for ANSI C compliance.  The System 5 support has been
X          brought up to SYS5 R3, and there is support for Sun OS 4.0.
X
X          _U_s_e_r-_V_i_s_i_b_l_e _C_h_a_n_g_e_s
X
X          Here a quick summary of the changes that were made which are
X          not backward-compatible with the previous release of _M_H:
X
X
X
X
X                                April 9, 1990
X
X
X
X
X
X                               Changes to MH 6.7                     3
X
X
X          repl   The `-format' and `-noformat' switches have not  been
X                 functional  since  _M_H  5, and have been removed.  Any
X                 users who have these switches in  their  .mh_profile,
X                 will have to remove them.
X
X          sortm  Previously, in most cases  _s_o_r_t_m  would  fill-in  any
X                 gaps in the numbering of a folder, by renumbering the
X                 messages starting with  `1'.   This  will  no  longer
X                 occur; for this behavior, use "folder -pack".
X
X
X          _U_s_i_n_g _A_l_i_a_s_e_s
X
X          A new profile entry `Aliasfile:' has been added.   The  _a_l_i,
X          _s_e_n_d, and _w_h_o_m programs will look for this profile entry and
X          treat it as they would an argument to `-alias'.  This should
X          make it easier for novice _M_H users to begin using aliases.
X
X
X          _R_e_a_d_i_n_g _N_e_t_w_o_r_k _N_e_w_s & _B_B_o_a_r_d_s
X
X          The UCI BBoards facility can read local BBoards, and if com-
X          piled  with  the  `bboards:  pop' and `pop: on' options, can
X          also read remote BBoards using the Post Office Protocol (POP
X          ver.  3).   With this release, _M_H can instead be compiled to
X          read the Network News (i.e., USENET) using the Network  News
X          Transfer Protocol (NNTP).
X
X               This capability is enabled by  compiling  _M_H  with  the
X          `bboards: nntp' and `pop: on' options.  Unfortunately, read-
X          ing remote BBoards via the POP and reading the Network  News
X          via the NNTP are mutually exclusive options.
X
X               To support the NNTP, a  new  module,  uip/pshsbr.c,  is
X          compiled   and   loaded   into   _b_b_c   and  _m_s_h  instead  of
X          uip/popsbr.c.  The default BBoard is changed  from  "system"
X          to "general" for the NNTP.
X
X               When reading BBoards, _b_b_c will  first  look  for  local
X          BBoards,  and  then contact the NNTP server to read the Net-
X          work News.  The location of the NNTP server should be speci-
X          fied  with  the `nntphost:' entry in the mtstailor file (see
X          the _M_H Administrator's Guide for details), or may be  speci-
X          fied on the command line with the `-host' switch.
X
X
X          _F_o_r_m_a_t _S_t_r_i_n_g_s
X
X          The manual page _m_h-_f_o_r_m_a_t (5) has been rewritten to  give  a
X          better  explanation  of how to write format strings, and how
X          they are interpreted by _M_H.  A line-by-line  description  of
X          the  default  _r_e_p_l  form file (replcomps) is now included in
X          that manual page.
X
X
X
X
X                                April 9, 1990
X
X
X
X
X
X                               Changes to MH 6.7                     4
X
X
X          Some new format functions were added, and others  were  aug-
X          mented:
X
X          trim        Strips any leading and trailing white-space from
X                      the current string value.
X
X          date2local  Will coerce the date to the local timezone.
X
X          date2gmt    Will coerce the date to GMT.
X
X          divide      Divides the current numeric value by  its  argu-
X                      ment.   This  could  be useful for building _s_c_a_n
X                      format strings which print large  message  sizes
X                      in "Kb" or "Mb".
X
X          friendly    If the address  field  cannot  be  parsed,  this
X                      function  will  return  the  text of the address
X                      header, instead of a null string.
X
X          szone       A flag indicating whether the timezone  was  ex-
X                      plicit in the date string.
X
X          _P_R_O_G_R_A_M _C_H_A_N_G_E_S
X
X          In addition to the general  changes  mentioned  above,  many
X          programs  have  specific  new  features added, either by new
X          switches  or  by  expanded  functionality.   Each  command's
X          manual   page  gives  complete  information  about  its  new
X          options.  Here is a short summary.
X
X          _U_s_e_r _I_n_t_e_r_f_a_c_e _P_r_o_g_r_a_m_s
X
X          anno      Accepts a `-nodate' switch which inhibits the date
X                    annotation, leaving only the body annotation.
X
X          folder    When invoked with the `-pack' switch and  the  new
X                    `-verbose'  switch,  _f_o_l_d_e_r  will give information
X                    about the actions taken to renumber the folder.
X
X                    On  most  systems,  _f_o_l_d_e_r  can  now  create   any
X                    non-existing parent folders of a new sub-folder.
X
X          forw      When making digests, _f_o_r_w will put the  issue  and
X                    volume  numbers  in  addition  to  the digest list
X                    name, in the digest trailer.
X
X          inc       Detects NFS write failures, and will not zero your
X                    maildrop in that event.
X
X          msh       Supports a variant of the new _s_o_r_t_m.
X
X          prompter  Considers a period on a line by itself to  signify
X                    end-of-file  when  the  `-doteof' switch is speci-
X                    fied.
X
X
X
X                                April 9, 1990
X
X
X
X
X
X                               Changes to MH 6.7                     5
X
X
X          repl      The `-[no]format'  switches  have  not  been  used
X                    since  _M_H  5  and have been deleted. _r_e_p_l will now
X                    find filter files in the _M_H library area.
X
X          scan      With the `-file msgbox' switch, _s_c_a_n  can  list  a
X                    _p_a_c_k_f'd-format file directly (without using _m_s_h).
X
X                    Lists  messages  in   reverse   order   with   the
X                    `-reverse'  switch.   This  should be considered a
X                    bug.
X
X          sortm     Now has the options: `-textfield field', `-notext-
X                    field', `-limit days', and `-nolimit'.
X
X                    With these options, _s_o_r_t_m  can  be  instructed  to
X                    sort  a  folder  based on the contents of an arbi-
X                    trary header such as "subject".
X
X                    _s_o_r_t_m minimizes renaming  messages,  and  will  no
X                    longer   arbitrarily   pack   folders;   for  this
X                    behavior, use "folder -pack".
X
X          whatnow   Deletes the draft  by  renaming  it  with  leading
X                    comma, instead of unlinking it.
X
X          _M_H _S_u_p_p_o_r_t _P_r_o_g_r_a_m_s
X
X          The following support programs also have changes or enhance-
X          ments:
X
X          mhl     Will now accept a format string  on  any  component,
X                  not just on addresses and dates.
X
X          popd    Will use _s_h_a_d_o_w passwords if compiled with the  SHA-
X                  DOW  option.   It can now also read UUCP-style mail-
X                  drops directly.
X
X          rcvtty  If given no arguments, _r_c_v_t_t_y will  produce  a  scan
X                  listing  as  specified by a format string or file; a
X                  default format string is used if one is  not  speci-
X                  fied.
X
X                  Before the listing is written to the users terminal,
X                  the terminal's bell is rung and a newline is output.
X                  The `-nobell' and the `-nonewline'  options  inhibit
X                  these functions.
X
X                  _r_c_v_t_t_y will obey terminal write notification set  by
X                  _m_e_s_g.   With  the  `-biff'  switch, _r_c_v_t_t_y will also
X                  obey the mail notification status set by _b_i_f_f.
X
X                  On BSD43 systems, as  with  _w_r_i_t_e,  _r_c_v_t_t_y  will  be
X                  installed set-group-id to the group "tty".
X
X
X
X
X                                April 9, 1990
X
X
X
X
X
X                               Changes to MH 6.7                     6
X
X
X          slocal  Understands UUCP-style "From " lines and will  write
X                  output  files  using  this  format  if  appropriate.
X                  Before invoking  a  delivery  program,  _s_l_o_c_a_l  will
X                  strip  such  lines  unless  compiled with the RPATHS
X                  option, in which case  it  will  will  convert  such
X                  lines into "Return-Path:" headers.
X
X                  _s_l_o_c_a_l has a new result code "N", for use in  .mail-
X                  delivery  files.  With this result code, _s_l_o_c_a_l will
X                  perform the action only if the message has not  been
X                  delivered  and  the previous action succeeded.  This
X                  allows for performing an  action  only  if  multiple
X                  conditions are true.
X
X          _D_O_C_U_M_E_N_T_A_T_I_O_N
X
X          Several of the older _M_H papers have been difficult to format
X          because  they  depended  on an older version of PhDTeX which
X          was not supplied.  These papers have been updated, and  some
X          TeX  library  files  are supplied in papers/doclib/, so that
X          these papers may be generated on any system with TeX.
X
X               Many of the manual pages have been revised  to  include
X          documentation  of  new  command  options, and some have been
X          expanded to give more detail.  All are now  slightly  refor-
X          matted  at  installation  time  to make them more compatible
X          with programs like _m_a_k_e_w_h_a_t_i_s.
X
X
X          _M_H _A_D_M_I_N_I_S_T_R_A_T_I_O_N
X
X          This section describes changes in configuring, compiling and
X          installing _M_H 6.7 and should not be of interest to casual _M_H
X          users.  The READ-ME file has been considerably  revised  and
X          expanded  to  give  more  detail about the configuration and
X          compilation  options  which  have  been  included  in   this
X          release.   Some  compilation  options have been removed, and
X          many new options have been added.
X
X               All _M_H Makefiles have been updated to work around  some
X          incompatibilities  introduced in newer versions of _m_a_k_e.  _M_H
X          programs will no longer be  installed  with  the  sticky-bit
X          turned on.
X
X               Reading this section not  a  substitute  for  carefully
X          reading the READ-ME file before attempting to compile _M_H
X
X
X
X
X
X
X
X
X
X
X
X                                April 9, 1990
X
X
X
X
X
X                               Changes to MH 6.7                     7
X
X
X
X          _B_u_g _F_i_x_e_s
X
X          Some bugs were fixed which in general were not user-visible:
X
X          address parser  Fixed to allow use of the "AT"  domain,  and
X                          some minor bugs were fixed pertaining to ad-
X                          dress groups.
X
X          date parser     Improved to accept  more  forms  of  illegal
X                          dates.  Military timezones were removed.
X
X          dynamic memory  Many problems with corruption of the dynamic
X                          memory pool have been fixed.
X
X          locking         Will open files for write, if  necessary  to
X                          enable locking.
X
X          nil pointers    All reported nil pointer problems have  been
X                          fixed.
X
X          replcomps       The "In-Reply-To:" header had  quotes  added
X                          around the date field to comply with RFC822.
X
X          _W_h_i_t_e _P_a_g_e_s
X
X          If _M_H is compiled with the WP  option,  _s_e_n_d  recognizes  an
X          address between "<<" and ">>" characters such as:
X
X                  To: << rose -org psi >>
X
X          to be a name meaningful to a whitepages service.   In  order
X          to  expand  the  name,  _s_e_n_d  must  be invoked interactively
X          (i.e., not from _p_u_s_h).  For each name, _s_e_n_d  will  invoke  a
X          command  called  _f_r_e_d in a special mode asking to expand the
X          name.
X
X               To get a copy  of  the  white  pages  service,  contact
X          wpp-manager@psi.com.
X
X          _C_o_n_f_i_g_u_r_a_t_i_o_n _O_p_t_i_o_n_s
X
X          Some configuration options have been added or changed:
X
X          cc          To specify an alternate C compiler.
X
X          ccoptions   Defaults to `-O'.
X
X          bboards     May now be defined as  "on",  "off",  "pop",  or
X                      "nntp".
X
X          bbdelivery  Determines whether the bboard delivery agent and
X                      library files should be installed.
X
X
X
X
X                                April 9, 1990
X
X
X
X
X
X                               Changes to MH 6.7                     8
X
X
X          lex         To specify an alternate version of _l_e_x.
X
X          mailgroup   If defined, _i_n_c will  be  made  set-group-id  to
X                      this group.
X
X          sharedlib   For SUN40 systems; if "on", makes libmh.a into a
X                      shared library.
X
X          slibdir     The directory where  the  above  shared  library
X                      should be installed.
X
X          sprintf     Set  this  to  "int"   if   that's   what   your
X                      _s_p_r_i_n_t_f (3) library routine returns.
X
X          _C_o_m_p_i_l_a_t_i_o_n _O_p_t_i_o_n_s
X
X          For different configurations, several  `-D'  options  to  _c_c
X          have been added or changed:
X
X          BERK        This disables the address and date parsing  rou-
X                      tines.    If   you   want   to   do   much  with
X                      _m_h-_f_o_r_m_a_t (5), don't enable this.
X
X          BSD43       Will  make  _r_c_v_t_t_y  set-group-id  to  the  group
X                      "tty".
X
X          DBM         For sites with a dbm-style password  file  (such
X                      as  with  Yellow  Pages),  _M_H  will not read the
X                      entire passwd file into a cache.   At  one  site
X                      that  runs YP on a large passwd file, using this
X                      showed a 6:1 performance improvement.
X
X          NETWORK     This option has been deleted.  See SOCKETS.
X
X          NOIOCTLH    Tells _M_H not to include  the  file  sys/ioctl.h.
X                      Use  this  if  this  file is not present on your
X                      system.
X
X          NTOHLSWAP   On systems with TCP/IP networking, _m_s_h will  try
X                      to   use   the   ntohl()  macro  from  the  file
X                      netinet/in.h to byte-swap the binary  map  files
X                      it writes.
X
X          SENDMAILBUG Some versions of _s_e_n_d_m_a_i_l return a 451 (failure)
X                      reply  code  when  they  don't  mean to indicate
X                      failure.  This option considers that code to  be
X                      equivalent to 250 (OK).
X
X          SHADOW      Causes _p_o_p_d to read  the  file  /etc/shadow  for
X                      encrypted passwords instead of /etc/passwd.  Use
X                      this if you have a shadow password file (such as
X                      on newer versions of SYSTEM 5).
X
X          SOCKETS     Enable this if you are on a non-BSD system  with
X
X
X
X                                April 9, 1990
X
X
X
X
X
X                               Changes to MH 6.7                     9
X
X
X                      a  socket interface for TCP/IP networking compa-
X                      tible with 4.2BSD UNIX.
X
X          SUN40       Use on Suns running Sun OS 4.0 and later.
X
X          SYS5        This option has been updated to refer to SYS5 R3
X                      and later systems.
X
X          SYS5DIR     Use this if your  system  uses  "struct  dirent"
X                      instead of "struct direct".  This should be true
X                      for systems based on SYS5 R3 and later.
X
X          TYPESIG     Defines the base  type  for  the  _s_i_g_n_a_l  system
X                      call.   This  defaults  to  "int", but should be
X                      defined as "void" if appropriate for  your  sys-
X                      tem.
X
X          WP          Enables support for the White Pages service.
X
X          _I_n_s_t_a_l_l_a_t_i_o_n
X
X          _M_H will now explicitly set the protection mode on every file
X          it installs.
X
X               Previously any existing file installed by _M_H  would  be
X          backed  up into the source tree, and then overwritten.  Now,
X          a few system-dependent files will not  be  overwritten,  and
X          your  changes  will  have  to be merged in by hand.  See the
X          READ-ME file for more details.
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X                                April 9, 1990
X
X
+ END-OF-FILE mh6.7.doc
chmod 'u=rw,g=r,o=r' 'mh6.7.doc'
echo '	-rw-r--r--  1 sources     21840 Apr 13 10:13 mh6.7.doc        (as sent)'
echo -n '	'
/bin/ls -l mh6.7.doc
exit 0