about summary refs log tree commit homepage
path: root/Documentation/GNUmakefile
diff options
context:
space:
mode:
authorEric Wong <e@80x24.org>2019-12-15 05:02:53 +0000
committerEric Wong <e@80x24.org>2019-12-15 05:02:53 +0000
commitd9b5943af26d5df5f49ab5cbf9731597c6ca85df (patch)
tree9226b262f500d316e7efcee0410a28cf0aa09930 /Documentation/GNUmakefile
parentf8b38d786942c6693662d2f998e810b2a3071719 (diff)
downloadunicorn-d9b5943af26d5df5f49ab5cbf9731597c6ca85df.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 nowadays and already low on
disk space, so installing pandoc is not realistic.  Maybe it
wasn't realistic to other hackers with limited resources in the
past.

There's also dozens of subtly incompatible Markdown flavors out
there, most of which can't really handle manpages.  Anyways,
roff isn't too bad and at least groff is well-documented.

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 'Documentation/GNUmakefile')
-rw-r--r--Documentation/GNUmakefile30
1 files changed, 0 insertions, 30 deletions
diff --git a/Documentation/GNUmakefile b/Documentation/GNUmakefile
deleted file mode 100644
index 2c04bdb..0000000
--- a/Documentation/GNUmakefile
+++ /dev/null
@@ -1,30 +0,0 @@
-all::
-
-PANDOC = pandoc
-PANDOC_OPTS = -f markdown --email-obfuscation=none
-pandoc = $(PANDOC) $(PANDOC_OPTS)
-pandoc_html = $(pandoc) --toc -t html --no-wrap
-
-man1 := $(addsuffix .1,unicorn unicorn_rails)
-html1 := $(addsuffix .html,$(man1))
-
-all:: html man
-
-html: $(html1)
-man: $(man1)
-
-install-html: html
-        mkdir -p ../doc/man1
-        install -m 644 $(html1) ../doc/man1
-
-install-man: man
-        mkdir -p ../man/man1
-        install -m 644 $(man1) ../man/man1
-
-%.1: %.1.txt
-        $(pandoc) -s -t man < $< > $@+ && mv $@+ $@
-%.1.html: %.1.txt
-        $(pandoc_html) < $< > $@+ && mv $@+ $@
-
-clean::
-        $(RM) $(man1) $(html1)