git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH 0/4] fix user-manual with Asciidoctor

From
MÅMartin Ågren <martin.agren@gmail.com>
Date
Sep 22, 2019, 11:57 UTC
Message-ID
<cover.1569152396.git.martin.agren@gmail.com>

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(-)
-- 
2.23.0
Next: Martin Ågren
Message 1 of 5 in “fix user-manual with Asciidoctor”
  1. 0/4 fix user-manual with AsciidoctorMartin Ågren, Sep 22, 2019
  2. 1/4 user-manual.txt: add missing section labelMartin Ågren, Sep 22, 2019
  3. 2/4 user-manual.txt: change header notationMartin Ågren, Sep 22, 2019
  4. 3/4 asciidoctor-extensions.rb: handle "book" doctype in linkgitMartin Ågren, Sep 22, 2019
  5. 4/4 user-manual.txt: render ASCII art correctly under AsciidoctorMartin Ågren, Sep 22, 2019

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.