X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fanno.man1;h=21ba903e2f5f29dd16b966588bc268050cfc2620;hp=e35899e6975bb353d7f85acfa045e07f5833cfc4;hb=6e9577f324bef90765a5edc02044eb111ec48072;hpb=d54c8db8bdf01e8381890f7729bc0ef4a055ea11 diff --git a/man/anno.man1 b/man/anno.man1 index e35899e..21ba903 100644 --- a/man/anno.man1 +++ b/man/anno.man1 @@ -17,7 +17,7 @@ anno \- annotate messages .RB [ \-append ] .RB [ \-date " | " \-nodate ] .RB [ \-preserve " | " \-nopreserve ] -.RB [ \-version ] +.RB [ \-Version ] .RB [ \-help ] .HP .B anno @@ -31,7 +31,7 @@ anno \- annotate messages .RB [ \-number .IR num " | all ] .RB [ \-preserve " | " \-nopreserve ] -.RB [ \-version ] +.RB [ \-Version ] .RB [ \-help ] .HP .B anno @@ -41,7 +41,7 @@ anno \- annotate messages .RB [ \-component .IR field ] .RB [ \-number ] -.RB [ \-version ] +.RB [ \-Version ] .RB [ \-help ] .ad .SH DESCRIPTION @@ -73,7 +73,6 @@ manually, you can perform arbitrary annotations of your own. .PP .B Anno has three operation modes: Adding, deleting and listing of header lines. - .SS "Add mode .PP This is the default mode. @@ -90,17 +89,17 @@ field:\ body .PP The .B \-component -option specifies the field name. +switch specifies the field name. If no .B \-component .I field is specified, .B anno -will prompt the user for the name of field for the annotation. +will prompt the user for a field name. .PP The .B \-text -option specifies the field body. +switch specifies the field body. If it is missing, only the date annotation will be added. The .B \-nodate @@ -112,21 +111,20 @@ By default, prepends the annotations to the message. Annotations are instead appended if the .B \-append -option is specified. +switch is specified. .PP .B Anno -always does the annotation inplace in order to preserve +always does the annotation in place in order to preserve any links to the message. .PP By default, .B anno -changes the last-accessed and last-modified times on annotate messages -to the time at which the annotation occurs. +changes the last-accessed and last-modified times on annotated messages +to the time of the annotation. .B Anno preserves the original times if the .B \-preserve -option is used. - +switch is used. .SS "Delete mode .PP The @@ -137,7 +135,7 @@ is deleted. .PP The .B \-component -option specifies the field name of headers to delete. +switch specifies the field name of headers to delete. If no .B \-component .I field @@ -147,7 +145,7 @@ will prompt the user for the name. .PP If the .B \-text -option is used, +switch is used, the first header field whose name matches the component and whose body matches the text is deleted. The text is treated as if it was a path name; if it begins with a @@ -156,7 +154,7 @@ last path name component of the field body must match. .PP If the .B \-number -option is used, +switch is used, the .IR n th header field whose name matches the component is deleted. @@ -171,35 +169,33 @@ Either or .B \-number may be specified, but not both at the same time. - .SS "List mode .PP The .B \-list mode produces a listing of the field bodies for header fields with matching component names, one per line. +Trailing whitespace in the field body does not get printed. If the .B \-number -option is also used, +switch is also used, the listing is numbered, starting at 1. .PP The .B \-component -option specifies the field name of headers to list. +switch specifies the field name of headers to list. If no .B \-component .I field is specified, .B anno will prompt the user for the name. - .SH FILES .fc ^ ~ .nf .ta \w'%etcdir%/ExtraBigFileName 'u ^$HOME/.mmh/profile~^The user profile .fi - .SH "PROFILE COMPONENTS" .fc ^ ~ .nf @@ -208,22 +204,18 @@ will prompt the user for the name. ^Path:~^To determine the user's mail storage ^Current\-Folder:~^To find the default current folder .fi - .SH "SEE ALSO" dist(1), forw(1), repl(1) - .SH DEFAULTS .nf .RI ` +folder "' defaults to the current folder" -.RI ` msgs "' defaults to cur" +.RI ` msgs "' defaults to the current message" .RB ` \-date ' .RB ` \-nopreserve ' .fi - .SH CONTEXT If a folder is given, it will become the current folder. The first message annotated will become the current message. - .SH BUGS .PP The