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

[PATCH 0/5] doc: convert git-status, git remote and git stage to synopsis style

From
Jean-Noël Avila via GitGitGadget <gitgitgadget@gmail.com>
Date
Dec 20, 2025, 19:16 UTC
Message-ID
<pull.2020.git.1766258187.gitgitgadget@gmail.com>

The changes are basically the expected stuff for synopsis conversion, and a few cases of "imperative mood" style.

Additionally, this series has two special commits
 * fix to the comparison of synopsis and help, to allow using synopsis
   paragraph elsewhere in manpages
 * the "ascii art" tables in git-status are converted to plain asciidoc
   tables. The alignment output is managed by the asciidoc processor.

The second patch is a RFC as to whether we should convert our tables or not. For the translations of the manual pages, this setup simplifies the maintenance, because we are able to export each table cell as a separate segment.

Jean-Noël Avila (5):
  doc: fix t0450-txt-doc-vs-help to select only first synopsis block
  doc: convert git-status to synopsis style
  doc: convert git-status tables to AsciiDoc format
  doc: convert git stage to use synopsis block
  doc: convert git-remote to synopsis style
 Documentation/git-remote.adoc | 106 +++++-----
 Documentation/git-stage.adoc  |   4 +-
 Documentation/git-status.adoc | 356 +++++++++++++++++-----------------
 t/t0450-txt-doc-vs-help.sh    |   2 +-
 4 files changed, 238 insertions(+), 230 deletions(-)
base-commit: c4a0c8845e2426375ad257b6c221a3a7d92ecfda
Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-2020%2Fjnavila%2Fdoc_git_status-v1
Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-2020/jnavila/doc_git_status-v1
Pull-Request: https://github.com/gitgitgadget/git/pull/2020
-- 
gitgitgadget
Next: Jean-Noël Avila via GitGitGadget
Message 1 of 6 in “doc: convert git-status, git remote and git stage to synopsis style”
  1. 0/5 doc: convert git-status, git remote and git stage to synopsis styleJean-Noël Avila via GitGitGadget, Dec 20, 2025
  2. 1/5 doc: fix t0450-txt-doc-vs-help to select only first synopsis blockJean-Noël Avila via GitGitGadget, Dec 20, 2025
  3. 2/5 doc: convert git-status to synopsis styleJean-Noël Avila via GitGitGadget, Dec 20, 2025
  4. 3/5 doc: convert git-status tables to AsciiDoc formatJean-Noël Avila via GitGitGadget, Dec 20, 2025
  5. 4/5 doc: convert git stage to use synopsis blockJean-Noël Avila via GitGitGadget, Dec 20, 2025
  6. 5/5 doc: convert git-remote to synopsis styleJean-Noël Avila via GitGitGadget, Dec 20, 2025

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.