X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/8e0f9bd3daae9d05dec58026d5a5924367e4e874..dcbbebd768c6444e2fbf83de2b3dc6c76b513a54:/man/new.man?ds=sidebyside diff --git a/man/new.man b/man/new.man index f21b51fb..d2c00046 100644 --- a/man/new.man +++ b/man/new.man @@ -1,9 +1,9 @@ -.TH NEW %manext1% "January 17, 2009" "%nmhversion%" -.\" +.TH NEW %manext1% 2009-01-17 "%nmhversion%" +. .\" %nmhwarning% -.\" +. .SH NAME -new \- report on folders with new messages +new \- report on nmh folders with new messages .PP fnext \- set current folder to next folder with new messages .PP @@ -14,13 +14,13 @@ unseen \- scan new messages in all folders with new messages .HP 5 .na .B new +.RB [ \-help ] +.RB [ \-version ] .RI [ sequences ] .RB [ \-mode .IR mode ] .RB [ \-folders .IR foldersfile ] -.RB [ \-version ] -.RB [ \-help ] .PP .HP 5 .B fnext @@ -38,14 +38,15 @@ is equivalent to .B new \-mode unseen .ad .SH DESCRIPTION -.B New -in its default mode produces a one\-line\-per\-folder listing of all -folders containing messages in the listed -.IR sequences -or in the sequences listed in the profile entry +.BR new , +in its default mode, produces a one-line-per-folder listing of all +folders which contain messages in the specified +.IR sequences , +or in the sequence(s) listed in the profile entry .RI \*(lq Unseen-Sequence \*(rq. -Each line contains the folder, the number of messages in the desired -sequences, and the message lists from the .mh_sequences file. For example: +Each line consists of the folder name, the total number of messages +in the specified sequences, and a list of messages derived from the +\&.mh_sequence file. For example: .PP .RS 5 .nf @@ -58,11 +59,11 @@ bar 380. 760\-772 824\-828 The `*' on foo indicates that it is the current folder. The last line shows the total number of messages in the desired sequences. .PP -.B New +.B new crawls the folder hierarchy recursively to find all folders, and prints them -in lexicographic order. Override this behavior by providing -.IR foldersfile -containing the pre-sorted list of folders +in lexicographic order. Override this behavior by providing a +.I foldersfile +containing the pre-sorted list of folders which .B new should check, one per line. .PP @@ -72,18 +73,19 @@ and .B fprev modes, .B new -instead changes to the next or previous matching folder, respectively. +changes to the next or previous matching folder, respectively. .PP In .B unseen mode, .B new executes -.B scan sequences +.B scan +.I sequences for each matching folder. .SH FILES .TP 20 -$HOME/\&.mh\(ruprofile +$HOME/.mh_profile The user profile .SH "PROFILE COMPONENTS" .PD 0