X-Git-Url: https://git.distorted.org.uk/~mdw/sgt/utils/blobdiff_plain/da0f85221585b50ae3b0de9fe2bec523acf60946..f6c8358c1ff5e343995be4323f49b3e97d4a43e1:/base64/base64.but diff --git a/base64/base64.but b/base64/base64.but index 0e09007..10c65f8 100644 --- a/base64/base64.but +++ b/base64/base64.but @@ -1,29 +1,29 @@ \cfg{man-identity}{base64}{1}{2004-11-20}{Simon Tatham}{Simon Tatham} -\cfg{man-mindepth}{1} -\C{base64-manpage} Man page for \cw{base64} +\title Man page for \cw{base64} -\H{base64-manpage-name} NAME +\U NAME \cw{base64} - stand-alone encoder and decoder for base64 -\H{base64-manpage-synopsis} SYNOPSIS +\U SYNOPSIS \c base64 [ -d ] [ filename ] \e bbbbbb bb iiiiiiii -\c base64 -e [ -cwidth ] [ filename ] -\e bbbbbb bb bbiiiii iiiiiiii +\c base64 -e [ -c width ] [ filename ] +\e bbbbbb bb bb iiiii iiiiiiii -\H{base64-manpage-description} DESCRIPTION +\U DESCRIPTION \cw{base64} is a command-line utility for encoding and decoding the \q{base64} encoding. -This encoding, defined in RFC 2045, is primarily used to encode -binary attachments in MIME e-mail, but is widely used in many other -applications as well. For example, the \q{Content-MD5} mail header -contains a small piece of base64; SSH private keys are generally -stored as base64-encoded blobs; and so on. +This encoding, defined in +\W{http://www.ietf.org/rfc/rfc2045.txt}{RFC 2045}, is primarily used +to encode binary attachments in MIME e-mail, but is widely used in +many other applications as well. For example, the \q{Content-MD5} +mail header contains a small piece of base64; SSH private keys are +generally stored as base64-encoded blobs; and so on. Other utilities, such as \cw{munpack}, exist which will take an entire MIME-encoded message, identify the base64-encoded subparts, @@ -34,7 +34,7 @@ need to inspect a Content-MD5 header or an SSH private key. base64 format \e{alone}. It does not try to understand MIME headers or anything other than raw data. -\H{base64-manpage-options} OPTIONS +\U OPTIONS By default (if neither \cw{-d} or \cw{-e} is supplied), \cw{base64} operates in decode mode. @@ -52,7 +52,7 @@ and output the decoded data on standard output. binary data from standard input or the supplied file name, encode it as base64, and output the encoded data on standard output. -\dt \cw{-c}\e{width} +\dt \cw{-c} \e{width} \dd If \cw{base64} is operating in encode mode, this controls the number of base64 characters output per line of the encoded file. @@ -72,7 +72,9 @@ parameter passed to \cw{-c} must be a multiple of 4. } -\H{base64-manpage-licence} LICENCE +\U LICENCE \cw{base64} is free software, distributed under the MIT licence. Type \cw{base64 --licence} to see the full licence text. + +\versionid $Id$