git.marmaro.de Git - mmh/blob - man/new.man

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