diff options
| author | Martin Ågren <martin.agren@gmail.com> | 2020-03-31 21:26:00 +0200 |
|---|---|---|
| committer | Junio C Hamano <gitster@pobox.com> | 2020-03-31 16:08:02 -0700 |
| commit | 3c255ad660b03c7bb372b01b6dcaf67023fb2886 (patch) | |
| tree | a9c9969e5942ec8f077db6e3d7b523cc8b8ababf /Documentation/user-manual.conf | |
| parent | 5a80d85bbe00cdaf4fc6d58ac26216090f5eac7a (diff) | |
| download | git-3c255ad660b03c7bb372b01b6dcaf67023fb2886.tar.gz | |
user-manual.conf: don't specify [listingblock]
This is the config file we use when we build the user manual with
AsciiDoc. The comment at the top of this chunk that we're removing says
the following:
"unbreak" docbook-xsl v1.68 for manpages (sic!). v1.69 works with or
without this.
This comes from d19fbc3c17 ("Documentation: add git user's manual",
2007-01-07), where it looks like this conf file in general and this
snippet in particular was copy-pasted from asciidoc.conf.
This chunk is very similar to something we just got rid of for the
manpages, and because this appears to be aimed at v1.68 -- which we no
longer support for the manpages as of a few commits ago --, it's
tempting to get rid of this. That reveals an interesting aspect of
"works with or without this": it turns out it actually works /better/
without!
Dropping this makes us render code snippets and shell listings using
<screen> rather than <literallayout>, just like Asciidoctor does. In
user-manual.pdf, this puts the contents into dimmed-background,
easy-to-distinguish-from-the-surrounding-text boxes, as opposed to
white-background (transparent) boxes.
Signed-off-by: Martin Ågren <martin.agren@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/user-manual.conf')
| -rw-r--r-- | Documentation/user-manual.conf | 10 |
1 files changed, 0 insertions, 10 deletions
diff --git a/Documentation/user-manual.conf b/Documentation/user-manual.conf index d87294de2f..0148f126dc 100644 --- a/Documentation/user-manual.conf +++ b/Documentation/user-manual.conf @@ -9,13 +9,3 @@ tilde=~ [linkgit-inlinemacro] <ulink url="{target}.html">{target}{0?({0})}</ulink> - -ifdef::backend-docbook[] -# "unbreak" docbook-xsl v1.68 for manpages. v1.69 works with or without this. -[listingblock] -<example><title>{title}</title> -<literallayout class="monospaced"> -| -</literallayout> -{title#}</example> -endif::backend-docbook[] |