X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/7480dbc14bc90f2d872d434205c0784704213252..edccf71caebd3979a2eef7993624ccc7dbf0691a:/man/anno.man diff --git a/man/anno.man b/man/anno.man index b626e2a4..311e1090 100644 --- a/man/anno.man +++ b/man/anno.man @@ -1,8 +1,7 @@ +.TH ANNO %manext1% "December 7, 2005" "%nmhversion%" .\" .\" %nmhwarning% -.\" $Id$ .\" -.TH ANNO %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] .SH NAME anno \- annotate messages .SH SYNOPSIS @@ -20,7 +19,8 @@ anno \- annotate messages .RB [ \-list ] .RB [ \-delete ] .RB [ \-number -.IR [ num ]] +.IR [ num|all ]] +.RB [ \-preserve " | " \-nopreserve ] .RB [ \-version ] .RB [ \-help ] .RB [ \-text @@ -32,7 +32,7 @@ manipulates header fields or .I annotations in messages. Header fields consist of a field name and an optional field body -as defined by RFC-2822. +as defined by RFC 2822. The .B -component option specifies the field name, and the @@ -84,8 +84,8 @@ is invoked, .B anno will prompt the user for the name of field for the annotation. .PP -The field specified must be a valid 2822-style message field name, -which means that it may only consist of alphanumerics and dashes, +The field specified must be a valid RFC 2822-style message field name, +which means that it may only consist of alphanumerics and dashes. The body specified is arbitrary text. .PP Normally @@ -133,33 +133,53 @@ whose name matches the component is deleted. The number matches that which is produced by the .B -list option. +The special value +.B all +can be used for the number, and causes all components that match the +name to be deleted. +.PP +By default, +.B anno +changes the last-accessed and last-modified times on annotate messages +to the time at which the annotation occurs. +.B Anno +preserves the original times if the +.B -preserve +option is used. +A matching +.B -nopreserve +option exists that allows time preservation to be turned off if enabled +in the profile. .SH FILES -.fc ^ ~ -.nf -.ta \w'%etcdir%/ExtraBigFileName 'u -^$HOME/\&.mh\(ruprofile~^The user profile -.fi - +.TP 20 +$HOME/\&.mh\(ruprofile +The user's profile. .SH "PROFILE COMPONENTS" -.fc ^ ~ -.nf -.ta 2.4i -.ta \w'ExtraBigProfileName 'u -^Path:~^To determine the user's nmh directory -^Current\-Folder:~^To find the default current folder -.fi - +.PD 0 +.TP 20 +Path: +To determine the user's nmh directory. +.TP +Current\-Folder: +To find the default current folder. +.PD .SH "SEE ALSO" -dist(1), forw(1), repl(1) - +.IR dist (1), +.IR forw (1), +.IR repl (1) .SH DEFAULTS -.nf -.RI ` +folder "' defaults to the current folder" -.RI ` msgs "' defaults to cur" -.RB ` \-inplace ' -.RB ` \-date ' -.fi - +.PD 0 +.TP 20 ++folder +The current folder. +.TP +msgs +The current message. +.TP +-inplace +.TP +-date +.PD .SH CONTEXT If a folder is given, it will become the current folder. The first message annotated will become the current message.