X-Git-Url: https://git.phdru.name/?a=blobdiff_plain;f=mimedecode.docbook;h=8fbb51be36769d5d028d79dd3a24d959465c4c87;hb=b47b1f1629b4a4887a422edcf54bf23865c2e2ae;hp=83b0e54cd213791c4a1f40517d07b2ed43fc5345;hpb=5a0b966d01b89f668ce0cea40208d511e1bc04f7;p=mimedecode.git diff --git a/mimedecode.docbook b/mimedecode.docbook index 83b0e54..8fbb51b 100644 --- a/mimedecode.docbook +++ b/mimedecode.docbook @@ -48,16 +48,40 @@ - + - + - + - + + + + + + + + + + + + + + + + + + + + + + + + + @@ -131,6 +155,13 @@ + + + Please be warned that in the following options asterisk is a shell + metacharacter and should be escaped or quoted. Either write -d \*,-h1,-h2 + or -d '*,-h1,-h2' or such. + + OPTIONS @@ -196,12 +227,25 @@ - -d header + -d header1[,header2,header3...] + + + Add the header(s) to a list of headers to decode; initially the + list contains headers "From", "To", "Cc", "Reply-To", + "Mail-Followup-To" and "Subject". + + + + + + -d *[,-header1,-header2,-header3...] - Add the header to a list of headers to decode; initially the list - contains headers "From", "To", "Cc", "Reply-To", "Mail-Followup-To" - and "Subject". + This variant completely changes headers decoding. First, the list of + headers to decode is cleared. Then all the headers are decoded + except the given list of exceptions (headers listed with '-'). In + this mode it would be meaningless to give more than one -d options + but the program doesn't enforce it. @@ -216,13 +260,42 @@ - -p header:param + -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). + Initially the list contains header "Content-Type", parameter "name"; + and header "Content-Disposition", parameter "filename". + + + + + + -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 + ones. + + + + + + -p header1[,header2,header3,...]:*[,-param1,-param2,-param3,...] - 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". + Decode all parameters except listed for the given list of headers. + + + + + + -p *[,-header1,-header2,-header3,...]:*[,-param1,-param2,-param3,...] + + + Decode all parameters except listed for all headers (except listed). @@ -237,21 +310,49 @@ - -r header + -r header1[,header2,header3...] - Add the header to a list of headers to remove completely; initially - the list is empty. + Add the header(s) to a list of headers to remove completely; + initially the list is empty. - -R header:param + -r *[,-header1,-header2,-header3...] + + + Remove all headers except listed. + + + + + + -R header1[,header2,header3,...]:param1[,param2,param3,...] + + + Add the parameters(s) to a list of headers parameters to remove; + the parameters will be decoded only for the given header(s). + Initially the list is empty. + + + + + + -R *[,-header1,-header2,-header3,...]:param1[,param2,param3,...] + + + + -R header1[,header2,header3,...]:*[,-param1,-param2,-param3,...] + + + + -R *[,-header1,-header2,-header3,...]:*[,-param1,-param2,-param3,...] - Add the pair (header, param) to a list of headers parameters to - remove; initially the list is empty. + Remove listed parameters (or all parameters except listed) frome + these headers (or from all headers except listed).