Fix documentation dependency generation.
Documentation/Makefile spent a lot of time to generate include dependencies, which was quite noticeable especially during "make clean". Rewrite it to generate just a single dependency file. Signed-off-by: Junio C Hamano <junkio@cox.net>
This commit is contained in:
parent
79f6ac77d9
commit
a5ae8e64cf
1
Documentation/.gitignore
vendored
1
Documentation/.gitignore
vendored
@ -3,3 +3,4 @@
|
|||||||
*.1
|
*.1
|
||||||
*.7
|
*.7
|
||||||
howto-index.txt
|
howto-index.txt
|
||||||
|
doc.dep
|
||||||
|
@ -53,21 +53,19 @@ install: man
|
|||||||
#
|
#
|
||||||
# Determine "include::" file references in asciidoc files.
|
# Determine "include::" file references in asciidoc files.
|
||||||
#
|
#
|
||||||
TEXTFILES = $(wildcard *.txt)
|
TEXTFILES = $(wildcard git-*.txt)
|
||||||
DEPFILES = $(TEXTFILES:%.txt=%.dep)
|
doc.dep : $(TEXTFILES) build-docdep.perl
|
||||||
|
rm -f $@+ $@
|
||||||
|
perl ./build-docdep.perl >$@+
|
||||||
|
mv $@+ $@
|
||||||
|
|
||||||
%.dep : %.txt
|
-include doc.dep
|
||||||
@rm -f $@
|
|
||||||
@$(foreach dep, $(shell grep include:: $< | sed -e 's/include::/ /' -e 's/\[\]//'), \
|
|
||||||
echo $(<:%.txt=%.html) $(<:%.txt=%.1) : $(dep) >> $@; )
|
|
||||||
|
|
||||||
-include $(DEPFILES)
|
|
||||||
|
|
||||||
git.7: ../README
|
git.7: ../README
|
||||||
|
|
||||||
|
|
||||||
clean:
|
clean:
|
||||||
rm -f *.xml *.html *.1 *.7 howto-index.txt howto/*.html *.dep
|
rm -f *.xml *.html *.1 *.7 howto-index.txt howto/*.html doc.dep
|
||||||
|
|
||||||
%.html : %.txt
|
%.html : %.txt
|
||||||
asciidoc -b xhtml11 -d manpage -f asciidoc.conf $<
|
asciidoc -b xhtml11 -d manpage -f asciidoc.conf $<
|
||||||
|
28
Documentation/build-docdep.perl
Executable file
28
Documentation/build-docdep.perl
Executable file
@ -0,0 +1,28 @@
|
|||||||
|
#!/usr/bin/perl
|
||||||
|
|
||||||
|
my %include = ();
|
||||||
|
|
||||||
|
for my $text (<git-*.txt>) {
|
||||||
|
open I, '<', $text || die "cannot read: $text";
|
||||||
|
(my $base = $text) =~ s/\.txt$//;
|
||||||
|
while (<I>) {
|
||||||
|
if (/^include::/) {
|
||||||
|
chomp;
|
||||||
|
s/^include::\s*//;
|
||||||
|
s/\[\]//;
|
||||||
|
$include{$base}{$_} = 1;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
close I;
|
||||||
|
}
|
||||||
|
|
||||||
|
# Do we care about chained includes???
|
||||||
|
|
||||||
|
while (my ($base, $included) = each %include) {
|
||||||
|
my ($suffix) = '1';
|
||||||
|
if ($base eq 'git') {
|
||||||
|
$suffix = '7'; # yuck...
|
||||||
|
}
|
||||||
|
print "$base.html $base.$suffix : ", join(" ", keys %$included), "\n";
|
||||||
|
}
|
||||||
|
|
Loading…
Reference in New Issue
Block a user