unicorn Ruby/Rack server user+dev discussion/patches/pulls/bugs/help
 help / color / mirror / Atom feed
* [PUSHED] doc: replace pandoc-"Markdown" with real manpages
@ 2019-12-15  5:07 Eric Wong
  0 siblings, 0 replies; only message in thread
From: Eric Wong @ 2019-12-15  5:07 UTC (permalink / raw)
  To: unicorn-public

Patch is unfortunately gigantic from whitespace changes,
but you can view/download it here and every other mirror.
https://bogomips.org/unicorn.git/commit/?id=d9b5943af26d5df5f49ab5cbf9731597c6ca85df

Subject: doc: replace pandoc-"Markdown" with real manpages

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.

^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~2019-12-15  5:07 UTC | newest]

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-12-15  5:07 [PUSHED] doc: replace pandoc-"Markdown" with real manpages Eric Wong

unicorn Ruby/Rack server user+dev discussion/patches/pulls/bugs/help

This inbox may be cloned and mirrored by anyone:

	git clone --mirror https://yhbt.net/unicorn-public
	git clone --mirror http://ou63pmih66umazou.onion/unicorn-public

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V1 unicorn-public unicorn-public/ https://yhbt.net/unicorn-public \
		unicorn-public@yhbt.net unicorn-public@bogomips.org mongrel-unicorn@rubyforge.org mongrel-unicorn-GrnCvJ7WPxnNLxjTenLetw@public.gmane.org
	public-inbox-index unicorn-public

Example config snippet for mirrors.
Newsgroups are available over NNTP:
	nntp://news.public-inbox.org/inbox.comp.lang.ruby.unicorn
	nntp://ou63pmih66umazou.onion/inbox.comp.lang.ruby.unicorn
 note: .onion URLs require Tor: https://www.torproject.org/

code repositories for the project(s) associated with this inbox:

	unicorn.git

AGPL code for this site: git clone https://public-inbox.org/public-inbox.git