REFILE(1mh) REFILE(1mh) NAME refile - file message in nmh folders SYNOPSIS refile [-help] [-version] [msgs] [-draft] [-link | -nolink] [-preserve | -nopreserve] [-retainsequences | -noretainsequences] [-unlink | -nounlink] [-src +folder] [-file file] [-rmmproc program] [-normmproc] +folder1 ... DESCRIPTION refile moves (see mv(1)) or links (see ln(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 des- tination folders are all on the same file system, multiple filing causes little storage overhead. This facility provides a good way to cross-file or multiple-index messages. For example, if a message is received from Jones about the ARPA Map Project, the command refile cur +jones +Map would allow the message to be found in either of the two folders `jones' or `Map'. You may specify the source folder using -src +folder. If this is not given, the current folder is used by default. If no message is specified, then `cur' is used by default. The option -file file directs refile to use the specified file as the source message to be filed, rather than a message from a folder. Note that the file should be a validly for- matted message, just like any other nmh message. It should not be in mail drop format (to convert a file in mail drop format to a folder of nmh messages, see inc(1)). If a destination folder doesn't exist, refile will ask if you want to create it. A nega- tive response will abort the file operation. If the standard input for refile is not a tty, then refile will not ask any questions and will proceed as if the user answered "yes" to all questions. The option -link preserves the source folder copy of the message (i.e., it does an ln(1) rather than a mv(1)), whereas, -nolink (the default) deletes the filed messages from the source folder. Normally when a message is refiled, for each destination folder it is assigned the number which is one above the current highest message number in that folder. Use of the -pre- serve switch will override this message renaming, and try to preserve the number of the message. If a conflict for a particular folder occurs when using the -preserve switch, then refile will use the next available message number which is above the message number you wish to preserve. As message sequences are folder-specific, moving the message from the source folder re- moves it from all its sequences in that folder. -retainsequences adds it to those same sequences in the destination folder, creating any that don't exist. This adding does not apply for the "cur" sequence. If -link is not specified (or -nolink is specified), the filed messages will be removed from the source folder. The default is to remove these messages by renaming them with a site-dependent prefix (usually a comma). Such files will then need to be removed in some manner after a certain amount of time. Many sites arrange for cron to remove these files once a day, so check with your system administrator. Alternately, if you wish for refile to really remove the files representing these messages from the source folder, you can use the -unlink switch (not to be confused with the -link switch). But messages removed by this method cannot be later recovered. If you prefer a more sophisticated method of `removing' the messages from the source folder, you can define the rmmproc profile component. For example, you can add a profile component such as rmmproc: /home/coleman/bin/rmm_msgs then refile will instead call the named program or script to handle the message files. The user may specify -rmmproc program on the command line to override this profile speci- fication. The -normmproc option forces the message files to be deleted by renaming or un- linking them as described above. The -draft switch tells refile to file the <mh-dir>/draft. FILES $HOME/.mh_profile The user profile PROFILE COMPONENTS Path: To determine the user's nmh directory Current-Folder: To find the default current folder Folder-Protect: To set mode when creating a new folder rmmproc: Program to delete the message SEE ALSO folder(1), mh-sequence(5), rmf(1), rmm(1) DEFAULTS `-src +folder' defaults to the current folder `msgs' defaults to cur `-nolink' `-nounlink' `-nopreserve' `-noretainsequences' CONTEXT If -src +folder is given, it will become the current folder. If neither -link nor `all' is specified, the current message in the source folder will be set to the last message specified; otherwise, the current message won't be changed. If the "Previous-Sequence" profile entry is set, in addition to defining the named se- quences from the source folder, refile will also define those sequences for the destina- tion folders. See mh-sequence(5) for information concerning the previous sequence. BUGS Since refile and rmm use your rmmproc to delete the message, the rmmproc must not call re- file or rmm without specifying -normmproc, or you will create an infinite loop. nmh-1.7.1 2013-03-19 REFILE(1mh)
Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2024-12-12 19:53 @18.188.161.29 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)