about summary refs log tree commit homepage
path: root/GNUmakefile
diff options
context:
space:
mode:
authorEric Wong <bofh@yhbt.net>2020-01-09 07:50:17 +0000
committerEric Wong <bofh@yhbt.net>2020-01-26 05:34:37 +0000
commit828679d0aacb270115355689036bee00bae096ad (patch)
tree88701f60503ede2a28adc68231eccb22df33f3b1 /GNUmakefile
parentb9650fdd82c4ace8f26a7d97a7f1d0ab02ee2447 (diff)
downloadrainbows-828679d0aacb270115355689036bee00bae096ad.tar.gz
Trying to install pandoc on an x86-64 Debian stable system says:
> Need to get 15.2 MB of archives.
> After this operation, 117 MB of additional disk space will be used.

My laptop is on metered Internet, now, and low on disk space, so
installing pandoc is too expensive.

There's also dozens of incompatible Markdown flavors out there,
most of which don't really handle manpages.

Updating the website now requires olddoc 1.8.0 (which is much
smaller than pandoc), but I'm the only one with that burden.  On
the flipside more users can update and read the manpages locally
without extra software, since nearly every developer's *nix
system has man(1) command, unlike pandoc.
Diffstat (limited to 'GNUmakefile')
-rw-r--r--GNUmakefile25
1 files changed, 12 insertions, 13 deletions
diff --git a/GNUmakefile b/GNUmakefile
index 70cc708..3a739b3 100644
--- a/GNUmakefile
+++ b/GNUmakefile
@@ -4,28 +4,27 @@ RSYNC_DEST := yhbt.net:/srv/yhbt/rainbows
 rfpackage := rainbows
 PLACEHOLDERS := rainbows_1 Summary
 
-man-rdoc: man html
-        $(MAKE) -C Documentation comparison.html
-doc:: man-rdoc
-include pkg.mk
+Documentation/comparison.html: Documentation/comparison.haml
+        haml < $< >$@+ && mv $@+ $@
+
+# only for the website
+doc :: Documentation/comparison.html
+doc :: man/man1/rainbows.1.html
 
-base_bins := rainbows
-bins := $(addprefix bin/, $(base_bins))
-man1_bins := $(addsuffix .1, $(base_bins))
-man1_paths := $(addprefix man/man1/, $(man1_bins))
+include pkg.mk
+man1 := man/man1/rainbows.1
 
 clean:
         -$(MAKE) -C Documentation clean
+        $(RM) $(man1) $(html1)
 
-man html:
-        $(MAKE) -C Documentation install-$@
+pkg_extra += $(man1) lib/rainbows/version.rb
 
-pkg_extra += $(man1_paths) lib/rainbows/version.rb
+%.1.html: %.1
+        $(OLDDOC) man2html -o $@ $<
 
 lib/rainbows/version.rb: GIT-VERSION-FILE
 
 all:: test
 test: lib/rainbows/version.rb
         $(MAKE) -C t
-
-.PHONY: man html