git/Documentation/build-docdep.perl
Junio C Hamano 06d9252bcc doc: fix build-docdep.perl
We renamed from .txt to .adoc all the asciidoc source files and
necessary includes.  We also need to adjust the build-docdep tool to
work on files whose suffix is .adoc when computing the documentation
dependencies.

Signed-off-by: Junio C Hamano <gitster@pobox.com>
2025-03-01 10:26:15 -08:00

50 lines
1.0 KiB
Perl
Executable File

#!/usr/bin/perl
my ($build_dir) = @ARGV;
my %include = ();
my %included = ();
for my $adoc (<*.adoc>) {
open I, '<', $adoc || die "cannot read: $adoc";
while (<I>) {
if (/^include::/) {
chomp;
s/^include::\s*//;
s/\[\]//;
s/{build_dir}/${build_dir}/;
$include{$adoc}{$_} = 1;
$included{$_} = 1;
}
}
close I;
}
# Do we care about chained includes???
my $changed = 1;
while ($changed) {
$changed = 0;
while (my ($adoc, $included) = each %include) {
for my $i (keys %$included) {
# $adoc has include::$i; if $i includes $j
# $adoc indirectly includes $j.
if (exists $include{$i}) {
for my $j (keys %{$include{$i}}) {
if (!exists $include{$adoc}{$j}) {
$include{$adoc}{$j} = 1;
$included{$j} = 1;
$changed = 1;
}
}
}
}
}
}
foreach my $adoc (sort keys %include) {
my $included = $include{$adoc};
if (! exists $included{$adoc} &&
(my $base = $adoc) =~ s/\.adoc$//) {
print "$base.html $base.xml : ", join(" ", sort keys %$included), "\n";
}
}