From patchwork Sun Sep 22 11:57:55 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: 11155809 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 8698716B1 for ; Sun, 22 Sep 2019 11:58:25 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 5BF9520820 for ; Sun, 22 Sep 2019 11:58:25 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="O1WJn0ls" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728780AbfIVL6X (ORCPT ); Sun, 22 Sep 2019 07:58:23 -0400 Received: from mail-lj1-f175.google.com ([209.85.208.175]:33128 "EHLO mail-lj1-f175.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728182AbfIVL6X (ORCPT ); Sun, 22 Sep 2019 07:58:23 -0400 Received: by mail-lj1-f175.google.com with SMTP id a22so11084009ljd.0 for ; Sun, 22 Sep 2019 04:58:21 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:subject:date:message-id:mime-version :content-transfer-encoding; bh=aQWtkXD3xYH+PYHNVzp2d3PvdUqj598FX8eWNjtzcis=; b=O1WJn0lsQ4d4IIhdJPOgsNasTjME8SgZhXDEOvAiWp6/AlYzggu3iXQ5g0kC2voldp RHX7tFhE8u+9hBwOfzFwv9zOmHmuIKxNrB9vEfIQr/kxxa4GXGCojd1F2U8e3RWG2+kg rcVyLdSlDF/IYuSk+PpEnBKsKs2Y2dnaiya8GOkT30hLi0AQyfdnPK0j1+nEFIN4Ahfh mnqHXv1E2Lhj0hYiJuG3kfwADf++VXq2zVWQlYBcwE0XIcEVUQ5CdP7ytFDarIqvLGUK f/9dNnIXO/N4tIvKFlEg7PqtIF92S5eJQsWLWlBccN1Olf4UZkr3ZZqgctlUeM6L0a3Z tkHw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:mime-version :content-transfer-encoding; bh=aQWtkXD3xYH+PYHNVzp2d3PvdUqj598FX8eWNjtzcis=; b=JhASwDiMuoF6PLykIgAYvzz3fOPSLCEz2mLmzr6w2Sq888+Ne0MMJdoRVohr6IpVx5 0gptavFxetTDvciG1WX9mASawbESXNAgLgCNKY2uQqM1nipiE4+EjHepPDcq+JfNdYAS 3XFD5wHiXrH4JSoNtzrrGTxKzY+3d/1EJVyUR00tPxMrTYeCyboG/ZWDADqvj7RtxIp+ LQSGZi3jTpZI41YDmSTJuEqVsUxzqEb86vzMcywfpqLsNhBnM6L2kPyzI+JwQQTDa5Kp pVPKPzinSPn6i7zlzJEdXgXwhz49bzgP70P5rNxwixobvMyzzVUK/tIpnRzsm1Tjk1YH U4Xg== X-Gm-Message-State: APjAAAXQvpg3atn5MySn9Uu/oD3Sg4LVQKfe/J+m6MKOpbyxlssBjICw TahbglCAP88ulsyVpbzv2AHvF/Tm X-Google-Smtp-Source: APXvYqwqAWy1Xc2ikNa8vSGBo8BSQfh6Km/NzQrnllIJHHyCKbf65tm4QuQTgquzZzjoBIZHZ2vw4g== X-Received: by 2002:a2e:2953:: with SMTP id u80mr14990723lje.233.1569153499880; Sun, 22 Sep 2019 04:58:19 -0700 (PDT) Received: from localhost.localdomain (31-211-229-121.customers.ownit.se. [31.211.229.121]) by smtp.gmail.com with ESMTPSA id q24sm1622413ljj.6.2019.09.22.04.58.16 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 22 Sep 2019 04:58:19 -0700 (PDT) From: =?utf-8?q?Martin_=C3=85gren?= To: git@vger.kernel.org Subject: [PATCH 0/4] fix user-manual with Asciidoctor Date: Sun, 22 Sep 2019 13:57:55 +0200 Message-Id: X-Mailer: git-send-email 2.23.0 MIME-Version: 1.0 Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org This series makes user-manual.html and user-manual.pdf render well with Asciidoctor. The first patch is a while-at-it. The other three patches then align Asciidoctor-rendering with AsciiDoc, first with two bigger-scope patches, then with a local ASCII-art fix. I was happily surprised that there weren't more issues like the one fixed by patch 4/4. After this series, scrolling through AsciiDoc- vs Asciidoctor-rendered versions of the user manual side by side is a quite pleasant experience. Tested with Asciidoctor 1.5.5 and 1.5.7, but also with 2.0.10 using brian's recent work on getting 2.x to build the docs. Martin Martin Ă…gren (4): user-manual.txt: add missing section label user-manual.txt: change header notation asciidoctor-extensions.rb: handle "book" doctype in linkgit user-manual.txt: render ASCII art correctly under Asciidoctor Documentation/asciidoctor-extensions.rb | 7 +- Documentation/user-manual.txt | 377 +++++++++--------------- 2 files changed, 137 insertions(+), 247 deletions(-)