1
0
mirror of https://github.com/git/git.git synced 2024-09-28 18:32:37 +02:00

doc: fix unmatched code fences in git-stripspace

The asciidoctor renderer is more picky than classic asciidoc,
and insists that the start and end of a code fence be the
same size.

Found with this hacky perl script:

    foreach my $fn (@ARGV) {
      open(my $fh, '<', $fn);
      my ($fence, $fence_lineno, $prev);
      while (<$fh>) {
        chomp;
        if (/^----+$/) {
          if ($fence_lineno) {
            if ($_ ne $fence) {
              print "$fn:$fence_lineno:mismatched fence: ",
                    length($fence), " != ", length($_), "\n";
            }
            $fence_lineno = undef;
          }
	  # hacky check to avoid title-underlining
          elsif ($prev eq '' || $prev eq '+') {
            $fence = $_;
            $fence_lineno = $.;
          }
        }
        $prev = $_;
      }
    }

Signed-off-by: Jeff King <peff@peff.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
Jeff King 2015-05-12 22:15:56 -04:00 committed by Junio C Hamano
parent 282616c72d
commit ad3967a5a2

@ -48,7 +48,7 @@ EXAMPLES
Given the following noisy input with '$' indicating the end of a line:
--------
---------
|A brief introduction $
| $
|$
@ -64,7 +64,7 @@ Given the following noisy input with '$' indicating the end of a line:
Use 'git stripspace' with no arguments to obtain:
--------
---------
|A brief introduction$
|$
|A new paragraph$
@ -78,7 +78,7 @@ Use 'git stripspace' with no arguments to obtain:
Use 'git stripspace --strip-comments' to obtain:
--------
---------
|A brief introduction$
|$
|A new paragraph$