git@vger.kernel.org mailing list mirror (one of many)
 help / color / mirror / code / Atom feed
blob 16451d81b88f41ce4f2b8bcec800c1a6d1bdc09f 1527 bytes (raw)
name: Documentation/cmd-list.perl 	 # note: path name is non-authoritative(*)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
 
#!/usr/bin/perl -w

use File::Compare qw(compare);

sub format_one {
	my ($out, $nameattr) = @_;
	my ($name, $attr) = @$nameattr;
	my ($state, $description);
	my $mansection;
	$state = 0;
	open I, '<', "$name.txt" or die "No such file $name.txt";
	while (<I>) {
		if (/^(git|scalar)[a-z0-9-]*\(([0-9])\)$/) {
			$mansection = $2;
			next;
		}
		if (/^NAME$/) {
			$state = 1;
			next;
		}
		if ($state == 1 && /^----$/) {
			$state = 2;
			next;
		}
		next if ($state != 2);
		chomp;
		$description = $_;
		last;
	}
	close I;
	if (!defined $description) {
		die "No description found in $name.txt";
	}
	if (my ($verify_name, $text) = ($description =~ /^($name) - (.*)/)) {
		print $out "linkgit:$name\[$mansection\]::\n\t";
		if ($attr =~ / deprecated /) {
			print $out "(deprecated) ";
		}
		print $out "$text.\n\n";
	}
	else {
		die "Description does not match $name: $description";
	}
}

my ($input, @categories) = @ARGV;

open IN, "<$input";
while (<IN>) {
	last if /^### command list/;
}

my %cmds = ();
for (sort <IN>) {
	next if /^#/;

	chomp;
	my ($name, $cat, $attr) = /^(\S+)\s+(.*?)(?:\s+(.*))?$/;
	$attr = '' unless defined $attr;
	push @{$cmds{$cat}}, [$name, " $attr "];
}
close IN;

for my $out (@categories) {
	my ($cat) = $out =~ /^cmds-(.*)\.txt$/;
	open O, '>', "$out+" or die "Cannot open output file $out+";
	for (@{$cmds{$cat}}) {
		format_one(\*O, $_);
	}
	close O;

	if (-f "$out" && compare("$out", "$out+") == 0) {
		unlink "$out+";
	}
	else {
		print STDERR "$out\n";
		rename "$out+", "$out";
	}
}

debug log:

solving 16451d81b8 ...
found 16451d81b8 in https://public-inbox.org/git/20220923070334.1970213-1-martin.agren@gmail.com/
found 9515a499a3 in https://80x24.org/mirrors/git.git
preparing index
index prepared:
100755 9515a499a316db4a8e48b81c83f0068e5faf2d22	Documentation/cmd-list.perl

applying [1/1] https://public-inbox.org/git/20220923070334.1970213-1-martin.agren@gmail.com/
diff --git a/Documentation/cmd-list.perl b/Documentation/cmd-list.perl
index 9515a499a3..16451d81b8 100755

Checking patch Documentation/cmd-list.perl...
Applied patch Documentation/cmd-list.perl cleanly.

index at:
100755 16451d81b88f41ce4f2b8bcec800c1a6d1bdc09f	Documentation/cmd-list.perl

(*) Git path names are given by the tree(s) the blob belongs to.
    Blobs themselves have no identifier aside from the hash of its contents.^

Code repositories for project(s) associated with this public inbox

	https://80x24.org/mirrors/git.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).