From f6be896b1f8467f48a0f1edccb43c0a2a9eb4e6a Mon Sep 17 00:00:00 2001 From: Nikolaus Schulz Date: Wed, 29 Dec 2010 01:03:09 +0100 Subject: Port man page from SGML to XML --- archivemail.sgml | 715 ------------------------------------------------------- 1 file changed, 715 deletions(-) delete mode 100644 archivemail.sgml (limited to 'archivemail.sgml') diff --git a/archivemail.sgml b/archivemail.sgml deleted file mode 100644 index 8b227b7..0000000 --- a/archivemail.sgml +++ /dev/null @@ -1,715 +0,0 @@ - - -"> - - - -"> - - - -"> - - - -"> - - - -"> - - - -"> - - - -"> - - - -"> -]> - - - -9 August 2010 - - -archivemail -1 -SP - - - -archivemail -archive and compress your old email - - - - - - - - - - - - -Description - - -archivemail is a tool for archiving and compressing old email in mailboxes. -By default it will read the mailbox - - -By default, exsouthrock, the archive will be created with the -filename exsouthrock_archive.gz. -This default behavior can be overridden with command line options, choosing -a custom suffix, a prefix, or a completely custom name for the archive. - - - - - - - Messages that are flagged important are not archived or deleted unless - explicitly requested with the option. - Also, - - -To archive an imap://username:password@server/mailbox - to specify the mailbox. -RFC 3501, which says: -The character "*" is a wildcard, and matches zero or more characters at this -position. The character "%" is similar to "*", but it does not match a -hierarchy delimiter. -You can omit the password from the --pwfile option to make --pwfile option is set, - - - -Options - - - - - - -Archive messages older than - - - - - -Archive messages older than - - - - - -Use the directory name - - - - -Read - - - - - -Append - - - - - -Prefix --suffix option for a list of valid - - - - - - - -Use the suffix _archive, unless a prefix is specified. - - - -Like a prefix, the suffix - - Locale's abbreviated weekday name. - - Locale's full weekday name. - - Locale's abbreviated month name. - - Locale's full month name. - - Locale's appropriate date and time representation. - - Day of the month as a decimal number [01,31]. - - Hour (24-hour clock) as a decimal number [00,23]. - - Hour (12-hour clock) as a decimal number [01,12]. - - Day of the year as a decimal number [001,366]. - - Month as a decimal number [01,12]. - - Minute as a decimal number [00,59]. - - Locale's equivalent of either AM or PM. - - Second as a decimal number [00,61]. (1) - - Week number of the year (Sunday as the first day of the week) as a decimal number [00,53]. All days in a new year preceding the first Sunday are considered to be in week 0. - - Weekday as a decimal number [0(Sunday),6]. - - Week number of the year (Monday as the first day of the week) as a decimal number [00,53]. All days in a new year preceding the first Sunday are considered to be in week 0. - - Locale's appropriate date representation. - - Locale's appropriate time representation. - - Year without century as a decimal number [00,99]. - - Year with century as a decimal number. - - Time zone name (or by no characters if no time zone exists). - - A literal "%" character. - - - - - - - - -Use - - - - - -Only archive messages that are - - - - - - - -Don't write to any files -- just show what would have been done. This is -useful for testing to see how many messages would have been archived. - - - - - - - - -Do not archive any messages that have not yet been read. :2, then it assumes the message has been read. - - - - - - - - -Do not mangle lines in message bodies beginning with "From ". When archiving -a message from a mailbox not in ' to them, since mail -user agents might otherwise interpret these lines as message separators. -Messages from - - - - - - - -Delete rather than archive old mail. Use this option with caution! - - - - - - - - -Copy rather than archive old mail. -Creates an archive, but the archived messages are not deleted from the -originating mailbox, which is left unchanged. -This is a complement to the - - - - - - - -Archive all messages, without distinction. - - - - - - - - -Normally messages that are flagged important are not archived or deleted. If -you specify this option, these messages can be archived or deleted just like -any other message. - - - - - - - - -Do not compress any archives. - - - - - - - - -Warn about duplicate - - - - - - - -Reports lots of extra debugging information about what is going on. - - - - - - - -Set - - - - - - - -Turns on quiet mode. Do not print any statistics about how many messages were -archived. This should be used if you are running - - - - - - - -Display the version of - - - - - - - -Display brief summary information about how to run - - - - - - -Notes - -.lock so that -procmail will not deliver to the mailbox while it is being processed. It will -also create an advisory lock on the mailbox using &lockf;. -The archive is locked in the same way when it is updated. - - - - - - - - - - When archiving mailboxes with leading dots in the name, - --prefix or - option is used. - Should there really be mailboxes distinguished only by leading dots in the - name, they will thus be archived to the same archive file by default. - - - - A conversion from other formats to &mbox; will silently overwrite existing - - - -<acronym/IMAP/ - -When - - -<acronym/IMAP/ <acronym/URLs/ - -RFC 2882 (Internet Message -Format) rules for the local-part of email addresses -in mind. -So, rather than enforcing an imap://"username@bogus.com":"password"@imap.bogus.com/mailbox -. -You can use a backslash to escape double-quotes that are part of a quoted -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. - - - - - - - - - -Examples - - - -To archive all messages in the mailbox debian-user that -are older than 180 days to a compressed mailbox called -debian-user_archive.gz in the current directory: - -bash$ archivemail debian-user - - - - - - -To archive all messages in the mailbox debian-user that -are older than 180 days to a compressed mailbox called -debian-user_October_2001.gz (where the current month and -year is April, 2002) in the current directory: - -bash$ archivemail --suffix '_%B_%Y' debian-user - - - - - - -To archive all messages in the mailbox cm-melb that -are older than the first of January 2002 to a compressed mailbox called -cm-melb_archive.gz in the current directory: - -bash$ archivemail --date'1 Jan 2002' cm-melb - - - - - - -Exactly the same as the above example, using an ISO date format instead: - -bash$ archivemail --date=2002-01-01 cm-melb - - - - - - -To delete all messages in the mailbox spam that -are older than 30 days: - -bash$ archivemail --delete --days=30 spam - - - - - - -To archive all read messages in the mailbox incoming that -are older than 180 days to a compressed mailbox called -incoming_archive.gz in the current directory: - -bash$ archivemail --preserve-unread incoming - - - - - - -To archive all messages in the mailbox received that -are older than 180 days to an uncompressed mailbox called -received_archive in the current directory: - -bash$ archivemail --no-compress received - - - - - - -To archive all mailboxes in the directory $HOME/Mail -that are older than 90 days to compressed mailboxes in the -$HOME/Mail/Archive directory: - -bash$ archivemail -d90 -o $HOME/Mail/Archive $HOME/Mail/* - - - - - - - To archive all mails older than 180 days from the given $HOME/Mail/Archive directory, quoting the password and - reading it from the environment variable PASSWORD: - - - -bash$ archivemail -o $HOME/Mail/Archive imaps://user:'"'$PASSWORD'"'@example.org/INBOX - - - Note the protected quotes. - - - - - - To archive all mails older than 180 days in subfolders of "foo" on the - given ~/imap-pass.txt: - - - bash$ archivemail --pwfile=~/imap-pass.txt imaps://user@example.org/foo/* - - - - - -Tips - -Probably the best way to run --quiet option. -Don't forget to try the and perhaps the - option for non-destructive testing. - - - - -Exit Status -Normally the exit status is 0. Nonzero indicates an unexpected error. - - - - -Bugs - -If an imap://user@example.com/folder/subfolder and -imap://user@example.com/folder.subfolder will be -archived in subfolder_archive.gz and -folder.subfolder_archive.gz, respectively, although they -might refer to the same - - - - - - - - -See Also - - &python;, &gzip;, &mutt;, &procmail; - - - - -Url -The sourceforge - - - - -Author - This manual page was written by Paul Rodger <paul at paulrodger dot -com>. Updated and supplemented by Nikolaus Schulz -microschulz@web.de - - - -- cgit v1.2.3