man page generation

diff --git a/Makefile.PL b/Makefile.PL
index df26287faa3c04f040752bc59a36d7c1cd0b113a..d51334c1fce62e2f41af0ac40ea96d05732cbfe6 100755 (executable)
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -14,10 +14,11 @@ pure_install:: extra_install
 extra_build:
        ./ikiwiki doc templates html --wikiname="ikiwiki" --verbose \
                --nosvn --exclude=/discussion
 extra_build:
        ./ikiwiki doc templates html --wikiname="ikiwiki" --verbose \
                --nosvn --exclude=/discussion

-
+       ./mdwn2man doc/usage.mdwn > ikiwiki.man
+               

 extra_clean:
 extra_clean:

-       rm -rf html
-       rm -rf doc/.ikiwiki
+       rm -rf html doc/.ikiwiki
+       rm -f ikiwiki.man

 
 extra_install:
        install -d $(PREFIX)/share/ikiwiki/templates
 
 extra_install:
        install -d $(PREFIX)/share/ikiwiki/templates

diff --git a/debian/rules b/debian/rules
index 7a0f8868fee3ca56307098d0473563fa34992abe..b65fa72f9e9b4f281ace1cd02ae317291be4a685 100755 (executable)
--- a/debian/rules
+++ b/debian/rules
@@ -24,7 +24,7 @@ binary-indep: build
        $(MAKE) pure_install INSTALLDIRS=vendor \
                PREFIX=$(shell pwd)/debian/ikiwiki/$(shell perl -MConfig -e 'print $$Config{prefix}')
        dh_installdocs html
        $(MAKE) pure_install INSTALLDIRS=vendor \
                PREFIX=$(shell pwd)/debian/ikiwiki/$(shell perl -MConfig -e 'print $$Config{prefix}')
        dh_installdocs html

-       dh_installexamples
+       dh_installman ikiwiki.man

        dh_installchangelogs
        dh_compress
        dh_fixperms
        dh_installchangelogs
        dh_compress
        dh_fixperms

diff --git a/doc/todo.mdwn b/doc/todo.mdwn
index 7565c5b5934373f189068729c78cf1b0228c81a3..68b1ccff50c4de69e902274295ad9888380382e6 100644 (file)
--- a/doc/todo.mdwn
+++ b/doc/todo.mdwn
@@ -19,11 +19,6 @@ is built. (As long as all changes to all pages is ok.)
   already, so just look at the userdb, svnlook at what's changed, and send
   mails to people who have subscribed.
 
   already, so just look at the userdb, svnlook at what's changed, and send
   mails to people who have subscribed.
 

-## docs
-
-Need to turn [[usage]] into a man page.
-this wiki too. Can markdown generate a man page somehow?
-

 ## pluggable renderers
 
 I'm considering a configurable rendering pipeline for each supported
 ## pluggable renderers
 
 I'm considering a configurable rendering pipeline for each supported

diff --git a/doc/usage.mdwn b/doc/usage.mdwn
index 0377014fd431d0344999775715569049b49a5173..75e3aa2461eb1173f48a923b763d3c14107f6e2e 100644 (file)
--- a/doc/usage.mdwn
+++ b/doc/usage.mdwn
@@ -100,3 +100,5 @@ flags such as --verbose can be negated with --no-verbose.
 # AUTHOR
 
 Joey Hess <joey@kitenet.net>
 # AUTHOR
 
 Joey Hess <joey@kitenet.net>

+
+Warning: this page is automatically made into ikiwiki's man page, edit with care

diff --git a/mdwn2man b/mdwn2man
new file mode 100755 (executable)
index 0000000..13b1b84
--- /dev/null
+++ b/mdwn2man
@@ -0,0 +1,35 @@
+#!/usr/bin/perl
+# Warning: hack
+
+print ".TH ikiwiki 1\n";
+
+while (<>) {
+       s/^#\s/.SH /;
+       s/^\s+//;
+       s/^Warning:.*//g;
+       s/^$/.PP\n/;
+       s/\[\[//g;
+       s/\]\]//g;
+       s/\`//g;
+       s/^\*\s+(.*)/.IP "$1"/;
+       next if $_ eq ".PP\n" && $skippara;
+       if (/^.IP /) {
+               $inlist=1;
+               $spippara=0;
+       }
+       elsif (/.SH/) {
+               $skippara=0;
+               $inlist=0;
+       }
+       elsif (/^\./) {
+               $skippara=1;
+       }
+       else {
+               $skippara=0;
+       }
+       if ($inlist && $_ eq ".PP\n") {
+               $_=".IP\n";
+       }
+
+       print $_;
+}