FOLDER (1)

SYNOPSIS

+.5i

folder \%[+folder] \%[msg] \%[-all] \%[-noall] \%[-create] \%[-nocreate] \%[-fast] \%[-nofast] \%[-header] \%[-noheader] \%[-recurse] \%[-norecurse] \%[-total] \%[-nototal] \%[-list] \%[-nolist] \%[-push] \%[-pop] \%[-pack] \%[-nopack] \%[-print] \%[-verbose] \%[-noverbose] \%[-version] \%[-help]

folders is equivalent to folder -all -.5i

DESCRIPTION

Since the nmh environment is the shell, it is easy to lose track of the current folder from day to day. When folder is given the `-print' switch (the default), folder will list the current folder, the number of messages in it, the range of the messages (low-high), and the current message within the folder, and will flag extra files if they exist. An example of this summary is:

t .in +.5i
\w'/rnd/phyl/Mail/EP 'u +\w'has ddd messages 'u +\w'(ddd-ddd); 'u
inbox+  has \016 messages       (\0\03-\022);  cur=\0\05.

t .in -.5i

If a `+folder' and/or `msg' are specified, they will become the current folder and/or message. By comparison, when a `+folder' argument is given, this corresponds to a \*(lqcd\*(rq operation in the shell; when no `+folder' argument is given, this corresponds roughly to a \*(lqpwd\*(rq operation in the shell.

If the specified (or default) folder doesn't exist, the default action is to query the user as to whether the folder should be created; when standard input is not a tty, the answer to the query is assumed to be \*(lqyes\*(rq.

Specifying `-create' will cause folder to create new folders without any query. (This is the easy way to create an empty folder for use later.) Specifying `-nocreate' will cause folder to exit without creating a non-existant folder.