unicorn Ruby/Rack server user+dev discussion/patches/pulls/bugs/help
 help / color / mirror / code / Atom feed
From: Eric Wong <e@80x24.org>
To: unicorn-public@bogomips.org
Subject: [PUSHED] doc: replace pandoc-"Markdown" with real manpages
Date: Sun, 15 Dec 2019 05:07:16 +0000	[thread overview]
Message-ID: <20191215050716.GA29702@dcvr> (raw)

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.

                 reply	other threads:[~2019-12-15  5:07 UTC|newest]

Thread overview: [no followups] expand[flat|nested]  mbox.gz  Atom feed

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://yhbt.net/unicorn/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20191215050716.GA29702@dcvr \
    --to=e@80x24.org \
    --cc=unicorn-public@bogomips.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://yhbt.net/unicorn.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).