diff options
author | Jean-Noël Avila <jn.avila@free.fr> | 2024-09-24 07:08:48 +0000 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2024-09-24 10:20:25 -0700 |
commit | 974cdca345cc51fb8623c611a25314f98b2cd3e3 (patch) | |
tree | c10c2b5502d7e9b0deba926bdd11cb128245442c /git-gui/lib/commit.tcl | |
parent | ad57f148c6b5f8735b62238dda8f571c582e0e54 (diff) |
doc: introduce a synopsis typesetting
In order to follow the common manpage usage, the synopsis of the
commands needs to be heavily typeset. A first try was performed with
using native markup, but it turned out to make the document source
almost unreadable, difficult to write and prone to mistakes with
unwanted Asciidoc's role attributes.
In order to both simplify the writer's task and obtain a consistant
typesetting in the synopsis, a custom 'synopsis' paragraph type is
created and the processor for backticked text are modified. The
backends of asciidoc and asciidoctor take in charge to correctly add
the required typesetting.
Signed-off-by: Jean-Noël Avila <jn.avila@free.fr>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'git-gui/lib/commit.tcl')
0 files changed, 0 insertions, 0 deletions