Ralph Corderoy [Tue, 18 Apr 2017 00:14:57 +0000 (01:14 +0100)]
man/*.man: Use italic for emphasis, not bold or SHOUTING.
When reading a body of text, italic is sufficient to add emphasis to
what's already being read. Bold draws the eye to the word on the page
and is more useful for keywords, concepts, etc. Some `.B' remain that
should probably be `.I', but they looked to have other problems so I
left them out of this pass.
Ralph Corderoy [Mon, 17 Apr 2017 23:24:07 +0000 (00:24 +0100)]
man/*.man: Replace minus sign with hyphen: `\-' with `-'.
Conservatively changed many of the troff minus-signs, `\-', with a troff
hyphen, `-'. Where it wasn't quickly obviously, I left it unchanged.
There were also cases that shouldn't be either minus sign or hyphen.
Those were changed to hyphen and still need to be fixed properly.
Ralph Corderoy [Mon, 17 Apr 2017 13:53:28 +0000 (14:53 +0100)]
Don't ignore bit 5 of a char when comparing alias names.
It's a crude method of ignoring case, but makes `^' equal to `~'.
Use tolower(3) instead.
http://lists.nongnu.org/archive/html/nmh-workers/2017-03/msg00050.html
Ralph Corderoy [Mon, 17 Apr 2017 10:42:39 +0000 (11:42 +0100)]
Change admonish(NULL, "foo") to inform("foo, continuing...").
Removes more uses of the ad... functions with unneeded parameters.
Puts the "continuing" at the call site rather than the reader having to
remember it's being magically appended. (Some calls were passing
"foo\n" that would result in "foo\n, continuing...\n" appearing.)
Ralph Corderoy [Mon, 17 Apr 2017 09:57:54 +0000 (10:57 +0100)]
Fix bug in advertise("", "", "foo", ap).
A non-NULL but empty `what' would result in "fooerrno\n" without
separation. Improve the function's comment to try and make it obvious
how its out of order parameters appear.
Ralph Corderoy [Sun, 16 Apr 2017 22:25:32 +0000 (23:25 +0100)]
man/*.man: Replace \(ru with an underscore, e.g. .mh_profile.
The character is an underscore, and that's what's wanted.
\(ru gives a "rule", which draws as a thick baseline in PDFs;
not a character at all.
Other devices map \(ru onto underscore, e.g. ASCII,
but an underscore should be used in the first place.
Ralph Corderoy [Sun, 16 Apr 2017 13:01:42 +0000 (14:01 +0100)]
Replace some strdup() with mh_xstrdup().
(This is an old patch I had stashed.)
Some surrounding `if...adios()' are removed too, but most of the
strdup() calls weren't being checked for success, thus their
replacement.
Ralph Corderoy [Sat, 15 Apr 2017 23:35:11 +0000 (00:35 +0100)]
Remove unneeded `\&' from man pages.
The zero-width character is used before a command character that is
intended to be literal but may end up at the start of a line.
Similarly, it's used after an end-of-sentence character when it may end
up at the end of the line but isn't the end of a sentence.
Remove the other cases because they're noise that confuses the issue of
when `\&' should be used.
Ralph Corderoy [Sat, 15 Apr 2017 18:17:31 +0000 (19:17 +0100)]
Fix errors in man-page NAME sections.
man/fmttest.man didn't have a NAME section, but a FMTTEST one.
And it broke lexgrog(1) by splitting the section over multiple lines and
using `.IR'. Re-write to use inline escapes.
man/rcvtty.man had two spaces before the `\-'.
Ralph Corderoy [Sat, 15 Apr 2017 13:25:12 +0000 (14:25 +0100)]
Fix forward-reference and `news.*' in mh-alias(5)'s example.
Spotted by Bob Carragher.
The example's forward reference was made a backward one, and `news.*'
explanation removed, in ff3060cefb460cce2174058eefff38b6e11ee2f1.
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.