Updated manpage: document that archivemail will implicitly unset the \Recent

message flag of all messages in an IMAP folder.
This commit is contained in:
Nikolaus Schulz 2007-11-02 19:21:10 +00:00
parent 3ee105d766
commit dfec62850e
2 changed files with 20 additions and 2 deletions

View File

@ -3,7 +3,7 @@
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
.\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "ARCHIVEMAIL" "1" "24 October 2007" "SP" ""
.TH "ARCHIVEMAIL" "1" "02 November 2007" "SP" ""
.SH NAME
archivemail \- archive and compress your old email
@ -256,6 +256,14 @@ will use the last-modified file timestamp on \fBMH\fR and
.PP
\fBarchivemail\fR will refuse to operate on mailboxes that are symbolic
links or create tempfiles or archives in world-writable directories.
.SS "IMAP"
.PP
When \fBarchivemail\fR processes an \fBIMAP\fR folder, all messages
in that folder will have their \\Recent flag unset, and they will
probably not show up as 'new' in your user agent later on.
There is no way around this, it's just how \fBIMAP\fR works.
This does not apply, however, if you run \fBarchivemail\fR with the options
\fB--dry-run\fR or \fB--copy\fR\&.
.SS "IMAP URLS"
.PP
\fBarchivemail\fR\&'s \fBIMAP\fR URL parser was written

View File

@ -400,7 +400,16 @@ links or create tempfiles or archives in world-writable directories.
</Para>
<RefSect2>
<Title><acronym/IMAP/ <acronym/URL/s</Title>
<Title><acronym/IMAP/</Title>
<Para>
When <command/archivemail/ processes an <application/IMAP/ folder, all messages
in that folder will have their <literal/\Recent/ flag unset, and they will
probably not show up as 'new' in your user agent later on.
There is no way around this, it's just how <application/IMAP/ works.
This does not apply, however, if you run <command/archivemail/ with the options
<option/--dry-run/ or <option/--copy/.
</Para>
<RefSect3><Title><acronym/IMAP/ <acronym/URLs/</Title>
<Para>
<command/archivemail/'s <application/IMAP/ <acronym/URL/ parser was written
with the <acronym>RFC</acronym> 2882 (<citetitle>Internet Message
@ -417,6 +426,7 @@ username or password.
Note that quoting only a substring will not work, and be aware that your shell
will probably remove unprotected quotes or backslashes.
</Para>
</RefSect3>
</RefSect2>
</RefSect1>