summaryrefslogtreecommitdiffstats
path: root/Makefile
diff options
context:
space:
mode:
authorOwen W. Taylor <otaylor@fishsoup.net>2009-09-05 09:50:38 -0400
committerOwen W. Taylor <otaylor@fishsoup.net>2009-09-05 09:53:31 -0400
commit170f40c2d1220e66c3084dafc135745357660956 (patch)
treea782111981db39e2cdf9b5c94bad7af8e2cf680f /Makefile
parent18e6fdc293fe416146512c35c4ce6a77cfc2ee39 (diff)
downloadgit-bz-170f40c2d1220e66c3084dafc135745357660956.tar.gz
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.
Diffstat (limited to 'Makefile')
-rw-r--r--Makefile14
1 files changed, 14 insertions, 0 deletions
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
+