mirror
/
archivemail
mirror of https://git.code.sf.net/p/archivemail/code
1
0
Fork 0
Code Issues Releases Wiki Activity

archivemail.sgml: edited and reordered 'Notes' section so that it looks nicer.

This commit is contained in:
Nikolaus Schulz 2007-11-03 00:24:37 +00:00
parent be4aabc20f
commit 3f5f591728
2 changed files with 12 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
archivemail.1
View File

@ -239,7 +239,6 @@ Display brief summary information about how to run \fBarchivemail\fR\&.
.SH "NOTES" .SH "NOTES"
.PP .PP
\fBarchivemail\fR requires \fBpython\fR(1) version 2.3 or later. \fBarchivemail\fR requires \fBpython\fR(1) version 2.3 or later.
.PP
When reading an \fBmbox\fR-format mailbox, \fBarchivemail\fR will When reading an \fBmbox\fR-format mailbox, \fBarchivemail\fR will
create a lockfile with the extension \fI\&.lock\fR so that create a lockfile with the extension \fI\&.lock\fR so that
procmail will not deliver to the mailbox while it is being processed. It will procmail will not deliver to the mailbox while it is being processed. It will
@ -250,9 +249,10 @@ mailbox while it is being read.
\fBarchivemail\fR will always attempt to preserve the mode, \fBarchivemail\fR will always attempt to preserve the mode,
last-access and last-modify times of the input mailbox. However, archive last-access and last-modify times of the input mailbox. However, archive
mailboxes are always created with a mode of \fB0600\fR\&. mailboxes are always created with a mode of \fB0600\fR\&.
.PP
If \fBarchivemail\fR finds a pre-existing archive mailbox it If \fBarchivemail\fR finds a pre-existing archive mailbox it
will append rather than overwrite that archive. will append rather than overwrite that archive.
\fBarchivemail\fR will refuse to operate on mailboxes that are symbolic
links or create tempfiles or archives in world-writable directories.
.PP .PP
\fBarchivemail\fR attempts to find the delivery date of a message by \fBarchivemail\fR attempts to find the delivery date of a message by
looking for valid dates in the following headers, in order of precedence: looking for valid dates in the following headers, in order of precedence:
@ -264,11 +264,8 @@ will use the last-modified file timestamp on \fBMH\fR and
\fBMaildir\fR format mailboxes, or the date on the \fBMaildir\fR format mailboxes, or the date on the
\fBFrom\fR line on \fBmbox\fR-format mailboxes. \fBFrom\fR line on \fBmbox\fR-format mailboxes.
.PP .PP
The conversion from other formats to \fBmbox\fR(5) will silently overwrite existing A conversion from other formats to \fBmbox\fR(5) will silently overwrite existing
\fBStatus\fR and \fBX-Status\fR message headers. \fBStatus\fR and \fBX-Status\fR message headers.
.PP
\fBarchivemail\fR will refuse to operate on mailboxes that are symbolic
links or create tempfiles or archives in world-writable directories.
.SS "IMAP" .SS "IMAP"
.PP .PP
When \fBarchivemail\fR processes an \fBIMAP\fR folder, all messages When \fBarchivemail\fR processes an \fBIMAP\fR folder, all messages
@ -280,9 +277,9 @@ This does not apply, however, if you run \fBarchivemail\fR with the options
.PP .PP
\fBarchivemail\fR relies on server-side searches to determine the messages \fBarchivemail\fR relies on server-side searches to determine the messages
that should be archived. that should be archived.
When matching dates, \fBIMAP\fR servers refer to server internal message When matching message dates, \fBIMAP\fR servers refer to server internal
dates, and these may differ from both delivery time and the message's message dates, and these may differ from both delivery time of a message and
\fBDate\fR header. its \fBDate\fR header.
Also, there exist broken servers which do not implement server side searches. Also, there exist broken servers which do not implement server side searches.
.SS "IMAP URLS" .SS "IMAP URLS"
.PP .PP

21
archivemail.sgml
View File

@ -379,9 +379,6 @@ Display brief summary information about how to run <Command/archivemail/.
<Title>Notes</Title> <Title>Notes</Title>
<Para> <Para>
<Command/archivemail/ requires &python; version 2.3 or later. <Command/archivemail/ requires &python; version 2.3 or later.
</Para>
<Para>
When reading an <application/mbox/-format mailbox, <command/archivemail/ will When reading an <application/mbox/-format mailbox, <command/archivemail/ will
create a lockfile with the extension <filename>.lock</filename> so that create a lockfile with the extension <filename>.lock</filename> so that
procmail will not deliver to the mailbox while it is being processed. It will procmail will not deliver to the mailbox while it is being processed. It will
@ -394,11 +391,10 @@ mailbox while it is being read.
<Command/archivemail/ will always attempt to preserve the mode, <Command/archivemail/ will always attempt to preserve the mode,
last-access and last-modify times of the input mailbox. However, archive last-access and last-modify times of the input mailbox. However, archive
mailboxes are always created with a mode of <application/0600/. mailboxes are always created with a mode of <application/0600/.
</Para>
<Para>
If <Command/archivemail/ finds a pre-existing archive mailbox it If <Command/archivemail/ finds a pre-existing archive mailbox it
will append rather than overwrite that archive. will append rather than overwrite that archive.
<Command/archivemail/ will refuse to operate on mailboxes that are symbolic
links or create tempfiles or archives in world-writable directories.
</Para> </Para>
<Para> <Para>
@ -414,15 +410,10 @@ will use the last-modified file timestamp on <application/MH/ and
</Para> </Para>
<Para> <Para>
The conversion from other formats to &mbox; will silently overwrite existing A conversion from other formats to &mbox; will silently overwrite existing
<application/Status/ and <application/X-Status/ message headers. <application/Status/ and <application/X-Status/ message headers.
</Para> </Para>
<Para>
<Command/archivemail/ will refuse to operate on mailboxes that are symbolic
links or create tempfiles or archives in world-writable directories.
</Para>
<RefSect2> <RefSect2>
<Title><acronym/IMAP/</Title> <Title><acronym/IMAP/</Title>
<Para> <Para>
@ -436,9 +427,9 @@ This does not apply, however, if you run <command/archivemail/ with the options
<Para> <Para>
<command/archivemail/ relies on server-side searches to determine the messages <command/archivemail/ relies on server-side searches to determine the messages
that should be archived. that should be archived.
When matching dates, <application/IMAP/ servers refer to server internal message When matching message dates, <application/IMAP/ servers refer to server internal
dates, and these may differ from both delivery time and the message's message dates, and these may differ from both delivery time of a message and
<application/Date/ header. its <application/Date/ header.
Also, there exist broken servers which do not implement server side searches. Also, there exist broken servers which do not implement server side searches.
</Para> </Para>
<RefSect3><Title><acronym/IMAP/ <acronym/URLs/</Title> <RefSect3><Title><acronym/IMAP/ <acronym/URLs/</Title>