Author: Bjarni Ingi Gislason Description: editorial changes --- a/unixpk.man +++ b/unixpk.man @@ -73,22 +73,22 @@ mpack \- pack a file in MIME format .I newsgroups .I file .SH DESCRIPTION -The +The .I mpack -program encodes the -the named file in one or more MIME messages. +program encodes the +named file in one or more MIME messages. The resulting messages are mailed to one or more recipients, -written to a named file or set of files, or posted to a set of -newsgroups. +written to a named file or set of files, +or posted to a set of newsgroups. .PP .SH OPTIONS .TP -.BI \-a +.B \-a Set the Content-Disposition to attachment. If \-a is not used the Content-Disposition is inline. .TP .BI \-s " subject" -Set the +Set the .B Subject header field to .IR Subject . @@ -103,25 +103,28 @@ in an introductory section at the beginn generated message. .TP .BI \-m " maxsize" -Split the message (if necessary) into partial messages, each not -exceeding +Split the message +(if necessary) +into partial messages, +each not exceeding .I maxsize -characters. The default limit is the value of the +characters. The default limit is the value of the .B SPLITSIZE -environment variable, or no limit if the environment variable -does not exist. -Specifying a +environment variable, +or no limit +if the environment variable does not exist. +Specifying a .I maxsize of 0 means there is no limit to the size of the generated message. .TP .BI \-c " content-type" Label the included file as being of MIME type .IR content-type , -which must be a subtype of +which must be a subtype of .BR application , .BR audio , .BR image , -or +or .BR video . If this switch is not given, .B mpack @@ -130,8 +133,8 @@ examines the file to determine its type. .BI \-o " outputfile" Write the generated message to the file .IR outputfile . -If the message has to be split, the partial messages will instead be -written to the files +If the message has to be split, +the partial messages will instead be written to the files .IR outputfile .01, .IR outputfile .02, etc. @@ -152,6 +155,6 @@ Mail the generated messages to the speci Directory to store temporary files. Default is /tmp. .TP .B SPLITSIZE -Default value of the -m switch. -.SH "REPORTING BUGS" +Default value of the \-m switch. +.SH REPORTING BUGS Send all bug reports to mpack\-bugs@andrew.cmu.edu. --- a/unixunpk.man +++ b/unixunpk.man @@ -24,85 +24,99 @@ munpack \- unpack messages in MIME or sp .I "filename \&..." ] .SH DESCRIPTION -The +The .I munpack program reads each RFC-822 message .I filename -and writes all non-text MIME parts or split-uuencoded files as files. -If no filename argument is given, +and writes all non-text MIME parts +or split-uuencoded files as files. +If no filename argument is given, .B munpack reads from standard input. .LP -If the message suggests a file name to use for the imbedded part, that -name is cleaned of potential problem characters and used for the -output file. If the suggested filename includes subdirectories, they -will be created as necessary. -If the message does not suggest a file name, the names -"part1", "part2", etc are used in sequence. -.LP -If the imbedded part was preceded with textual information, that -information is also written to a file. The file is named the same as -the imbedded part, with any filename extension replaced with ".desc". +If the message suggests a file name to use for the imbedded part, +that name is cleaned of potential problem characters +and used for the output file. +If the suggested filename includes subdirectories, +they will be created as necessary. +If the message does not suggest a file name, +the names "part1", "part2", etc.\& are used in sequence. +.LP +If the imbedded part was preceded with textual information, +that information is also written to a file. +The file is named the same as the imbedded part, +with any filename extension replaced with ".desc". .SH OPTIONS .TP .B \-f -Force overwriting of existing files. If a message suggests a file -name of an existing file, the file will be overwritten. Without this -flag, -.B -munpack -appends ".1", ".2", etc to find a nonexistent file. +Force overwriting of existing files. +If a message suggests a file name of an existing file, +the file will be overwritten. +Without this flag, +.B munpack +appends ".1", ".2", etc.\& to find a nonexistent file. .TP .B \-q -Be quiet. Suppresses messages about saving partial messages and about -messages with no interesting information. +Be quiet. +Suppresses messages about saving partial messages +and about messages with no interesting information. .TP .B \-t -Also write the text MIME parts of multipart messages as files. By -default, text parts that do not have a filename parameter do not get -unpacked. This option effectively disables the ".desc" file feature -for MIME messages. +Also write the text MIME parts of multipart messages as files. +By default, +text parts +that do not have a filename parameter +do not get unpacked. +This option effectively disables the ".desc" file feature for MIME messages. .TP .BI \-r " character" -If the suggested filename contains invalid characters, they are -replaced with this character. The default replacement character is +If the suggested filename contains invalid characters, +they are replaced with this character. +The default replacement character is "X". .TP .BI \-C " directory" -Change the current directory to +Change the current directory to .I directory -before reading any files. This is useful when invoking +before reading any files. This is useful when invoking .B munpack from a mail or news reader. -.SH "DECODING MIME" -.LP -To decode a MIME message, first save it to a text file. If possible, -save it with all headers included. +.SH DECODING MIME +To decode a MIME message, +first save it to a text file. +If possible, +save it with all headers included. .I Munpack can decode some MIME files -when the headers are missing or incomplete, other files it cannot -decode without having the information in the headers. In general, -messages which have a statement at the beginning that they are in MIME -format can be decoded without the headers. Messages which have been -split into multiple parts generally require all headers in order to be -reassembled and decoded. -.LP -Some LAN-based mail systems and some mail providers (including America -Online, as of the writing of this document) place the mail headers at -the bottom of the message, instead of at the top of the message. If -you are having problems decoding a MIME message on such a system, you -need to convert the mail back into the standard format by removing the -system's nonstandard headers and moving the standard Internet headers -at the top of the message (separated from the message body with a -blank line). +when the headers are missing or incomplete, +other files +it cannot decode without having the information in the headers. +In general, +messages which have a statement at the beginning +that they are in MIME format +can be decoded without the headers. +Messages +which have been split into multiple parts +generally require all headers in order to be reassembled and decoded. +.LP +Some LAN-based mail systems and some mail providers +(including America Online, as of the writing of this document) +place the mail headers at the bottom of the message, +instead of at the top of the message. +If you are having problems decoding a MIME message on such a system, +you need to convert the mail back into the standard format +by removing the system's nonstandard headers +and moving the standard Internet headers at the top of the message +(separated from the message body with a blank line). .LP -There must be exactly one message per file. +There must be exactly one message per file. .I Munpack -cannot deal with -multiple messages in a single file, to decode things correctly it must -know when one message ends and the next one begins. +cannot deal with multiple messages in a single file, +to decode things correctly it must know +when one message ends and the next one begins. .LP -To decode a message, run the command: +To decode a message, +run the command: .IP .IB munpack " file" .LP @@ -121,5 +135,5 @@ Directory to store temporary files. Def .TP .B $TMPDIR/m-prts-$USER/ Directory used to store partial messages awaiting reassembly. -.SH "REPORTING BUGS" +.SH REPORTING BUGS Send all bug reports to mpack\-bugs@andrew.cmu.edu.