Now it's possible to have two equally named pages in two different sections.
This appeared to be interesting for mmh(X), but I don't use it now. Let's
see if we keep the new system or even rework it to become simpler.
mandir = @mandir@
manext1 = 1
manext5 = 5
+manext7 = 7
manext8 = 8
mailspool = @mailspool@
SEDMAN = $(SED) -f man.sed $< > $@
.SUFFIXES:
-.SUFFIXES: .man .$(manext1) .$(manext5) .$(manext8)
+.SUFFIXES: .man1 .man5 .man7 .man8 \
+ .$(manext1) .$(manext5) .$(manext7) .$(manext8)
-.man.$(manext1):
+.man1.$(manext1):
$(SEDMAN)
-.man.$(manext5):
+.man5.$(manext5):
$(SEDMAN)
-.man.$(manext8):
+.man7.$(manext7):
+ $(SEDMAN)
+
+.man8.$(manext8):
$(SEDMAN)
# man pages to install in $(mandir)/$(manext1)
MAN1SRC = ali. anno. burst. comp. dist. flist. flists. folder. folders. \
- forw. inc. mark. mh-chart. nmh. mhbuild. mhl. mhlist. \
+ forw. inc. mark. mh-chart. mhbuild. mhl. mhlist. mmh. \
mhmail. mhparam. mhpath. mhshow. mhstore. msgchk. new. fnext. \
fprev. unseen. next. packf. pick. prev. prompter. rcvdist. rcvpack. \
rcvstore. rcvtty. refile. repl. rmf. rmm. scan. send. sendfiles. \
show. slocal. sortm. whatnow.
-MAN5SRC = mh-alias. mh-draft. mh-format. mh-mail. mh-profile. mh-sequence. \
- mh-tailor. mts.conf.
+MAN5SRC = mh-alias. mh-format. mh-mail. mh-profile. mh-tailor. mts.conf.
-MAN8SRC = ap. conflict. dp. fmtdump. mmh. post.
+MAN7SRC = mmh-intro. mh-draft. mh-sequence.
+
+MAN8SRC = ap. conflict. dp. fmtdump. post.
MAN1 = $(MAN1SRC:.=.$(manext1))
MAN5 = $(MAN5SRC:.=.$(manext5))
+MAN7 = $(MAN7SRC:.=.$(manext7))
MAN8 = $(MAN8SRC:.=.$(manext8))
# source for man pages
-DIST_MANSRC = $(MAN1SRC) $(MAN5SRC) $(MAN8SRC)
-DIST_MAN = $(DIST_MANSRC:.=.man)
+DIST_MAN1 = $(MAN1SRC:.=.man1)
+DIST_MAN5 = $(MAN5SRC:.=.man5)
+DIST_MAN7 = $(MAN7SRC:.=.man7)
+DIST_MAN8 = $(MAN8SRC:.=.man8)
# auxiliary files
AUX = Makefile.in
# all files in this directory included in the distribution
-DIST = $(DIST_MAN) $(AUX)
+DIST = $(DIST_MAN1) $(DIST_MAN5) $(DIST_MAN7) $(DIST_MAN8) $(AUX)
# ========= DEFAULT TARGET ==========
-all: $(MAN1) $(MAN5) $(MAN8)
+all: $(MAN1) $(MAN5) $(MAN7) $(MAN8)
-$(MAN1) $(MAN5) $(MAN8): man.sed
+$(MAN1) $(MAN5) $(MAN7) $(MAN8): man.sed
# create the sed file for building man pages
man.sed: Makefile
echo 's,%nmhwarning%,THIS FILE HAS BEEN AUTOMATICALLY GENERATED. DO NOT EDIT.,g' > $@
- echo 's,%nmhversion%,nmh-$(VERSION),g' >> $@
+ echo 's,%nmhversion%,mmh-$(VERSION),g' >> $@
echo 's,%nmhdate%,$(DATE),g' >> $@
echo 's,%bindir%,$(bindir),g' >> $@
echo 's,%etcdir%,$(etcdir),g' >> $@
echo 's,%sendmailpath%,$(sendmailpath),g' >> $@
echo 's,%manext1%,$(manext1),g' >> $@
echo 's,%manext5%,$(manext5),g' >> $@
+ echo 's,%manext7%,$(manext7),g' >> $@
echo 's,%manext8%,$(manext8),g' >> $@
echo '/%components%/r $(top_srcdir)/etc/components' >> $@
echo ' s,%components%,,g' >> $@
# ========= INSTALL TARGETS =========
-install: install-man1 install-man5 install-man8
+install: install-man1 install-man5 install-man7 install-man8
# install the man pages in man1
install-man1:
for file in $(MAN5); do \
$(INSTALL_DATA) $$file $(DESTDIR)$(mandir)/man$(manext5) ; \
done
- if [ ! -f $(DESTDIR)$(mandir)/man$(manext5)/mh_profile.$(manext5) ] ; then \
- ( cd $(DESTDIR)$(mandir)/man$(manext5) ; ln mh-profile.$(manext5) \
- mh_profile.$(manext5) ) \
- fi
+
+# install the man pages in man7
+install-man7:
+ $(top_srcdir)/mkinstalldirs $(DESTDIR)$(mandir)/man$(manext7)
+ for file in $(MAN7); do \
+ $(INSTALL_DATA) $$file $(DESTDIR)$(mandir)/man$(manext7) ; \
+ done
# install the man pages in man8
install-man8:
rm -f $(DESTDIR)$(mandir)/man$(manext5)/$$file; \
done
+# uninstall the man pages in man7
+uninstall-man7:
+ for file in $(MAN7); do \
+ rm -f $(DESTDIR)$(mandir)/man$(manext7)/$$file; \
+ done
+
# uninstall the man pages in man8
uninstall-man8:
for file in $(MAN8); do \
rm -f *~
clean: mostlyclean
- rm -f man.sed *.$(manext1) *.$(manext5) *.$(manext8)
+ rm -f man.sed *.$(manext1) *.$(manext5) *.$(manext7) *.$(manext8)
distclean: clean
rm -f Makefile
is required.)
.PP
Consult the
-.BR mh-draft (5)
+.BR mh-draft (7)
man page for more information.
.PP
The
.BR $mhfolder .
.PP
Consult the
-.BR mh-draft (5)
+.BR mh-draft (7)
man page for more information.
.PP
Upon exiting from the editor,
for all the sequences specified by the
.RI \*(lq Unseen-Sequence \*(rq
profile component. For more details about sequences, read the
-.BR mh\-sequence (5)
+.BR mh\-sequence (7)
man page.
.PP
Typically,
.PP
The \*(lqprivate\*(rq flag indicates that the given sequence for
that folder is private. See the
-.BR mh\-sequence (5)
+.BR mh\-sequence (7)
man page for details about private sequences.
.PP
If the option
.fi
.SH "SEE ALSO"
-folder(1), rcvstore(1), slocal(1), mh\-sequence(5)
+folder(1), rcvstore(1), slocal(1), mh\-sequence(7)
.SH DEFAULTS
.nf
.fi
.SH "SEE ALSO"
-mh-format(5), mh-sequences(8)
+mh-format(5), mh-sequence(7)
.SH CONTEXT
None
prior to sending the draft.
.PP
Consult the
-.BR mh-draft (5)
+.BR mh-draft (7)
man page for more information.
.PP
The
will maintain their current status, and new sequences will default to
\*(lqpublic\*(rq if you have write permission for the relevant folder.
Check the
-.BR mh\-sequence (5)
+.BR mh\-sequence (7)
man page for more details about the difference
between \*(lqpublic\*(rq and \*(lqprivate\*(rq sequences.
.PP
.fi
.SH "SEE ALSO"
-flist(1), pick(1), mh-sequence(5)
+flist(1), pick(1), mh-sequence(7)
.SH DEFAULTS
.nf
.\"
.\" %nmhwarning%
.\"
-.TH MH-DRAFT %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MH-DRAFT %manext7% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
mh-draft \- draft folder facility for nmh message system
.SH SYNOPSIS
no such sequences are defined. Otherwise, for each name given, the
sequence is first zero'd and then each message is added to the sequence.
Read the
-.BR mh\-sequence (5)
+.BR mh\-sequence (7)
man page for the details about this sequence. (profile, no default)
.RE
.PP
Defines the string which, when prefixed to a sequence name, negates
that sequence. Hence, \*(lqnotseen\*(rq means all those messages that
are not a member of the sequence \*(lqseen\*(rq. Read the
-.BR mh\-sequence (5)
+.BR mh\-sequence (7)
man page for the details. (profile, no default)
.RE
.PP
sequences when they are incorporated or read. If not present or
empty, no such sequences are defined. Otherwise, each message is
added to, or removed from, each sequence name given. Read the
-.BR mh\-sequence (5)
+.BR mh\-sequence (7)
man page for the details about this sequence.
(profile, no default)
.RE
Keeps track of the private sequence called \*(lqseq\*(rq in the specified
folder. Private sequences are generally used for read\-only folders.
See the
-.BR mh\-sequence (5)
+.BR mh\-sequence (7)
man page for details about private sequences.
(context, no default)
.RE
drafts
.RS 5
Changes the default draft folder. Read the
-.BR mh\-draft (5)
+.BR mh\-draft (7)
man page for details. (profile, default: +drafts)
.RE
.PP
.BR show
are not given any `msgs'
arguments, then they will default to using the file indicated by
-.BR mh\-draft (5).
+.BR mh\-draft (7).
This is useful for getting the default behavior
supplied by the default
.IR whatnowproc .
.fi
.SH "SEE ALSO"
-nmh(1), environ(5), mh-sequence(5)
+nmh(1), environ(5), mh-sequence(7)
.SH HISTORY
The
.\"
.\" %nmhwarning%
.\"
-.TH MH-SEQUENCE %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MH-SEQUENCE %manext7% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
mh-sequence \- sequence specification for nmh message system
.SH SYNOPSIS
.\"
.\" %nmhwarning%
.\"
-.TH NMH %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH NMH %manext7% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
-nmh \- new MH message system
-.SH SYNOPSIS
-any
-.B nmh
-command
+mmh \- Introduction to the Modern MH message system
.SH DESCRIPTION
-.B nmh
-is the name of a powerful message handling system. Rather than
+.B mmh
+is a powerful message handling system, based on
+.BR nmh ,
+which in turn bases on MH, the Rand Corporation's Message Handler.
+.PP
+Rather than
being a single comprehensive program,
-.B nmh
+.B mmh
consists of a collection
-of fairly simple single-purpose programs to send, retrieve, save,
+of fairly simple single-purpose programs to send, retrieve, organize,
and manipulate messages.
.PP
-Unlike most mail clients in UNIX,
-.B nmh
+Unlike most other mail clients,
+.B mmh
is not a closed system which
must be explicitly run, then exited when you wish to return to the shell.
-You may freely intersperse
-.B nmh
+Instead, you may freely intersperse
+.B mmh
commands with other shell commands,
-allowing you to read and answer your mail while you have (for example)
-a compilation running, or search for a file or run programs as needed
+allowing you to read and answer your mail while you
+search for a file or run programs as needed
to find the answer to someone's question before answering their mail.
.PP
The rest of this manual entry is a quick tutorial which will teach you
the basics of
-.BR nmh .
+.BR mmh .
You should read the manual entries for the
individual programs for complete documentation.
.PP
To get started using
-.BR nmh ,
+.BR mmh ,
put the directory
.I %bindir%
on your
do this.) Run the
.B mmh
command. If you've never used
-.B nmh
+.B mmh
before, it will create the necessary default files and directories after
asking you if you wish it to do so.
.PP
.B inc
moves mail from your system maildrop into your
-.B nmh
-`+inbox' folder, breaking it up into separate files and converting it
-to
-.B nmh
-format as it goes. It prints one line for each message it
-processes, containing the from field, the subject field and as much of
-the first line of the message as will fit. It leaves the first message
-it processes as your current message. You'll need to run
+.B mmh
+`+inbox' folder, converting it to the MH format (one file per message).
+It prints one line for each message it
+processes, containing the date, from and subject fields.
+It leaves the first message it processes as your current message.
+You'll need to run
.B inc
-each
-time you wish to incorporate new mail into your
-.B nmh
-file.
+each time you wish to incorporate new mail into your
+.B mmh
+mail storage.
.PP
.B scan
-.B prints a list of the messages in your current folder.
+prints a list of the messages in your current folder.
.PP
The commands:
.BR show ,
on a prototype message form, and then lets you send it.
.PP
All the
-.B nmh
+.B mmh
commands may be run with the single argument:
.BR \-help ,
which causes them to print a list of the arguments they may be invoked
with and then exit.
.PP
-All the
-.B nmh
-commands may be run with the single argument:
-.BR \-version ,
-which cause them to print the version number of the
-.B nmh
-distribution, and then exit.
-.PP
Commands which take a message number as an argument (
.BR scan ,
.BR show ,
of this manual entry.
.PP
Following is a list of all the
-.B nmh
+.B mmh
commands:
.PP
.RS 5
^inc(1)~^\- incorporate new mail
^mark(1)~^\- mark messages
^mhbuild(1)~^\- translate MIME composition draft
-^mhl(1)~^\- produce formatted listings of nmh messages
+^mhl(1)~^\- produce formatted listings of mmh messages
^mhlist(1)~^\- list information about content of MIME messages
^mhmail(1)~^\- send or read mail
-^mhparam(1)~^\- print nmh profile components
-^mhpath(1)~^\- print full pathnames of nmh messages and folders
+^mhparam(1)~^\- print mmh profile components
+^mhpath(1)~^\- print full pathnames of mmh messages and folders
^mhshow(1)~^\- display MIME messages
^mhstore(1)~^\- store contents of MIME messages into files
+^mmh(1)~^\- initialize the mmh environment
^msgchk(1)~^\- check for messages
^next(1)~^\- show the next message
^packf(1)~^\- compress a folder into a single file
^sortm(1)~^\- sort messages
^whatnow(1)~^\- prompting front\-end for send
.sp
-^mh\-alias(5)~^\- alias file for nmh message system
-^mh\-draft(5)~^\- draft folder facility
-^mh\-format(5)~^\- format file for nmh message system
-^mh\-mail(5)~^\- message format for nmh message system
-^mh\-profile(5)~^\- user customization for nmh message system
-^mh\-sequence(5)~^\- sequence specification for nmh message system
-^mh\-tailor(5)~^\- mail transport customization for nmh message system
-.sp
^ap(8)~^\- parse addresses 822\-style
^conflict(8)~^\- search for alias/password conflicts
^dp(8)~^\- parse dates 822\-style
-^fmtdump(8)~^\- decode \fInmh\fP format files
-^mmh(8)~^\- initialize the mmh environment
+^fmtdump(8)~^\- decode \fImmh\fP format files
^post(8)~^\- deliver a message
.fi
.RE
+.PP
+Theses are descriptions of files and concepts:
+.PP
+.RS 5
+.fc ^ ~
+.nf
+.ta 1.5i
+^mh\-alias(5)~^\- alias file for mmh message system
+^mh\-format(5)~^\- format file for mmh message system
+^mh\-mail(5)~^\- message format for mmh message system
+^mh\-profile(5)~^\- user customization for mmh message system
+^mh\-tailor(5)~^\- mail transport customization for mmh message system
+.sp
+^mmh(7)~^\- introduction to the mmh message system
+^mh\-draft(7)~^\- draft folder facility
+^mh\-sequence(7)~^\- sequence specification for mmh message system
+.RE
.SH FILES
.fc ^ ~
.nf
.ta \w'%etcdir%/ExtraBigFileName 'u
-^%bindir%~^contains \fInmh\fR commands
-^%etcdir%~^contains \fInmh\fR format files
-^%libdir%~^contains \fInmh\fR library commands
+^%bindir%~^contains \fImmh\fR commands
+^%etcdir%~^contains \fImmh\fR format files
+^%libdir%~^contains \fImmh\fR library commands
^$HOME/.mmh~^The user's mmh directory
^$HOME/.mmh/profile~^The user's profile
^$HOME/.mmh/context~^The user's context
.fc ^ ~
.nf
.ta 2.4i
-.ta \w'ExtraBigProfileName 'u
+.ta \w'LongName 'u
^Path:~^To determine the user's mail storage
.fi
+.SH HISTORY
+.B mmh
+is an experimental version of
+.BR nmh ,
+the New Mail Handler.
+Its name ``mmh'' stands primarily for ``meillo's MH'',
+but also for modern, minimalistic, and non-compatible Mail Handler.
+
.SH BUGS
-If problems are encountered with an
-.B nmh
-program, the problems should
-be reported to the local maintainers of
-.BR nmh .
-When doing this, the
-name of the program should be reported, along with the version information
-for the program.
-.br
-To find out what version of an
-.B nmh
-program is being run, invoke
-the program with the
+If you encounter problems with an
+.B mmh
+program, please report them.
+When doing this, include the version information, which you can obtain
+by invoking the program with the
.B \-version
-switch. This information includes
-the version of
-.BR nmh ,
-the host it was generated on, and the date the
-program was loaded.
+switch.
.PP
Send bug reports and suggestions to
+.IR "markus schnalke <meillo@marmaro.de>" ,
+or (as a fall-back) to
.IR nmh-workers@nongnu.org .
.SH "SEE ALSO"
mh-chart(1)
.\"
.\" %nmhwarning%
.\"
-.TH MMH %manext8% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH MMH %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
mmh \- initialize the mmh environment
.SH SYNOPSIS
.B mmh
user.
.PP
+.B (For an introduction to the mmh system, see mmh\-intro(7).)
+.PP
First, the mmh directory
.I $HOME/.mmh
is created.
The \fB\-c\fP option can be used to check whether or not mmh has
been installed. This can be used by other programs
without having knowledge about the internals of mmh.
-.PP
-.ft B
-Note: This man page describes the command mmh;
-for information about the mmh system, see mmh(7).
.SH "ENVIRONMENT VARIABLES"
.fc ^ ~
None
.SH "SEE ALSO"
-mmh(7)
+mmh\-intro(7)
.fi
.SH "SEE ALSO"
-rcvdist(1), rcvpack(1), rcvtty(1), mh\-sequence(5)
+rcvdist(1), rcvpack(1), rcvtty(1), mh\-sequence(7)
.SH DEFAULTS
.nf
.B refile
will also define
those sequences for the destination folders. See
-.B mh\-sequence (5)
+.B mh\-sequence (7)
for information concerning the previous sequence.
.SH BUGS
component.
.PP
Consult the
-.BR mh-draft (5)
+.BR mh-draft (7)
man page for more
information.
.PP
.I +folder
argument might be added in the future.)
Consult the
-.BR mh-draft (5)
+.BR mh-draft (7)
man page for more information.
.PP
Once the transport system has successfully accepted custody of the
.BR whatnow .
.PP
Consult the
-.BR mh-draft (5)
+.BR mh-draft (7)
man page for more
information.
.B nmh
draft folder facility. This is an advanced (and highly
useful) feature. Consult the
-.BR mh-draft (5)
+.BR mh-draft (7)
man page for more information.
.PP
The files specified by the profile entry \*(lqAliasfile:\*(rq and any
projects / mmh / commitdiff