From patchwork Mon Sep 16 19:00:26 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Martin_=C3=85gren?= X-Patchwork-Id: 11147679 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 97B4F1747 for ; Mon, 16 Sep 2019 19:00:53 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 7642020830 for ; Mon, 16 Sep 2019 19:00:53 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="GyvjU+8y" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1732853AbfIPTAw (ORCPT ); Mon, 16 Sep 2019 15:00:52 -0400 Received: from mail-lf1-f66.google.com ([209.85.167.66]:40358 "EHLO mail-lf1-f66.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725912AbfIPTAw (ORCPT ); Mon, 16 Sep 2019 15:00:52 -0400 Received: by mail-lf1-f66.google.com with SMTP id d17so818304lfa.7 for ; Mon, 16 Sep 2019 12:00:51 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=RonXXUa1BfCEMjRNE8XfYd6dtxm3Y6HWnEz0sNI4IIQ=; b=GyvjU+8yAGaSbsf5Wu8NqIn2Z9+S9zuyXBNkOAumHUKnX7riOccwAdTMuHi+/oprjs 4b733fdw/RSZV/oUvFX9pPMp2bl4ERczPh2z/lOh8jzVDibiElHI0HLitxnGpUQKcXpS u6UUQCtVCKzcIsm/LU/Cqw6KUBNWpFK5Cxzi5ND/BMrkFtmiZEycJ50vhJHbs7NPDVLA ImcppUyEI4yxdy9hDbqHXrE6a39D5IHQQV5OKTONrqgBGy7kS72eslrpBb4cdxF72bR+ n5AT2w/kKEeV9h8nAyFHn+EwNeoKPYiI9bBGP8Rg+fRIn08KY7F9XO7R6UJoMBzw3uC9 x1ig== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=RonXXUa1BfCEMjRNE8XfYd6dtxm3Y6HWnEz0sNI4IIQ=; b=Ck6OwNm+7TFJw9jbzOL/lxsPK0gn9VJiTPuzBQd7qP+7SW0uEQ8fpsqvNSvf/8uNiF QXM9lIoXllBX//xjm/nlb4mlXCQWJwd94Ll2OD/1H53RotRdfzVNBF31k+K22EIlC7gg njXjDHZXE+Ie+IvSam9A6Y4IWCsxugJlTHxTq+aLSJP//uuEYXRV9CcmJ9Pozwtbipey uE2lF1aAWRNqt/U57IlIwWbrZRFZfMmucPHEtIDfGOSRrqWyaA4maMLrqFYOMiPMAAEi p2/hOCjrsmtCfGL6DJTA94qZ3lFmDMr+TWmuVejdRetSQP/IBj8OMWZhbpPjDepjnXG0 y4Hw== X-Gm-Message-State: APjAAAUHbbf1oCbW9KWO03/KggIoYrNAIpdMYeuQlsyIRvNhTHvYdVLJ +THpBtYze9ROznh9gEP6vmdfkoCU X-Google-Smtp-Source: APXvYqx0GSWucxRY7q29K5jS5qi7n+YXNevAwZtIo7bHA96EItPBRXlZtLYtdRIvCIBMYKMW32f5xA== X-Received: by 2002:ac2:5925:: with SMTP id v5mr515079lfi.8.1568660449987; Mon, 16 Sep 2019 12:00:49 -0700 (PDT) Received: from localhost.localdomain (31-211-229-121.customers.ownit.se. [31.211.229.121]) by smtp.gmail.com with ESMTPSA id j28sm9127608lfh.57.2019.09.16.12.00.48 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 16 Sep 2019 12:00:49 -0700 (PDT) From: =?utf-8?q?Martin_=C3=85gren?= To: git@vger.kernel.org Cc: Todd Zullinger , Jeff King , =?utf-8?q?SZE?= =?utf-8?q?DER_G=C3=A1bor?= , "brian m. carlson" , Junio C Hamano Subject: [PATCH v3 1/3] Doc/Makefile: give mansource/-version/-manual attributes Date: Mon, 16 Sep 2019 21:00:26 +0200 Message-Id: X-Mailer: git-send-email 2.23.0 In-Reply-To: References: MIME-Version: 1.0 Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Rather than hardcoding "Git Manual" and "Git" as the manual and source in asciidoc.conf, provide them as attributes `manmanual` and `mansource`. Rename the `git_version` attribute to `manversion`. These new attribute names are not arbitrary, see, e.g., [1]. For AsciiDoc (8.6.10) and Asciidoctor <1.5.7, this is a no-op. Starting with Asciidoctor 1.5.7, `manmanual` and `mansource` actually end up in the xml-files and eventually in the rendered manpages. In particular, the manpage headers now render just as with AsciiDoc. No versions of Asciidoctor pick up the `manversion` [2], and older versions don't pick up any of these attributes. -- We'll fix that with a bit of a hack in the next commit. [1] https://asciidoctor.org/docs/user-manual/#man-pages [2] Note how [1] says "Not used by Asciidoctor". Signed-off-by: Martin Ă…gren --- Documentation/Makefile | 3 ++- Documentation/asciidoc.conf | 6 +++--- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/Documentation/Makefile b/Documentation/Makefile index dbf5a0f276..a67bc04ae8 100644 --- a/Documentation/Makefile +++ b/Documentation/Makefile @@ -122,7 +122,8 @@ ASCIIDOC_HTML = xhtml11 ASCIIDOC_DOCBOOK = docbook ASCIIDOC_CONF = -f asciidoc.conf ASCIIDOC_COMMON = $(ASCIIDOC) $(ASCIIDOC_EXTRA) $(ASCIIDOC_CONF) \ - -agit_version=$(GIT_VERSION) + -amanversion=$(GIT_VERSION) \ + -amanmanual='Git Manual' -amansource='Git' TXT_TO_HTML = $(ASCIIDOC_COMMON) -b $(ASCIIDOC_HTML) TXT_TO_XML = $(ASCIIDOC_COMMON) -b $(ASCIIDOC_DOCBOOK) MANPAGE_XSL = manpage-normal.xsl diff --git a/Documentation/asciidoc.conf b/Documentation/asciidoc.conf index 2c16c536ba..8fc4b67081 100644 --- a/Documentation/asciidoc.conf +++ b/Documentation/asciidoc.conf @@ -78,9 +78,9 @@ template::[header-declarations] {mantitle} {manvolnum} -Git -{git_version} -Git Manual +{mansource} +{manversion} +{manmanual} {manname}