From 34477d3793d308de20711a4df48f7823c91baaba Mon Sep 17 00:00:00 2001 From: Gervase Markham Date: Tue, 25 Feb 2014 12:00:48 +0000 Subject: Bug 963120 - allow extensions to document themselves, and build result into docs. r=LpSolit, a=justdave. --- docs/makedocs.pl | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) (limited to 'docs/makedocs.pl') diff --git a/docs/makedocs.pl b/docs/makedocs.pl index deb117ff3..d14e79434 100755 --- a/docs/makedocs.pl +++ b/docs/makedocs.pl @@ -25,6 +25,8 @@ use 5.10.1; use strict; use Cwd; +use File::Find; +use File::Copy; # We need to be in this directory to use our libraries. BEGIN { @@ -122,6 +124,24 @@ foreach my $lang (@langs) { next if grep { $_ eq '--pod-only' } @ARGV; + # Collect up local extension documentation into the extensions/ dir. + sub wanted { + if ($File::Find::dir =~ /\/doc\/?$/ && + $_ =~ /\.rst$/) + { + copy($File::Find::name, "rst/extensions"); + } + }; + + # Clear out old extensions docs + rmtree('rst/extensions', 0, 1); + mkdir('rst/extensions'); + + find({ + 'wanted' => \&wanted, + 'no_chdir' => 1, + }, "$docparent/../extensions"); + MakeDocs('HTML', 'make html'); MakeDocs('TXT', 'make text'); -- cgit v1.2.3-24-g4f1b