X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/d1cb667bddf8d1c5c0721fc7ab642c22946baf1f..94187a80bd60baab4b9c4b949ad820d730578123:/man/new.man diff --git a/man/new.man b/man/new.man index 7f93b9a3..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,30 +70,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" .IR scan (1), .IR mh\-format (5)