diplodocus.org Git - nmh/blob - man/new.man

   1 .TH NEW %manext1% 2009-01-17 "%nmhversion%"
   2 .
   3 .\" %nmhwarning%
   4 .
   5 .SH NAME
   6 new \- report on nmh folders with new messages
   7 .PP
   8 fnext \- set current folder to next folder with new messages
   9 .PP
  10 fprev \- set current folder to previous folder with new messages
  11 .PP
  12 unseen \- scan new messages in all folders with new messages
  13 .SH SYNOPSIS
  14 .HP 5
  15 .na
  16 .B new
  17 .RB [ \-help ]
  18 .RB [ \-version ]
  19 .RI [ sequences ]
  20 .RB [ \-mode
  21 .IR mode ]
  22 .RB [ \-folders
  23 .IR foldersfile ]
  24 .PP
  25 .HP 5
  26 .B fnext
  27 is equivalent to
  28 .B new \-mode fnext
  29 .PP
  30 .HP 5
  31 .B fprev
  32 is equivalent to
  33 .B new \-mode fprev
  34 .PP
  35 .HP 5
  36 .B unseen
  37 is equivalent to
  38 .B new \-mode unseen
  39 .ad
  40 .SH DESCRIPTION
  41 .BR new ,
  42 in its default mode, produces a one-line-per-folder listing of all
  43 folders which contain messages in the specified
  44 .IR sequences ,
  45 or in the sequence(s) listed in the profile entry
  46 .RI \*(lq Unseen-Sequence \*(rq.
  47 Each line consists of the folder name, the total number of messages
  48 in the specified sequences, and a list of messages derived from the
  49 \&.mh_sequence file.  For example:
  50 .PP
  51 .RS 5
  52 .nf
  53 foo     11.* 40\-50
  54 bar    380.  760\-772 824\-828
  55  total    391.
  56 .fi
  57 .RE
  58 .PP
  59 The `*' on foo indicates that it is the current folder.  The last line shows
  60 the total number of messages in the desired sequences.
  61 .PP
  62 .B new
  63 crawls the folder hierarchy recursively to find all folders, and prints them
  64 in lexicographic order.  Override this behavior by providing a
  65 .I foldersfile
  66 containing the pre-sorted list of folders which
  67 .B new
  68 should check, one per line.
  69 .PP
  70 In
  71 .B fnext
  72 and
  73 .B fprev
  74 modes,
  75 .B new
  76 changes to the next or previous matching folder, respectively.
  77 .PP
  78 In
  79 .B unseen
  80 mode,
  81 .B new
  82 executes
  83 .B scan
  84 .I sequences
  85 for each matching folder.
  86 .SH FILES
  87 .TP 20
  88 $HOME/.mh_profile
  89 The user profile
  90 .SH "PROFILE COMPONENTS"
  91 .PD 0
  92 .TP 20
  93 Path:
  94 To determine the user's nmh directory.
  95 .TP 20
  96 Current\-Folder:
  97 To find the default current folder.
  98 .TP 20
  99 Unseen-Sequence:
 100 The name of the unseen message sequence.
 101 .PD
 102 .SH "SEE ALSO"
 103 .IR scan (1),
 104 .IR mh\-format (5)