Skip to content

AsciiDoc vs Asciidoctor, once again

Martin Ågren git 1 version In review

Get series with b4
b4 am [email protected]

Versions newest first

  1. v1 Latest6 patches 15 repliesIn review

Patches in v1 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/6git-http-push.txt,git-send-pack.txt: avoid single quoteDocumentation/git-http-push.txt Documentation/git-send-pack.txt+2 -20 replies
2/6git-range-diff.txt: avoid single quotesDocumentation/git-range-diff.txt+3 -30 replies
3/6git-check-ref-format.txt: avoid single quoteDocumentation/git-check-ref-format.txt+3 -37 replies
4/6diff-options.txt: move monospace markup out of attributeDocumentation/diff-options.txt Documentation/git-log.txt Documentation/git-show.txt+3 -30 replies
5/6git-svn.txt: change verse to listing blockDocumentation/git-svn.txt+30 -150 replies
6/6Doc: use two backticks for monospace, not backtick+apostropheDocumentation/config/diff.txt Documentation/git-check-ignore.txt Documentation/git-describe.txt +1 more+6 -60 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/6] AsciiDoc vs Asciidoctor, once again

These patches reduce

  ./doc-diff --from-asciidoc --to-asciidoctor --cut-footer HEAD HEAD

from ~1200 to ~1000 lines. It's the usual mix of things where one or the other of the tools renders something less well, or where we're doing something odd in the source and we just happen to notice it in the diff.

My ulterior motive here is to have a smaller doc-diff when I post a patch to switch the default to Asciidoctor (with xmlto), so that it gets a bit easier to reason about. But if everybody gets prettier docs, that's also good.

Some of these rephrase wording such as "other peoples' commits" to avoid that apostrophe at the end of a word. I'm hoping those rephrasings don't regress the quality of the text -- if they do, I'll be happy to try something else.

Martin Ågren (6):
git-http-push.txt,git-send-pack.txt: avoid single quote git-range-diff.txt: avoid single quotes git-check-ref-format.txt: avoid single quote diff-options.txt: move monospace markup out of attribute git-svn.txt: change verse to listing block
Doc: use two backticks for monospace, not backtick+apostrophe

 Documentation/config/diff.txt          |  2 +-
 Documentation/diff-options.txt         |  2 +-
 Documentation/git-check-ignore.txt     |  2 +-
 Documentation/git-check-ref-format.txt |  6 +--
 Documentation/git-describe.txt         |  2 +-
 Documentation/git-http-push.txt        |  2 +-
 Documentation/git-log.txt              |  2 +-
 Documentation/git-range-diff.txt       |  6 +--
 Documentation/git-send-pack.txt        |  2 +-
 Documentation/git-show.txt             |  2 +-
 Documentation/git-svn.txt              | 51 +++++++++++++++++---------
 11 files changed, 47 insertions(+), 32 deletions(-)
Signature · 1 line
2.31.1.751.gd2f1c929bd