# [PATCH] doc/config/push: use longer "--" line for preformatted example 2 messages from 2020-02-18 to 2020-02-18. Participants: Jeff King, Junio C Hamano. Thread: https://gitlist.dev/t/52837 ## Jeff King, 2020-02-18 21:25 Subject: [PATCH] doc/config/push: use longer "--" line for preformatted example Message-ID: <20200218212537.GA33327@coredump.intra.peff.net> URL: https://gitlist.dev/e/20200218212537.GA33327%40coredump.intra.peff.net ``` The example for the push.pushOption config tries to create a preformatted section, but uses only two dashes in its "--" line. In AsciiDoc this is an "open block", with no type; the lines end up jumbled because they're formatted as paragraphs. We need four or more dashes to make it a "listing block" that will respect the linebreaks. Signed-off-by: Jeff King --- I noticed this as part our other discussion. The rendered output of "./doc-diff HEAD^ HEAD" is: @@ -4143,15 +4143,20 @@ CONFIGURATION FILE repository) to clear the values inherited from a lower priority configuration files (e.g. $HOME/.gitconfig). - Example: + Example: - /etc/gitconfig push.pushoption = a push.pushoption = b + /etc/gitconfig + push.pushoption = a + push.pushoption = b - ~/.gitconfig push.pushoption = c + ~/.gitconfig + push.pushoption = c - repo/.git/config push.pushoption = push.pushoption = b + repo/.git/config + push.pushoption = + push.pushoption = b - This will result in only b (a and c are cleared). + This will result in only b (a and c are cleared). push.recurseSubmodules Make sure all submodule commits used by the revisions to be pushed Documentation/config/push.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/config/push.txt b/Documentation/config/push.txt index 54871f8213..0a7aa322a9 100644 --- a/Documentation/config/push.txt +++ b/Documentation/config/push.txt @@ -80,7 +80,7 @@ higher priority configuration file (e.g. `.git/config` in a repository) to clear the values inherited from a lower priority configuration files (e.g. `$HOME/.gitconfig`). + --- +---- Example: @@ -97,7 +97,7 @@ repo/.git/config This will result in only b (a and c are cleared). --- +---- push.recurseSubmodules:: Make sure all submodule commits used by the revisions to be pushed -- 2.25.1.795.g3fd338b409 ``` ## Junio C Hamano, 2020-02-18 21:47 Subject: Re: [PATCH] doc/config/push: use longer "--" line for preformatted example Message-ID: URL: https://gitlist.dev/e/xmqqblpvin4a.fsf%40gitster-ct.c.googlers.com In-Reply-To: <20200218212537.GA33327@coredump.intra.peff.net> ``` Jeff King writes: > The example for the push.pushOption config tries to create a > preformatted section, but uses only two dashes in its "--" line. In > AsciiDoc this is an "open block", with no type; the lines end up jumbled > because they're formatted as paragraphs. We need four or more dashes to > make it a "listing block" that will respect the linebreaks. And the itemized list in push.default is delimited with two dashes as a non listing block, so it is shown correctly as a bulletted list just fine. Makes sense. Will queue. ```