From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: X-Spam-Status: No, score=-2.9 required=3.0 tests=ALL_TRUSTED,AWL,BAYES_00, URIBL_BLOCKED shortcircuit=no autolearn=unavailable version=3.3.2 X-Original-To: yahns-public@yhbt.net Received: from localhost (dcvr.yhbt.net [127.0.0.1]) by dcvr.yhbt.net (Postfix) with ESMTP id DCA2D202F6; Sun, 14 Feb 2016 11:28:56 +0000 (UTC) Date: Sun, 14 Feb 2016 11:28:56 +0000 From: Eric Wong To: yahns-public@yhbt.net Subject: [PUSHED] doc: switch to perlpod (from pandoc-flavored Markdown) Message-ID: <20160214112856.GA17497@dcvr.yhbt.net> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline List-Id: pod2man(1) and pod2text(1) are already installed on most modern GNU/Linix systems including Debian and RedHat-based systems; pandoc(1) and Haskell are not, and we do not wish to waste precious bandwidth and disk space of potential packagers. perlpod(1) is also better standardized than any Markdown flavor, especially when it comes to generating manpages. Finally, I'm mildly proficient at Perl (it is similar to Ruby) and can poke around at the source if I encounter breakage. --- Documentation/.gitignore | 3 + Documentation/GNUmakefile | 27 +- Documentation/yahns-rackup.pod | 176 +++++++++++ Documentation/yahns-rackup.txt | 152 ---------- Documentation/yahns.pod | 97 +++++++ Documentation/yahns.txt | 72 ----- Documentation/yahns_config.pod | 641 +++++++++++++++++++++++++++++++++++++++++ Documentation/yahns_config.txt | 584 ------------------------------------- Rakefile | 5 + 9 files changed, 945 insertions(+), 812 deletions(-) create mode 100644 Documentation/yahns-rackup.pod delete mode 100644 Documentation/yahns-rackup.txt create mode 100644 Documentation/yahns.pod delete mode 100644 Documentation/yahns.txt create mode 100644 Documentation/yahns_config.pod delete mode 100644 Documentation/yahns_config.txt Big indentation changes necessary, so it breaks rename detection. Full patch here: http://yhbt.net/yahns.git/patch?id=4ef59c7e5e49