This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
add perlreftut.pod
[perl5.git] / pod / Makefile
1 CONVERTERS = pod2html pod2latex pod2man pod2text checkpods
2
3 HTMLROOT = /    # Change this to fix cross-references in HTML
4 POD2HTML = pod2html \
5             --htmlroot=$(HTMLROOT) \
6             --podroot=.. --podpath=pod:lib:ext:vms \
7             --libpods=perlfunc:perlguts:perlvar:perlrun:perlop
8
9 all: $(CONVERTERS) man
10
11 converters: $(CONVERTERS)
12
13 PERL = ../miniperl
14 REALPERL = ../perl
15
16 POD = \
17         perl.pod        \
18         perldelta.pod   \
19         perldata.pod    \
20         perlsyn.pod     \
21         perlop.pod      \
22         perlre.pod      \
23         perlrun.pod     \
24         perlfunc.pod    \
25         perlvar.pod     \
26         perlsub.pod     \
27         perlmod.pod     \
28         perlmodlib.pod  \
29         perlmodinstall.pod      \
30         perlform.pod    \
31         perllocale.pod  \
32         perlref.pod     \
33         perlreftut.pod  \
34         perldsc.pod     \
35         perllol.pod     \
36         perltoot.pod    \
37         perlobj.pod     \
38         perltie.pod     \
39         perlbot.pod     \
40         perlipc.pod     \
41         perldebug.pod   \
42         perldiag.pod    \
43         perlsec.pod     \
44         perltrap.pod    \
45         perlport.pod    \
46         perlstyle.pod   \
47         perlpod.pod     \
48         perlbook.pod    \
49         perlembed.pod   \
50         perlapio.pod    \
51         perlxs.pod      \
52         perlxstut.pod   \
53         perlguts.pod    \
54         perlcall.pod    \
55         perlfaq.pod     \
56         perlfaq1.pod    \
57         perlfaq2.pod    \
58         perlfaq3.pod    \
59         perlfaq4.pod    \
60         perlfaq5.pod    \
61         perlfaq6.pod    \
62         perlfaq7.pod    \
63         perlfaq8.pod    \
64         perlfaq9.pod    \
65         perltoc.pod
66
67 MAN = \
68         perl.man        \
69         perldelta.man   \
70         perldata.man    \
71         perlsyn.man     \
72         perlop.man      \
73         perlre.man      \
74         perlrun.man     \
75         perlfunc.man    \
76         perlvar.man     \
77         perlsub.man     \
78         perlmod.man     \
79         perlmodlib.man  \
80         perlmodinstall.man      \
81         perlform.man    \
82         perllocale.man  \
83         perlref.man     \
84         perlreftut.man  \
85         perldsc.man     \
86         perllol.man     \
87         perltoot.man    \
88         perlobj.man     \
89         perltie.man     \
90         perlbot.man     \
91         perlipc.man     \
92         perldebug.man   \
93         perldiag.man    \
94         perlsec.man     \
95         perltrap.man    \
96         perlport.man    \
97         perlstyle.man   \
98         perlpod.man     \
99         perlbook.man    \
100         perlembed.man   \
101         perlapio.man    \
102         perlxs.man      \
103         perlxstut.man   \
104         perlguts.man    \
105         perlcall.man    \
106         perlfaq.man     \
107         perlfaq1.man    \
108         perlfaq2.man    \
109         perlfaq3.man    \
110         perlfaq4.man    \
111         perlfaq5.man    \
112         perlfaq6.man    \
113         perlfaq7.man    \
114         perlfaq8.man    \
115         perlfaq9.man    \
116         perltoc.man
117
118 HTML = \
119         perl.html       \
120         perldelta.html  \
121         perldata.html   \
122         perlsyn.html    \
123         perlop.html     \
124         perlre.html     \
125         perlrun.html    \
126         perlfunc.html   \
127         perlvar.html    \
128         perlsub.html    \
129         perlmod.html    \
130         perlmodlib.html \
131         perlmodinstall.html     \
132         perlform.html   \
133         perllocale.html \
134         perlref.html    \
135         perlreftut.html \
136         perldsc.html    \
137         perllol.html    \
138         perltoot.html   \
139         perlobj.html    \
140         perltie.html    \
141         perlbot.html    \
142         perlipc.html    \
143         perldebug.html  \
144         perldiag.html   \
145         perlsec.html    \
146         perltrap.html   \
147         perlport.html   \
148         perlstyle.html  \
149         perlpod.html    \
150         perlbook.html   \
151         perlembed.html  \
152         perlapio.html   \
153         perlxs.html     \
154         perlxstut.html  \
155         perlguts.html   \
156         perlcall.html   \
157         perlfaq.html    \
158         perlfaq1.html   \
159         perlfaq2.html   \
160         perlfaq3.html   \
161         perlfaq4.html   \
162         perlfaq5.html   \
163         perlfaq6.html   \
164         perlfaq7.html   \
165         perlfaq8.html   \
166         perlfaq9.html
167 # not perltoc.html
168
169 TEX = \
170         perl.tex        \
171         perldelta.tex   \
172         perldata.tex    \
173         perlsyn.tex     \
174         perlop.tex      \
175         perlre.tex      \
176         perlrun.tex     \
177         perlfunc.tex    \
178         perlvar.tex     \
179         perlsub.tex     \
180         perlmod.tex     \
181         perlmodlib.tex  \
182         perlmodinstall.tex      \
183         perlform.tex    \
184         perllocale.tex  \
185         perlref.tex     \
186         perlreftut.tex  \
187         perldsc.tex     \
188         perllol.tex     \
189         perltoot.tex    \
190         perlobj.tex     \
191         perltie.tex     \
192         perlbot.tex     \
193         perlipc.tex     \
194         perldebug.tex   \
195         perldiag.tex    \
196         perlsec.tex     \
197         perltrap.tex    \
198         perlport.tex    \
199         perlstyle.tex   \
200         perlpod.tex     \
201         perlbook.tex    \
202         perlembed.tex   \
203         perlapio.tex    \
204         perlxs.tex      \
205         perlxstut.tex   \
206         perlguts.tex    \
207         perlcall.tex    \
208         perlfaq.tex     \
209         perlfaq1.tex    \
210         perlfaq2.tex    \
211         perlfaq3.tex    \
212         perlfaq4.tex    \
213         perlfaq5.tex    \
214         perlfaq6.tex    \
215         perlfaq7.tex    \
216         perlfaq8.tex    \
217         perlfaq9.tex    \
218         perltoc.tex
219
220 man:    pod2man $(MAN)
221
222 html:   pod2html $(HTML)
223
224 tex:    pod2latex $(TEX)
225
226 toc:
227         $(PERL) -I../lib buildtoc >perltoc.pod
228
229 .SUFFIXES: .pm .pod
230
231 .SUFFIXES: .man
232
233 .pm.man:     pod2man
234         $(PERL) -I../lib pod2man $*.pm >$*.man
235
236 .pod.man:     pod2man
237         $(PERL) -I../lib pod2man $*.pod >$*.man
238
239 .SUFFIXES: .html
240
241 .pm.html:    pod2html
242         $(PERL) -I../lib $(POD2HTML) --infile=$*.pm --outfile=$*.html
243
244 .pod.html:    pod2html
245         $(PERL) -I../lib $(POD2HTML) --infile=$*.pod --outfile=$*.html
246
247 .SUFFIXES: .tex
248
249 .pm.tex: pod2latex
250         $(PERL) -I../lib pod2latex $*.pm
251
252 .pod.tex: pod2latex
253         $(PERL) -I../lib pod2latex $*.pod
254
255 clean:
256         rm -f $(MAN)
257         rm -f $(HTML)
258         rm -f $(TEX)
259         rm -f pod2html-*cache
260         rm -f *.aux *.log *.exe
261
262 realclean:      clean
263         rm -f $(CONVERTERS)
264
265 distclean:      realclean
266
267 check:  checkpods
268         @echo "checking..."; \
269         $(PERL) -I../lib checkpods $(POD)
270
271 # Dependencies.
272 pod2latex:      pod2latex.PL ../lib/Config.pm
273         $(PERL) -I../lib pod2latex.PL
274
275 pod2html:       pod2html.PL ../lib/Config.pm
276         $(PERL) -I ../lib pod2html.PL
277
278 pod2man:        pod2man.PL ../lib/Config.pm
279         $(PERL) -I ../lib pod2man.PL
280
281 pod2text:       pod2text.PL ../lib/Config.pm
282         $(PERL) -I ../lib pod2text.PL
283
284 checkpods:      checkpods.PL ../lib/Config.pm
285         $(PERL) -I ../lib checkpods.PL
286
287 compile: all
288         $(REALPERL) -I../lib ../utils/perlcc -regex 's/$$/.exe/' pod2latex pod2man pod2text checkpods -prog -verbose dcf -log ../compilelog;
289
290