It's about time I brought my `nntpid' utility under version control,

[sgt/utils] / base64 / base64.but

diff --git a/base64/base64.but b/base64/base64.but
index ce12b0e..10c65f8 100644 (file)
--- 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-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
 
 
 \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 [ -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.
 
 
 \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,
 
 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.
 
 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.
 
 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.
 
 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.
 
 \dd If \cw{base64} is operating in encode mode, this controls the
 number of base64 characters output per line of the encoded file.


@@ -66,7 +66,15 @@ line break in the middle of the data at all.
 
 The base64 encoding converts between a group of three plaintext
 bytes and a group of four encoded bytes. \cw{base64} does not
 
 The base64 encoding converts between a group of three plaintext
 bytes and a group of four encoded bytes. \cw{base64} does not

-support breaking an encoded group across a line. Therefore, the
-\e{width} parameter passed to \cw{-c} must be a multiple of 4.
+support breaking an encoded group across a line (although it can
+handle it as input if it receives it). Therefore, the \e{width}
+parameter passed to \cw{-c} must be a multiple of 4.

 
 }
 
 }

+
+\U LICENCE
+
+\cw{base64} is free software, distributed under the MIT licence.
+Type \cw{base64 --licence} to see the full licence text.
+
+\versionid $Id$