clarify docs on return value from binding operators
[p5sagit/p5-mst-13.2.git] / pod / Makefile
1 CONVERTERS = pod2html pod2latex pod2man pod2text checkpods \
2                 pod2usage podchecker podselect
3
4 HTMLROOT = /    # Change this to fix cross-references in HTML
5 POD2HTML = pod2html \
6             --htmlroot=$(HTMLROOT) \
7             --podroot=.. --podpath=pod:lib:ext:vms \
8             --libpods=perlfunc:perlguts:perlvar:perlrun:perlop
9
10 all: $(CONVERTERS) man
11
12 converters: $(CONVERTERS)
13
14 PERL = ../miniperl
15 REALPERL = ../perl
16
17 POD = \
18         perl.pod        \
19         perldelta.pod   \
20         perl5004delta.pod       \
21         perl5005delta.pod       \
22         perldata.pod    \
23         perlsyn.pod     \
24         perlop.pod      \
25         perlre.pod      \
26         perlrun.pod     \
27         perlfunc.pod    \
28         perlopentut.pod \
29         perlvar.pod     \
30         perlsub.pod     \
31         perlmod.pod     \
32         perlmodlib.pod  \
33         perlmodinstall.pod      \
34         perlfork.pod    \
35         perlform.pod    \
36         perllocale.pod  \
37         perlref.pod     \
38         perlreftut.pod  \
39         perldsc.pod     \
40         perllol.pod     \
41         perlboot.pod    \
42         perltoot.pod    \
43         perltootc.pod   \
44         perlobj.pod     \
45         perltie.pod     \
46         perlbot.pod     \
47         perlipc.pod     \
48         perlthrtut.pod  \
49         perldbmfilter.pod       \
50         perldebug.pod   \
51         perlnumber.pod  \
52         perldiag.pod    \
53         perlsec.pod     \
54         perltrap.pod    \
55         perlport.pod    \
56         perlstyle.pod   \
57         perlpod.pod     \
58         perlbook.pod    \
59         perlembed.pod   \
60         perlapio.pod    \
61         perlxs.pod      \
62         perlxstut.pod   \
63         perlguts.pod    \
64         perlcall.pod    \
65         perlcompile.pod \
66         perltodo.pod    \
67         perlapi.pod     \
68         perlintern.pod  \
69         perlhack.pod    \
70         perlhist.pod    \
71         perlfaq.pod     \
72         perlfaq1.pod    \
73         perlfaq2.pod    \
74         perlfaq3.pod    \
75         perlfaq4.pod    \
76         perlfaq5.pod    \
77         perlfaq6.pod    \
78         perlfaq7.pod    \
79         perlfaq8.pod    \
80         perlfaq9.pod    \
81         perltoc.pod
82
83 MAN = \
84         perl.man        \
85         perldelta.man   \
86         perl5004delta.man       \
87         perl5005delta.man       \
88         perldata.man    \
89         perlsyn.man     \
90         perlop.man      \
91         perlre.man      \
92         perlrun.man     \
93         perlfunc.man    \
94         perlopentut.man \
95         perlvar.man     \
96         perlsub.man     \
97         perlmod.man     \
98         perlmodlib.man  \
99         perlmodinstall.man      \
100         perlfork.man    \
101         perlform.man    \
102         perllocale.man  \
103         perlref.man     \
104         perlreftut.man  \
105         perldsc.man     \
106         perllol.man     \
107         perlboot.man    \
108         perltoot.man    \
109         perltootc.man   \
110         perlobj.man     \
111         perltie.man     \
112         perlbot.man     \
113         perlipc.man     \
114         perlthrtut.man  \
115         perldbmfilter.man       \
116         perldebug.man   \
117         perlnumber.man  \
118         perldiag.man    \
119         perlsec.man     \
120         perltrap.man    \
121         perlport.man    \
122         perlstyle.man   \
123         perlpod.man     \
124         perlbook.man    \
125         perlembed.man   \
126         perlapio.man    \
127         perlxs.man      \
128         perlxstut.man   \
129         perlguts.man    \
130         perlcall.man    \
131         perlcompile.man \
132         perltodo.man    \
133         perlapi.man     \
134         perlintern.man  \
135         perlhack.man    \
136         perlhist.man    \
137         perlfaq.man     \
138         perlfaq1.man    \
139         perlfaq2.man    \
140         perlfaq3.man    \
141         perlfaq4.man    \
142         perlfaq5.man    \
143         perlfaq6.man    \
144         perlfaq7.man    \
145         perlfaq8.man    \
146         perlfaq9.man    \
147         perltoc.man
148
149 HTML = \
150         perl.html       \
151         perldelta.html  \
152         perl5004delta.html      \
153         perl5005delta.html      \
154         perldata.html   \
155         perlsyn.html    \
156         perlop.html     \
157         perlre.html     \
158         perlrun.html    \
159         perlfunc.html   \
160         perlopentut.html        \
161         perlvar.html    \
162         perlsub.html    \
163         perlmod.html    \
164         perlmodlib.html \
165         perlmodinstall.html     \
166         perlfork.html   \
167         perlform.html   \
168         perllocale.html \
169         perlref.html    \
170         perlreftut.html \
171         perldsc.html    \
172         perllol.html    \
173         perlboot.html   \
174         perltoot.html   \
175         perltootc.html  \
176         perlobj.html    \
177         perltie.html    \
178         perlbot.html    \
179         perlipc.html    \
180         perlthrtut.html \
181         perldbmfilter.html      \
182         perldebug.html  \
183         perlnumber.html \
184         perldiag.html   \
185         perlsec.html    \
186         perltrap.html   \
187         perlport.html   \
188         perlstyle.html  \
189         perlpod.html    \
190         perlbook.html   \
191         perlembed.html  \
192         perlapio.html   \
193         perlxs.html     \
194         perlxstut.html  \
195         perlguts.html   \
196         perlcall.html   \
197         perlcompile.html        \
198         perltodo.html   \
199         perlapi.html    \
200         perlintern.html \
201         perlhack.html   \
202         perlhist.html   \
203         perlfaq.html    \
204         perlfaq1.html   \
205         perlfaq2.html   \
206         perlfaq3.html   \
207         perlfaq4.html   \
208         perlfaq5.html   \
209         perlfaq6.html   \
210         perlfaq7.html   \
211         perlfaq8.html   \
212         perlfaq9.html
213 # not perltoc.html
214
215 TEX = \
216         perl.tex        \
217         perldelta.tex   \
218         perl5004delta.tex       \
219         perl5005delta.tex       \
220         perldata.tex    \
221         perlsyn.tex     \
222         perlop.tex      \
223         perlre.tex      \
224         perlrun.tex     \
225         perlfunc.tex    \
226         perlopentut.tex \
227         perlvar.tex     \
228         perlsub.tex     \
229         perlmod.tex     \
230         perlmodlib.tex  \
231         perlmodinstall.tex      \
232         perlfork.tex    \
233         perlform.tex    \
234         perllocale.tex  \
235         perlref.tex     \
236         perlreftut.tex  \
237         perldsc.tex     \
238         perllol.tex     \
239         perlboot.tex    \
240         perltoot.tex    \
241         perltootc.tex   \
242         perlobj.tex     \
243         perltie.tex     \
244         perlbot.tex     \
245         perlipc.tex     \
246         perlthrtut.tex  \
247         perldbmfilter.tex       \
248         perldebug.tex   \
249         perlnumber.tex  \
250         perldiag.tex    \
251         perlsec.tex     \
252         perltrap.tex    \
253         perlport.tex    \
254         perlstyle.tex   \
255         perlpod.tex     \
256         perlbook.tex    \
257         perlembed.tex   \
258         perlapio.tex    \
259         perlxs.tex      \
260         perlxstut.tex   \
261         perlguts.tex    \
262         perlcall.tex    \
263         perlcompile.tex \
264         perltodo.tex    \
265         perlapi.tex     \
266         perlintern.tex  \
267         perlhack.tex    \
268         perlhist.tex    \
269         perlfaq.tex     \
270         perlfaq1.tex    \
271         perlfaq2.tex    \
272         perlfaq3.tex    \
273         perlfaq4.tex    \
274         perlfaq5.tex    \
275         perlfaq6.tex    \
276         perlfaq7.tex    \
277         perlfaq8.tex    \
278         perlfaq9.tex    \
279         perltoc.tex
280
281 man:    pod2man $(MAN)
282
283 html:   pod2html $(HTML)
284
285 tex:    pod2latex $(TEX)
286
287 toc:
288         $(PERL) -I../lib buildtoc >perltoc.pod
289
290 .SUFFIXES: .pm .pod
291
292 .SUFFIXES: .man
293
294 .pm.man:     pod2man
295         $(PERL) -I../lib pod2man $*.pm >$*.man
296
297 .pod.man:     pod2man
298         $(PERL) -I../lib pod2man $*.pod >$*.man
299
300 .SUFFIXES: .html
301
302 .pm.html:    pod2html
303         $(PERL) -I../lib $(POD2HTML) --infile=$*.pm --outfile=$*.html
304
305 .pod.html:    pod2html
306         $(PERL) -I../lib $(POD2HTML) --infile=$*.pod --outfile=$*.html
307
308 .SUFFIXES: .tex
309
310 .pm.tex: pod2latex
311         $(PERL) -I../lib pod2latex $*.pm
312
313 .pod.tex: pod2latex
314         $(PERL) -I../lib pod2latex $*.pod
315
316 clean:
317         rm -f $(MAN)
318         rm -f $(HTML)
319         rm -f $(TEX)
320         rm -f pod2html-*cache
321         rm -f *.aux *.log *.exe
322
323 realclean:      clean
324         rm -f $(CONVERTERS)
325
326 distclean:      realclean
327
328 check:  checkpods
329         @echo "checking..."; \
330         $(PERL) -I../lib checkpods $(POD)
331
332 # Dependencies.
333 pod2latex:      pod2latex.PL ../lib/Config.pm
334         $(PERL) -I../lib pod2latex.PL
335
336 pod2html:       pod2html.PL ../lib/Config.pm
337         $(PERL) -I ../lib pod2html.PL
338
339 pod2man:        pod2man.PL ../lib/Config.pm
340         $(PERL) -I ../lib pod2man.PL
341
342 pod2text:       pod2text.PL ../lib/Config.pm
343         $(PERL) -I ../lib pod2text.PL
344
345 checkpods:      checkpods.PL ../lib/Config.pm
346         $(PERL) -I ../lib checkpods.PL
347
348 pod2usage:      pod2usage.PL ../lib/Config.pm
349         $(PERL) -I ../lib pod2usage.PL
350
351 podchecker:     podchecker.PL ../lib/Config.pm
352         $(PERL) -I ../lib podchecker.PL
353
354 podselect:      podselect.PL ../lib/Config.pm
355         $(PERL) -I ../lib podselect.PL
356
357 compile: all
358         $(REALPERL) -I../lib ../utils/perlcc -regex 's/$$/.exe/' pod2latex pod2man pod2text checkpods -prog -verbose dcf -log ../compilelog;
359
360