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

RE: [PATCH v2 00/11] doc: asciidoctor: direct man page creation and fixes

From
Felipe Contreras <felipe.contreras@gmail.com>
Date
May 21, 2021, 22:51 UTC
Message-ID
<60a83956270be_81ac020848@natae.notmuch>
In-Reply-To
<20210521224452.530852-1-felipe.contreras@gmail.com>
Felipe Contreras wrote:
Show 12 quoted lines
> This patch series enables direct man page creation with asciidoctor, but in addition tries to
> minimize the difference with asciidoc+docbook.
> 
> I fixed as many issues as I could, and now the doc-diff looks very sensible. I could not find any
> major issues, however, some minor ones still remain.
> 
> On the other hand the asciidoc method has issues as well, so it's not clear which method is superior
> at this point; both have advantages and disadvantages.
> 
> At the very least the man pages with pure asciidoctor should be quite usable now.
> 
> This series builds on top of my previous cleanups [1].
I forgot to mention what changed since v1:
 * The option USE_ASCIIDOCTOR_MANPAGE was added
 * Jeff's patch for *asciidoctor-direct optiosn to doc-diff was added
 * Martin Ågren's patch to remove -cut-footer was added
 * The format of linkgit was updated to be closer to brian's version
   (though not quite the same)
 * A few tiny cleanups
-- 
Felipe Contreras
Previous: Felipe Contreras
Message 17 of 17 in “doc: asciidoctor: direct man page creation and fixes”
  1. 00/11 doc: asciidoctor: direct man page creation and fixesFelipe Contreras, May 21, 2021
  2. 01/11 doc: doc-diff: set docdate manuallyFelipe Contreras, May 21, 2021
  3. Bagas SanjayaMay 22, 2021
  4. Felipe ContrerasMay 22, 2021
  5. 02/11 doc-diff: drop --cut-footer switchFelipe Contreras, May 21, 2021
  6. 03/11 doc: use asciidoctor to build man pages directlyFelipe Contreras, May 21, 2021
  7. Felipe ContrerasJun 2, 2021
  8. 04/11 doc-diff: support asciidoctor man pagesFelipe Contreras, May 21, 2021
  9. Felipe ContrerasMay 21, 2021
  10. 05/11 doc: asciidoctor: add linkgit macros in man pagesFelipe Contreras, May 21, 2021
  11. 06/11 doc: add man pages workaround for asciidoctorFelipe Contreras, May 21, 2021
  12. 07/11 doc: asciidoctor: add hack for xrefsFelipe Contreras, May 21, 2021
  13. 08/11 doc: asciidoctor: add hack to improve linksFelipe Contreras, May 21, 2021
  14. 09/11 doc: asciidoctor: add support for baseurlFelipe Contreras, May 21, 2021
  15. 10/11 doc: asciidoctor: cleanup man page hackFelipe Contreras, May 21, 2021
  16. 11/11 doc: asciidoctor: add hack for old versionsFelipe Contreras, May 21, 2021
  17. Felipe ContrerasMay 21, 2021

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.