kernel
/
git
mirror of https://git.kernel.org/pub/scm/git/git.git
1
0
Fork 0
Code Releases Activity

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>
maint
Jeff King 2015-05-12 22:15:56 -04:00 committed by Junio C Hamano
parent 282616c72d
commit ad3967a5a2
1 changed files with 3 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
Documentation/git-stripspace.txt
View File

@ -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$