From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: X-Spam-Status: No, score=-4.0 required=3.0 tests=ALL_TRUSTED,BAYES_00 shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from localhost (dcvr.yhbt.net [127.0.0.1]) by dcvr.yhbt.net (Postfix) with ESMTP id AE26E1F463; Sun, 15 Dec 2019 05:07:16 +0000 (UTC) Date: Sun, 15 Dec 2019 05:07:16 +0000 From: Eric Wong To: unicorn-public@bogomips.org Subject: [PUSHED] doc: replace pandoc-"Markdown" with real manpages Message-ID: <20191215050716.GA29702@dcvr> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline List-Id: 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.