X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=docs%2FREADME.manpages;h=0d435eff3df8b442ba15367a1f3db41901e0584b;hp=84275e946b58c18193631cff508d9f7ba8745b17;hb=1fb6287fc4986668e8f49d7c3bdca27d53e267af;hpb=5459cb05a6f5bba960e6501b9f03d7e16bc54f41 diff --git a/docs/README.manpages b/docs/README.manpages index 84275e9..0d435ef 100644 --- a/docs/README.manpages +++ b/docs/README.manpages @@ -4,20 +4,19 @@ nmh manpages should be in this general form: .\" .\" %nmhwarning% -.\" $Id$ .\" .TH COMP %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] .SH NAME comp \- compose a message .SH SYNOPSIS .HP 5 -.B comp +.B comp .RI [ +folder ] .RI [ msgs ] .RB [ \-form .IR formfile ] .RB [ \-use " | " \-nouse ] -.RB [ \-version ] +.RB [ \-Version ] .RB [ \-help ] .SH DESCRIPTION .B Comp @@ -70,8 +69,8 @@ Source files .PP Of course, replace "components" with a unique identifier that - reflects the content being included, like "mts_conf" for - etc/mts.conf. Then, add two lines to the man.sed target in + reflects the content being included, like "mhl_reply" for + etc/mhl.reply. Then, add two lines to the man.sed target in Makefile.in like: echo '/%components%/r $(top_srcdir)/etc/components' >> $@ @@ -106,7 +105,7 @@ SYNPOSIS section .RI [ +folder ] <---- parameter .RI [ msgs ] <---- parameter - .RB [ \-version ] <---- flag + .RB [ \-Version ] <---- flag .RB [ \-editor <---- flag with .IR editor ] parameter .RB [ \-use " | " \-nouse ] <---- exclusive parameters @@ -157,17 +156,26 @@ Other italicized text Italicize file names, profile entries, and folder names: If a file named - .RI \*(lq components \*(rq + .RI ` components ' exists in the user's nmh directory, If the user's profile contains a - .RI \*(lq "Msg\-Protect: nnn" \*(rq + .RI ` "Msg\-Protect: nnn" ' entry, it - The \*(lq+\*(rq after + The `+' after .I inbox indicates that it is the current folder. Enclose the file names and profile entries in lq/rq quotes, too. +Pointer manpages + + Certain manpages are shared between one or more programs + (such as folder/folders). The secondary program should + have a man page that only contains: + + .so man1/folder.1 + + Also, add this manpage to the appropriate section in Makefile.in