From 85efd688c798fc782567d3f9c283064a01d5c9fe Mon Sep 17 00:00:00 2001 From: markus schnalke Date: Wed, 11 Apr 2012 15:18:39 +0200 Subject: [PATCH] Man page mhbuild(1): Tried to make the structure more clear through markup. --- man/mhbuild.man1 | 25 ++++++++++++++----------- 1 file changed, 14 insertions(+), 11 deletions(-) diff --git a/man/mhbuild.man1 b/man/mhbuild.man1 index 3d3260f..db44f02 100644 --- a/man/mhbuild.man1 +++ b/man/mhbuild.man1 @@ -115,14 +115,14 @@ than one line, e.g., .fi .RE .PP -There are four kinds of directives: \*(lqtype\*(rq directives, which -name the type and subtype of the content; \*(lqexternal-type\*(rq -directives, which also name the type and subtype of the content; the -\*(lqmessage\*(rq directive (#forw), which is used to forward one or -more messages; and, the \*(lqbegin\*(rq directive (#begin), which is -used to create a multipart content. -.PP -The \*(lqtype\*(rq directive is used to directly specify the type and +There are four kinds of directives: +\*(lqtype\*(rq, +\*(lqexternal-type\*(rq, +\*(lqmessage\*(rq (#forw), +and \*(lqbegin\*(rq (#begin). +.PP +.B "(1) The \*(lqtype\*(rq directive +is used to directly specify the type and subtype of a content. You may only specify discrete types in this manner (can't specify the types multipart or message with this directive). You may optionally specify the name of a file containing the contents @@ -198,7 +198,8 @@ contents should probably be put in the file specified by the environment variable, instead of directly in your user profile. .PP -The \*(lqexternal-type\*(rq directives are used to provide a MIME +.B "(2) The \*(lqexternal-type\*(rq directives +are used to provide a MIME reference to a content, rather than enclosing the contents itself (for instance, by specifying an ftp site). Hence, instead of providing a filename as with the type directives, external-parameters @@ -245,7 +246,8 @@ body= command to send for retrieval .fi .RE .PP -The \*(lqmessage\*(rq directive (#forw) is used to specify a message or +.B "(3) The \*(lqmessage\*(rq directive (#forw) +is used to specify a message or group of messages to include. You may optionally specify the name of the folder and which messages are to be forwarded. If a folder is not given, it defaults to the current folder. Similarly, if a message is not @@ -283,7 +285,8 @@ do not contain encapsulated messages themselves. The drawback of this approach is that the encapsulations are generated by placing an extra newline at the end of the body of each message. .PP -The \*(lqbegin\*(rq directive is used to create a multipart content. +.B "(4) The \*(lqbegin\*(rq directive +is used to create a multipart content. When using the \*(lqbegin\*(rq directive, you must specify at least one content between the begin and end pairs. .PP -- 1.7.10.4