4.2BSD/usr/man/mann/file.n

.TH FILE 1 "3 August 1983"
.UC 4
.SH NAME
file \- file message(s) in (an)other folder(s)
.SH SYNOPSIS
file [ \-src +folder ] [ msgs ] [ \-link ] [ \-preserve ] +folder ...
[ \-nolink] [ \-nopreserve ]
[ \-file file ] [ \-nofile ] [ \-help ]
.SH DESCRIPTION
\fIFile\fR moves (\fImv\fR(1)) or links (\fIln\fR(1)) messages from a
source folder into one or more destination folders.
If you think
of a message as a sheet of paper, this operation is not
unlike filing the sheet of paper (or copies) in file cabinet
folders.
When a message is filed, it is linked into the
destination folder(s) if possible, and is copied otherwise.
As long
as the destination folders are all on the same file system, multiple filing
causes little storage overhead.
This facility provides a good way to cross-file or multiply-index
messages.
For example, if a message is received from Jones about
the ARPA Map Project, the command
.nf

     file\0cur\0+jones\0+Map

.fi
would allow the message to be found in either of the two
folders `jones' or `Map'.
.PP
The option `\-file file' directs \fIfile\fR to use the specified
file as the source message to be filed, rather than a message from
a folder.
.PP
If a destination folder doesn't exist, \fIfile\fR will ask if you
want to create one.
A negative response will abort the file
operation.
.PP
`\-link' preserves the source folder copy of the message
(i.e., it does a \fIln\fR(1) rather than a \fImv\fR(1)), whereas,
`\-nolink' deletes the \*(lqfiled\*(rq messages from the source
folder.
Normally, when a message is filed, it is assigned the
next highest number available in each of the destination folders.
Use of the `\-preserve' switch will override this message
\*(lqrenaming\*(rq, but name conflicts may occur, so
use this switch cautiously.
(See \fIpick\fR for more details on
message numbering.)
.PP
If `\-link' is not specified (or `\-nolink' is specified),
the filed messages will be removed (
.IR unlink (2))
from the source folder.
.PP
If `\-src +folder' is given, it will become the
current folder for future MH commands.
If neither `\-link' nor
`all' are specified, the current message in the source
folder will be set to the last message specified; otherwise, the
current message won't be changed.
.SH FILES
.nf
.ta \w'$HOME/\*.mh\(ruprofile    'u
$HOME/\*.mh\(ruprofile	The user profile
.fi
.SH "PROFILE COMPONENTS"
.nf
.ta \w'Folder\-Protect:    'u
Path:	To determine the user's MH directory
Current-Folder:	To find the default current folder
Folder\-Protect:	To set mode when creating a new folder
.fi
.SH DEFAULTS
.nf
`\-src +folder' defaults to the current folder
`msgs' defaults to cur
`\-nolink'
`\-nopreserve'
`\-nofile'
.fi
.SH CONTEXT
If `\-src +folder' is given, it will become the
current folder for future MH commands.
If neither `\-link' nor
`all' are specified, the current message in the source
folder will be set to the last message specified; otherwise, the
current message won't be changed.