mirror of
https://github.com/librempeg/librempeg
synced 2024-11-22 18:49:58 +00:00
doc: add script to compute texi files dependencies
Replace the inline awk script with a Perl script which tracks the dependencies recursively. This allows to correctly track dependencies for files including files with a second level include (for example: ffmpeg-devices.texi -> devices.texi -> outdevs.texi). This also adds a dependency on perl for computing the dependencies, which should not be a problem since perl is already required all the way for building documentation.
This commit is contained in:
parent
37a970bbb6
commit
628ceac652
4
configure
vendored
4
configure
vendored
@ -2214,8 +2214,8 @@ ffserver_extralibs='$ldl'
|
||||
# documentation
|
||||
podpages_deps="perl"
|
||||
manpages_deps="perl pod2man"
|
||||
htmlpages_deps="texi2html"
|
||||
txtpages_deps="makeinfo"
|
||||
htmlpages_deps="perl texi2html"
|
||||
txtpages_deps="perl makeinfo"
|
||||
doc_deps_any="manpages htmlpages podpages txtpages"
|
||||
|
||||
# default parameters
|
||||
|
@ -43,7 +43,7 @@ doc: documentation
|
||||
apidoc: doc/doxy/html
|
||||
documentation: $(DOCS)
|
||||
|
||||
TEXIDEP = awk '/^@(verbatim)?include/ { printf "$@: $(@D)/%s\n", $$2 }' <$< >$(@:%=%.d)
|
||||
TEXIDEP = perl $(SRC_PATH)/doc/texidep.pl $< $@ >$(@:%=%.d)
|
||||
|
||||
doc/%.txt: TAG = TXT
|
||||
doc/%.txt: doc/%.texi
|
||||
|
22
doc/texidep.pl
Normal file
22
doc/texidep.pl
Normal file
@ -0,0 +1,22 @@
|
||||
#! /usr/bin/perl
|
||||
|
||||
use warnings;
|
||||
use strict;
|
||||
|
||||
my ($root, $target) = @ARGV;
|
||||
|
||||
sub print_deps {
|
||||
my ($file, $deps) = @_;
|
||||
$deps->{$file} = 1;
|
||||
|
||||
open(my $fh, "$file") or die "Cannot open file '$file': $!";
|
||||
while (<$fh>) {
|
||||
/^@(?:verbatim)?include\s+(\S+)/ and do {
|
||||
die "Circular dependency found in file $root\n" if exists $deps->{"doc/$1"};
|
||||
print "$target: doc/$1\n";
|
||||
print_deps("doc/$1", {%$deps});
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
print_deps($root, {});
|
Loading…
Reference in New Issue
Block a user