X-Git-Url: https://git.phdru.name/?a=blobdiff_plain;ds=sidebyside;f=mimedecode.docbook;h=61a30b863710625d4256011ababe3435c5f589c3;hb=8989dd0488670beb82419a80c0df268eea83d80b;hp=7d767f3cff55fe7eb7030c46e5952bca3c068724;hpb=c28acc38624deae7053621be113c102ca86472a7;p=mimedecode.git
diff --git a/mimedecode.docbook b/mimedecode.docbook
index 7d767f3..61a30b8 100644
--- a/mimedecode.docbook
+++ b/mimedecode.docbook
@@ -90,7 +90,7 @@
-
+
@@ -276,8 +276,8 @@
-p header1[,header2,header3,...]:param1[,param2,param3,...]
- Add the parameters(s) to a list of headers parameters to decode;
- the parameters will be decoded only for the given header(s).
+ Add the parameter(s) to a list of headers parameters to decode;
+ the parameter(s) will be decoded only for the given header(s).
Initially the list contains header "Content-Type", parameter "name";
and header "Content-Disposition", parameter "filename".
@@ -288,8 +288,8 @@
-p *[,-header1,-header2,-header3,...]:param1[,param2,param3,...]
- Add the parameters(s) to a list of headers parameters to decode;
- the parameters will be decoded for all headers except the given
+ Add the parameter(s) to a list of headers parameters to decode;
+ the parameter(s) will be decoded for all headers except the given
ones.
@@ -345,8 +345,8 @@
-R header1[,header2,header3,...]:param1[,param2,param3,...]
- Add the parameters(s) to a list of headers parameters to remove;
- the parameters will be removed only for the given header(s).
+ Add the parameter(s) to a list of headers parameters to remove;
+ the parameter(s) will be removed only for the given header(s).
Initially the list is empty.
@@ -364,7 +364,7 @@
-R *[,-header1,-header2,-header3,...]:*[,-param1,-param2,-param3,...]
- Remove listed parameters (or all parameters except listed) frome
+ Remove listed parameters (or all parameters except listed) from
these headers (or from all headers except listed).
@@ -422,6 +422,17 @@
+
+ -I mask
+
+
+ Append mask to the list of content types to completely ignore.
+ There will be no output - no headers, no body, no warning. For a
+ multipart part the entire subtree is removed.
+
+
+
+
-i mask
@@ -520,6 +531,12 @@ cat input_file | mimedecode.py -o output_file
earlier than -B */*.
+
+ Options -e/-I/-i can also work with multipart subparts of a MIME message. In
+ case of -I/-i the entire subtree of that multipart is removed; with -i it's
+ replaced with ignore warning.
+
+
Initially all 5 lists are empty, so without any additional parameters
the program always uses the default decoding (as -t */*).
@@ -536,9 +553,21 @@ cat input_file | mimedecode.py -o output_file
counter is prepended to the filename to avoid collisions; if there are no
name/filename parameters, or the name/filename parameters contain forbidden
characters (null, slash, backslash) the filename is just the serial counter.
+
+
+
+ If the file doesn't have any extensions (no dots in the value of the
+ name/filename parameters, or the name is just the counter) the program tries
+ to guess an extension by looking up the content type in mime.types files
+ including .mime.types file in the user's home directory (if it exists). If
+ the file has an extension the program doesn't try to verify that it
+ corresponds to the content type.
+
+
+
The file is saved in the directory set with -O (default is the current
- directory). The save options are processed before option -e so the user can
- save the message that causes the error.
+ directory). The save options are proceeded before -e options so the user can
+ save the message that causes an error.