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

[PATCH] doc: asciidoc: remove custom header macro

From
Felipe Contreras <felipe.contreras@gmail.com>
Date
Mar 23, 2023, 22:15 UTC
Message-ID
<20230323221523.52472-1-felipe.contreras@gmail.com>

In 2007 we added a custom header macro to provide version information 7ef195ba3e (Documentation: Add version information to man pages, 2007-03-25),

However, in 2008 asciidoc added the attributes to do this properly [1].

This was not implemented in Git until 2019: 226daba280 (Doc/Makefile: give mansource/-version/-manual attributes, 2019-09-16).

But in 2023 we are doing it properly, so there's no need for the custom macro.

[1] https://github.com/asciidoc-py/asciidoc-py/commit/ad78a3c
Cc: Martin Ågren <martin.agren@gmail.com>
Signed-off-by: Felipe Contreras <felipe.contreras@gmail.com>
---
 Documentation/asciidoc.conf | 19 -------------------
 1 file changed, 19 deletions(-)
diff --git a/Documentation/asciidoc.conf b/Documentation/asciidoc.conf
index 3e4c13971b..60f76f43ed 100644
--- a/Documentation/asciidoc.conf
+++ b/Documentation/asciidoc.conf
@@ -51,25 +51,6 @@ ifdef::doctype-manpage[]
 endif::doctype-manpage[]
 endif::backend-docbook[]
 
-ifdef::doctype-manpage[]
-ifdef::backend-docbook[]
-[header]
-template::[header-declarations]
-<refentry>
-<refmeta>
-<refentrytitle>{mantitle}</refentrytitle>
-<manvolnum>{manvolnum}</manvolnum>
-<refmiscinfo class="source">{mansource}</refmiscinfo>
-<refmiscinfo class="version">{manversion}</refmiscinfo>
-<refmiscinfo class="manual">{manmanual}</refmiscinfo>
-</refmeta>
-<refnamediv>
-  <refname>{manname}</refname>
-  <refpurpose>{manpurpose}</refpurpose>
-</refnamediv>
-endif::backend-docbook[]
-endif::doctype-manpage[]
-
 ifdef::backend-xhtml11[]
 [attributes]
 git-relative-html-prefix=
-- 
2.39.2.13.g1fb56cf030
Next: Jeff King
Message 1 of 8 in “doc: asciidoc: remove custom header macro”
  1. doc: asciidoc: remove custom header macroFelipe Contreras, Mar 23, 2023
  2. Jeff KingApr 6, 2023
  3. Junio C HamanoApr 6, 2023
  4. Jeff KingApr 6, 2023
  5. Felipe ContrerasApr 6, 2023
  6. Felipe ContrerasApr 6, 2023
  7. Jeff KingApr 6, 2023
  8. Junio C HamanoApr 7, 2023

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.