explain caveat about use of numeric constants in podoc for sysopen()

[p5sagit/p5-mst-13.2.git] / pod / Makefile

diff --git a/pod/Makefile b/pod/Makefile
index cd01028..9187c84 100644 (file)
--- a/pod/Makefile
+++ b/pod/Makefile
@@ -1,11 +1,21 @@
 CONVERTERS = pod2html pod2latex pod2man pod2text checkpods
 
+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        \
-       perlnews.pod    \
+       perldelta.pod   \
        perldata.pod    \
        perlsyn.pod     \
        perlop.pod      \
@@ -15,6 +25,8 @@ POD = \
        perlvar.pod     \
        perlsub.pod     \
        perlmod.pod     \
+       perlmodlib.pod  \
+       perlmodinstall.pod      \
        perlform.pod    \
        perllocale.pod  \
        perlref.pod     \
@@ -29,6 +41,7 @@ POD = \
        perldiag.pod    \
        perlsec.pod     \
        perltrap.pod    \
+       perlport.pod    \
        perlstyle.pod   \
        perlpod.pod     \
        perlbook.pod    \
@@ -38,11 +51,21 @@ POD = \
        perlxstut.pod   \
        perlguts.pod    \
        perlcall.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        \
-       perlnews.man    \
+       perldelta.man   \
        perldata.man    \
        perlsyn.man     \
        perlop.man      \
@@ -52,6 +75,8 @@ MAN = \
        perlvar.man     \
        perlsub.man     \
        perlmod.man     \
+       perlmodlib.man  \
+       perlmodinstall.man      \
        perlform.man    \
        perllocale.man  \
        perlref.man     \
@@ -66,6 +91,7 @@ MAN = \
        perldiag.man    \
        perlsec.man     \
        perltrap.man    \
+       perlport.man    \
        perlstyle.man   \
        perlpod.man     \
        perlbook.man    \
@@ -75,11 +101,21 @@ MAN = \
        perlxstut.man   \
        perlguts.man    \
        perlcall.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       \
-       perlnews.html   \
+       perldelta.html  \
        perldata.html   \
        perlsyn.html    \
        perlop.html     \
@@ -89,6 +125,8 @@ HTML = \
        perlvar.html    \
        perlsub.html    \
        perlmod.html    \
+       perlmodlib.html \
+       perlmodinstall.html     \
        perlform.html   \
        perllocale.html \
        perlref.html    \
@@ -103,6 +141,7 @@ HTML = \
        perldiag.html   \
        perlsec.html    \
        perltrap.html   \
+       perlport.html   \
        perlstyle.html  \
        perlpod.html    \
        perlbook.html   \
@@ -112,11 +151,21 @@ HTML = \
        perlxstut.html  \
        perlguts.html   \
        perlcall.html   \
-       perltoc.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        \
-       perlnews.tex    \
+       perldelta.tex   \
        perldata.tex    \
        perlsyn.tex     \
        perlop.tex      \
@@ -126,6 +175,8 @@ TEX = \
        perlvar.tex     \
        perlsub.tex     \
        perlmod.tex     \
+       perlmodlib.tex  \
+       perlmodinstall.tex      \
        perlform.tex    \
        perllocale.tex  \
        perlref.tex     \
@@ -140,6 +191,7 @@ TEX = \
        perldiag.tex    \
        perlsec.tex     \
        perltrap.tex    \
+       perlport.tex    \
        perlstyle.tex   \
        perlpod.tex     \
        perlbook.tex    \
@@ -149,21 +201,30 @@ TEX = \
        perlxstut.tex   \
        perlguts.tex    \
        perlcall.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) -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
@@ -171,25 +232,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
+       $(PERL) -I../lib $(POD2HTML) --infile=$*.pod --outfile=$*.html
 
-.SUFFIXES: .pm .pod .tex
-
-.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)
@@ -216,4 +280,7 @@ pod2text:   pod2text.PL ../lib/Config.pm
 checkpods:     checkpods.PL ../lib/Config.pm
        $(PERL) -I ../lib checkpods.PL
 
+compile: all
+       $(REALPERL) -I../lib ../utils/perlcc -regex 's/$$/.exe/' pod2latex pod2man pod2text checkpods -prog -verbose dcf -log ../compilelog;
 
+