diplodocus.org Git - nmh/blob - docs/historical/mh-jun-1982/man/folder.1

   1 .TH FOLDER 1 RAND
   2 .SH NAME
   3 folder, folders \- set/list current folder/message
   4 .SH SYNOPSIS
   5 \fBfolder\fR \%[+folder] \%[msg] \%[\fB\-all\fR]
   6 \%[\fB\-fast\fR] \%[\fB\-nofast\fR] \%[\fB\-up\fR] \%[\fB\-down\fR]
   7 \%[\fB\-header\fR] \%[\fB\-noheader\fR] \%[\fB\-total\fR]
   8 \%[\fB\-nototal\fR] \%[\fB\-pack\fR] \%[\fB\-nopack\fR]
   9 \%[\fB\-help\fR]
  10 .br
  11 \fBfolders\fR
  12 .SH DESCRIPTION
  13 Since the MH environment is the shell, it is easy to lose
  14 track of the current folder from day to day.
  15 \fIFolder\fR will
  16 list the current folder, the number of messages in it, the
  17 range of the messages (low-high), and the current message within
  18 the folder, and will flag a selection list or extra files if they
  19 exist.
  20 An example of the output is:
  21
  22       inbox+ has 16 messages ( 3\- 22); cur= 5.
  23
  24 If a `+folder' and/or `msg' are specified, they will
  25 become the current folder and/or message.
  26 An `\-all' switch
  27 will produce a line for each folder in the user's MH directory,
  28 sorted alphabetically.
  29 These folders are preceded by the read-only
  30 folders, which occur as \*.mh\(ruprofile ``cur\-'' entries.
  31 For example,
  32
  33 .nf
  34 .ta .5i 2.5i 3.6i
  35            Folder\ \    #\ of\ messages (\ range\ );\ cur msg (other files)
  36    /fsd/rs/m/tacc\ \ has        35\ messages    (1\-\035);\ cur=\ 23.
  37 /rnd/phyl/Mail/EP\ \ has        82\ messages    (       1\-108);\ cur=\ 82.
  38                ff\ \ has        4\ messages     (1\-\0\04);\ cur=\ \01.
  39             inbox+\ has 16\ messages    (3\-\022);\ cur=\ \05.
  40                mh\ \ has        76\ messages    (1\-\076);\ cur=\ 70.
  41             notes\ \ has        2\ messages     (1\-\0\02);\ cur=\ \01.
  42              ucom\ \ has        124\ messages   (1\-124);\ cur=\ \06; (select).
  43
  44         TOTAL=\0339\ messages\0in\0\07\0Folders.
  45 .re
  46 .fi
  47
  48 The ``+'' after inbox indicates that it is the current folder.
  49 The ``(select)'' indicates that the folder ucom has a selection
  50 list produced by \fIpick\fR.
  51 If ``others'' had appeared in parentheses at
  52 the right of a line, it would indicate that there are files in
  53 the folder directory that don't belong under the MH file naming
  54 scheme.
  55
  56 The header is output if either an `\-all' or a `\-header' switch
  57 is specified; it is suppressed by `\-noheader'.
  58 Also, if \fIfolder\fR
  59 is invoked by a name ending with ``s'' (e.g., \fIfolders\fR),
  60 `\-all' is assumed.
  61 A `\-total' switch will produce only the
  62 summary line.
  63
  64 If `\-fast' is given, only the folder name (or names in the
  65 case of `\-all') will be listed.
  66 (This is faster because the
  67 folders need not be read.)
  68
  69 The switches `\-up' and `\-down' change the folder to be the
  70 one above or below the current folder.
  71 That is, ``folder \-down''
  72 will set the folder to ``<current\-folder>/select'', and if the
  73 current folder is a selection-list folder, ``folder \-up'' will
  74 set the current folder to the parent of the selection-list.
  75 (See \fIpick(1)\fR for details on selection-lists.)
  76
  77 The `\-pack' switch will compress the message names in a folder, removing
  78 holes in message numbering.
  79 .SH FILES
  80 .ta 2.4i
  81 $HOME/\*.mh\(ruprofile  The user profile
  82 .br
  83 /bin/ls To fast-list the folders
  84 .SH PROFILE COMPONENTS
  85 Path:   To determine the user's MH directory
  86 .br
  87 Current-Folder: To find the default current folder
  88 .SH SEE ALSO
  89 pick(1)
  90 .SH DEFAULTS
  91 `+folder' defaults to the current folder
  92 .br
  93 `msg' defaults to none
  94 .br
  95 `\-nofast'
  96 .br
  97 `\-noheader'
  98 .br
  99 `\-nototal'
 100 .br
 101 `\-nopack'
 102 .SH CONTEXT
 103 If `+folder' and/or `msg' are given, they will become the
 104 current folder and/or message.