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 38d5b0f..f28b9d4 100644 (file)
-CONVERTERS = pod2html pod2latex pod2man
+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        \
-       perlbook.pod    \
-       perlbot.pod     \
-       perlcall.pod    \
+       perldelta.pod   \
+       perl5004delta.pod       \
+       perl5005delta.pod       \
        perldata.pod    \
-       perldebug.pod   \
-       perldiag.pod    \
-       perldsc.pod     \
-       perlembed.pod   \
-       perlform.pod    \
-       perlfunc.pod    \
-       perlguts.pod    \
-       perlipc.pod     \
-       perllol.pod     \
-       perlmod.pod     \
-       perlobj.pod     \
+       perlsyn.pod     \
        perlop.pod      \
-       perlovl.pod     \
-       perlpod.pod     \
        perlre.pod      \
-       perlref.pod     \
        perlrun.pod     \
-       perlsec.pod     \
-       perlstyle.pod   \
+       perlfunc.pod    \
+       perlopentut.pod \
+       perlvar.pod     \
        perlsub.pod     \
-       perlsyn.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    \
-       perlvar.pod     \
+       perlport.pod    \
+       perlstyle.pod   \
+       perlpod.pod     \
+       perlbook.pod    \
+       perlembed.pod   \
+       perlapio.pod    \
        perlxs.pod      \
-       perlxstut.pod
+       perlxstut.pod   \
+       perlguts.pod    \
+       perlcall.pod    \
+       perltodo.pod    \
+       perlhist.pod    \
+       perlfaq.pod     \
+       perlfaq1.pod    \
+       perlfaq2.pod    \
+       perlfaq3.pod    \
+       perlfaq4.pod    \
+       perlfaq5.pod    \
+       perlfaq6.pod    \
+       perlfaq7.pod    \
+       perlfaq8.pod    \
+       perlfaq9.pod    \
+       perltoc.pod
 
 MAN = \
        perl.man        \
-       perlbook.man    \
-       perlbot.man     \
-       perlcall.man    \
+       perldelta.man   \
+       perl5004delta.man       \
+       perl5005delta.man       \
        perldata.man    \
-       perldebug.man   \
-       perldiag.man    \
-       perldsc.man     \
-       perlembed.man   \
-       perlform.man    \
-       perlfunc.man    \
-       perlguts.man    \
-       perlipc.man     \
-       perllol.man     \
-       perlmod.man     \
-       perlobj.man     \
+       perlsyn.man     \
        perlop.man      \
-       perlovl.man     \
-       perlpod.man     \
        perlre.man      \
-       perlref.man     \
        perlrun.man     \
-       perlsec.man     \
-       perlstyle.man   \
+       perlfunc.man    \
+       perlopentut.man \
+       perlvar.man     \
        perlsub.man     \
-       perlsyn.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    \
-       perlvar.man     \
+       perlport.man    \
+       perlstyle.man   \
+       perlpod.man     \
+       perlbook.man    \
+       perlembed.man   \
+       perlapio.man    \
        perlxs.man      \
-       perlxstut.man
+       perlxstut.man   \
+       perlguts.man    \
+       perlcall.man    \
+       perltodo.man    \
+       perlhist.man    \
+       perlfaq.man     \
+       perlfaq1.man    \
+       perlfaq2.man    \
+       perlfaq3.man    \
+       perlfaq4.man    \
+       perlfaq5.man    \
+       perlfaq6.man    \
+       perlfaq7.man    \
+       perlfaq8.man    \
+       perlfaq9.man    \
+       perltoc.man
 
 HTML = \
        perl.html       \
-       perlbook.html   \
-       perlbot.html    \
-       perlcall.html   \
+       perldelta.html  \
+       perl5004delta.html      \
+       perl5005delta.html      \
        perldata.html   \
-       perldebug.html  \
-       perldiag.html   \
-       perldsc.html    \
-       perlembed.html  \
-       perlform.html   \
-       perlfunc.html   \
-       perlguts.html   \
-       perlipc.html    \
-       perllol.html    \
-       perlmod.html    \
-       perlobj.html    \
+       perlsyn.html    \
        perlop.html     \
-       perlovl.html    \
-       perlpod.html    \
        perlre.html     \
-       perlref.html    \
        perlrun.html    \
-       perlsec.html    \
-       perlstyle.html  \
+       perlfunc.html   \
+       perlopentut.html        \
+       perlvar.html    \
        perlsub.html    \
-       perlsyn.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   \
-       perlvar.html    \
+       perlport.html   \
+       perlstyle.html  \
+       perlpod.html    \
+       perlbook.html   \
+       perlembed.html  \
+       perlapio.html   \
        perlxs.html     \
-       perlxstut.html
+       perlxstut.html  \
+       perlguts.html   \
+       perlcall.html   \
+       perltodo.html   \
+       perlhist.html   \
+       perlfaq.html    \
+       perlfaq1.html   \
+       perlfaq2.html   \
+       perlfaq3.html   \
+       perlfaq4.html   \
+       perlfaq5.html   \
+       perlfaq6.html   \
+       perlfaq7.html   \
+       perlfaq8.html   \
+       perlfaq9.html
+# not perltoc.html
 
 TEX = \
        perl.tex        \
-       perlbook.tex    \
-       perlbot.tex     \
-       perlcall.tex    \
+       perldelta.tex   \
+       perl5004delta.tex       \
+       perl5005delta.tex       \
        perldata.tex    \
-       perldebug.tex   \
-       perldiag.tex    \
-       perldsc.tex     \
-       perlembed.tex   \
-       perlform.tex    \
-       perlfunc.tex    \
-       perlguts.tex    \
-       perlipc.tex     \
-       perllol.tex     \
-       perlmod.tex     \
-       perlobj.tex     \
+       perlsyn.tex     \
        perlop.tex      \
-       perlovl.tex     \
-       perlpod.tex     \
        perlre.tex      \
-       perlref.tex     \
        perlrun.tex     \
-       perlsec.tex     \
-       perlstyle.tex   \
+       perlfunc.tex    \
+       perlopentut.tex \
+       perlvar.tex     \
        perlsub.tex     \
-       perlsyn.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    \
-       perlvar.tex     \
+       perlport.tex    \
+       perlstyle.tex   \
+       perlpod.tex     \
+       perlbook.tex    \
+       perlembed.tex   \
+       perlapio.tex    \
        perlxs.tex      \
-       perlxstut.tex
+       perlxstut.tex   \
+       perlguts.tex    \
+       perlcall.tex    \
+       perltodo.tex    \
+       perlhist.tex    \
+       perlfaq.tex     \
+       perlfaq1.tex    \
+       perlfaq2.tex    \
+       perlfaq3.tex    \
+       perlfaq4.tex    \
+       perlfaq5.tex    \
+       perlfaq6.tex    \
+       perlfaq7.tex    \
+       perlfaq8.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) pod2html *.pod
+html:  pod2html $(HTML)
 
 tex:   pod2latex $(TEX)
 
-.SUFFIXES: .pod .man
+toc:
+       $(PERL) -I../lib buildtoc >perltoc.pod
+
+.SUFFIXES: .pm .pod
+
+.SUFFIXES: .man
+
+.pm.man:     pod2man
+       $(PERL) -I../lib pod2man $*.pm >$*.man
 
 .pod.man:     pod2man
-       $(PERL) pod2man $*.pod >$*.man
+       $(PERL) -I../lib pod2man $*.pod >$*.man
 
-.SUFFIXES: .pod .html
+.SUFFIXES: .html
+
+.pm.html:    pod2html
+       $(PERL) -I../lib $(POD2HTML) --infile=$*.pm --outfile=$*.html
 
 .pod.html:    pod2html
-       $(PERL) pod2html $*.pod
+       $(PERL) -I../lib $(POD2HTML) --infile=$*.pod --outfile=$*.html
+
+.SUFFIXES: .tex
 
-.SUFFIXES: .pod .tex
+.pm.tex: pod2latex
+       $(PERL) -I../lib pod2latex $*.pm
 
 .pod.tex: pod2latex
-       $(PERL) pod2latex $*.pod
+       $(PERL) -I../lib pod2latex $*.pod
 
 clean:
-       rm -f $(MAN) $(HTML) $(TEX)
+       rm -f $(MAN)
+       rm -f $(HTML)
+       rm -f $(TEX)
+       rm -f pod2html-*cache
+       rm -f *.aux *.log *.exe
 
 realclean:     clean
-       rm -f pod2man pod2latex pod2html
+       rm -f $(CONVERTERS)
 
 distclean:     realclean
 
+check: checkpods
+       @echo "checking..."; \
+       $(PERL) -I../lib checkpods $(POD)
+
 # Dependencies.
 pod2latex:     pod2latex.PL ../lib/Config.pm
        $(PERL) -I../lib pod2latex.PL
@@ -173,3 +310,23 @@ pod2html:  pod2html.PL ../lib/Config.pm
 
 pod2man:       pod2man.PL ../lib/Config.pm
        $(PERL) -I ../lib pod2man.PL
+
+pod2text:      pod2text.PL ../lib/Config.pm
+       $(PERL) -I ../lib pod2text.PL
+
+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;
+
+