unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



refile(1)							    refile(1)



NAME

  refile - file	message	in other folders (only available within	the message
  handling system, mh)

SYNOPSIS

  refile [msgs]	[+folder] [options]

OPTIONS

  -draft
      Refiles the draft	message, or the	current	message	in your	+drafts
      folder, if you have one set up. You cannot give a	msgs argument when
      you use this option.

  -file	filename
      Moves a file into	a folder. This option takes a file from	its directory
      and places it in the named folder, as the	next message in	the folder.
      The file must be formatted as a legal mail message. This means that the
      message must have	the minimum header fields separated from the body of
      the message by a blank line or a line of dashes.

  -help
      Prints a list of the valid options to this command.

  -link

  -nolink
      Keeps a copy of the message in the source	folder.	Normally, refile
      removes the messages from	the original folder when it refiles them. The
      -link option keeps a copy	in the original	folder,	as well	as filing a
      copy in the new folder.

  -preserve

  -nopreserve
      Preserves	the number of a	message	in the new folder. Normally, when a
      message is refiled in to another folder, it is set to the	next avail-
      able number in that folder. The -preserve	option keeps the number	of
      the message the same in the new folder as	it had been in the old.

      You cannot have two messages with	the same number	in one folder, so you
      should use this option with care.

  -src +folder
      Specifies	the source folder to take messages from. Normally, messages
      are refiled from the current folder into another folder. However,	you
      can take messages	from a different folder	by using the -src +folder
      option to	specify	the alternative	source folder.




DESCRIPTION

  Use the refile command to move the specified message from the	current
  folder to another folder. You	can refile messages in more than one folder
  by giving multiple folder names as arguments.

  If you do not	specify	a message, the current message is refiled. You can
  refile a message other than the current message by giving its	number as a
  msgs argument. You can also refile more than one message at a	time by
  specifying more than one message number, or a	range of message numbers, or
  a message sequence. See mark(1) for more information on sequences.

  The current folder remains the same unless the -src option is	specified; in
  that case, the source	folder becomes current.	Normally, the last message
  specified becomes the	current	message. However, if the -link option is
  used,	the current message is not changed.

  If the Previous-Sequence: entry is set in the	.mh_profile file, in addition
  to defining the named	sequences from the source folder, refile will also
  define those sequences for the destination folders. See mh_profile(4)	for
  information concerning the previous sequence.

PROFILE	COMPONENTS

  Path:	To determine your Mail directory

  Folder-Protect: To set protections when creating a new folder

  rmmproc: Program to delete the message

EXAMPLES

   1.  The following example refiles messages 3	and 5 in the folder +records:
	    % refile 3 5 +records

   2.  The next	example	files the current message into two folders:
	    % refile +jones +map

   3.  The next	example	takes message 13 in the	current	folder and refiles it
       in the +test folder. The	message	remains	in the current folder as well
       as appearing in the +test folder.
	    % refile -link 13 +test

   4.  The next	example	takes a	message	from the folder	+test when it is not
       the current folder, and places it in the	folder +outbox:
	    % refile 3 -src +test +outbox



FILES

  $HOME/.mh_profile
      The user profile.

SEE ALSO

  folder(1), mark(1), mh_profile(4)