From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: AS31976 209.132.180.0/23 X-Spam-Status: No, score=-5.4 required=3.0 tests=AWL,BAYES_00,DKIM_SIGNED, HEADER_FROM_DIFFERENT_DOMAINS,RCVD_IN_DNSWL_HI,RP_MATCHES_RCVD,T_DKIM_INVALID shortcircuit=no autolearn=ham autolearn_force=no version=3.4.0 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by dcvr.yhbt.net (Postfix) with ESMTP id 6D04B1F89C for ; Sat, 21 Jan 2017 21:59:44 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751399AbdAUV7l (ORCPT ); Sat, 21 Jan 2017 16:59:41 -0500 Received: from castro.crustytoothpaste.net ([75.10.60.170]:38708 "EHLO castro.crustytoothpaste.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751412AbdAUV7j (ORCPT ); Sat, 21 Jan 2017 16:59:39 -0500 Received: from genre.crustytoothpaste.net (unknown [IPv6:2001:470:b978:101:254c:7dd1:74c7:cde0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by castro.crustytoothpaste.net (Postfix) with ESMTPSA id CB684280AC; Sat, 21 Jan 2017 21:59:24 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=crustytoothpaste.net; s=default; t=1485035964; bh=OQRwCH9ob8dLSWlH9OIbwcgD9yWT3LcB2313PrITZUs=; h=From:To:Cc:Subject:Date:From; b=NDeYN4xlZeU97Vkd/+xPBzkwvtWHo9FIqiqeI6XoocGQ0ChNaijtYC5ZDwSeAAlS/ bniPx2p1yj6b/mZXcXckTUKGzfq1cmCVMvHBIva7dBBGAFFgaE2sM0hbsXwfsEbcPp GWHwzyZkXAiRuTLs7JPkys/X6cVkn/DHMhmmlhBQ4dMMU12Y1rdTgRZn+QU5zd+pLp LmW/iVNaF2t8bpsgJODtCVlZHGrhVW+sIT5L9sdGxOrp24oXmK3SrsfpY4HA9+shZD mu09+9OpAzSPC7feopf3ToLUMGjQ6XiS/xdevkKh035otHTETGLsglYlRlQ8jZOjK3 /oYUi9BdVscBF0OWsb5MHIm7dF0rOjcv/jwFabzYdGiA3pHBsITg67BQa0d3c7BE/T Tl2atH9FEMybOTRE2djCCeSm+nu2qtLLFL9liy4LHStEIr4cvYHotQuln+y7r70KDr HQHxydqSFjcKDwmgYm4MvOuqEXAvXoAjw+Jf2k8BLCUO/8T2lRa From: "brian m. carlson" To: git@vger.kernel.org Cc: Johannes Schindelin , Jeff King Subject: [PATCH 0/7] Macro for Asciidoctor support Date: Sat, 21 Jan 2017 21:59:05 +0000 Message-Id: <20170121215912.246691-1-sandals@crustytoothpaste.net> X-Mailer: git-send-email 2.11.0 Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org There are two major processors of AsciiDoc: AsciiDoc itself, and Asciidoctor. Both have advantages and disadvantages, but traditionally the documentation has been built with AsciiDoc, leading to some surprising breakage when building with Asciidoctor. Partially, this is due to the need to specify a significant number of macros on the command line when building with Asciidoctor. This series cleans up some issues building the documentation with Asciidoctor and provides two knobs, USE_ASCIIDOCTOR, which controls building with Asciidoctor, and ASCIIDOCTOR_EXTENSIONS_LAB, which controls the location of the Asciidoctor Extensions Lab, which is necessary to expand the linkgit macro. The need for the extensions could be replaced with a small amount of Ruby code, if that's considered desirable. Previous opinions on doing so were negative, however. In the process, I found several issues with cat-texi.perl, which have been fixed. It has also been modernized to use strict, warnings, and lexical file handles. I also made an attempt to produce more diffable texi files; I may follow up with additional series along this line to make the documentation build reproducibly. brian m. carlson (7): Documentation: fix warning in cat-texi.perl Documentation: modernize cat-texi.perl Documentation: remove unneeded argument in cat-texi.perl Documentation: sort sources for gitman.texi Documentation: add XSLT to fix DocBook for Texinfo Documentation: move dblatex arguments into variable Makefile: add a knob to enable the use of Asciidoctor Documentation/Makefile | 22 ++++++++++++++++++---- Documentation/cat-texi.perl | 21 ++++++++++++--------- Documentation/texi.xsl | 26 ++++++++++++++++++++++++++ Makefile | 6 ++++++ 4 files changed, 62 insertions(+), 13 deletions(-) create mode 100644 Documentation/texi.xsl