X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/cbce5e434f84af560946e16709d3c2ad10eb8942..29db9a64a:/man/new.man?ds=sidebyside diff --git a/man/new.man b/man/new.man index fbb2ceee..d2c00046 100644 --- a/man/new.man +++ b/man/new.man @@ -1,9 +1,9 @@ -.TH NEW %manext1% "%nmhdate%" MH.6.8 [%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,31 +73,32 @@ 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 -.fc ^ ~ -.nf -.ta \w'%etcdir%/ExtraBigFileName 'u -^$HOME/\&.mh\(ruprofile~^The user profile -.fi +.TP 20 +$HOME/.mh_profile +The user 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 -^Unseen-Sequence:~^The name of the unseen message sequence -.fi +.PD 0 +.TP 20 +Path: +To determine the user's nmh directory. +.TP 20 +Current\-Folder: +To find the default current folder. +.TP 20 +Unseen-Sequence: +The name of the unseen message sequence. +.PD .SH "SEE ALSO" -scan(1), mh\-format(5) -.SH HISTORY -Based on Luke Mewburn's new (http://www.mewburn.net/luke/src/new). +.IR scan (1), +.IR mh\-format (5)