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

[PATCH 0/2] Improve man pages formatting

From
Sergey Vlasov <vsu@altlinux.ru>
Date
Sep 19, 2005, 10:09 UTC
Message-ID
<20050919100914.GA28095@master.mivlgu.local>
Hello!

Currently GIT man pages - especially git(7) - do not look good, because the references to other man pages are represented as HTML file names (like "git-cat-file: git-cat-file.html"). The standard convention for such references in man pages is PAGE(SECTION), and some man viewers (e.g., pinfo (pman), or KDE help) even treat such text in man pages as hyperlinks.

This problem was fixed in cogito by adding the "gitlink:" asciidoc macro which generates proper formatting for either HTML or man page output. I have adapted that patch for GIT.

-- 
Sergey Vlasov
Next: Sergey Vlasov
Message 1 of 3 in “Improve man pages formatting”
  1. 0/2 Improve man pages formattingSergey Vlasov, Sep 19, 2005
  2. 1/2 Documentation: Add asciidoc.conf file and gitlink: macroSergey Vlasov, Sep 19, 2005
  3. 2/2 Documentation: Update all files to use the new gitlink: macroSergey Vlasov, Sep 19, 2005

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.