BSD 4_2 development

Work on file usr/src/new/new/mh/man/file.1

Synthesized-from: CSRG/cd1/4.2

diff --git a/usr/src/new/new/mh/man/file.1 b/usr/src/new/new/mh/man/file.1
new file mode 100644 (file)
index 0000000..74c7441
--- /dev/null
+++ b/usr/src/new/new/mh/man/file.1
@@ -0,0 +1,91 @@
+.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.