/usr/share/doc/mailutils-doc/mailutils.html/Program-Diffs.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Published by the Free Software Foundation,
51 Franklin Street, Fifth Floor
Boston, MA 02110-1301, USA

Copyright (C) 1999-2004, 2008-2012, 2014-2015 Free Software
Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with no
Invariant Sections, no Front-Cover, and no Back-Cover texts.
A copy of the license is included in the section entitled "GNU Free
Documentation License". -->
<!-- Created by GNU Texinfo 6.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Mailutils Manual: Program Diffs</title>

<meta name="description" content="GNU Mailutils Manual: Program Diffs">
<meta name="keywords" content="GNU Mailutils Manual: Program Diffs">
<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="Function-Index.html#Function-Index" rel="index" title="Function Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Diffs.html#Diffs" rel="up" title="Diffs">
<link href="mu.html#mu" rel="next" title="mu">
<link href="Profile-Variable-Diffs.html#Profile-Variable-Diffs" rel="prev" title="Profile Variable Diffs">
<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.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; 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="Program-Diffs"></a>
<div class="header">
<p>
Previous: <a href="Profile-Variable-Diffs.html#Profile-Variable-Diffs" accesskey="p" rel="prev">Profile Variable Diffs</a>, Up: <a href="Diffs.html#Diffs" accesskey="u" rel="up">Diffs</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Differences-in-MH-Program-Behavior"></a>
<h4 class="subsubsection">2.16.1.3 Differences in MH Program Behavior</h4>

<dl compact="compact">
<dt><code>anno</code></dt>
<dd>
<p>The prompt in interactive mode is &lsquo;<samp>Component name:</samp>&rsquo;, instead
of &lsquo;<samp>Enter component name:</samp>&rsquo; displayed by the RAND <code>anno</code>.
</p>
<p>If a <samp>-component field</samp> is not specified and standard input
is not connected to a terminal, <code>anno</code> does not display
the prompt before reading the component from the standard input.
RAND <code>anno</code> displays the prompt anyway.
</p>
</dd>
<dt><code>burst</code></dt>
<dd>
<p>The utility is able to burst both RFC 934 digest messages and MIME
multipart messages.  It provides two additional command line options:
<samp>--recurse</samp> and <samp>--length</samp>.
</p>
<p>The <samp>--recurse</samp> option instructs the utility to recursively
expand the digest.
</p>
<p>The <samp>--length</samp> option can be used to set the minimal encapsulation
boundary length for RFC 934 digests.  Default length is 1,
i.e. encountering one dash immediately following a newline triggers
digest decoding.  It is OK for messages that follow RFC 934
specification.  However, many user agents do not precisely follow it,
in particular, they often do not escape lines starting with a dash by
&lsquo;<samp>- </samp>&rsquo; sequence.  <code>Mailman</code> is one of such agents.  To cope
with such digests you can set encapsulation boundary length to a higher
value.  For example, <code>bounce --length=8</code> has been found to be
sufficient for most Mailman-generated digests.
</p>
</dd>
<dt><code>comp</code></dt>
<dd>
<p>Understands <samp>--build</samp> option.
</p>
</dd>
<dt><code>fmtdump</code></dt>
<dd>
<p>This command is not provided.  Use <samp>fmtcheck</samp> instead.
</p>
</dd>
<dt><code>inc</code></dt>
<dd><ul>
<li> The <samp>--moveto</samp> option.
The <samp>--moveto</samp> option instructs <code>inc</code> to move
messages into another folder after incorporating them.  This option
has effect only if the <samp>--truncate</samp> option has also been
specified and the underlying mailbox supports the &lsquo;<samp>move</samp>&rsquo;
operation.  Currently only &lsquo;<samp>imap</samp>&rsquo; and &lsquo;<samp>imaps</samp>&rsquo; mailboxes
support it.  For example, the following command moves incorporated
messages into the &lsquo;<samp>archive</samp>&rsquo; folder:

<div class="example">
<pre class="example">inc --file imaps://imap.gmail.com --moveto=archive
</pre></div>

<p>The &lsquo;<samp>moveto</samp>&rsquo; URL parameter can be used instead of this option,
e.g.:
</p>
<div class="example">
<pre class="example">inc --file 'imaps://imap.gmail.com;moveto=archive'
</pre></div>

</li><li> Multiple sources
Mailutils <code>inc</code> is able to incorporate messages from several
source mailboxes. These are specified via multiple <samp>-file</samp>
options, e.g.:

<div class="example">
<pre class="example">inc  -truncate \
     -file 'imaps://imap.gmail.com;moveto=archived' \
     -file pops://mail.gnu.org \
     -file /var/mail/root
</pre></div>

</li><li> URL parameters
The following additional parameters can be used in the mailbox
URLs supplied with the <samp>-file</samp> option:

<dl compact="compact">
<dt><samp>moveto=<var>folder</var></samp></dt>
<dd><p>Moves incorporated messages into another folder.  This was discussed
above.
</p>
</dd>
<dt><samp>nomoveto</samp></dt>
<dd><p>Disables the previous <samp>--moveto</samp> option.
</p>
</dd>
<dt><samp>truncate[=<var>bool</var>]</samp></dt>
<dd><p>Controls source mailbox truncation.  If <var>bool</var> is not given or it is
&lsquo;<samp>yes</samp>&rsquo;, the mailbox will be truncated after successful processing.
If <var>bool</var> is &lsquo;<samp>no</samp>&rsquo;, the source mailbox will not be truncated.
</p></dd>
</dl>
</li></ul>

</dd>
<dt><code>mhl</code></dt>
<dd>
<p>The &lsquo;<samp>ignores</samp>&rsquo; keyword can be used in variable list.  In that
case, if its value contains  more than one component name
it must be enclosed in double-quotes, e.g.:
</p>
<div class="smallexample">
<pre class="smallexample">leftadjust,compwidth=9,&quot;ignores=msgid,message-id,received&quot;
</pre></div>

<p>The above is equivalent to the following traditional notation:
</p>
<div class="smallexample">
<pre class="smallexample">leftadjust,compwidth=9
ignores=msgid,message-id,received
</pre></div>

<p>The &lsquo;<samp>MessageName</samp>&rsquo; component is not yet implemented.
</p>
<p>Interactive prompting is not yet implemented.
</p>
<p>The following format variables are silently ignored: &lsquo;<samp>center</samp>&rsquo;,
&lsquo;<samp>split</samp>&rsquo;, &lsquo;<samp>datefield</samp>&rsquo;.
</p>
</dd>
<dt><code>mhn</code></dt>
<dd>
<ul>
<li> New option
New option <samp>--compose</samp> forces <code>mhn</code> editing mode.  This
is also the default mode.  This differs from the standard
<code>mhn</code>, which switches to the editing mode only if no other
options were given and the input file name coincides with the value of
<code>mhdraft</code> environment variable.  

</li><li> Show mode (<samp>--show</samp>)
If an appropriate mhn-show-type[/subtype] was not found, GNU <code>mhn</code>
prints the decoded message content using <code>moreproc</code>
variable.  Standard <code>mhn</code> in this case used to print &lsquo;<samp>don't
know how to display content</samp>&rsquo; diagnostic. 

<p>The default behaviour is to pipe the content to the standard input
of the mhn-show-type[/subtype] command.  This is altered to using a
temporary file if the command contains <code>%f</code> or <code>%F</code> escapes.
</p>
</li><li> Store mode (<samp>--store</samp>)
If the <code>Content-Disposition</code> header contains &lsquo;<samp>filename=</samp>&rsquo;,
and <code>mhn</code> is invoked with <samp>--auto</samp> switch, it
transforms the file name into the absolute notation and uses it only
if it lies below the current mhn-storage directory.  Standard
<code>mhn</code> only requires that the file name do not begin with &lsquo;<samp>/</samp>&rsquo;.

<p>Before saving a message part, GNU <code>mhn</code> checks if the file already
exists.  If so, it asks whether the user wishes to rewrite it.  This
behaviour is disabled when <samp>--quiet</samp> option was given.
</p></li></ul>

</dd>
<dt><code>mhparam</code></dt>
<dd>
<p>The <samp>--all</samp> mode does not display commented out entries.
</p>
</dd>
<dt><code>pick</code></dt>
<dd>
<p>The command line syntax <samp>--<var>component</var> <var>string</var></samp>) is
recognized only if at least one of the following conditions is met:
</p>
<ul>
<li> The word <var>component</var> contains at least one capital letter.
E.g.  <samp>--User-Agent Mailutils</samp>.

</li><li> The word <var>component</var> ends with a colon, as in
<samp>user-agent: Mailutils</samp>.

</li><li> Standard input is not connected to a terminal.
</li></ul>

<p>The GNU syntax for component matching is:
</p>
<div class="smallexample">
<pre class="smallexample">pick --component <var>field</var> --pattern <var>string</var>
</pre></div>

<p>New command line option <samp>--cflags</samp> allows to control the type of 
regular expressions used.  The option must occur right before
<samp>--pattern</samp> or <samp>--component</samp> option (or one of its
aliases, like <samp>--cc</samp>, <samp>--from</samp>, etc.)
</p>
<p>The argument to this option is a string of type specifications:
</p>
<table>
<tr><td width="20%">B</td><td width="80%">Use basic regular expressions</td></tr>
<tr><td width="20%">E</td><td width="80%">Use extended regular expressions</td></tr>
<tr><td width="20%">I</td><td width="80%">Ignore case</td></tr>
<tr><td width="20%">C</td><td width="80%">Case sensitive</td></tr>
</table>

<p>Default is &lsquo;<samp>EI</samp>&rsquo;.
</p>
<p>The flags remain in effect until the next occurrence of <samp>--cflags</samp>
option.
</p>
<p>Sample usage:
</p>
<div class="smallexample">
<pre class="smallexample">pick --cflag BC --subject '*a string' 
</pre></div>

<p>The date comparison options (<samp>--before</samp> and <samp>--after</samp>
accept date specifications in a wide variety of formats, e.g.:
</p>
<div class="smallexample">
<pre class="smallexample">pick --after 20030301
pick --after 2003-03-01
pick --after 01-mar-2003
pick --after 2003-mar-01
pick --before '1 year ago'
etc...
</pre></div>

</dd>
<dt><code>prompter</code></dt>
<dd><ol>
<li> Prompter attempts to use GNU Readline library, if it is installed.
Consequently, arguments to <samp>-erase</samp> and <samp>-kill</samp> option
must follow GNU style key sequence notation (see <a href="http://cnswww.cns.cwru.edu/php/chet/readline/readline.html#Readline-Init-File-Syntax">keyseq</a> in <cite>GNU Readline Library</cite>).

<p>If <code>prompter</code> is built without <code>readline</code>, it accepts
the following character notations:
</p>
<dl compact="compact">
<dt>\<var>nnnn</var></dt>
<dd><p>Here, <var>n</var> stands for a single octal digit.
</p>
</dd>
<dt>^<var>chr</var></dt>
<dd><p>This notation is translated to the ASCII code &lsquo;<samp><var>chr</var> + 0100</samp>&rsquo;.
</p></dd>
</dl>

</li><li> Component continuation lines are not required to begin with a
whitespace.  If leading whitespace is not present, <code>prompter</code>
will add it automatically.
</li></ol>

</dd>
<dt><code>refile</code></dt>
<dd>
<ol>
<li> Linking messages between folders goes against the logic of Mailutils,
so <code>refile</code> never makes links even if called with
<samp>--link</samp> option.  The latter is actually a synonym for <samp>--copy</samp>,
which preserves the original message.

</li><li> The <samp>--preserve</samp> option is not implemented.  It is retained for backward
compatibility only.

</li><li> Message specs and folder names may be interspersed.
</li></ol>

</dd>
<dt><code>repl</code></dt>
<dd>
<p>Understands <samp>--use</samp> option.  Disposition shell provides
<code>use</code> command. 
</p>
</dd>
<dt><code>rmm</code></dt>
<dd>
<ol>
<li> Different behaviour if one of the messages in the list does not exist:

<p>Mailutils <code>rmm</code> does not delete any messages.  Standard
<code>rmm</code> in this case deletes all messages preceding the
non-existent one. 
</p>
</li><li> The <code>rmm</code> utility will unlink messages, if the <code>rmmproc</code>
profile component has empty value, e.g.:

<div class="example">
<pre class="example">rmmproc:
</pre></div>
</li></ol>

</dd>
<dt><code>sortm</code></dt>
<dd>
<p>New option <samp>--numfield</samp> specifies numeric comparison for the
given field. 
</p>
<p>Any number of <samp>--datefield</samp>, <samp>--textfield</samp> and
<samp>--numfield</samp> options may be given, thus allowing to build sort
criteria of arbitrary complexity. 
</p>
<p>The order of <samp>--.*field</samp> options sets the ordering priority.  This
differs from the behaviour of the standard <code>sortm</code>, which
always orders datefield-major, textfield-minor.
</p>
<p>Apart from sorting the mailfolder the following actions may be
specified:
</p>
<dl compact="compact">
<dt><samp>--list</samp></dt>
<dd><p>List the ordered messages using a format string given by
<samp>--form</samp> or <samp>--format</samp> option.
</p>
</dd>
<dt><samp>--dry-run</samp></dt>
<dd><p>Do not actually sort messages, rather print what would have been
done.  This is useful for debugging purposes.
</p></dd>
</dl>

</dd>
</dl>



<hr>
<div class="header">
<p>
Previous: <a href="Profile-Variable-Diffs.html#Profile-Variable-Diffs" accesskey="p" rel="prev">Profile Variable Diffs</a>, Up: <a href="Diffs.html#Diffs" accesskey="u" rel="up">Diffs</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>
mailutils-doc 1:2.99.99-1ubuntu2 / usr / share / doc / mailutils-doc / mailutils.html / Program-Diffs.html
