X-Git-Url: https://git.phdru.name/?a=blobdiff_plain;ds=sidebyside;f=mimedecode.docbook;h=6fcc39822f8dce7e19b13b82950894b76fed927e;hb=ae8aeab467eba38d6fbc4c52e2f31e31cba11404;hp=0605fa84da98e3845df8d51d3619b7eed7dbe7cf;hpb=93b627c389e98f0ef7347035ee75a8603b6dd866;p=mimedecode.git diff --git a/mimedecode.docbook b/mimedecode.docbook index 0605fa8..6fcc398 100644 --- a/mimedecode.docbook +++ b/mimedecode.docbook @@ -56,6 +56,9 @@ + + + @@ -73,13 +76,13 @@ DESCRIPTION Mail users, especially in non-English countries, often find that mail -messages arrived in different formats, with different content types, in -different encodings and charsets. Usually it is good because it allows to use -an appropriate format/encoding/whatever. Sometimes, though, some unification is -desirable. For example, one may want to put mail messages into an archive, -make HTML indices, run search indexer, etc. In such situations converting -messages to text in one character set and skipping some binary attachments is -much desirable. + messages arrived in different formats, with different content types, in + different encodings and charsets. Usually it is good because it allows to + use an appropriate format/encoding/whatever. Sometimes, though, some + unification is desirable. For example, one may want to put mail messages + into an archive, make HTML indices, run search indexer, etc. In such + situations converting messages to text in one character set and skipping + some binary attachments is much desirable. @@ -88,12 +91,12 @@ much desirable. This is a program to decode MIME messages. The program expects one input -file (either on command line or on stdin) which is treated as an RFC822 -message, and decodes to stdout or an output file. If the file is not an RFC822 -message it is just copied to the output one-to-one. If the file is a simple -RFC822 message it is decoded as one part. If it is a MIME message with multiple -parts ("attachments") all parts are decoded. Decoding can be controlled by -command-line options. + file (either on command line or on stdin) which is treated as an RFC822 + message, and decodes to stdout or an output file. If the file is not an + RFC822 message it is just copied to the output one-to-one. If the file is a + simple RFC822 message it is decoded as one part. If it is a MIME message + with multiple parts ("attachments") all parts are decoded. Decoding can be + controlled by command-line options. @@ -214,7 +217,7 @@ command-line options. -p header:param - Add the pair (header, param) to a list of headers' parameters to + Add the pair (header, param) to a list of headers parameters to decode; initially the list contains header "Content-Type", parameter "name" and header "Content-Disposition", parameter "filename". @@ -226,7 +229,7 @@ command-line options. -P - Clear the list of headers' parameters to decode (make it empty). + Clear the list of headers parameters to decode (make it empty). @@ -241,6 +244,16 @@ command-line options. + + -R header:param + + + Add the pair (header, param) to a list of headers parameters to + remove; initially the list is empty. + + + + -b mask @@ -298,11 +311,11 @@ cat input_file | mimedecode.py -o output_file - The 4 list options (-beit) require more explanation. They allow a user -to control body decoding with great flexibility. Think about said mail -archive; for example, its maintainer wants to put there only texts, convert -Postscript/PDF to text, pass HTML and images as is, and ignore everything -else. Easy: + The 4 list options (-beit) require more explanation. They allow a user to + control body decoding with great flexibility. Think about said mail archive; + for example, its maintainer wants to put there only texts, convert + Postscript/PDF to text, pass HTML and images as is, and ignore everything + else. Easy: