mirror of
https://github.com/curl/curl.git
synced 2024-12-27 06:59:43 +08:00
2494b8dd51
- switch all invidual files documenting command line options into .md, as the documentation is now markdown-looking. - made the parser treat 4-space indents as quotes - switch to building the curl.1 manpage using the "mainpage.idx" file, which lists the files to include to generate it, instead of using the previous page-footer/headers. Also, those files are now also .md ones, using the same format. I gave them underscore prefixes to make them sort separately: _NAME.md, _SYNOPSIS.md, _DESCRIPTION.md, _URL.md, _GLOBBING.md, _VARIABLES.md, _OUTPUT.md, _PROTOCOLS.md, _PROGRESS.md, _VERSION.md, _OPTIONS.md, _FILES.md, _ENVIRONMENT.md, _PROXYPREFIX.md, _EXITCODES.md, _BUGS.md, _AUTHORS.md, _WWW.md, _SEEALSO.md - updated test cases accordingly Closes #12751
118 lines
3.4 KiB
Perl
Executable File
118 lines
3.4 KiB
Perl
Executable File
#!/usr/bin/env perl
|
|
#***************************************************************************
|
|
# _ _ ____ _
|
|
# Project ___| | | | _ \| |
|
|
# / __| | | | |_) | |
|
|
# | (__| |_| | _ <| |___
|
|
# \___|\___/|_| \_\_____|
|
|
#
|
|
# Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
#
|
|
# This software is licensed as described in the file COPYING, which
|
|
# you should have received as part of this distribution. The terms
|
|
# are also available at https://curl.se/docs/copyright.html.
|
|
#
|
|
# You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
|
# copies of the Software, and permit persons to whom the Software is
|
|
# furnished to do so, under the terms of the COPYING file.
|
|
#
|
|
# This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
|
# KIND, either express or implied.
|
|
#
|
|
# SPDX-License-Identifier: curl
|
|
#
|
|
###########################################################################
|
|
|
|
my $root=$ARGV[0] || "..";
|
|
|
|
my @m = `git ls-files -- $root`;
|
|
|
|
my $errors;
|
|
|
|
my %accepted=('curl' => 1,
|
|
'libcurl' => 1,
|
|
'c-ares' => 1);
|
|
|
|
sub checkfile {
|
|
my ($f) = @_;
|
|
chomp $f;
|
|
if($f !~ /\.md\z/) {
|
|
return;
|
|
}
|
|
open(my $fh, "<", "$f");
|
|
my $l;
|
|
my $prevl;
|
|
my $ignore = 0;
|
|
my $metadata = 0;
|
|
while(<$fh>) {
|
|
my $line = $_;
|
|
chomp $line;
|
|
$l++;
|
|
if(($l == 1) && ($line =~ /^---/)) {
|
|
# first line is a meta-data divider, skip to the next one
|
|
$metadata = 1;
|
|
print STDERR "skip meta-data in $f\n";
|
|
next;
|
|
}
|
|
elsif($metadata) {
|
|
if($line !~ /^---/) {
|
|
next;
|
|
}
|
|
$metadata = 0;
|
|
next;
|
|
}
|
|
if($line =~ /^(\`\`\`|\~\~\~)/) {
|
|
# start or stop ignore-mode
|
|
$ignore ^= 1;
|
|
}
|
|
if(!$ignore) {
|
|
if(($prevl =~ /\.\z/) && ($line =~ /^( *)([a-z-]+)/)) {
|
|
my ($prefix, $word) = ($1, $2);
|
|
if($word =~ /^[a-z]/ && !$accepted{$word}) {
|
|
my $c = length($prefix);
|
|
print STDERR
|
|
"$f:$l:$c:error: lowercase $word after period\n";
|
|
print STDERR "$line\n";
|
|
print STDERR ' ' x $c;
|
|
print STDERR "^\n";
|
|
$errors++;
|
|
}
|
|
}
|
|
elsif($line =~ /^(.*)\. +([a-z-]+)/) {
|
|
my ($prefix, $word) = ($1, $2);
|
|
|
|
if(($prefix =~ /\.\.\z/) ||
|
|
($prefix =~ /[0-9]\z/) ||
|
|
($prefix =~ /e.g\z/) ||
|
|
($prefix =~ /i.e\z/) ||
|
|
($prefix =~ /E.g\z/) ||
|
|
($prefix =~ /etc\z/) ||
|
|
($word !~ /^[a-z]/) ||
|
|
$accepted{$word}) {
|
|
}
|
|
else {
|
|
my $c = length($prefix) + 2;
|
|
print STDERR
|
|
"$f:$l:$c:error: lowercase $word after period\n";
|
|
print STDERR "$line\n";
|
|
print STDERR ' ' x $c;
|
|
print STDERR "^\n";
|
|
$errors++;
|
|
}
|
|
}
|
|
}
|
|
$prevl = $line;
|
|
}
|
|
close($fh);
|
|
}
|
|
|
|
|
|
for my $f (@m) {
|
|
checkfile($f);
|
|
}
|
|
|
|
if($errors) {
|
|
exit 1;
|
|
}
|
|
print "ok\n";
|