SUBDIRS = base64 cvt-utf8 multi xcopy
+DESTDIR = .
all:
for i in $(SUBDIRS); do make -C $$i; done
clean:
+ rm -f *.html *.tar.gz
for i in $(SUBDIRS); do make -C $$i clean; done
+
+html:
+ for i in $(SUBDIRS); do make -C $$i html DESTDIR=../$(DESTDIR); done
+
+release:
+ for i in $(SUBDIRS); do make -C $$i release DESTDIR=../$(DESTDIR); done
+DESTDIR = .
+
all: base64.1 base64
base64: base64.c
halibut --man=$@ $<
clean:
- rm -f *.1 base64
+ rm -f *.1 base64 *.html *.tar.gz
+
+html:
+ halibut --html=$(DESTDIR)/base64.html base64.but
+
+release: base64.1
+ mkdir -p reltmp/base64
+ ln -s ../../base64.c reltmp/base64
+ ln -s ../../base64.1 reltmp/base64
+ ln -s ../../base64.but reltmp/base64
+ ln -s ../../Makefile reltmp/base64
+ tar -C reltmp -chzvf $(DESTDIR)/base64.tar.gz base64
+ rm -rf reltmp
\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.
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.
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.
}
-\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.
+DESTDIR = .
+
all: cvt-utf8.1
%.1: %.but
halibut --man=$@ $<
clean:
- rm -f *.1
+ rm -f *.1 *.html *.tar.gz
+
+html:
+ halibut --html=$(DESTDIR)/cvt-utf8.html cvt-utf8.but
+
+release: cvt-utf8.1
+ mkdir -p reltmp/cvt-utf8
+ ln -s ../../cvt-utf8 reltmp/cvt-utf8
+ ln -s ../../cvt-utf8.1 reltmp/cvt-utf8
+ ln -s ../../cvt-utf8.but reltmp/cvt-utf8
+ ln -s ../../Makefile reltmp/cvt-utf8
+ tar -C reltmp -chzvf $(DESTDIR)/cvt-utf8.tar.gz cvt-utf8
+ rm -rf reltmp
\cfg{man-identity}{cvt-utf8}{1}{2004-03-24}{Simon Tatham}{Simon Tatham}
-\cfg{man-mindepth}{1}
+\cfg{html-chapter-numeric}{yes}
-\C{cvt-utf8-manpage} Man page for \cw{cvt-utf8}
+\title Man page for \cw{cvt-utf8}
-\H{cvt-utf8-manpage-name} NAME
+\U NAME
\cw{cvt-utf8} - convert between UTF-8 and Unicode, and analyse Unicode
-\H{cvt-utf8-manpage-synopsis} SYNOPSIS
+\U SYNOPSIS
\c cvt-utf8 [flags] [hex UTF-8 bytes and/or U+codepoints]
\e bbbbbbbb iiiii iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii
-\H{cvt-utf8-manpage-description} DESCRIPTION
+\U DESCRIPTION
\cw{cvt-utf8} is a tool for manipulating and analysing UTF-8 and
Unicode data. Its functions include:
read UTF-8 from standard input or to write pure UTF-8 to standard
output, you can do so using command-line options.
-\H{cvt-utf8-manpage-options} OPTIONS
+\U OPTIONS
\dt \cw{-i}
\dd Look up each code point in the Unihan database as well as the
main Unicode character database.
-\H{cvt-utf8-manpage-examples} EXAMPLES
+\U EXAMPLES
In \cw{cvt-utf8}'s native mode, it simply analyses input Unicode or
UTF-8 data. For example, you can give a list of Unicode code
\c midst of; hit (target); attain
\c U-00006587 E6 96 87 <han> literature, culture, writing
-\H{cvt-utf8-manpage-admin} ADMINISTRATION
+\U ADMINISTRATION
In order to print the \cw{unicode.org} official name of each
character, \cw{cvt-utf8} requires file mapping code points to names.
If either of these files is not found, \cw{cvt-utf8} will still
perform the rest of its functions.
-\H{cvt-utf8-manpage-licence} LICENCE
+\U LICENCE
\cw{cvt-utf8} is free software, distributed under the MIT licence.
Type \cw{cvt-utf8 --licence} to see the full licence text.
+DESTDIR = .
+
all: multi.1
%.1: %.but
halibut --man=$@ $<
clean:
- rm -f *.1
+ rm -f *.1 *.html *.tar.gz
+
+html:
+ halibut --html=$(DESTDIR)/multi.html multi.but
+
+release: multi.1
+ mkdir -p reltmp/multi
+ ln -s ../../multi reltmp/multi
+ ln -s ../../multi.1 reltmp/multi
+ ln -s ../../multi.but reltmp/multi
+ ln -s ../../Makefile reltmp/multi
+ tar -C reltmp -chzvf $(DESTDIR)/multi.tar.gz multi
+ rm -rf reltmp
\cfg{man-identity}{multi}{1}{2004-11-20}{Simon Tatham}{Simon Tatham}
\cfg{man-mindepth}{1}
-\C{multi-manpage} Man page for \cw{multi}
+\title Man page for \cw{multi}
-\H{multi-manpage-name} NAME
+\U NAME
\cw{multi} - bulk file rename/copy utility using Perl regexps
-\H{multi-manpage-synopsis} SYNOPSIS
+\U SYNOPSIS
\c multi [ -n | -q ] [ -r ] cmd perlfragment file [file...]
\e bbbbb bb bb bb iii iiiiiiiiiiii iiii iiii
\c multi [ -n | -q ] [ -r ] - cmd cmd - perlfragment file [file...]
\e bbbbb bb bb bb iii iii iiiiiiiiiiii iiii iiii
-\H{multi-manpage-description} DESCRIPTION
+\U DESCRIPTION
\cw{multi} is a utility which allows you to invoke a command
(typically, but not always, \cw{mv} or \cw{cp}) on a lot of files in
passing \cw{mv} or \cw{cp} as the command. However, it can have more
complex uses as well; see the examples below.
-\H{multi-manpage-args} ARGUMENTS
+\U ARGUMENTS
\dt \e{cmd}
to be transformed. Typically these will be generated by typing one
or more wildcard expressions on the shell command line.
-\H{multi-manpage-options} OPTIONS
+\U OPTIONS
By default, \cw{multi} will print every command it executes on
standard output, so that you can see what it has just done (in case
\dd Reverse the order of arguments to the subcommand, so that it
receives the transformed file name \e{before} the original one.
-\H{multi-manpage-examples} EXAMPLES
+\U EXAMPLES
The simplest use of \cw{multi} is to rename a large number of files.
Suppose, for example, you have a lot of text files with \cw{.txt}
programs and you want to quickly compile them all into binaries:
\c $ multi -r - cc -o - 's/.c$//' *.c
-\c bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb
+\e bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb
\c cc -o bar bar.c
\c cc -o baz baz.c
\c cc -o foo foo.c
\c grep foo baz.txt > baz.grepped
\c grep foo foo.txt > foo.grepped
-\H{multi-manpage-ack} ACKNOWLEDGEMENTS
+\U ACKNOWLEDGEMENTS
The O'Reilly book \q{Programming Perl} includes a simple example
script which contains the core idea of this program. It takes a
internal \cw{rename} function. \cw{multi} is a complete rewrite of
this basic idea, supplying more options and configurability.
-\H{multi-manpage-licence} LICENCE
+\U LICENCE
\cw{multi} is free software, distributed under the MIT licence. Type
\cw{multi --licence} to see the full licence text.
+DESTDIR = .
+
X11LIB=-L/usr/X11R6/lib -lX11
all: xcopy.1 xcopy
halibut --man=$@ $<
clean:
- rm -f *.1 xcopy
+ rm -f *.1 xcopy *.html *.tar.gz
+
+html:
+ halibut --html=$(DESTDIR)/xcopy.html xcopy.but
+
+release: xcopy.1
+ mkdir -p reltmp/xcopy
+ ln -s ../../xcopy.c reltmp/xcopy
+ ln -s ../../xcopy.1 reltmp/xcopy
+ ln -s ../../xcopy.but reltmp/xcopy
+ ln -s ../../Makefile reltmp/xcopy
+ tar -C reltmp -chzvf $(DESTDIR)/xcopy.tar.gz xcopy
+ rm -rf reltmp
+
+
\cfg{man-identity}{xcopy}{1}{2004-08-02}{Simon Tatham}{Simon Tatham}
\cfg{man-mindepth}{1}
-\C{xcopy-manpage} Man page for \cw{xcopy}
+\title Man page for \cw{xcopy}
-\H{xcopy-manpage-name} NAME
+\U NAME
\cw{xcopy} - read and write text to/from an X selection from the
command line
-\H{xcopy-manpage-synopsis} SYNOPSIS
+\U SYNOPSIS
\c xcopy [ -r ] [ -u | -c ] [ -C ]
\e bbbbb bb bb bb bb
-\H{xcopy-manpage-description} DESCRIPTION
+\U DESCRIPTION
\cw{xcopy} is a command-line utility for manipulating the X selection.
(multiple-character-set) text. Use the \cw{-u}, \cw{-c} and \cw{-C}
options to control this aspect of its behaviour.
-\H{xcopy-manpage-options} OPTIONS
+\U OPTIONS
By default (if \cw{-r} is not supplied), \cw{xcopy} operates in
write mode.
sequences and control characters, in which case you may need to use
\cw{-C} to disable conversion to compound text.
-\H{xcopy-manpage-bugs} BUGS
+\U BUGS
Occasionally \cw{xcopy -r} completely fails to notice selection data
owned by another process. I have not yet reproduced this reliably;
they don't appear to work very well (missing out many characters
which they could have converted).
-\H{xcopy-manpage-licence} LICENCE
+\U LICENCE
\cw{xcopy} is free software, distributed under the MIT licence. Type
\cw{xcopy --licence} to see the full licence text.