From 170f40c2d1220e66c3084dafc135745357660956 Mon Sep 17 00:00:00 2001 From: "Owen W. Taylor" Date: Sat, 5 Sep 2009 09:50:38 -0400 Subject: Split out documentation Move the documentation from a giant comment at the start of the file into a separate asciidoc document. Among other revisions an 'EXAMPLE SESSION' section is added to give a sense of the normal workflow. Add a Makefile and asciidoc.conf for converting the asciidoc into HTML or a man page. --- Makefile | 14 ++++++++++++++ 1 file changed, 14 insertions(+) create mode 100644 Makefile (limited to 'Makefile') diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..45576f6 --- /dev/null +++ b/Makefile @@ -0,0 +1,14 @@ +%.xml: %.txt + asciidoc -f asciidoc.conf -d manpage -b docbook $< + +%.html: %.txt + asciidoc -f asciidoc.conf -d manpage $< + +%.1: %.xml + xmlto man $< + +upload-html: git-bz.html + DEST=`git config local.upload-html-dest` ; \ + if [ $$? = 0 ] ; then : ; else echo "upload location not configured" ; exit 1 ; fi ; \ + scp $< $$DEST + -- cgit v1.2.3