/usr/share/doc/vm/html/Message-Attributes.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.0, http://www.gnu.org/software/texinfo/ -->
<head>
<title>VM User&rsquo;s Manual: Message Attributes</title>

<meta name="description" content="VM User&rsquo;s Manual: Message Attributes">
<meta name="keywords" content="VM User&rsquo;s Manual: Message Attributes">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index">
<link href="License.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index.html#Top" rel="up" title="Top">
<link href="Sorting-Messages.html#Sorting-Messages" rel="next" title="Sorting Messages">
<link href="Marking-Messages.html#Marking-Messages" rel="prev" title="Marking Messages">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space: nowrap}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: serif; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en">
<a name="Message-Attributes"></a>
<div class="header">
<p>
Next: <a href="Sorting-Messages.html#Sorting-Messages" accesskey="n" rel="next">Sorting Messages</a>, Previous: <a href="Marking-Messages.html#Marking-Messages" accesskey="p" rel="prev">Marking Messages</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="License.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Message-Attributes-1"></a>
<h2 class="chapter">9 Message Attributes</h2>
<a name="index-message-attributes-3"></a>

<p>Each message in a folder has a set of attributes that VM will remember
from session to session.  Various VM commands set and unset these
attributes.  Here are the attributes maintained by VM.
</p>
<dl compact="compact">
<dt><code>new</code></dt>
<dd><p>The message was retrieved from a spool file during this
visit of the current folder.
</p></dd>
<dt><code>unread</code></dt>
<dd><p>The message was retrieved from a spool file during some
past visit of the folder but is still unread.
</p></dd>
<dt><code>filed</code></dt>
<dd><p>The message has been saved to some folder.
</p></dd>
<dt><code>written</code></dt>
<dd><p>The body of the message has been saved to a file.
</p></dd>
<dt><code>edited</code></dt>
<dd><p>The message has been altered (with <code>vm-edit-message</code>) since it arrived.
</p></dd>
<dt><code>deleted</code></dt>
<dd><p>The message is deleted and will be removed from the folder
at the next expunge.
</p></dd>
<dt><code>forwarded</code></dt>
<dd><p>The message has been forwarded with either
<code>vm-forward-message</code>, <code>vm-send-digest</code> or one of their variants.
</p></dd>
<dt><code>redistributed</code></dt>
<dd><p>The message has been forwarded with the
<code>vm-resend-message</code> command.
</p></dd>
<dt><code>replied</code></dt>
<dd><p>The message has been replied to.
</p></dd>
</dl>

<a name="index-vm_002dset_002dmessage_002dattributes"></a>
<p>You can set and unset these attributes directly by using
<code>M-x vm-set-message-attributes</code>.  You will be prompted in the
minibuffer for names of the attributes and you can enter them with
completion.  Every attribute has an &ldquo;un-&rdquo; prefixed name you can use
to unset the attribute, excepting &ldquo;new&rdquo; and &ldquo;unread&rdquo;, which are both
negated by &ldquo;read&rdquo;.  You can use a prefix argument with this command to
affect multiple messages, and you can apply this command to marked
messages with <kbd>M N</kbd>.
</p>
<a name="index-vm_002dundo"></a>
<a name="index-C_002dx-u"></a>
<a name="index-C_002d_005f"></a>
<a name="index-undo"></a>
<p>VM provides a special form of undo which allows changes to message
attributes to be undone.  Typing <kbd>C-x u</kbd> or <tt class="key">C-_</tt>
(<code>vm-undo</code>) undoes the last attribute change.  Consecutive
<code>vm-undo</code>&rsquo;s undo further and further back.  Any intervening command
breaks the undo chain, after which the undo&rsquo;s themselves become undoable
by subsequent invocations of <code>vm-undo</code>.
</p>
<p>Note that expunges, saves and message edits are <em>not</em> undoable.
</p>
<a name="index-vm_002dadd_002dmessage_002dlabels"></a>
<a name="index-vm_002ddelete_002dmessage_002dlabels"></a>
<a name="index-l-a"></a>
<a name="index-l-d"></a>
<a name="index-message-labels-2"></a>
<p><em>Labels</em> are user-defined message attributes.  They can have any
name and be assigned any meaning by you.  Labels are added with
<kbd>l a</kbd> (<code>vm-add-message-labels</code> and <kbd>l e</kbd>
(<code>vm-add-existing-message-labels</code>, and are removed by <kbd>l d</kbd>
(<code>vm-delete-message-labels</code>).  BABYL format folders use labels to
store basic attributed like &ldquo;deleted&rdquo; and &ldquo;unread&rdquo;.  When visiting a
BABYL folder VM uses these labels also in order to be compatible with
other BABYL mailers.  The labels used are &ldquo;recent&rdquo;, &ldquo;unseen&rdquo;,
&ldquo;deleted&rdquo;, &ldquo;answered&rdquo;, &ldquo;forwarded&rdquo;, &ldquo;redistributed&rdquo;, &ldquo;filed&rdquo;,
&ldquo;edited&rdquo; and &ldquo;written&rdquo;.  If (and only if) you are using BABYL format
folders, you should not use these label names for your own purposes.
</p>
<a name="index-vm_002dflush_002dinterval"></a>
<a name="index-auto_002dsave-1"></a>
<p>All message attributes are stored in the folder.  In order for
attribute changes to be saved to disk, they must be written to
the folder&rsquo;s buffer prior to the buffer being saved.  The
variable <code>vm-flush-interval</code> controls how often that is done.  A
value of <code>t</code> means write the new attributes to the folder
buffer whenever a change occurs.  A value of <code>nil</code> means
wait until just before the folder is saved before writing out the
attributes.  VM will work faster with this setting, but if Emacs
or your system crashes, the auto-save file will contain no useful
data pertaining to message attribute changes.  The auto-save file
will still reflect message edits and expunges.  See <a href="Starting-Up.html#Crash-Recovery">Crash Recovery</a>.  A positive integer value <var>n</var> instructs VM to write
out attribute changes every <var>n</var> seconds.  The default value
of this variable is <code>t</code>.
</p>
<hr>
<div class="header">
<p>
Next: <a href="Sorting-Messages.html#Sorting-Messages" accesskey="n" rel="next">Sorting Messages</a>, Previous: <a href="Marking-Messages.html#Marking-Messages" accesskey="p" rel="prev">Marking Messages</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="License.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>
vm 8.2.0b-2 / usr / share / doc / vm / html / Message-Attributes.html
