master
1#!/usr/bin/env perl
2#***************************************************************************
3# _ _ ____ _
4# Project ___| | | | _ \| |
5# / __| | | | |_) | |
6# | (__| |_| | _ <| |___
7# \___|\___/|_| \_\_____|
8#
9# Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
10#
11# This software is licensed as described in the file COPYING, which
12# you should have received as part of this distribution. The terms
13# are also available at https://curl.se/docs/copyright.html.
14#
15# You may opt to use, copy, modify, merge, publish, distribute and/or sell
16# copies of the Software, and permit persons to whom the Software is
17# furnished to do so, under the terms of the COPYING file.
18#
19# This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
20# KIND, either express or implied.
21#
22# SPDX-License-Identifier: curl
23#
24###########################################################################
25#
26# scan man pages to find basic syntactic problems such as unbalanced \f
27# codes or references to non-existing curl man pages.
29use strict;
30use warnings;
32my $docsroot = $ARGV[0] || '.';
34if(!$docsroot || ($docsroot eq "-g")) {
35 print "Usage: test1140.pl <docs root dir> [manpages]\n";
36 exit;
37}
39shift @ARGV;
41my @f = @ARGV;
42my %manp;
43my $errors = 0;
45sub manpresent {
46 my ($man) = @_;
47 if($manp{$man}) {
48 return 1;
49 }
50 elsif(-r "$docsroot/$man" ||
51 -r "$docsroot/libcurl/$man" ||
52 -r "$docsroot/libcurl/opts/$man") {
53 $manp{$man} = 1;
54 return 1;
55 }
56 return 0;
57}
59sub file {
60 my ($f) = @_;
61 open(my $fh, "<", $f) or die "test1140.pl could not open $f";
62 my $line = 1;
63 while(<$fh>) {
64 chomp;
65 my $l = $_;
66 while($l =~ s/\\f(.)([^ ]*)\\f(.)//) {
67 my ($pre, $str, $post) = ($1, $2, $3);
68 if($str =~ /^\\f[ib]/i) {
69 print "error: $f:$line: double-highlight\n";
70 $errors++;
71 }
72 if($post ne "P") {
73 print "error: $f:$line: missing \\fP after $str\n";
74 $errors++;
75 }
76 if($str =~ /((libcurl|curl)([^ ]*))\(3\)/i) {
77 my $man = "$1.3";
78 $man =~ s/\\//g; # cut off backslashes
79 if(!manpresent($man)) {
80 print "error: $f:$line: referring to non-existing man page $man\n";
81 $errors++;
82 }
83 if($pre ne "I") {
84 print "error: $f:$line: use \\fI before $str\n";
85 $errors++;
86 }
87 }
88 }
89 if($l =~ /(curl([^ ]*)\(3\))/i) {
90 print "error: $f:$line: non-referencing $1\n";
91 $errors++;
92 }
93 if($l =~ /^\.BR (.*)/) {
94 my $i = $1;
95 while($i =~ s/((lib|)curl([^ ]*)) *\"\(3\)(,|) *\" *//i ) {
96 my $man = "$1.3";
97 $man =~ s/\\//g; # cut off backslashes
98 if(!manpresent($man)) {
99 print "error: $f:$line: referring to non-existing man page $man\n";
100 $errors++;
101 }
102 }
103 }
104 $line++;
105 }
106 close($fh);
107}
109foreach my $f (@f) {
110 file($f);
111}
113print "OK\n" if(!$errors);
115exit ($errors ? 1 : 0);
Diagnostics4 git calls · 186 ms
CallStatusSizeTime0186 ms
discover200152 B2 ms
git.upload-pack discover http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=ls-refs git.upstream.dur_ms=2 git.response.bytes=152 git.server.agent=gitty/1.0 git.server.object_format=sha1 git.server.caps=agent ls-refs fetch object-format git.server.fetch=shallow filter sideband-all git.protocol.version=2 git.pkt.frames=8 git.pkt.data=6 git.pkt.flush=2 git.pkt.delim=0 git.pkt.bytes=152 git.pkt.payload.max=34
ls-refs200149 B · hit3 ms
git.upload-pack ls-refs http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=ls-refs git.upstream.dur_ms=2 git.response.bytes=149 git.response.cache=HIT git.response.duration_ms=3 git.protocol.version=2 git.pkt.frames=3 git.pkt.data=2 git.pkt.flush=1 git.pkt.delim=0 git.pkt.bytes=149 git.pkt.payload.max=78 git.ls_refs.count=2 git.ls_refs.head=refs/heads/master
fetchblob:none · deepen 10200287 KiB · hit2 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=2 git.response.bytes=293470 git.response.cache=HIT git.response.duration_ms=2 git.fetch.filter=blob:none git.fetch.filter.requested=tree:0 git.fetch.filter.fallback=blob:none git.fetch.filter.learned=false git.fetch.wants=31c911efe5652725e930f4d2e60c9060e5f6646d git.fetch.haves.count=0 git.fetch.deepen=10 git.fetch.thin_pack=false git.fetch.ofs_delta=true git.protocol.version=2 git.pkt.frames=10 git.pkt.data=8 git.pkt.flush=1 git.pkt.delim=1 git.pkt.bytes=293470 git.pkt.payload.max=65516 git.sideband.band1.bytes=293354 git.sideband.band2.bytes=0 git.sideband.band3.bytes=0 git.pack.objects=87 git.pack.bytes=293354 git.pack.ofs_delta=0 git.pack.ref_delta=1 git.pack.chain.max=1 git.pack.trailer=6a646bcda6740bab42e321b51998b52ea15146c0 git.pack.full=86Open pack map
fetch2001.3 KiB181 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=181 git.response.bytes=1350 git.response.cache=MISS git.response.duration_ms=181 git.fetch.wants=320f9f94392ba7ac7e0bdfe41f36dcc9f082d915 git.fetch.haves.count=0 git.fetch.deepen=0 git.fetch.thin_pack=false git.fetch.ofs_delta=true git.protocol.version=2 git.pkt.frames=3 git.pkt.data=2 git.pkt.flush=1 git.pkt.delim=0 git.pkt.bytes=1350 git.pkt.payload.max=1329 git.sideband.band1.bytes=1328 git.sideband.band2.bytes=0 git.sideband.band3.bytes=0
Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.
- Remote
- https://5ad2236b39de4c8bd8f6270ea63f3ea9.artifacts.cloudflare.net/git/public-v0/curl.git
- Ref
- refs/heads/master
- Commit
- 31c911efe5652725e930f4d2e60c9060e5f6646d
- cf-ray
- a5e1c351ecb736cd
- Request
- ef364738…
- Protocol
- v2 · sha1
- Agent
- gitty/1.0
- Filter
- advertised
- Fetch
- shallow filter sideband-all
- Capabilities
- agent ls-refs fetch object-format