git/Documentation/diff-options.adoc, branch v2.51.2Mirror of https://git.kernel.org/pub/scm/git/git.git/
https://git.shady.money/git/atom?h=v2.51.22025-07-07T20:45:00Zdoc: git-log: convert diff options to new doc format2025-07-07T20:45:00ZJean-Noël Avilajn.avila@free.fr2025-07-07T18:53:31Zurn:sha1:0b4ccb2199efedce3f8de33a1da46bab59f5da35
- Use `backticks` for keywords and more complex option
descriptions. The new rendering engine will apply synopsis rules to
these spans.
- In description lists, put each option on its own line, to make them more
searchable and enable automatic translation of the options.
Signed-off-by: Jean-Noël Avila <jn.avila@free.fr>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
doc: use .adoc extension for AsciiDoc files2025-01-21T20:56:06Zbrian m. carlsonsandals@crustytoothpaste.net2025-01-20T01:56:02Zurn:sha1:1f010d6bdf756129db13d1367c888aa4153f6d87
We presently use the ".txt" extension for our AsciiDoc files. While not
wrong, most editors do not associate this extension with AsciiDoc,
meaning that contributors don't get automatic editor functionality that
could be useful, such as syntax highlighting and prose linting.
It is much more common to use the ".adoc" extension for AsciiDoc files,
since this helps editors automatically detect files and also allows
various forges to provide rich (HTML-like) rendering. Let's do that
here, renaming all of the files and updating the includes where
relevant. Adjust the various build scripts and makefiles to use the new
extension as well.
Note that this should not result in any user-visible changes to the
documentation.
Signed-off-by: brian m. carlson <sandals@crustytoothpaste.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>