Skip to content

fix user-manual with Asciidoctor

Martin Ågren git 1 version New

Get series with b4
b4 am [email protected]

Versions newest first

  1. v1 Latest4 patches 0 repliesNew

Patches in v1 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/4user-manual.txt: add missing section labelDocumentation/user-manual.txt+1 -00 replies
2/4user-manual.txt: change header notationDocumentation/user-manual.txt+120 -2360 replies
3/4asciidoctor-extensions.rb: handle "book" doctype in linkgitDocumentation/asciidoctor-extensions.rb+5 -20 replies
4/4user-manual.txt: render ASCII art correctly under AsciidoctorDocumentation/user-manual.txt+11 -90 replies

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v1 yet.

Read the v1 thread

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

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(-)
Signature · 1 line
2.23.0