From: David Levine Date: Sun, 16 Mar 2014 15:15:41 +0000 (-0500) Subject: Moved "mhparam iconv" description to mhparam(1) man page and put X-Git-Url: https://diplodocus.org/git/nmh/commitdiff_plain/fc18ad68f85f29c016667b7bf54d7e4b2f3b42c5?ds=sidebyside Moved "mhparam iconv" description to mhparam(1) man page and put references to it in mh-mime(7), mhfixmsg(1), and mhshow(1) man pages. Updated mhparam man page description of other configuration parameters. Added "Message Rewrite" section to mh-mime page. --- diff --git a/man/mh-mime.man b/man/mh-mime.man index a7d813d2..abc3c22d 100644 --- a/man/mh-mime.man +++ b/man/mh-mime.man @@ -1,4 +1,4 @@ -.TH MH\-MIME %manext7% " March 13, 2014" "%nmhversion%" +.TH MH\-MIME %manext7% "March 16, 2014" "%nmhversion%" .\" .\" %nmhwarning% .\" @@ -12,7 +12,7 @@ The acronym MIME stands for Multipurpose Internet Mail Extensions, the format of Internet messages used to send multi\-media content. The .B nmh -command suite has support for the display and composition of MIME messages, but +command suite has support for the display and composition of MIME messages, but currently MIME support is not completely integrated into all tools. This document provides an overview as to which tools support MIME message display, storage, and composition. @@ -28,27 +28,13 @@ local character set. Character set conversion will only take place if .B nmh was built with .IR iconv (3) -support. You can check the status of -.IR iconv (3) -support in -.B nmh -by executing the command -.PP -.RS 5 -.nf -mhparam\0iconv -.fi -.RE -.PP -If it returns -.IR iconv , -then +support. See the +.IR mhparam (1) +man page for how determine whether your .B nmh -is built with +installation includes .IR iconv (3) -support. If it is blank, then -.IR iconv (3) -support is not included. +support. .PP Depending on the source and target character set, it may not be possible to convert all characters to the local character set. In this case a @@ -166,16 +152,30 @@ to be included in a message reply. See the comments at the top of for instructions on how to configure .B nmh to work with it. +.SS +Message Rewrite +The +.IR mhfixmsg (1) +command can apply various transformations to MIME messages, including +decoding of text parts, converting the character set of text parts, +and insertion of text/plain parts to correspond to text parts of other +subtypes. +.I mhfixmsg +can also repair defects in MIME messages, such as mismatched top-level +boundary indicators and invalid Content-Transfer-Encoding values. .SH "SEE ALSO" -.IR nmh (7), -.IR mhbuild (1), .IR comp (1), +.IR iconv (3), +.IR mh\-format (5) +.IR mhbuild (1), +.IR mhfixmsg (1), +.IR mhparam (1), +.IR nmh (7), .IR repl (1), .IR whatnow (1), -.IR mh\-format (5) .PP .I %docdir%/contrib/replyfilter .SH BUGS -MIME support should be more integrated into all of the +MIME support should be more integrated into all of the .B nmh tools than it currently is. diff --git a/man/mhfixmsg.man b/man/mhfixmsg.man index ea342330..7209f740 100644 --- a/man/mhfixmsg.man +++ b/man/mhfixmsg.man @@ -1,4 +1,4 @@ -.TH MHFIXMSG %manext1% "February 8, 2014" "%nmhversion%" +.TH MHFIXMSG %manext1% "March 16, 2014" "%nmhversion%" .\" .\" %nmhwarning% .\" @@ -76,7 +76,12 @@ should be converted to Charset conversions require that .B nmh be built with -.IR iconv (3). +.IR iconv (3); +see the +.BR mhparam (1) +man page for how determine whether your +.B nmh +installation includes that. To convert text parts other than text/plain, an external program can be used, via the .B \-reformat @@ -325,6 +330,7 @@ is checked. .IR mh-profile (5), .IR mhbuild (1), .IR mhlist (1), +.IR mhparam (1), .IR mhshow (1), .IR mkstemp (3), .IR procmail (1), diff --git a/man/mhparam.man b/man/mhparam.man index bf7c40a3..467f5b59 100644 --- a/man/mhparam.man +++ b/man/mhparam.man @@ -1,4 +1,4 @@ -.TH MHPARAM %manext1% "February 26, 2014" "%nmhversion%" +.TH MHPARAM %manext1% "March 16, 2014" "%nmhversion%" .\" .\" %nmhwarning% .\" @@ -45,16 +45,37 @@ is specified, then all components in the nmh profile are displayed and other arguments are ignored. .PP .BR mhparam -can provide other information, such as -the locations of the nmh +can provide other information, such as the +.B nmh +version identifier, the locations of the nmh .I etcdir and .I libdir install directories, all .I proc -settings, and the default locking method with which the +settings, and the +.I datalocking +method described in the +.IR mh_profile (5) +man page. Information about the configuration of the .B nmh -installation was configured. The +installation is also available, including the default mail spool +locking method. To test whether the configuration includes +support for SASL, TLS, and +.IR iconv (3), +the following commands, respectively, will output a non-null string to +indicate support: +.PP +.RS 5 +.nf +mhparam\0sasl +mhparam\0tls +mhparam\0iconv +.fi +.RE +.PP +Conversely, no output means that the specified support is not included. +The .B \-debug switch displays all such other information available from .BR mhparam . @@ -85,17 +106,29 @@ rmmproc Path: Mail context: context +% mhparam version +%nmhversion% + % mhparam etcdir %etcdir% % mhparam libdir %libdir% +% mhparam spoollocking +%default_locking% + % mhparam datalocking fcntl -% mhparam spoollocking -flock +% mhparam sasl +cyrus_sasl + +% mhparam tls +tls + +% mhparam iconv +iconv .fi .RE .PP @@ -112,7 +145,7 @@ returns the number of components that were not found. .SH FILES .fc ^ ~ .nf -.ta \w'%etcdir%/ExtraBigFileName 'u +.ta \w'ExtraBigProfileName 'u ^$HOME/.mh_profile~^The user profile ^or $MH~^Rather than the standard profile ^/context~^The user context diff --git a/man/mhshow.man b/man/mhshow.man index 8505d7e1..91f68054 100644 --- a/man/mhshow.man +++ b/man/mhshow.man @@ -1,4 +1,4 @@ -.TH MHSHOW %manext1% "February 18, 2014" "%nmhversion%" +.TH MHSHOW %manext1% "March 16, 2014" "%nmhversion%" .\" .\" %nmhwarning% .\" @@ -346,7 +346,13 @@ If was built with .IR iconv (3), then all text/plain parts of the message(s) will be displayed using -the character set of the current locale. To convert text parts other +the character set of the current locale. See the +.BR mhparam (1) +man page for how determine whether your +.B nmh +installation includes +.IR iconv (3) +support. To convert text parts other than text/plain, or if .B mhshow was not built with @@ -630,6 +636,7 @@ is checked. .IR mhbuild (1), .IR mhl (1), .IR mhlist (1), +.IR mhparam (1), .IR mhstore (1), .IR sendfiles (1) .SH DEFAULTS