@matheusbsbs / matheus-bagliano / commits / 9e4cbccbd7

Documentation/git-svn: improve asciidoctor compatibility

The second paragraph in the CONFIGURATION section intends to emphasize the word 'must' with bold type. It does so by writing it as *must*, and this works fine with AsciiDoc. It usually works great with Asciidoctor, too, but in this particular instance, we have another "*" earlier in the paragraph. We do escape it, and it is rendered literally just like we want it to, but Asciidoctor then ends up tripping on the second (or third) of the asterisks in this paragraph. Since that asterisk is (part of) a literal example, we can set it in monospace, by giving it as `*`. Adjust the whole paragraph in this way. There's lots more monospacing to be done in this document, but since our main motivation is addressing AsciiDoc/Asciidoctor discrepancies like this one, let's just convert this one paragraph. Signed-off-by: Todd Zullinger <tmz@pobox.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>

Todd Zullinger committed Apr 9, 2019 at 20:37 UTC 9e4cbccbd73c2558cf0f5f9c2602445cdfc1f371

1 file changed +3 -3

Documentation/git-svn.txt

+3 -3

@@ -1100,10 +1100,10 @@ listed below are allowed:

1100 tags = tags/*/project-a:refs/remotes/project-a/tags/*

1101 ------------------------------------------------------------------------

1102

1103 -Keep in mind that the '\*' (asterisk) wildcard of the local ref

1104 -(right of the ':') *must* be the farthest right path component;

1103 +Keep in mind that the `*` (asterisk) wildcard of the local ref

1104 +(right of the `:`) *must* be the farthest right path component;

1105 however the remote wildcard may be anywhere as long as it's an

1106 -independent path component (surrounded by '/' or EOL). This

1106 +independent path component (surrounded by `/` or EOL). This

1107 type of configuration is not automatically created by 'init' and

1108 should be manually entered with a text-editor or using 'git config'.

1109