This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Integrate with Sarathy.
[perl5.git] / pod / Makefile
index 0ec08f9..f28b9d4 100644 (file)
@@ -1,34 +1,55 @@
-CONVERTERS = pod2html pod2latex pod2man pod2text checkpods
+CONVERTERS = pod2html pod2latex pod2man pod2text checkpods \
+               pod2usage podchecker podselect
+
+HTMLROOT = /   # Change this to fix cross-references in HTML
+POD2HTML = pod2html \
+           --htmlroot=$(HTMLROOT) \
+           --podroot=.. --podpath=pod:lib:ext:vms \
+           --libpods=perlfunc:perlguts:perlvar:perlrun:perlop
 
 all: $(CONVERTERS) man
+
+converters: $(CONVERTERS)
+
 PERL = ../miniperl
+REALPERL = ../perl
 
 POD = \
        perl.pod        \
        perldelta.pod   \
+       perl5004delta.pod       \
+       perl5005delta.pod       \
        perldata.pod    \
        perlsyn.pod     \
        perlop.pod      \
        perlre.pod      \
        perlrun.pod     \
        perlfunc.pod    \
+       perlopentut.pod \
        perlvar.pod     \
        perlsub.pod     \
        perlmod.pod     \
+       perlmodlib.pod  \
+       perlmodinstall.pod      \
        perlform.pod    \
        perllocale.pod  \
        perlref.pod     \
+       perlreftut.pod  \
        perldsc.pod     \
        perllol.pod     \
        perltoot.pod    \
+       perltootc.pod   \
        perlobj.pod     \
        perltie.pod     \
        perlbot.pod     \
        perlipc.pod     \
+       perlthrtut.pod  \
+       perldbmfilter.pod       \
        perldebug.pod   \
        perldiag.pod    \
        perlsec.pod     \
        perltrap.pod    \
+       perlport.pod    \
        perlstyle.pod   \
        perlpod.pod     \
        perlbook.pod    \
@@ -38,6 +59,8 @@ POD = \
        perlxstut.pod   \
        perlguts.pod    \
        perlcall.pod    \
+       perltodo.pod    \
+       perlhist.pod    \
        perlfaq.pod     \
        perlfaq1.pod    \
        perlfaq2.pod    \
@@ -53,29 +76,39 @@ POD = \
 MAN = \
        perl.man        \
        perldelta.man   \
+       perl5004delta.man       \
+       perl5005delta.man       \
        perldata.man    \
        perlsyn.man     \
        perlop.man      \
        perlre.man      \
        perlrun.man     \
        perlfunc.man    \
+       perlopentut.man \
        perlvar.man     \
        perlsub.man     \
        perlmod.man     \
+       perlmodlib.man  \
+       perlmodinstall.man      \
        perlform.man    \
        perllocale.man  \
        perlref.man     \
+       perlreftut.man  \
        perldsc.man     \
        perllol.man     \
        perltoot.man    \
+       perltootc.man   \
        perlobj.man     \
        perltie.man     \
        perlbot.man     \
        perlipc.man     \
+       perlthrtut.man  \
+       perldbmfilter.man       \
        perldebug.man   \
        perldiag.man    \
        perlsec.man     \
        perltrap.man    \
+       perlport.man    \
        perlstyle.man   \
        perlpod.man     \
        perlbook.man    \
@@ -85,6 +118,8 @@ MAN = \
        perlxstut.man   \
        perlguts.man    \
        perlcall.man    \
+       perltodo.man    \
+       perlhist.man    \
        perlfaq.man     \
        perlfaq1.man    \
        perlfaq2.man    \
@@ -100,29 +135,39 @@ MAN = \
 HTML = \
        perl.html       \
        perldelta.html  \
+       perl5004delta.html      \
+       perl5005delta.html      \
        perldata.html   \
        perlsyn.html    \
        perlop.html     \
        perlre.html     \
        perlrun.html    \
        perlfunc.html   \
+       perlopentut.html        \
        perlvar.html    \
        perlsub.html    \
        perlmod.html    \
+       perlmodlib.html \
+       perlmodinstall.html     \
        perlform.html   \
        perllocale.html \
        perlref.html    \
+       perlreftut.html \
        perldsc.html    \
        perllol.html    \
        perltoot.html   \
+       perltootc.html  \
        perlobj.html    \
        perltie.html    \
        perlbot.html    \
        perlipc.html    \
+       perlthrtut.html \
+       perldbmfilter.html      \
        perldebug.html  \
        perldiag.html   \
        perlsec.html    \
        perltrap.html   \
+       perlport.html   \
        perlstyle.html  \
        perlpod.html    \
        perlbook.html   \
@@ -132,6 +177,8 @@ HTML = \
        perlxstut.html  \
        perlguts.html   \
        perlcall.html   \
+       perltodo.html   \
+       perlhist.html   \
        perlfaq.html    \
        perlfaq1.html   \
        perlfaq2.html   \
@@ -141,35 +188,45 @@ HTML = \
        perlfaq6.html   \
        perlfaq7.html   \
        perlfaq8.html   \
-       perlfaq9.html   \
-       perltoc.html
+       perlfaq9.html
+# not perltoc.html
 
 TEX = \
        perl.tex        \
        perldelta.tex   \
+       perl5004delta.tex       \
+       perl5005delta.tex       \
        perldata.tex    \
        perlsyn.tex     \
        perlop.tex      \
        perlre.tex      \
        perlrun.tex     \
        perlfunc.tex    \
+       perlopentut.tex \
        perlvar.tex     \
        perlsub.tex     \
        perlmod.tex     \
+       perlmodlib.tex  \
+       perlmodinstall.tex      \
        perlform.tex    \
        perllocale.tex  \
        perlref.tex     \
+       perlreftut.tex  \
        perldsc.tex     \
        perllol.tex     \
        perltoot.tex    \
+       perltootc.tex   \
        perlobj.tex     \
        perltie.tex     \
        perlbot.tex     \
        perlipc.tex     \
+       perlthrtut.tex  \
+       perldbmfilter.tex       \
        perldebug.tex   \
        perldiag.tex    \
        perlsec.tex     \
        perltrap.tex    \
+       perlport.tex    \
        perlstyle.tex   \
        perlpod.tex     \
        perlbook.tex    \
@@ -179,6 +236,8 @@ TEX = \
        perlxstut.tex   \
        perlguts.tex    \
        perlcall.tex    \
+       perltodo.tex    \
+       perlhist.tex    \
        perlfaq.tex     \
        perlfaq1.tex    \
        perlfaq2.tex    \
@@ -191,19 +250,18 @@ TEX = \
        perlfaq9.tex    \
        perltoc.tex
 
-man:  pod2man $(MAN)
+man:   pod2man $(MAN)
 
-# pod2html normally runs on all the pods at once in order to build up
-# cross-references.
-html: pod2html
-       $(PERL) -I../lib pod2html $(POD)
+html:  pod2html $(HTML)
 
 tex:   pod2latex $(TEX)
 
 toc:
        $(PERL) -I../lib buildtoc >perltoc.pod
 
-.SUFFIXES: .pm .pod .man
+.SUFFIXES: .pm .pod
+
+.SUFFIXES: .man
 
 .pm.man:     pod2man
        $(PERL) -I../lib pod2man $*.pm >$*.man
@@ -211,25 +269,28 @@ toc:
 .pod.man:     pod2man
        $(PERL) -I../lib pod2man $*.pod >$*.man
 
-.SUFFIXES: .mp .pod .html
+.SUFFIXES: .html
 
 .pm.html:    pod2html
-       $(PERL) -I../lib pod2html $*.pod
+       $(PERL) -I../lib $(POD2HTML) --infile=$*.pm --outfile=$*.html
 
 .pod.html:    pod2html
-       $(PERL) -I../lib pod2html $*.pod
-
-.SUFFIXES: .pm .pod .tex
+       $(PERL) -I../lib $(POD2HTML) --infile=$*.pod --outfile=$*.html
 
-.pod.tex: pod2latex
-       $(PERL) -I../lib pod2latex $*.pod
+.SUFFIXES: .tex
 
 .pm.tex: pod2latex
+       $(PERL) -I../lib pod2latex $*.pm
+
+.pod.tex: pod2latex
        $(PERL) -I../lib pod2latex $*.pod
 
 clean:
-       rm -f $(MAN) $(HTML) $(TEX)
-       rm -f *.aux *.log
+       rm -f $(MAN)
+       rm -f $(HTML)
+       rm -f $(TEX)
+       rm -f pod2html-*cache
+       rm -f *.aux *.log *.exe
 
 realclean:     clean
        rm -f $(CONVERTERS)
@@ -256,4 +317,16 @@ pod2text:  pod2text.PL ../lib/Config.pm
 checkpods:     checkpods.PL ../lib/Config.pm
        $(PERL) -I ../lib checkpods.PL
 
+pod2usage:     pod2usage.PL ../lib/Config.pm
+       $(PERL) -I ../lib pod2usage.PL
+
+podchecker:    podchecker.PL ../lib/Config.pm
+       $(PERL) -I ../lib podchecker.PL
+
+podselect:     podselect.PL ../lib/Config.pm
+       $(PERL) -I ../lib podselect.PL
+
+compile: all
+       $(REALPERL) -I../lib ../utils/perlcc -regex 's/$$/.exe/' pod2latex pod2man pod2text checkpods -prog -verbose dcf -log ../compilelog;
 
+