X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/8e0f9bd3daae9d05dec58026d5a5924367e4e874..9291a5f82480f2458e04cb9ea7e6749bc952b308:/man/new.man diff --git a/man/new.man b/man/new.man index f21b51fb..b059d22d 100644 --- a/man/new.man +++ b/man/new.man @@ -1,51 +1,49 @@ -.TH NEW %manext1% "January 17, 2009" "%nmhversion%" -.\" +.TH NEW %manext1% 2009-01-17 "%nmhversion%" +. .\" %nmhwarning% -.\" +. .SH NAME -new \- report on folders with new messages -.PP -fnext \- set current folder to next folder with new messages -.PP -fprev \- set current folder to previous folder with new messages -.PP -unseen \- scan new messages in all folders with new messages +new \- report on nmh folders with new messages +.br +fnext \- set current nmh folder to next folder with new messages +.br +fprev \- set current nmh folder to previous folder with new messages +.br +unseen \- scan any new messages in all nmh folders .SH SYNOPSIS .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 is equivalent to .B new \-mode fnext -.PP .HP 5 .B fprev is equivalent to .B new \-mode fprev -.PP .HP 5 .B unseen 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 +56,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 +70,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