This series converts the man page of git log to the synopsis format style. Git log is the second largest manpage after git config, which makes the changes quite large. A special note about the log format description which required escaping the synopsis processing of parentheses. Changes since V1: * rework the grammar style when refering to plural placeholders . The text is more descriptive and does not rely on puns. Puns may be difficult to understand and to translate. * change commit message to reflect the conversion of inline description of several option to a list. Jean-Noël Avila (9): doc: convert git-log to new documentation format doc: git-log convert rev-list-description to new doc format doc: git-log: convert line range options to new doc format doc: git-log: convert line range format to new doc format doc: git-log: convert rev list options to new doc format doc: git-log: convert pretty options to new doc format doc: git-log: convert pretty formats to new doc format doc: git-log: convert diff options to new doc format doc: git-log: convert log config to new doc format Documentation/asciidoc.conf.in | 2 +- Documentation/asciidoctor-extensions.rb.in | 4 +- Documentation/config/log.adoc | 47 +-- Documentation/diff-options.adoc | 40 ++- Documentation/git-log.adoc | 86 ++--- Documentation/line-range-format.adoc | 26 +- Documentation/line-range-options.adoc | 10 +- Documentation/pretty-formats.adoc | 283 +++++++-------- Documentation/pretty-options.adoc | 71 ++-- Documentation/rev-list-description.adoc | 6 +- Documentation/rev-list-options.adoc | 390 ++++++++++----------- 11 files changed, 493 insertions(+), 472 deletions(-) base-commit: 8b6f19ccfc3aefbd0f22f6b7d56ad6a3fc5e4f37 Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-1933%2Fjnavila%2Fdoc_git_log-v3 Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-1933/jnavila/doc_git_log-v3 Pull-Request: https://github.com/gitgitgadget/git/pull/1933 Range-diff vs v2: 1: f2b69588195 = 1: 10ea4ad1cbe doc: convert git-log to new documentation format 2: 1f6c951726b = 2: 9b52a62204c doc: git-log convert rev-list-description to new doc format 3: 7bab515e136 = 3: b0b229082ce doc: git-log: convert line range options to new doc format 4: 384a7d23563 = 4: a4ac3ea5306 doc: git-log: convert line range format to new doc format 5: c2e857105d4 = 5: 1eb897ee9ad doc: git-log: convert rev list options to new doc format 6: 01835272c2e ! 6: b860561069d doc: git-log: convert pretty options to new doc format @@ Documentation/pretty-options.adoc + See the "PRETTY FORMATS" section for some additional details for each -format. When '=<format>' part is omitted, it defaults to 'medium'. -+format. When `=<format>` part is omitted, it defaults to `medium. ++format. When `=<format>` part is omitted, it defaults to `medium`. + -Note: you can specify the default pretty format in the repository +NOTE: you can specify the default pretty format in the repository 7: d5490f7d868 = 7: 0d461544c9d doc: git-log: convert pretty formats to new doc format 8: c2346eb580c = 8: 207fc49a201 doc: git-log: convert diff options to new doc format 9: b12b8294b86 = 9: b51d3621964 doc: git-log: convert log config to new doc format -- gitgitgadget
