Larry Hynes [Fri, 24 Mar 2017 23:02:00 +0000 (23:02 +0000)]
Editing of man/repl.com.
- unashamedly add nmh to .SH NAME
- replace the delightfully baroque 'may be used to produce a reply
to an existing message' with 'may be used to reply to a message'.
- remove some \- objects
- deflower 'repl uses a reply template to guide its actions'
- remove multiple instances of 'replied\-to', with 'replied to'
- change 'tab\-stop' to 'tab stop'
- some formatting
- replace .B mhbuild with .IR mhbuild (1)
- replace whatnow with .B whatnow
Larry Hynes [Fri, 24 Mar 2017 01:19:47 +0000 (01:19 +0000)]
Editing of man/rcvtty.man.
- Add missing 'command'
- Some formatting
- Remove a \-, the mark that dare not speak its name
- Use 'switches' instead of 'options'
- Sort SEE ALSO programs
Larry Hynes [Fri, 24 Mar 2017 00:54:05 +0000 (00:54 +0000)]
Editing of man/mhfixmsg.man.
- 8bit -> 8-bit, nbit -> n-bit, except in flags and error msgs
- Add nmh to .SH NAME
- Formatting
- use .B for -outfile
- use .IR for mh-profile (5)
- sort SEE ALSO programs
Larry Hynes [Thu, 23 Mar 2017 22:08:44 +0000 (22:08 +0000)]
Editing of man/mhshow.man.
- Add some stray s's
- Some formatting
- Remove an \- object (I now pronounce \- as uh-unh; it's easier this way)
- Use alternative instead of alternate
Larry Hynes [Thu, 23 Mar 2017 17:31:12 +0000 (17:31 +0000)]
Editing of man/mhl.man.
- Refer to environment variables (in text) without preceding $
- Don't put environment variables in bold (as per most other pages)
- Some better formatting
Larry Hynes [Thu, 23 Mar 2017 17:05:26 +0000 (17:05 +0000)]
Editing of man/mhical.man.
- Don't use capitalised .SH, when uncapitalised .SS will do
- Remove some early .SH/.SS to improve narrative
- Delete superfluous .fi
It could be argued that each of the (now) .SSs, which have been
demoted from .SHs, are unnecessary or, at least, not in line with
the other man pages . Demotion may suffice, for now.
Larry Hynes [Wed, 22 Mar 2017 22:57:13 +0000 (22:57 +0000)]
Editing of man/mh-mime.man.
- Clean up .SH NAME to one line without .IR nmh (7) on it
- Don't use escaped hyphens when not necessary
- Clean up some formatting
- Use 'Attach:' consistently (instead of 'Attach')
Ralph Corderoy [Wed, 22 Mar 2017 14:47:18 +0000 (14:47 +0000)]
Fix free(3) of unmalloc()'d string in whatnow's refile.
`ref +foo' at comp(1)'s whatnow prompt was trying to free "+foo".
Take a copy of the string so the later free works.
Tom Rodman reported the problem to nmh-workers.
Bug introduced in 3b6be5607a251a3a793e97382e251ce66ea2bca0.
Ken Hornstein [Sun, 19 Feb 2017 22:05:12 +0000 (17:05 -0500)]
Change "servers" mts.conf entry to only support a single SMTP server.
As part of this change, fix SMTP code so the chosen SMTP server is
configured correctly for the netsec code.
Ralph Corderoy [Tue, 17 Jan 2017 12:54:02 +0000 (12:54 +0000)]
mhfixmsg: Use folder name to open second message of a sequence.
`mhfixmsg foo' where foo was sequence of more than one message would
sucessfully process the lowest numbered message of the sequence, but
fail to open(2) the second one as the folder was missing from the path.
For example, /home/ralph/mail/inbox/1 was used to open the first, but
/home/ralph/mail/2 was attempted for the second. I guess this was
because a static array was being trampled during the first's processing,
though didn't try too hard to find where. Making a copy of it fixed the
problem.
Larry Hynes [Sat, 31 Dec 2016 17:57:13 +0000 (17:57 +0000)]
Changes to install-mh.man
Some more simple wordsmithing...
Change instances of 'Install-mh' to 'install-mh', in line with
other pages, switch to single `' around 'Mail', in line with
other pages, option -> switch, clean up a little.
Larry Hynes [Sat, 31 Dec 2016 15:57:42 +0000 (15:57 +0000)]
A cleanup, and possibly some controversy: I've replaced
Rather than standard message skeleton
with
User message skeleton
My thinking here is that a) we can do away with the kinda weird
'Rather than', b) I find the distinction between 'default' and
'standard' to be vague and c) it only appears in a few pages
and is easily remedied. It turns up in comp(1) as "An alternative
to the standard skeleton.", where 'standard' is used in the same
way as 'default' is used in rcvdist(1), so I think it's worth
settling on something 'better' and applying it consistently.
My proposal is 'Default foo', for the foo in %nmhetcdir% and
'User foo' for the foo in the user's <mh-dir>.
Larry Hynes [Sat, 31 Dec 2016 15:54:55 +0000 (15:54 +0000)]
Fix skeletons in comp(1), forw(1) and dist(1)
While I was here, I removed two 'empty' paragraphs (.PP) in forw(1).
They may have been intended as line breaks, but I think they are
unnecessary; feel free to overrule me!
Aside: I would not be unhappy if, some day, 'skeleton' was replaced by
something utilitarian like 'template'.
Larry Hynes [Mon, 19 Dec 2016 01:17:10 +0000 (01:17 +0000)]
Changes to mh-format.man
This is a beast, and we may not tame it at the first attempt.
Mostly language simplification, some grammar and formatting, trailing
whitespace, that sort of thing. There are one or two instances where
I've taken (small) liberties with language, in favour of 'comprehension
at first glance'.
There are some commented lines hanging around in this. I've left
them in, but I think they should go at the first opportunity.
Larry Hynes [Fri, 16 Dec 2016 22:55:39 +0000 (22:55 +0000)]
Changes to comp.man
Remove the slightly legalistic 'in truth of fact', and bring the
mention of man whatnow into the preceding sentence.
The line 'If the draft already exists, comp will ask you as to the
disposition of the draft.' makes no sense to me, and I'm struggling
to make it make sense. If we put to one side the fact that I think
it's a broken sentence, I still haven't managed to get comp to
accept - or prompt me for - a 'replace' option when 'the draft
already exists', so I'm afraid I have to admit defeat here and seek
the wisdom of the elders.
David Levine [Thu, 15 Dec 2016 22:44:56 +0000 (17:44 -0500)]
Added clarifications to abbreviations.
1) N must be a positive number.
2) The + can be omitted.
3) As many of the N messages that exist.
4) Can also use - (or +) with first, prev, next, and last.
Larry Hynes [Thu, 15 Dec 2016 18:33:15 +0000 (18:33 +0000)]
Changes to nmh.man
This adds a reference to the 'COMMANDS' section, corrects - and
hopefully simplifies - a couple of things, and tries to untangle
the line beginning 'show displays...' in the seventh paragraph.
The line 'The first, previous, next or last messages, if they exist.'
doesn't seem to accurately cover the accompanying 'foo:N' listing
in the following, or am I missing something?
first:N
prev:N
next:N
last:N The first, previous, next or last messages, if they exist.