Mercurial > dive4elements > river
comparison flys-artifacts/doc/datacage-config-manual/Makefile @ 3266:43a2b1e7bc0d
Added makefile for datacage conf doc.
flys-artifacts/trunk@4906 c6561f87-3c4e-4783-a992-168aeb5c3f6f
author | Felix Wolfsteller <felix.wolfsteller@intevation.de> |
---|---|
date | Sun, 08 Jul 2012 18:57:59 +0000 |
parents | |
children |
comparison
equal
deleted
inserted
replaced
3265:c1f445b94d03 | 3266:43a2b1e7bc0d |
---|---|
1 # Copyright 2004 Chris Monson (shiblon@gmail.com) | |
2 # Latest version available at http://www.bouncingchairs.net/oss | |
3 # | |
4 # This file is part of ``Chris Monson's Free Software''. | |
5 # | |
6 # ``Chris Monson's Free Software'' is free software; you can redistribute it | |
7 # and/or modify it under the terms of the GNU General Public License as | |
8 # published by the Free Software Foundation, Version 2. | |
9 # | |
10 # ``Chris Monson's Free Software'' is distributed in the hope that it will | |
11 # be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of | |
12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General | |
13 # Public License for more details. | |
14 # | |
15 # You should have received a copy of the GNU General Public License along | |
16 # with ``Chris Monson's Free Software''; if not, write to the Free Software | |
17 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA | |
18 # | |
19 # It is also available on the web at http://www.gnu.org/copyleft/gpl.html | |
20 # | |
21 # Note that using this makefile to build your documents does NOT place them | |
22 # under the GPL unless you, the author, specifically do so. In other words, | |
23 # I, Chris Monson, the copyright holder and author of this makefile, | |
24 # consider it impossible to ``link'' to this makefile in any way covered by | |
25 # the GPL. | |
26 # | |
27 # TO OBTAIN INSTRUCTIONS FOR USING THIS FILE, RUN: | |
28 # make help | |
29 # | |
30 fileinfo := LaTeX Makefile | |
31 author := Chris Monson | |
32 version := 2.2.0-rc1 | |
33 # | |
34 # Note that the user-global version is imported *after* the source directory, | |
35 # so that you can use stuff like ?= to get proper override behavior. | |
36 .PHONY: Makefile GNUmakefile Makefile.ini $(HOME)/.latex-makefile/Makefile.ini | |
37 -include Makefile.ini | |
38 -include $(HOME)/.latex-makefile/Makefile.ini | |
39 # | |
40 # This can be pdflatex or latex - you can change this by adding the following line to your Makefile.ini: | |
41 # BUILD_STRATEGY := latex | |
42 BUILD_STRATEGY ?= pdflatex | |
43 # | |
44 # Sets LC_ALL=C, by default, so that the locale-aware tools, like sort, be | |
45 # # immune to changes to the locale in the user environment. | |
46 export LC_ALL ?= C | |
47 # | |
48 # | |
49 # If you specify sources here, all other files with the same suffix | |
50 # will be treated as if they were _include_ files. | |
51 #onlysources.tex ?= main.tex | |
52 #onlysources.tex.sh ?= | |
53 #onlysources.tex.pl ?= | |
54 #onlysources.tex.py ?= | |
55 #onlysources.rst ?= | |
56 #onlysources.fig ?= | |
57 #onlysources.gpi ?= | |
58 #onlysources.dot ?= | |
59 #onlysources.xvg ?= | |
60 #onlysources.svg ?= | |
61 #onlysources.eps.gz ?= | |
62 #onlysources.eps ?= | |
63 # | |
64 # If you list files here, they will be treated as _include_ files | |
65 #includes.tex ?= file1.tex file2.tex | |
66 #includes.tex.sh ?= | |
67 #includes.tex.pl ?= | |
68 #includes.tex.py ?= | |
69 #includes.rst ?= | |
70 #includes.fig ?= | |
71 #includes.gpi ?= | |
72 #includes.dot ?= | |
73 #includes.xvg ?= | |
74 #includes.svg ?= | |
75 #includes.eps.gz ?= | |
76 #includes.eps ?= | |
77 # | |
78 # If you list files or wildcards here, they will *not* be cleaned - default is | |
79 # to allow everything to be cleaned. | |
80 #neverclean ?= *.pdf | |
81 # | |
82 # Alternatively (recommended), you can add those lines to a Makefile.ini file | |
83 # and it will get picked up automatically without your having to edit this | |
84 # Makefile. | |
85 # | |
86 # KNOWN ISSUES: | |
87 # * The following occurs: | |
88 # file with: \usepackage{named}\bibliographystyle{named} | |
89 # Compile | |
90 # change to: \usepackage{apalike}\bibliographystyle{apalike} | |
91 # Compile again -- BARF! | |
92 # | |
93 # The workaround: make clean-nographics; make | |
94 # | |
95 # Note that we may not be able to fix this. LaTeX itself barfs | |
96 # on this, not the makefile. The very first invocation of LaTeX | |
97 # (when something like this has happened) reads the existing .aux | |
98 # file and discovers invalid commands like \citeauthoryear that | |
99 # are only valid in the package that was just removed. It then | |
100 # tries to parse them and explodes. It's not at all clear to me | |
101 # how to fix this. I tried removing the .aux files on the first | |
102 # run of LaTeX, but that necessarily requires more subsequent | |
103 # rebuilds on common edits. There does not appear to be a | |
104 # graceful solution to this issue. | |
105 # | |
106 # CHANGES: | |
107 # Chris Monson (2010-04-08): | |
108 # * Bumped version to 2.2.0-rc1 | |
109 # * Added back in the rst_style_file stuff that got broken when switching | |
110 # rst -> tex to use the script mechanism | |
111 # Chris Monson (2010-03-23): | |
112 # * Bumped version to 2.2.0-beta8 | |
113 # * Work on issue 76: bad backtick escape for some sed versions, failure | |
114 # to clear out the hold buffer when outputting MISSING comment. | |
115 # - Backed out 2>&1 to &> (doesn't work in sh) | |
116 # - Backed out using . to source variables | |
117 # Chris Monson (2010-03-22): | |
118 # * Bumped version to 2.2.0-beta7 | |
119 # * Issue 72: Fix latex/bibtex invocation order for annotated bib styles | |
120 # * Fixed informational output to reflect which LaTeX run we're on | |
121 # * Fixed graphic detection to include graphics that are already there in | |
122 # .d files | |
123 # * Tightened up the .d file output to only make .d depend on graphic | |
124 # *source* files. This means that building foo.d no longer | |
125 # builds all of the graphics files on which foo.tex depends. | |
126 # Had to use .SECONDEXPANSION trickery to make it work. | |
127 # * Changed get-graphics to only accept a stem. | |
128 # * Fixed build-once logic for scripted .tex to work better | |
129 # * Made get-inputs sed script more maintainable. | |
130 # * Moved Makefile.ini import up higher. | |
131 # * Changed bare stems to not recursively invoke make | |
132 # * Updated diff output to be more silent everywhere | |
133 # * Added a MISSING comment to the .d file if stuff isn't found - forces | |
134 # removal of .1st.make file, which often forces it to try again. | |
135 # * Fixed broken graphics-target function | |
136 # * Added sleep to .d file generation when stuff is missing - if it | |
137 # builds too fast, make doesn't realize it needs to be reloaded, | |
138 # and thus never discovers some deeper dependencies (especially | |
139 # evident when graphics are included from scripted include | |
140 # files). | |
141 # Chris Monson (2010-03-17): | |
142 # * Bumped version to 2.2.0-beta6 | |
143 # * Fixed bareword builds to actually work (requires static patterns) | |
144 # * Fixed colorization to work with new paragraph stuff | |
145 # Chris Monson (2010-03-17): | |
146 # * Bumped version to 2.2.0-beta5 | |
147 # * Fixed graphic detection to be much more focused - splits log file | |
148 # into paragraphs before doing pattern matching. | |
149 # * Fixed make foo to work properly (recursively calls make foo.pdf) | |
150 # * Fixed gpi -> pdf generation to not waste time building .eps *after* | |
151 # the pdf already exists. | |
152 # * Changed log copies to include MAKE_RESTARTS as part of the name. | |
153 # * Fixed missing include file detection (also makes use of the paragraph | |
154 # stuff) to detect missing scripted include files. | |
155 # Chris Monson (2010-03-16): | |
156 # * Bumped version to 2.2.0-beta4 | |
157 # * issue 70: .pdf not moved out of the way properly on first | |
158 # compilation, resulting in early error detection failure. | |
159 # * issue 74: fixed broken error on missing .aux files: the | |
160 # implementation was masking real errors. | |
161 # Chris Monson (2010-03-15): | |
162 # * Bumped version to 2.2.0-beta3 | |
163 # * issue 71: Made the tput dependency optional | |
164 # * issue 73: Made .tex targets not pull in .d files (building them from | |
165 # scripts should not require a .d) | |
166 # * issue 74: Output a much saner error when a .aux file is not produced | |
167 # (e.g., when you are typing "make" without arguments in a | |
168 # directory with included .tex files that are not named with | |
169 # ._include_.) | |
170 # Chris Monson (2010-03-11): | |
171 # * Bumped version to 2.2.0-beta2 | |
172 # * Fixed clean-graphics to get rid of intermediate .eps files that may | |
173 # be hanging around | |
174 # * Added an automatic setting to use eps terminals in pdflatex mode for | |
175 # gnuplot if it doesn't understand pdf. | |
176 # * issue 66: Removed grayscale generation via magic suffix. Grayscale | |
177 # generation is now only available via GRAY=1 | |
178 # * issue 68: Added explicit handling of LC_ALL for locale-aware tools | |
179 # like "sort" | |
180 # Chris Monson (2010-03-10): | |
181 # * Bumped version to 2.2.0-beta1 | |
182 # * Fixed success message to handle output message in different places | |
183 # * Added name of produced file to success message | |
184 # Chris Monson (2010-03-10): | |
185 # * Bumped version to 2.2.0-alpha3 | |
186 # * Added meaningful error message for wrong hyperref options | |
187 # * Added meaningful error message for incorrect graphics extensions | |
188 # Chris Monson (2010-03-09): | |
189 # * Bumped version to 2.2.0-alpha2 | |
190 # * Updated graphics handling (gnuplot and fig generate pdf natively) | |
191 # * Changed xmgrace to output monochrome natively | |
192 # Chris Monson (2010-03-09): | |
193 # * Bumped version to 2.2.0-alpha1 - major change! | |
194 # * Support pdflatex natively and by default (issue 6 - a long time coming) | |
195 # * Add ability to have a single $HOME/.latex-makefile/Makefile.ini for | |
196 # all invocations | |
197 # * Reworked graphic inclusion detection so that extensions need not be | |
198 # specified for either build strategy (e.g., | |
199 # \includegraphics{test1.eps} -> \includegrahpics{test1}) | |
200 # * Changed log format to include filenames and line numbers | |
201 # Chris Monson (2010-02-04): | |
202 # * Bumped version to 2.1.43 | |
203 # * All of the following are for issue 63 (thanks to mojoh81): | |
204 # * Added documentation about fixing Makefile.ini default target | |
205 # * Added perl and python script targets | |
206 # * Fixed run logic to allow included .tex files to be scripted (the | |
207 # run-again logic now detects missing .tex files, and the MV | |
208 # command has been switched out for a command that only invokes | |
209 # MV if the files exist) | |
210 # * Changed scripted generation to only run once per make invocation | |
211 # * Added dependency on expr | |
212 # Chris Monson (2010-01-19): | |
213 # * Bumped version to 2.1.42 | |
214 # * issue 62: Added .brf extension to cleanable files (backrefs) | |
215 # Chris Monson (2010-01-07): | |
216 # * Bumped version to 2.1.41 | |
217 # * issue 60: bad makeindex runs now error out on subsequent tries | |
218 # Chris Monson (2009-12-01): | |
219 # * Bumped version to 2.1.40 | |
220 # * issue 36: build all indices (for e.g., splitidx usage) | |
221 # * issue 59: clean up all generated files (including indices) | |
222 # Chris Monson (2009-11-23): | |
223 # * Bumped version to 2.1.39 | |
224 # * issue 57: change ps2pdf invocations to just use gs directly | |
225 # Chris Monson (2009-11-19): | |
226 # * Bumped version to 2.1.38 | |
227 # * issue 57: Added some limited support for Cygwin (spaces in filenames) | |
228 # Chris Monson (2009-11-15): | |
229 # * Bumped version to 2.1.37 | |
230 # * Removed svninfo, since this is now managed by mercurial | |
231 # * Fixed typo in changelist | |
232 # * Issue 52: added jpg->eps conversion (thanks to brubakee) | |
233 # * Issue 54: fix missing Overfull colorization due to lack of a blank | |
234 # line preceding the first error. | |
235 # * Issue 51: remove head.tmp and body.tmp in make clean invocation | |
236 # * Issue 56: maintain multiple versions of log files (for debugging) | |
237 # Chris Monson (2009-11-14): | |
238 # * Bumped version to 2.1.36 | |
239 # * Issues 53 and 49: added .brf, .mtc, and .maf to the cleanables | |
240 # Chris Monson (2009-11-05): | |
241 # * Bumped version to 2.1.35 | |
242 # * Added nomenclature support (see issue 48) | |
243 # Chris Monson (2009-10-29): | |
244 # * Bumped version to 2.1.34 | |
245 # * Fixed _out_ creation bug introduced in 2.1.33 (it was always created) | |
246 # * Fixed erroneous help output for $HOME in BINARY_TARGET_DIR | |
247 # * Changed contact email address - bring on the spam! | |
248 # Chris Monson (2009-10-21): | |
249 # * Bumped version to 2.1.33 | |
250 # * Fixed issue 46, adding support for dot2tex (thanks to fdemesmay) | |
251 # * Made all_files.* settable in Makefile.ini (using ?= instead of :=) | |
252 # * Fixed issue 47, thanks to fdemesmay: add binary copy directory, copy | |
253 # dvi, pdf, and ps if it exists | |
254 # Chris Monson (2009-09-25): | |
255 # * Bumped version to 2.1.32 | |
256 # * Fixed so that a changed lol file will cause a rebuild | |
257 # * Added .lol files to the cleanable list | |
258 # Chris Monson (2009-09-08): | |
259 # * Bumped version to 2.1.31 | |
260 # * Closed issue 43: evince doesn't notice pdf change w/out touch | |
261 # Chris Monson (2009-08-28): | |
262 # * Bumped version to 2.1.30 | |
263 # * Closed issue 39: Capture multi-line log warnings/errors to output | |
264 # Chris Monson (2009-08-26): | |
265 # * Bumped version to 2.1.29 | |
266 # * Closed issue 42: add svg support using inkscape | |
267 # Chris Monson (2009-08-17): | |
268 # * Bumped version to 2.1.28 | |
269 # * Patch from paul.biggar for issue 38: package warnings are overlooked | |
270 # Chris Monson (2009-08-07): | |
271 # * Bumped version to 2.1.27 | |
272 # * Included patch for issue 37 - removes pdf/ps files before copying, | |
273 # allowing some broken viewers to see changes properly. | |
274 # Chris Monson (2009-05-15): | |
275 # * Bumped version to 2.1.26 | |
276 # * Included patch for issue 9 from favonia - detects .fig changes for | |
277 # pstex files during regular compilation, so long as the pstex | |
278 # has been built at least once with make all-pstex. | |
279 # Chris Monson (2009-03-27): | |
280 # * Bumped version to 2.1.25 | |
281 # * Cleaned up a bunch of variable setting stuff - more stuff is now | |
282 # settable from Makefile.ini | |
283 # * Cleaned up documentation for various features, especially settable | |
284 # variables. | |
285 # * issue 28: support for png -> eps conversion (it even looks good!) | |
286 # * issue 29: support for "neverclean" files in Makefile.ini | |
287 # * issue 30: make ps2pdf14 the default - fall back when not there | |
288 # Chris Monson (2009-03-09): | |
289 # * Bumped version to 2.1.24 | |
290 # * issue 27: xmgrace support (thanks to rolandschulzhd) | |
291 # Chris Monson (2008-10-23): | |
292 # * Bumped version to 2.1.23 | |
293 # * issue 23: fixed _check_programs to not use bash string subs | |
294 # Chris Monson (2008-09-02): | |
295 # * Bumped version to 2.1.22 | |
296 # * Appled patch from Holger <yllohy@googlemail.com> to add include | |
297 # sources and some documentation updates. | |
298 # * Updated backup_patterns to be a bit more aggressive (also thanks to | |
299 # Holger) | |
300 # Chris Monson (2008-08-30): | |
301 # * Bumped version to 2.1.21 | |
302 # * Added ability to specify onlysources.* variables to indicate the only | |
303 # files that should *not* be considered includes. Thanks to Holger | |
304 # <yllohy@googlemail.com> for this patch. | |
305 # * Added an automatic include of Makefile.ini if it exists. Allows | |
306 # settings to be made outside of this makefile. | |
307 # Chris Monson (2008-05-21): | |
308 # * Bumped version to 2.1.20 | |
309 # * Added manual pstex compilation support (run make all-pstex first) | |
310 # * Removed all automatic pstex support. It was totally breaking | |
311 # everything and is very hard to incorporate into the makefile | |
312 # concept because it requires LaTeX to *fail* before it can | |
313 # determine that it needs the files. | |
314 # Chris Monson (2008-04-17): | |
315 # * Bumped version to 2.1.19 | |
316 # * Changed the pstex build hack to be on by default | |
317 # Chris Monson (2008-04-09): | |
318 # * Bumped version to 2.1.18 | |
319 # * issue 16: fixed pstex build problems, seems nondeterministic. Added | |
320 # gratuitious hack for testing: set PSTEX_BUILD_ALL_HACK=1. | |
321 # Chris Monson (2008-04-09): | |
322 # * Bumped version to 2.1.17 | |
323 # * issue 20: fixed accumulation of <pid>*.make files - wildcard was | |
324 # refusing to work on files that are very recently created. | |
325 # Chris Monson (2008-04-02): | |
326 # * Bumped version to 2.1.16 | |
327 # * issue 19: Removed the use of "type" to fix broken "echo" settings | |
328 # Chris Monson (2008-03-27): | |
329 # * Bumped version to 2.1.15 | |
330 # * issue 18: Favors binary echo over builtin, as binary understands -n | |
331 # * issue 16: Fixed handling of missing pstex_t files in the log | |
332 # * issue 9: Added .SECONDARY target for .pstex files | |
333 # Chris Monson (2008-03-21): | |
334 # * Bumped version to 2.1.14 | |
335 # * Fixed broken aux file flattening, which caused included bibs to be | |
336 # missed. | |
337 # Chris Monson (2008-03-20): | |
338 # * Bumped version to 2.1.13 | |
339 # * Changed error output colorization to show errors for missing files | |
340 # that are not graphics files. | |
341 # Chris Monson (2008-03-20): | |
342 # * Bumped version to 2.1.12 | |
343 # * Fixed a regression introduced in r28 that makes bibtex fail when | |
344 # there is no index file present | |
345 # Chris Monson (2008-03-03): | |
346 # * Bumped version to 2.1.11 | |
347 # * Fixed issue 11 (handle index files, reported by abachn) | |
348 # * Cleaned up some comments and help text | |
349 # Chris Monson (2008-01-24): | |
350 # * Bumped version to 2.1.10 | |
351 # * Fixed to work when 'sh' is a POSIX shell like 'dash' | |
352 # Chris Monson (2007-12-12): | |
353 # * Bumped version to 2.1.9 | |
354 # * Fixed documentation and dependency graph for pstex files | |
355 # Chris Monson (2007-12-12): | |
356 # * Bumped version to 2.1.8 | |
357 # * Added basic pstex_t support for fig files (Issue 9 by favonia) | |
358 # I still suggest that psfrag be used instead. | |
359 # Chris Monson (2007-10-16): | |
360 # * Bumped version to 2.1.7 | |
361 # * Removed todo item: allow other comment directives for rst conversion | |
362 # * Added ability to use global rst style file _rststyle_._include_.tex | |
363 # * Added help text to that effect | |
364 # Chris Monson (2007-05-20): | |
365 # * Bumped version to 2.1.6 | |
366 # * Changed default paper size for rst files | |
367 # * Added todo item: fix paper size for rst files | |
368 # * Added todo item: allow other comment directives for rst conversion | |
369 # Chris Monson (2007-04-02): | |
370 # * Bumped version to 2.1.5 | |
371 # * Addressed Issue 7, incorrect .gpi.d generation in subdirectories | |
372 # Chris Monson (2007-03-28): | |
373 # * Bumped version to 2.1.4 | |
374 # * Fixed syntax error in dot output | |
375 # Chris Monson (2007-03-01): | |
376 # * Bumped version to 2.1.3 | |
377 # * Added reST to the included documentation | |
378 # * Fixed graphics and script generation to be settable in the | |
379 # environment. | |
380 # Chris Monson (2007-02-23): | |
381 # * Bumped version to 2.1.2 | |
382 # * Added the ability to generate .tex files from .rst files | |
383 # Chris Monson (2006-10-17): | |
384 # * Bumped version to 2.1.1 | |
385 # * Fixed includes from subdirectories (sed-to-sed slash escape problem) | |
386 # Chris Monson (2006-10-05): | |
387 # * Bumped version to 2.1.0 (pretty serious new feature added) | |
388 # * New feature: bib files can now be anywhere on the BIBINPUTS path | |
389 # * New programs: kpsewhich (with tetex) and xargs (BSD) | |
390 # Chris Monson (2006-09-28): | |
391 # * Bumped version to 2.0.9 | |
392 # * Added ability to parse more than one bibliography | |
393 # Chris Monson (2006-06-01): | |
394 # * Bumped version to 2.0.8 | |
395 # * Added .vrb to the list of cleaned files | |
396 # Chris Monson (2006-04-26): | |
397 # * Bumped version to 2.0.7 | |
398 # * Fixed so that clean-nographics does not remove .gpi.d files | |
399 # * Removed jpg -> eps hack (not working properly -- just pre-convert) | |
400 # * Fixed so that postscript grayscale can be done with BSD sed | |
401 # Chris Monson (2006-04-25): | |
402 # * Bumped version to 2.0.6 | |
403 # * Fixed so that changed toc, lot, lof, or out causes a rebuild | |
404 # Chris Monson (2006-04-17): | |
405 # * Bumped version to 2.0.5 | |
406 # * Added jpg -> eps conversion target | |
407 # Chris Monson (2006-04-12): | |
408 # * Bumped version to 2.0.4 | |
409 # * Fixed BSD sed invocation to not use \| as a branch delimiter | |
410 # * Added a comment section on what is and is not allowed in BSD sed | |
411 # * Made paper size handling more robust while I was at it | |
412 # * Fixed postscript RGB grayscale to use a weighted average | |
413 # * Fixed postscript HSB grayscale to convert to RGB first | |
414 # * Fixed a problem with rebuilding .bbl files | |
415 # Chris Monson (2006-04-11): | |
416 # * Bumped version to 2.0.3 | |
417 # * Fixed some BSD sed problems: can't use \n in substitutions | |
418 # Chris Monson (2006-04-10): | |
419 # * Bumped version to 2.0.2 | |
420 # * Once again removed ability to create .tex files from scripts | |
421 # * \includeonly works again | |
422 # Chris Monson (2006-04-09): | |
423 # * Bumped version to 2.0.1 | |
424 # * Fixed grayscale postscript handling to be more robust | |
425 # * Added ability to generate ._gray_. files from eps and eps.gz | |
426 # * Added ability to clean ._gray_.eps files created from .eps files | |
427 # Chris Monson (2006-04-07): | |
428 # * Bumped version to 2.0.0 | |
429 # * Removed clunky ability to create included .tex files from scripts | |
430 # * Added note in the help about included tex scripting not working | |
431 # * Fixed the .eps generation to delete %.gpihead.make when finished | |
432 # * Abandoned designs to use shell variables to create sed scripts | |
433 # * Abandoned __default__.tex.sh idea: it causes recursion with %: . | |
434 # * Removed web page to-do. All items are now complete. | |
435 # * Added better grayscale conversion for dot figures (direct ps fixup). | |
436 # * Include files can now be scripted (at the expense of \includeonly). | |
437 # * Updated dependency graph to contain better node names. | |
438 # Chris Monson (2006-04-06): | |
439 # * Bumped version to 2.0b3 | |
440 # * Top level includes now fail if there is no rule to build them | |
441 # * A helpful message is printed when they do fail | |
442 # * Grayscale has been changed to be ._gray_, other phonies use _ now, too | |
443 # * Grayscale handling has been completed | |
444 # * Changed _include_stems target to _includes target. | |
445 # * Fixed _includes target to be useful by itself. | |
446 # * Removed the ability to specify clean and build targets at once | |
447 # * Verified that epsfig works fine with current code | |
448 # * Fixed included scripts so that they are added to the dep files | |
449 # * Fixed so that graphics includes don't happen if they aren't for gpi | |
450 # * Fixed dot output to allow grayscale. | |
451 # Chris Monson (2006-04-05): | |
452 # * Bumped version to 2.0b2 | |
453 # * Removed automatic -gray output. It needs fixing in a bad way. | |
454 # * Revamped dependency creation completely. | |
455 # * Fixed conditional inclusion to actually work (test.nobuild.d, test.d). | |
456 # * Fixed clean target to remove log targets | |
457 # * Added the 'monochrome' word for gray gpi output | |
458 # * Added a _check_gpi_files target that checks for common problems | |
459 # * Changed the _version target into the version target (no _) | |
460 # * Added better handling of grayscale files. Use the .gray.pdf target. | |
461 # * Fixed testing for rebuilds | |
462 # Chris Monson (2006-04-04): | |
463 # * Bumped version to 2.0b1 | |
464 # * Changed colorization of output | |
465 # * Made .auxbbl and .auxtex .make files secondary targets | |
466 # * Shortened and simplified the final latex invocation loop | |
467 # * Added version-specific output ($$i vs. $$$$i) in latex loop | |
468 # * Added a build message for the first .dvi run (Building .dvi (0)) | |
469 # * Removed some build messages that most people don't care about. | |
470 # * Simplified procedure for user-set colors -- simple text specification | |
471 # * Fixed diff output to...not output. | |
472 # * Fixed rerun bug -- detect not only when preceded with LaTeX Warning | |
473 # * Sped up gpi plotting | |
474 # * Added error handling and colorized output for gpi failure | |
475 # * Documented color changing stuff. | |
476 # * Now sort the flattened aux file to avoid false recompilation needs | |
477 # * Added clean-nographics target | |
478 # * Don't remove self.dvi file if self.aux is missing in the log | |
479 # * Clarified some code. Did some very minor adjusting. | |
480 # Chris Monson (2006-04-03): | |
481 # * Bumped version to 2.0a7 | |
482 # * Added .dvi and .ps files as secondary files. | |
483 # * Fixed handling of multiple run detection when includeonly is in use. | |
484 # * Added code to flatten .aux files. | |
485 # * Added more files as .SECONDARY prerequisites to avoid recompilation. | |
486 # * Fixed the inputs generation to be much simpler and to use pipes. | |
487 # * Added the dependency graph directly into the makefile. | |
488 # * Changed flatten-aux to remove \@writefile \relax \newlabel, etc. | |
489 # * Undid pipe changes with sed usage (BSD sed doesn't know -f-). | |
490 # * Added a _check_programs target that tells you what your system has. | |
491 # * Fixed an error in colorization that made unnecessary errors appear | |
492 # * Added view targets. | |
493 # * Updated help text. | |
494 # * Augmented cookies so that .aux can trigger .bbl and .dvi rebuilds | |
495 # * Added more informative error handling for dvips and ps2pdf | |
496 # Chris Monson (2006-04-02): | |
497 # * Bumped version to 2.0a6 | |
498 # * Added indirection to .bbl dependencies to avoid rebuilding .bbl files | |
499 # * Streamlined the diff invocation to eliminate an existence test | |
500 # * Removed special shell quote escape variables | |
501 # * Moved includes to a more prominent location | |
502 # * Fixed .inputs.make to not contain .aux files | |
503 # * Fixed embedding to use a file instead of always grepping. | |
504 # * Added *.make.temp to the list of cleanable files | |
505 # * Fixed Ruby. It should now be supported properly. | |
506 # * Now differentiate between all, default, and buildable files. | |
507 # * Fixed to bail out on serious errors. | |
508 # * Revised the handling of includable files. Still working on it. | |
509 # Chris Monson (2006-03-31): | |
510 # * Bumped version to 2.0a5 | |
511 # * Fixed a bug with LaTeX error detection (there can be spaces) | |
512 # * Added .bbl support, simplifying everything and making it more correct | |
513 # * Refactored some tests that muddy the code | |
514 # * Did a little cleanup of some shell loops that can safely be make loops | |
515 # * Added support for graphviz .dot files | |
516 # * Made _all_programs output easier to read | |
517 # * Added the ruby support that has long been advertised | |
518 # * Font embedding was screwed up for PostScript -- now implicit | |
519 # * Changed the generation of -gray.gpi files to a single command | |
520 # * Changed any make-generated file that is not included from .d to .make | |
521 # Chris Monson (2006-03-30): | |
522 # * Bumped version to 2.0a4 | |
523 # * Fixed a bug with very long graphics file names | |
524 # * Added a todo entry for epsfig support | |
525 # * Fixed a bug paper size bug: sometimes more than one entry appears | |
526 # * Fixed DVI build echoing to display the number instead of process ID | |
527 # * DVI files are now removed on first invocation if ANY file is missing | |
528 # * Added a simple grayscale approach: if a file ends with -gray.gpi, it | |
529 # is created from the corresponding .gpi file with a special | |
530 # comment ##GRAY in its header, which causes coloring to be | |
531 # turned off. | |
532 # * Fixed a bug in the handling of .tex.sh files. For some reason I had | |
533 # neglected to define file stems for scripted output. | |
534 # * Removed a trailing ; from the %.graphics dependencies | |
535 # * Added dvips embedding (I think it works, anyway) | |
536 # Chris Monson (2006-03-29): | |
537 # * Bumped version to 2.0a3 | |
538 # * Fixed error in make 3.79 with MAKEFILE_LIST usage | |
539 # * Added the presumed filename to the _version output | |
540 # * Added a vim macro for converting sed scripts to make commands | |
541 # * Added gpi dependency support (plotting external files and loading gpi) | |
542 # * Allow .gpi files to be ignored if called .include.gpi or .nobuild.gpi | |
543 # * Fixed sed invocations where \+ was used. BSD sed uses \{1,\}. | |
544 # Chris Monson (2006-03-28): | |
545 # * Bumped version to 2.0a2 | |
546 # * Added SHELL_DEBUG and VERBOSE options | |
547 # * Changed the default shell back to /bin/sh (unset, in other words) | |
548 # * Moved .PHONY declarations closer to their targets | |
549 # * Moved help text into its own define block to obtain better formatting | |
550 # * Removed need for double-entry when adding a new program invocation | |
551 # * Moved .SECONDARY declaration closer to its relevant occurrence | |
552 # * Commented things more heavily | |
553 # * Added help text about setting terminal and output in gnuplot | |
554 # * Created more fine-grained clean targets | |
555 # * Added a %.graphics target that generates all of %'s graphics | |
556 # * Killed backward-compatible graphics generation (e.g., eps.gpi=gpi.eps) | |
557 # * For now, we're just GPL 2, not 3. Maybe it will change later | |
558 # * Made the version and svninfo into variables | |
559 # Chris Monson (2006-03-27): | |
560 # * Bumped version to 2.0a1 | |
561 # * Huge, sweeping changes -- automatic dependencies | |
562 | |
563 # IMPORTANT! | |
564 # | |
565 # When adding to the following list, do not introduce any blank lines. The | |
566 # list is extracted for documentation using sed and is terminated by a blank | |
567 # line. | |
568 # | |
569 # EXTERNAL PROGRAMS: | |
570 # = ESSENTIAL PROGRAMS = | |
571 # == Basic Shell Utilities == | |
572 CAT ?= cat | |
573 CP ?= cp -f | |
574 DIFF ?= diff | |
575 ECHO ?= echo | |
576 EGREP ?= egrep | |
577 ENV ?= env | |
578 EXPR ?= expr | |
579 MV ?= mv -f | |
580 SED ?= sed | |
581 SORT ?= sort | |
582 TOUCH ?= touch | |
583 UNIQ ?= uniq | |
584 WHICH ?= which | |
585 XARGS ?= xargs | |
586 SLEEP ?= sleep | |
587 # == LaTeX (tetex-provided) == | |
588 BIBTEX ?= bibtex | |
589 DVIPS ?= dvips | |
590 LATEX ?= latex | |
591 PDFLATEX ?= pdflatex | |
592 EPSTOPDF ?= epstopdf | |
593 MAKEINDEX ?= makeindex | |
594 KPSEWHICH ?= kpsewhich | |
595 GS ?= gs | |
596 # = OPTIONAL PROGRAMS = | |
597 # == Makefile Color Output == | |
598 TPUT ?= tput | |
599 # == TeX Generation == | |
600 PERL ?= perl | |
601 PYTHON ?= python | |
602 RST2LATEX ?= rst2latex.py | |
603 # == EPS Generation == | |
604 CONVERT ?= convert # ImageMagick | |
605 DOT ?= dot # GraphViz | |
606 DOT2TEX ?= dot2tex # dot2tex - add options (not -o) as needed | |
607 FIG2DEV ?= fig2dev # XFig | |
608 GNUPLOT ?= gnuplot # GNUplot | |
609 INKSCAPE ?= inkscape # Inkscape (svg support) | |
610 XMGRACE ?= xmgrace # XMgrace | |
611 PNGTOPNM ?= pngtopnm # From NetPBM - step 1 for png -> eps | |
612 PPMTOPGM ?= ppmtopgm # From NetPBM - (gray) step 2 for png -> eps | |
613 PNMTOPS ?= pnmtops # From NetPBM - step 3 for png -> eps | |
614 GUNZIP ?= gunzip # GZipped EPS | |
615 # == Beamer Enlarged Output == | |
616 PSNUP ?= psnup | |
617 # == Viewing Stuff == | |
618 VIEW_POSTSCRIPT ?= gv | |
619 VIEW_PDF ?= xpdf | |
620 VIEW_GRAPHICS ?= display | |
621 | |
622 # Command options for embedding fonts and postscript->pdf conversion | |
623 PS_EMBED_OPTIONS ?= -dPDFSETTINGS=/printer -dEmbedAllFonts=true -dSubsetFonts=true -dMaxSubsetPct=100 | |
624 PS_COMPATIBILITY ?= 1.4 | |
625 | |
626 # Defaults for GPI | |
627 DEFAULT_GPI_EPS_FONTSIZE ?= 22 | |
628 DEFAULT_GPI_PDF_FONTSIZE ?= 12 | |
629 | |
630 # Style file for ReST | |
631 RST_STYLE_FILE ?= $(wildcard _rststyle_._include_.tex) | |
632 | |
633 # This ensures that even when echo is a shell builtin, we still use the binary | |
634 # (the builtin doesn't always understand -n) | |
635 FIXED_ECHO := $(if $(findstring -n,$(shell $(ECHO) -n)),$(shell which echo),$(ECHO)) | |
636 ECHO := $(if $(FIXED_ECHO),$(FIXED_ECHO),$(ECHO)) | |
637 | |
638 define determine-gnuplot-output-extension | |
639 $(if $(shell $(WHICH) $(GNUPLOT)), | |
640 $(if $(findstring unknown or ambiguous, $(shell $(GNUPLOT) -e "set terminal pdf" 2>&1)), | |
641 eps, pdf), | |
642 none) | |
643 endef | |
644 | |
645 GNUPLOT_OUTPUT_EXTENSION ?= $(strip $(call determine-gnuplot-output-extension)) | |
646 | |
647 # Directory into which we place "binaries" if it exists. | |
648 # Note that this can be changed on the commandline or in Makefile.ini: | |
649 # | |
650 # Command line: | |
651 # make BINARY_TARGET_DIR=$HOME/pdfs myfile.pdf | |
652 # | |
653 # Also, you can specify a relative directory (relative to the Makefile): | |
654 # make BINARY_TARGET_DIR=pdfs myfile.pdf | |
655 # | |
656 # Or, you can use Makefile.ini: | |
657 # | |
658 # BINARY_TARGET_DIR := $(HOME)/bin_out | |
659 # | |
660 BINARY_TARGET_DIR ?= _out_ | |
661 | |
662 RESTARTS := $(if $(MAKE_RESTARTS),$(MAKE_RESTARTS),0) | |
663 # SH NOTES | |
664 # | |
665 # On some systems, /bin/sh, which is the default shell, is not linked to | |
666 # /bin/bash. While bash is supposed to be sh-compatible when invoked as sh, it | |
667 # just isn't. This section details some of the things you have to stay away | |
668 # from to remain sh-compatible. | |
669 # | |
670 # * File pattern expansion does not work for {} | |
671 # * [ "$x" = "$y" ] has to be [ x"$x" x"$y" ] | |
672 # * &> for stderr redirection doesn't work, use 2>&1 instead | |
673 # | |
674 # BSD SED NOTES | |
675 # | |
676 # BSD SED is not very nice compared to GNU sed, but it is the most | |
677 # commonly-invoked sed on Macs (being based on BSD), so we have to cater to | |
678 # it or require people to install GNU sed. It seems like the GNU | |
679 # requirement isn't too bad since this makefile is really a GNU makefile, | |
680 # but apparently GNU sed is much less common than GNU make in general, so | |
681 # I'm supporting it here. | |
682 # | |
683 # Sad experience has taught me the following about BSD sed: | |
684 # | |
685 # * \+ is not understood to mean \{1,\} | |
686 # * \| is meaningless (does not branch) | |
687 # * \n cannot be used as a substitution character | |
688 # * ? does not mean \{0,1\}, but is literal | |
689 # * a\ works, but only reliably for a single line if subsequent lines | |
690 # have forward slashes in them (as is the case in postscript) | |
691 # | |
692 # For more info (on the Mac) you can consult | |
693 # | |
694 # man -M /usr/share/man re_format | |
695 # | |
696 # And look for the word "Obsolete" near the bottom. | |
697 | |
698 # | |
699 # EXTERNAL PROGRAM DOCUMENTATION SCRIPT | |
700 # | |
701 | |
702 # $(call output-all-programs,[<output file>]) | |
703 define output-all-programs | |
704 [ -f '$(this_file)' ] && \ | |
705 $(SED) \ | |
706 -e '/^[[:space:]]*#[[:space:]]*EXTERNAL PROGRAMS:/,/^$$/!d' \ | |
707 -e '/EXTERNAL PROGRAMS/d' \ | |
708 -e '/^$$/d' \ | |
709 -e '/^[[:space:]]*#/i\ '\ | |
710 -e 's/^[[:space:]]*#[[:space:]][^=]*//' \ | |
711 $(this_file) $(if $1,> '$1',) || \ | |
712 $(ECHO) "Cannot determine the name of this makefile." | |
713 endef | |
714 | |
715 # If they misspell gray, it should still work. | |
716 GRAY ?= $(call get-default,$(GREY),) | |
717 | |
718 # | |
719 # Utility Functions and Definitions | |
720 # | |
721 | |
722 # While not exactly a make function, this vim macro is useful. It takes a | |
723 # verbatim sed script and converts each line to something suitable in a command | |
724 # context. Just paste the script's contents into the editor, yank this into a | |
725 # register (starting at '0') and run the macro once for each line of the | |
726 # original script: | |
727 # | |
728 # 0i -e :s/\$/$$/eg | |
729 :s/'/'"'"'/eg | |
730 ^Ela'A' \:noh | |
731 j | |
732 | |
733 # don't call this directly - it is here to avoid calling wildcard more than | |
734 # once in remove-files. | |
735 remove-files-helper = $(if $1,$(RM) $1,$(sh_true)) | |
736 | |
737 # $(call remove-files,file1 file2) | |
738 remove-files = $(call remove-files-helper,$(wildcard $1)) | |
739 | |
740 # Removes all cleanable files in the given list | |
741 # $(call clean-files,file1 file2 file3 ...) | |
742 # Works exactly like remove-files, but filters out files in $(neverclean) | |
743 clean-files = \ | |
744 $(call remove-files-helper,$(call cleanable-files,$(wildcard $1))) | |
745 | |
746 # Outputs all generated files to STDOUT, along with some others that are | |
747 # created by these (e.g., .idx files end up producing .ilg and .ind files). | |
748 # Discovered by reading *.fls OUTPUT lines and producing corresponding .ind | |
749 # filenames as needed. | |
750 # | |
751 # $(call get-generated-names,<source recorder file (*.fls)>) | |
752 define get-generated-names | |
753 [ -f '$1' ] && \ | |
754 $(SED) \ | |
755 -e '/^OUTPUT /{' \ | |
756 -e ' s///' \ | |
757 -e ' p' \ | |
758 -e ' s/\.idx/\.ind/p' \ | |
759 -e ' s/\.ind/\.ilg/p' \ | |
760 -e '}' \ | |
761 -e 'd' \ | |
762 '$1' \ | |
763 | $(SORT) | $(UNIQ) | |
764 endef | |
765 | |
766 # This removes files without checking whether they are there or not. This | |
767 # sometimes has to be used when the file is created by a series of shell | |
768 # commands, but there ends up being a race condition: make doesn't know about | |
769 # the file generation as quickly as the system does, so $(wildcard ...) doesn't | |
770 # work right. Blech. | |
771 # $(call remove-temporary-files,filenames) | |
772 remove-temporary-files = $(if $1,$(RM) $1,:) | |
773 | |
774 # Create an identifier from a file name | |
775 # $(call cleanse-filename,filename) | |
776 cleanse-filename = $(subst .,_,$(subst /,__,$1)) | |
777 | |
778 # Escape dots | |
779 # $(call escape-dots,str) | |
780 escape-dots = $(subst .,\\.,$1) | |
781 | |
782 # Test that a file exists | |
783 # $(call test-exists,file) | |
784 test-exists = [ -e '$1' ] | |
785 | |
786 # $(call move-files,source,destination) | |
787 move-if-exists = $(call test-exists,$1) && $(MV) '$1' '$2' | |
788 | |
789 # Copy file1 to file2 only if file2 doesn't exist or they are different | |
790 # $(call copy-if-different,sfile,dfile) | |
791 copy-if-different = $(call test-different,$1,$2) && $(CP) '$1' '$2' | |
792 copy-if-exists = $(call test-exists,$1) && $(CP) '$1' '$2' | |
793 move-if-different = $(call test-different,$1,$2) && $(MV) '$1' '$2' | |
794 replace-if-different-and-remove = \ | |
795 $(call test-different,$1,$2) \ | |
796 && $(MV) '$1' '$2' \ | |
797 || $(call remove-files,'$1') | |
798 | |
799 # Note that $(DIFF) returns success when the files are the SAME.... | |
800 # $(call test-different,sfile,dfile) | |
801 test-different = ! $(DIFF) -q '$1' '$2' >/dev/null 2>&1 | |
802 test-exists-and-different = \ | |
803 $(call test-exists,$2) && $(call test-different,$1,$2) | |
804 | |
805 # Return value 1, or value 2 if value 1 is empty | |
806 # $(call get-default,<possibly empty arg>,<default value if empty>) | |
807 get-default = $(if $1,$1,$2) | |
808 | |
809 # Copy a file and log what's going on | |
810 # $(call copy-with-logging,<source>,<target>) | |
811 define copy-with-logging | |
812 if [ -d '$2/' ]; then \ | |
813 if $(CP) '$1' '$2/'; then \ | |
814 $(ECHO) "$(C_INFO)Copied '$1' to '$2/'$(C_RESET)"; \ | |
815 else \ | |
816 $(ECHO) "$(C_ERROR)Failed to copy '$1' to '$2/'$(C_RESET)"; \ | |
817 fi; \ | |
818 fi | |
819 endef | |
820 | |
821 # Gives a reassuring message about the failure to find include files | |
822 # $(call include-message,<list of include files>) | |
823 define include-message | |
824 $(strip \ | |
825 $(if $(filter-out $(wildcard $1),$1),\ | |
826 $(shell $(ECHO) \ | |
827 "$(C_INFO)NOTE: You may ignore warnings about the"\ | |
828 "following files:" >&2;\ | |
829 $(ECHO) >&2; \ | |
830 $(foreach s,$(filter-out $(wildcard $1),$1),$(ECHO) ' $s' >&2;)\ | |
831 $(ECHO) "$(C_RESET)" >&2) | |
832 )) | |
833 endef | |
834 # Characters that are hard to specify in certain places | |
835 space := $(empty) $(empty) | |
836 colon := \: | |
837 comma := , | |
838 | |
839 # Useful shell definitions | |
840 sh_true := : | |
841 sh_false := ! : | |
842 | |
843 # Clear out the standard interfering make suffixes | |
844 .SUFFIXES: | |
845 | |
846 # Turn off forceful rm (RM is usually mapped to rm -f) | |
847 ifdef SAFE_RM | |
848 RM := rm | |
849 endif | |
850 | |
851 # Turn command echoing back on with VERBOSE=1 | |
852 ifndef VERBOSE | |
853 QUIET := @ | |
854 endif | |
855 | |
856 # Turn on shell debugging with SHELL_DEBUG=1 | |
857 # (EVERYTHING is echoed, even $(shell ...) invocations) | |
858 ifdef SHELL_DEBUG | |
859 SHELL += -x | |
860 endif | |
861 | |
862 # Get the name of this makefile (always right in 3.80, often right in 3.79) | |
863 # This is only really used for documentation, so it isn't too serious. | |
864 ifdef MAKEFILE_LIST | |
865 this_file := $(word $(words $(MAKEFILE_LIST)),$(MAKEFILE_LIST)) | |
866 else | |
867 this_file := $(wildcard GNUmakefile makefile Makefile) | |
868 endif | |
869 | |
870 # Terminal color definitions | |
871 | |
872 REAL_TPUT := $(if $(NO_COLOR),,$(shell $(WHICH) $(TPUT))) | |
873 | |
874 # $(call get-term-code,codeinfo) | |
875 # e.g., | |
876 # $(call get-term-code,setaf 0) | |
877 get-term-code = $(if $(REAL_TPUT),$(shell $(REAL_TPUT) $1),) | |
878 | |
879 black := $(call get-term-code,setaf 0) | |
880 red := $(call get-term-code,setaf 1) | |
881 green := $(call get-term-code,setaf 2) | |
882 yellow := $(call get-term-code,setaf 3) | |
883 blue := $(call get-term-code,setaf 4) | |
884 magenta := $(call get-term-code,setaf 5) | |
885 cyan := $(call get-term-code,setaf 6) | |
886 white := $(call get-term-code,setaf 7) | |
887 bold := $(call get-term-code,bold) | |
888 uline := $(call get-term-code,smul) | |
889 reset := $(call get-term-code,sgr0) | |
890 | |
891 # | |
892 # User-settable definitions | |
893 # | |
894 LATEX_COLOR_WARNING ?= magenta | |
895 LATEX_COLOR_ERROR ?= red | |
896 LATEX_COLOR_INFO ?= green | |
897 LATEX_COLOR_UNDERFULL ?= magenta | |
898 LATEX_COLOR_OVERFULL ?= red bold | |
899 LATEX_COLOR_PAGES ?= bold | |
900 LATEX_COLOR_BUILD ?= cyan | |
901 LATEX_COLOR_GRAPHIC ?= yellow | |
902 LATEX_COLOR_DEP ?= green | |
903 LATEX_COLOR_SUCCESS ?= green bold | |
904 LATEX_COLOR_FAILURE ?= red bold | |
905 | |
906 # Gets the real color from a simple textual definition like those above | |
907 # $(call get-color,ALL_CAPS_COLOR_NAME) | |
908 # e.g., $(call get-color,WARNING) | |
909 get-color = $(subst $(space),,$(foreach c,$(LATEX_COLOR_$1),$($c))) | |
910 | |
911 # | |
912 # STANDARD COLORS | |
913 # | |
914 C_WARNING := $(call get-color,WARNING) | |
915 C_ERROR := $(call get-color,ERROR) | |
916 C_INFO := $(call get-color,INFO) | |
917 C_UNDERFULL := $(call get-color,UNDERFULL) | |
918 C_OVERFULL := $(call get-color,OVERFULL) | |
919 C_PAGES := $(call get-color,PAGES) | |
920 C_BUILD := $(call get-color,BUILD) | |
921 C_GRAPHIC := $(call get-color,GRAPHIC) | |
922 C_DEP := $(call get-color,DEP) | |
923 C_SUCCESS := $(call get-color,SUCCESS) | |
924 C_FAILURE := $(call get-color,FAILURE) | |
925 C_RESET := $(reset) | |
926 | |
927 # | |
928 # PRE-BUILD TESTS | |
929 # | |
930 | |
931 # Check that clean targets are not combined with other targets (weird things | |
932 # happen, and it's not easy to fix them) | |
933 hascleangoals := $(if $(sort $(filter clean clean-%,$(MAKECMDGOALS))),1) | |
934 hasbuildgoals := $(if $(sort $(filter-out clean clean-%,$(MAKECMDGOALS))),1) | |
935 ifneq "$(hasbuildgoals)" "" | |
936 ifneq "$(hascleangoals)" "" | |
937 $(error $(C_ERROR)Clean and build targets specified together$(C_RESET))) | |
938 endif | |
939 endif | |
940 | |
941 # | |
942 # VARIABLE DECLARATIONS | |
943 # | |
944 | |
945 # Names of sed scripts that morph gnuplot files -- only the first found is used | |
946 GNUPLOT_SED := global-gpi.sed gnuplot.sed | |
947 GNUPLOT_GLOBAL := global._include_.gpi gnuplot.global | |
948 | |
949 ifneq "$(strip $(BUILD_STRATEGY))" "pdflatex" | |
950 default_graphic_extension ?= eps | |
951 latex_build_program ?= $(LATEX) | |
952 build_target_extension ?= dvi | |
953 hyperref_driver_pattern ?= hdvips | |
954 hyperref_driver_error ?= Using dvips: specify ps2pdf in the hyperref options. | |
955 else | |
956 default_graphic_extension ?= pdf | |
957 latex_build_program ?= $(PDFLATEX) | |
958 build_target_extension ?= pdf | |
959 hyperref_driver_pattern ?= hpdf.* | |
960 hyperref_driver_error ?= Using pdflatex: specify pdftex in the hyperref options (or leave it blank). | |
961 endif | |
962 | |
963 # Files of interest | |
964 all_files.tex ?= $(wildcard *.tex) | |
965 all_files.tex.sh ?= $(wildcard *.tex.sh) | |
966 all_files.tex.pl ?= $(wildcard *.tex.pl) | |
967 all_files.tex.py ?= $(wildcard *.tex.py) | |
968 all_files.rst ?= $(wildcard *.rst) | |
969 all_files.fig ?= $(wildcard *.fig) | |
970 all_files.gpi ?= $(wildcard *.gpi) | |
971 all_files.dot ?= $(wildcard *.dot) | |
972 all_files.xvg ?= $(wildcard *.xvg) | |
973 all_files.svg ?= $(wildcard *.svg) | |
974 all_files.png ?= $(wildcard *.png) | |
975 all_files.jpg ?= $(wildcard *.jpg) | |
976 all_files.eps.gz ?= $(wildcard *.eps.gz) | |
977 all_files.eps ?= $(wildcard *.eps) | |
978 | |
979 # Utility function for obtaining all files not specified in $(neverclean) | |
980 # $(call cleanable-files,file1 file2 file3 ...) | |
981 # Returns the list of files that is not in $(wildcard $(neverclean)) | |
982 cleanable-files = $(filter-out $(wildcard $(neverclean)), $1) | |
983 | |
984 # Utility function for getting all .$1 files that are to be ignored | |
985 # * files listed in $(includes.$1) | |
986 # * files not listed in $(onlysources.$1) if it is defined | |
987 ignore_files = \ | |
988 $(includes.$1) \ | |
989 $(if $(onlysources.$1),$(filter-out $(onlysources.$1), $(all_files.$1))) | |
990 | |
991 # Patterns to never be allowed as source targets | |
992 ignore_patterns := %._include_ | |
993 | |
994 # Patterns allowed as source targets but not included in 'all' builds | |
995 nodefault_patterns := %._nobuild_ $(ignore_patterns) | |
996 | |
997 # Utility function for getting targets suitable building | |
998 # $(call filter-buildable,suffix) | |
999 filter-buildable = \ | |
1000 $(filter-out $(call ignore_files,$1) \ | |
1001 $(addsuffix .$1,$(ignore_patterns)),$(all_files.$1)) | |
1002 | |
1003 # Utility function for getting targets suitable for 'all' builds | |
1004 # $(call filter-default,suffix) | |
1005 filter-default = \ | |
1006 $(filter-out $(call ignore_files,$1) \ | |
1007 $(addsuffix .$1,$(nodefault_patterns)),$(all_files.$1)) | |
1008 | |
1009 # Top level sources that can be built even when they are not by default | |
1010 files.tex := $(call filter-buildable,tex) | |
1011 files.tex.sh := $(call filter-buildable,tex.sh) | |
1012 files.tex.pl := $(call filter-buildable,tex.pl) | |
1013 files.tex.py := $(call filter-buildable,tex.py) | |
1014 files.rst := $(call filter-buildable,rst) | |
1015 files.gpi := $(call filter-buildable,gpi) | |
1016 files.dot := $(call filter-buildable,dot) | |
1017 files.fig := $(call filter-buildable,fig) | |
1018 files.xvg := $(call filter-buildable,xvg) | |
1019 files.svg := $(call filter-buildable,svg) | |
1020 files.png := $(call filter-buildable,png) | |
1021 files.jpg := $(call filter-buildable,jpg) | |
1022 files.eps.gz := $(call filter-buildable,eps.gz) | |
1023 | |
1024 # Make all pstex targets secondary. The pstex_t target requires the pstex | |
1025 # target, and nothing else really depends on it, so it often gets deleted. | |
1026 # This avoids that by allowing *all* fig files to be pstex targets, which is | |
1027 # perfectly valid and causes no problems even if they're going to become eps | |
1028 # files in the end. | |
1029 .SECONDARY: $(patsubst %.fig,%.pstex,$(files.fig)) | |
1030 | |
1031 # Top level sources that are built by default targets | |
1032 default_files.tex := $(call filter-default,tex) | |
1033 default_files.tex.sh := $(call filter-default,tex.sh) | |
1034 default_files.tex.pl := $(call filter-default,tex.pl) | |
1035 default_files.tex.py := $(call filter-default,tex.py) | |
1036 default_files.rst := $(call filter-default,rst) | |
1037 default_files.gpi := $(call filter-default,gpi) | |
1038 default_files.dot := $(call filter-default,dot) | |
1039 default_files.fig := $(call filter-default,fig) | |
1040 default_files.xvg := $(call filter-default,xvg) | |
1041 default_files.svg := $(call filter-default,svg) | |
1042 default_files.png := $(call filter-default,png) | |
1043 default_files.jpg := $(call filter-default,jpg) | |
1044 default_files.eps.gz := $(call filter-default,eps.gz) | |
1045 | |
1046 # Utility function for creating larger lists of files | |
1047 # $(call concat-files,suffixes,[prefix]) | |
1048 concat-files = $(foreach s,$1,$($(if $2,$2_,)files.$s)) | |
1049 | |
1050 # Useful file groupings | |
1051 all_files_source := $(call concat-files,tex,all) | |
1052 all_files_scripts := $(call concat-files,tex.sh tex.pl tex.py rst,all) | |
1053 | |
1054 .PHONY: $(all_files_scripts) | |
1055 | |
1056 default_files_source := $(call concat-files,tex,default) | |
1057 default_files_scripts := $(call concat-files,tex.sh tex.pl tex.py rst,default) | |
1058 | |
1059 files_source := $(call concat-files,tex) | |
1060 files_scripts := $(call concat-files,tex.sh tex.pl tex.py rst) | |
1061 | |
1062 # Utility function for obtaining stems | |
1063 # $(call get-stems,suffix,[prefix]) | |
1064 get-stems = $(sort $($(if $2,$2_,)files.$1:%.$1=%)) | |
1065 | |
1066 # List of all stems (including ._include_ and ._nobuild_ file stems) | |
1067 all_stems.tex := $(call get-stems,tex,all) | |
1068 all_stems.tex.sh := $(call get-stems,tex.sh,all) | |
1069 all_stems.tex.pl := $(call get-stems,tex.pl,all) | |
1070 all_stems.tex.py := $(call get-stems,tex.py,all) | |
1071 all_stems.rst := $(call get-stems,rst,all) | |
1072 all_stems.fig := $(call get-stems,fig,all) | |
1073 all_stems.gpi := $(call get-stems,gpi,all) | |
1074 all_stems.dot := $(call get-stems,dot,all) | |
1075 all_stems.xvg := $(call get-stems,xvg,all) | |
1076 all_stems.svg := $(call get-stems,svg,all) | |
1077 all_stems.png := $(call get-stems,png,all) | |
1078 all_stems.jpg := $(call get-stems,jpg,all) | |
1079 all_stems.eps.gz := $(call get-stems,eps.gz,all) | |
1080 all_stems.eps := $(call get-stems,eps,all) | |
1081 | |
1082 # List of all default stems (all default PDF targets): | |
1083 default_stems.tex := $(call get-stems,tex,default) | |
1084 default_stems.tex.sh := $(call get-stems,tex.sh,default) | |
1085 default_stems.tex.pl := $(call get-stems,tex.pl,default) | |
1086 default_stems.tex.py := $(call get-stems,tex.py,default) | |
1087 default_stems.rst := $(call get-stems,rst,default) | |
1088 default_stems.fig := $(call get-stems,fig,default) | |
1089 default_stems.gpi := $(call get-stems,gpi,default) | |
1090 default_stems.dot := $(call get-stems,dot,default) | |
1091 default_stems.xvg := $(call get-stems,xvg,default) | |
1092 default_stems.svg := $(call get-stems,svg,default) | |
1093 default_stems.png := $(call get-stems,png,default) | |
1094 default_stems.jpg := $(call get-stems,jpg,default) | |
1095 default_stems.eps.gz := $(call get-stems,eps.gz,default) | |
1096 | |
1097 # List of all stems (all possible bare PDF targets created here): | |
1098 stems.tex := $(call get-stems,tex) | |
1099 stems.tex.sh := $(call get-stems,tex.sh) | |
1100 stems.tex.pl := $(call get-stems,tex.pl) | |
1101 stems.tex.py := $(call get-stems,tex.py) | |
1102 stems.rst := $(call get-stems,rst) | |
1103 stems.fig := $(call get-stems,fig) | |
1104 stems.gpi := $(call get-stems,gpi) | |
1105 stems.dot := $(call get-stems,dot) | |
1106 stems.xvg := $(call get-stems,xvg) | |
1107 stems.svg := $(call get-stems,svg) | |
1108 stems.png := $(call get-stems,png) | |
1109 stems.jpg := $(call get-stems,jpg) | |
1110 stems.eps.gz := $(call get-stems,eps.gz) | |
1111 | |
1112 # Utility function for creating larger lists of stems | |
1113 # $(call concat-stems,suffixes,[prefix]) | |
1114 concat-stems = $(sort $(foreach s,$1,$($(if $2,$2_,)stems.$s))) | |
1115 | |
1116 # The most likely to be source but not finished product go first | |
1117 graphic_source_extensions := fig \ | |
1118 gpi \ | |
1119 xvg \ | |
1120 svg \ | |
1121 dot \ | |
1122 eps.gz | |
1123 | |
1124 ifneq "$(strip $(BUILD_STRATEGY))" "pdflatex" | |
1125 graphic_source_extensions += png jpg | |
1126 graphic_target_extensions := eps ps | |
1127 else | |
1128 graphic_source_extensions += eps | |
1129 graphic_target_extensions := pdf png jpg mps tif | |
1130 endif | |
1131 | |
1132 all_stems_source := $(call concat-stems,tex,all) | |
1133 all_stems_script := $(call concat-stems,tex.sh tex.pl tex.py rst,all) | |
1134 all_stems_graphic := $(call concat-stems,$(graphic_source_extensions),all) | |
1135 all_stems_ss := $(sort $(all_stems_source) $(all_stems_script)) | |
1136 all_stems_sg := $(sort $(all_stems_script)) | |
1137 all_stems_ssg := $(sort $(all_stems_ss)) | |
1138 | |
1139 default_stems_source := $(call concat-stems,tex,default) | |
1140 default_stems_script := $(call concat-stems,tex.sh tex.pl tex.py rst,default) | |
1141 default_stems_ss := $(sort $(default_stems_source) $(default_stems_script)) | |
1142 default_stems_sg := $(sort $(default_stems_script)) | |
1143 default_stems_ssg := $(sort $(default_stems_ss)) | |
1144 | |
1145 stems_source := $(call concat-stems,tex) | |
1146 stems_script := $(call concat-stems,tex.sh tex.pl tex.py rst) | |
1147 stems_graphic := $(call concat-stems,$(graphic_source_extensions)) | |
1148 stems_gg := $(sort $(stems_graphic)) | |
1149 stems_ss := $(sort $(stems_source) $(stems_script)) | |
1150 stems_sg := $(sort $(stems_script)) | |
1151 stems_ssg := $(sort $(stems_ss)) | |
1152 | |
1153 # Calculate names that can generate the need for an include file. We can't | |
1154 # really do this with patterns because it's too easy to screw up, so we create | |
1155 # an exhaustive list. | |
1156 allowed_source_suffixes := \ | |
1157 pdf \ | |
1158 ps \ | |
1159 dvi \ | |
1160 ind \ | |
1161 nls \ | |
1162 bbl \ | |
1163 aux \ | |
1164 aux.make \ | |
1165 d \ | |
1166 auxbbl.make \ | |
1167 _graphics \ | |
1168 _show | |
1169 allowed_source_patterns := $(addprefix %.,$(allowed_source_suffixes)) | |
1170 | |
1171 allowed_graphic_suffixes := \ | |
1172 pdf \ | |
1173 eps \ | |
1174 gpihead.make \ | |
1175 gpi.d | |
1176 allowed_graphic_patterns := $(addprefix %.,$(allowed_graphic_suffixes)) | |
1177 | |
1178 # All targets allowed to build documents | |
1179 allowed_source_targets := \ | |
1180 $(foreach suff,$(allowed_source_suffixes),\ | |
1181 $(addsuffix .$(suff),$(stems_ssg))) | |
1182 | |
1183 # All targets allowed to build graphics | |
1184 allowed_graphic_targets := \ | |
1185 $(foreach suff,$(allowed_graphic_suffixes),\ | |
1186 $(addsuffix .$(suff),$(stems_gg))) | |
1187 | |
1188 # All targets that build multiple documents (like 'all') | |
1189 allowed_batch_source_targets := \ | |
1190 all \ | |
1191 all-pdf \ | |
1192 all-ps \ | |
1193 all-dvi \ | |
1194 all-bbl \ | |
1195 all-ind \ | |
1196 all-gls \ | |
1197 all-nls \ | |
1198 show | |
1199 | |
1200 # All targets that build multiple graphics (independent of document) | |
1201 allowed_batch_graphic_targets := \ | |
1202 all-graphics \ | |
1203 all-pstex \ | |
1204 all-dot2tex \ | |
1205 show-graphics | |
1206 | |
1207 # Now we figure out which stuff is available as a make target for THIS RUN. | |
1208 real_goals := $(call get-default,$(filter-out _includes,$(MAKECMDGOALS)),\ | |
1209 all) | |
1210 | |
1211 specified_source_targets := $(strip \ | |
1212 $(filter $(allowed_source_targets) $(stems_ssg),$(real_goals)) \ | |
1213 ) | |
1214 | |
1215 specified_batch_source_targets := $(strip \ | |
1216 $(filter $(allowed_batch_source_targets),$(real_goals)) \ | |
1217 ) | |
1218 | |
1219 specified_graphic_targets := $(strip \ | |
1220 $(filter $(allowed_graphic_targets),$(real_goals)) \ | |
1221 ) | |
1222 | |
1223 specified_batch_graphic_targets := $(strip \ | |
1224 $(filter $(allowed_batch_graphic_targets),$(real_goals)) \ | |
1225 ) | |
1226 | |
1227 specified_gpi_targets := $(patsubst %.gpi,%.$(default_graphic_extension),\ | |
1228 $(filter $(patsubst %.$(default_graphic_extension),%.gpi,$(specified_graphic_targets)),\ | |
1229 $(all_files.gpi)) \ | |
1230 ) | |
1231 | |
1232 # Determine which .d files need including from the information gained above. | |
1233 # This is done by first checking whether a batch target exists. If it does, | |
1234 # then all *default* stems are used to create possible includes (nobuild need | |
1235 # not apply for batch status). If no batch targets exist, then the individual | |
1236 # targets are considered and appropriate includes are taken from them. | |
1237 source_stems_to_include := \ | |
1238 $(sort\ | |
1239 $(if $(specified_batch_source_targets),\ | |
1240 $(default_stems_ss),\ | |
1241 $(foreach t,$(specified_source_targets),\ | |
1242 $(foreach p,$(allowed_source_patterns),\ | |
1243 $(patsubst $p,%,$(filter $p $(stems_ssg),$t)) \ | |
1244 )) \ | |
1245 )) | |
1246 | |
1247 # Determine which .gpi.d files are needed using the above information. We | |
1248 # first check whether a batch target is specified, then check individual | |
1249 # graphics that may have been specified. | |
1250 graphic_stems_to_include := \ | |
1251 $(sort\ | |
1252 $(if $(specified_batch_graphic_targets),\ | |
1253 $(default_stems.gpi),\ | |
1254 $(foreach t,$(specified_gpi_targets),\ | |
1255 $(foreach p,$(allowed_graphic_patterns),\ | |
1256 $(patsubst $p,%,$(filter $p,$t)) \ | |
1257 )) \ | |
1258 )) | |
1259 | |
1260 # All dependencies for the 'all' targets | |
1261 all_pdf_targets := $(addsuffix .pdf,$(stems_ssg)) | |
1262 all_ps_targets := $(addsuffix .ps,$(stems_ssg)) | |
1263 all_dvi_targets := $(addsuffix .dvi,$(stems_ssg)) | |
1264 all_tex_targets := $(addsuffix .tex,$(stems_sg)) | |
1265 all_d_targets := $(addsuffix .d,$(stems_ssg)) | |
1266 all_graphics_targets := $(addsuffix .$(default_graphic_extension),$(stems_gg)) | |
1267 intermediate_graphics_targets := $(if $(filter pdf,$(default_graphic_extension)),$(addsuffix .eps,$(stems_gg)),) | |
1268 all_pstex_targets := $(addsuffix .pstex_t,$(stems.fig)) | |
1269 all_dot2tex_targets := $(addsuffix .dot_t,$(stems.dot)) | |
1270 | |
1271 all_known_graphics := $(sort $(all_graphics_targets) $(wildcard *.$(default_graphic_extension))) | |
1272 | |
1273 default_pdf_targets := $(addsuffix .pdf,$(default_stems_ss)) | |
1274 ifneq "$(strip $(BUILD_STRATEGY))" "pdflatex" | |
1275 default_ps_targets := $(addsuffix .ps,$(default_stems_ss)) | |
1276 default_dvi_targets := $(addsuffix .dvi,$(default_stems_ss)) | |
1277 pre_pdf_extensions := dvi ps | |
1278 endif | |
1279 | |
1280 # Extensions generated by LaTeX invocation that can be removed when complete | |
1281 rm_ext := \ | |
1282 log *.log aux $(pre_pdf_extensions) pdf blg bbl out nav snm toc lof lot lol pfg \ | |
1283 fls vrb idx ind ilg glg glo gls lox nls nlo nlg brf mtc maf brf | |
1284 backup_patterns := *~ *.bak *.backup body.tmp head.tmp | |
1285 | |
1286 graph_stem := _graph | |
1287 | |
1288 # All LaTeX-generated files that can be safely removed | |
1289 | |
1290 rm_tex := \ | |
1291 $(foreach e,$(rm_ext),$(addsuffix .$e,$(all_stems_source))) \ | |
1292 $(foreach e,$(rm_ext) tex,$(addsuffix .$e,$(all_stems_sg))) \ | |
1293 $(addsuffix .log,$(all_ps_targets) $(all_pdf_targets)) \ | |
1294 $(addsuffix .*.log,$(stems_graphic)) | |
1295 | |
1296 # These are the files that will affect .gpi transformation for all .gpi files. | |
1297 # | |
1298 # Use only the first one found. Backward compatible values are at the end. | |
1299 # Note that we use foreach, even though wildcard also returns a list, to ensure | |
1300 # that the order in the uppercase variables is preserved. Directory listings | |
1301 # provide no such guarantee, so we avoid relying on them. | |
1302 gpi_sed := $(strip \ | |
1303 $(firstword $(foreach f,$(GNUPLOT_SED),$(wildcard $f)))) | |
1304 gpi_global := $(strip \ | |
1305 $(firstword $(foreach f,$(GNUPLOT_GLOBAL),$(wildcard $f)))) | |
1306 | |
1307 # | |
1308 # Functions used in generating output | |
1309 # | |
1310 | |
1311 # Outputs all source dependencies to stdout. The first argument is the file to | |
1312 # be parsed, the second is a list of files that will show up as dependencies in | |
1313 # the new .d file created here. | |
1314 # | |
1315 # NOTE: BSD sed does not understand \|, so we have to do something more | |
1316 # clunky to extract suitable extensions. | |
1317 # | |
1318 # Also, we do a little bit of funny rewriting up front (TARGETS=) to make sure | |
1319 # that we can properly backslash-escape spaces in file names (e.g, on Cygwin | |
1320 # for tex distributions that have "Program Files" in their name). | |
1321 # | |
1322 # $(call get-inputs,<parsed file>,<target files>) | |
1323 define get-inputs | |
1324 $(SED) \ | |
1325 -e '/^INPUT/!d' \ | |
1326 -e 's!^INPUT \(\./\)\{0,1\}!!' \ | |
1327 -e 's/[[:space:]]/\\ /g' \ | |
1328 -e 's/\(.*\)\.aux$$/\1.tex/' \ | |
1329 -e '/\.tex$$/b addtargets' \ | |
1330 -e '/\.cls$$/b addtargets' \ | |
1331 -e '/\.sty$$/b addtargets' \ | |
1332 -e '/\.pstex_t$$/b addtargets' \ | |
1333 -e '/\.dot_t$$/b addtargets' \ | |
1334 -e 'd' \ | |
1335 -e ':addtargets' \ | |
1336 -e 's/^/$2: /' \ | |
1337 $1 | $(SORT) | $(UNIQ) | |
1338 endef | |
1339 | |
1340 # $(call get-missing-inputs,<log file>,<target files>) | |
1341 define get-missing-inputs | |
1342 $(SED) \ | |
1343 -e '$$ b para' \ | |
1344 -e '/^$$/b para' \ | |
1345 -e 'H' \ | |
1346 -e 'd' \ | |
1347 -e ':para' \ | |
1348 -e 'x' \ | |
1349 -e '/^$$/d' \ | |
1350 -e 's/^\n*//' \ | |
1351 -e '/^! LaTeX Error: File /{' \ | |
1352 -e ' s/^/::DOUBLE_PARAGRAPH::/' \ | |
1353 -e ' h' \ | |
1354 -e ' d' \ | |
1355 -e '}' \ | |
1356 -e 's/^::DOUBLE_PARAGRAPH:://' \ | |
1357 -e '/Default extension: /!d' \ | |
1358 -e 's/[[:space:]]\{1,\}/ /g' \ | |
1359 -e 's/\n\{1,\}/ /g' \ | |
1360 -e 's/^.*File `//' \ | |
1361 -e 's/'"'"' not found\..*//' \ | |
1362 -e '/\.tex/!s/$$/.tex/' \ | |
1363 -e 's/[[:space:]]/\\ /g' \ | |
1364 -e 'h' \ | |
1365 -e 's/.*/# MISSING input "&" - (presence of comment affects build)/' \ | |
1366 -e 'p' \ | |
1367 -e 's/.*//' \ | |
1368 -e 'x' \ | |
1369 -e 's/^/$2: /' \ | |
1370 $1 | $(SORT) | $(UNIQ) | |
1371 endef | |
1372 | |
1373 # Get source file for specified graphics stem. | |
1374 # | |
1375 # $(call graphics-source,<stem>) | |
1376 define graphics-source | |
1377 $(strip $(firstword \ | |
1378 $(wildcard \ | |
1379 $(addprefix $1.,\ | |
1380 $(graphic_source_extensions))) \ | |
1381 $1 \ | |
1382 )) | |
1383 endef | |
1384 | |
1385 # Get the target file for the specified graphics file/stem | |
1386 # | |
1387 # $(call graphics-target,<stem>) | |
1388 define graphics-target | |
1389 $(strip $(if $(filter $(addprefix %.,$(graphic_target_extensions)),$1), $1, | |
1390 $(firstword $(patsubst $(addprefix %.,$(graphic_source_extensions) $(graphic_target_extensions)), %, $1).$(default_graphic_extension) $1.$(default_graphic_extension)))) | |
1391 endef | |
1392 | |
1393 # Outputs all of the graphical dependencies to stdout. The first argument is | |
1394 # the stem of the source file being built, the second is a list of suffixes | |
1395 # that will show up as dependencies in the generated .d file. | |
1396 # | |
1397 # Note that we try to escape spaces in filenames where possible. We have to do | |
1398 # it with three backslashes so that as the name percolates through the makefile | |
1399 # it eventually ends up with the proper escaping when the build rule is found. | |
1400 # Ugly, but it appears to work. Note that graphicx doesn't allow filenames | |
1401 # with spaces, so this could in many ways be moot unless you're using something | |
1402 # like grffile. | |
1403 # | |
1404 # For pdflatex, we really need the missing file to be specified without an | |
1405 # extension, otherwise compilation barfs on the first missing file. Truly | |
1406 # annoying, but there you have it. | |
1407 # | |
1408 # It turns out that the graphics errors, although they have lines with empty | |
1409 # space, are only made of two paragraphs. So, we just use some sed magic to | |
1410 # get everything into paragraphs, detect when it's a paragraph that interests | |
1411 # us, and double it up. Then we get the filename only if we're missing | |
1412 # extensions (a sign that it's graphicx complaining). | |
1413 # | |
1414 # $(call get-graphics,<target file stem>) | |
1415 #.log,$(addprefix $*.,d $(build_target_extension) _graphics) | |
1416 define get-graphics | |
1417 $(SED) \ | |
1418 -e '$$ b para' \ | |
1419 -e '/^$$/b para' \ | |
1420 -e 'H' \ | |
1421 -e 'd' \ | |
1422 -e ':para' \ | |
1423 -e 'x' \ | |
1424 -e '/^$$/d' \ | |
1425 -e 's/^\n*//' \ | |
1426 -e '/^! LaTeX Error: File `/{' \ | |
1427 -e ' s/^/::DOUBLE_PARAGRAPH::/' \ | |
1428 -e ' h' \ | |
1429 -e ' d' \ | |
1430 -e '}' \ | |
1431 -e 's/^::DOUBLE_PARAGRAPH:://' \ | |
1432 -e '/could not locate the file with any of these extensions:/{' \ | |
1433 -e ' s/\n\{1,\}/ /g' \ | |
1434 -e ' s/[[:space:]]\{1,\}/ /g' \ | |
1435 -e ' s/^.*File `//' \ | |
1436 -e ' s/'"'"' not found\..*//' \ | |
1437 -e ' h' \ | |
1438 -e ' s/.*/# MISSING stem "&" - (presence of comment affects build)/' \ | |
1439 -e ' p' \ | |
1440 -e ' g' \ | |
1441 -e ' b addtargets' \ | |
1442 -e '}' \ | |
1443 -e '/.*File: \(.*\) Graphic file (type [^)]*).*/{' \ | |
1444 -e ' s//\1/' \ | |
1445 -e ' b addtargets' \ | |
1446 -e '}' \ | |
1447 -e 'd' \ | |
1448 -e ':addtargets' \ | |
1449 -e 's/[[:space:]]/\\\\\\&/g' \ | |
1450 -e 'h' \ | |
1451 -e 's/.*/-include &.gpi.d/' \ | |
1452 -e 'p' \ | |
1453 -e 'g' \ | |
1454 -e 's/.*/$(addprefix $1,.d): $$$$(call graphics-source,&)/' \ | |
1455 -e 'p' \ | |
1456 -e 's/.*//' \ | |
1457 -e 'x' \ | |
1458 -e 's/.*/$(addprefix $1.,$(build_target_extension) _graphics): $$$$(call graphics-target,&)/' \ | |
1459 -e 'p' \ | |
1460 -e 'd' \ | |
1461 $*.log | |
1462 endef | |
1463 | |
1464 # Checks for build failure due to pstex inclusion, and gives instructions. | |
1465 # | |
1466 # $(call die-on-pstexs,<parsed file>) | |
1467 define die-on-pstexs | |
1468 if $(EGREP) -q '^! LaTeX Error: File .*\.pstex.* not found' $1; then \ | |
1469 $(ECHO) "$(C_ERROR)Missing pstex_t file(s)$(C_RESET)"; \ | |
1470 $(ECHO) "$(C_ERROR)Please run$(C_RESET)"; \ | |
1471 $(ECHO) "$(C_ERROR) make all-pstex$(C_RESET)"; \ | |
1472 $(ECHO) "$(C_ERROR)before proceeding.$(C_RESET)"; \ | |
1473 exit 1; \ | |
1474 fi | |
1475 endef | |
1476 | |
1477 # Checks for build failure due to dot2tex, and gives instructions. | |
1478 # | |
1479 # $(call die-on-dot2tex,<parsed file>) | |
1480 define die-on-dot2tex | |
1481 if $(EGREP) -q ' LaTeX Error: File .*\.dot_t.* not found' $1; then \ | |
1482 $(ECHO) "$(C_ERROR)Missing dot_t file(s)$(C_RESET)"; \ | |
1483 $(ECHO) "$(C_ERROR)Please run$(C_RESET)"; \ | |
1484 $(ECHO) "$(C_ERROR) make all-dot2tex$(C_RESET)"; \ | |
1485 $(ECHO) "$(C_ERROR)before proceeding.$(C_RESET)"; \ | |
1486 exit 1; \ | |
1487 fi | |
1488 endef | |
1489 | |
1490 # Checks for the existence of a .aux file, and dies with an error message if it | |
1491 # isn't there. Note that we pass the file stem in, not the full filename, | |
1492 # e.g., to check for foo.aux, we call it thus: $(call die-on-no-aux,foo) | |
1493 # | |
1494 # $(call die-on-no-aux,<aux stem>) | |
1495 define die-on-no-aux | |
1496 if [ ! -e '$1.aux' ]; then \ | |
1497 $(call colorize-latex-errors,$1.log); \ | |
1498 exit 1; \ | |
1499 fi | |
1500 endef | |
1501 | |
1502 # Outputs all index files to stdout. Arg 1 is the source file stem, arg 2 is | |
1503 # the list of targets for the discovered dependency. | |
1504 # | |
1505 # $(call get-log-index,<log file stem>,<target files>) | |
1506 define get-log-index | |
1507 $(SED) \ | |
1508 -e 's/^No file \(.*\.ind\)\.$$/TARGETS=\1/' \ | |
1509 -e 's/^No file \(.*\.[gn]ls\)\.$$/TARGETS=\1/' \ | |
1510 -e 's/[[:space:]]/\\&/g' \ | |
1511 -e '/^TARGETS=/{' \ | |
1512 -e ' h' \ | |
1513 -e ' s/^TARGETS=/$2: /p' \ | |
1514 -e ' g' \ | |
1515 -e ' s/^TARGETS=\(.*\)/\1: $1.tex/p' \ | |
1516 -e '}' \ | |
1517 -e 'd' \ | |
1518 '$1.log' | $(SORT) | $(UNIQ) | |
1519 endef | |
1520 | |
1521 | |
1522 # Outputs all bibliography files to stdout. Arg 1 is the source stem, arg 2 is | |
1523 # a list of targets for each dependency found. | |
1524 # | |
1525 # The script kills all lines that do not contain bibdata. Remaining lines have | |
1526 # the \bibdata macro and delimiters removed to create a dependency list. A | |
1527 # trailing comma is added, then all adjacent commas are collapsed into a single | |
1528 # comma. Then commas are replaced with the string .bib[space], and the | |
1529 # trailing space is killed off. Finally, all filename spaces are escaped. | |
1530 # This produces a list of space-delimited .bib filenames, which is what the | |
1531 # make dep file expects to see. | |
1532 # | |
1533 # Note that we give kpsewhich a bogus argument so that a failure of sed to | |
1534 # produce output will not cause an error. | |
1535 # | |
1536 # $(call get-bibs,<aux file>,<targets>) | |
1537 define get-bibs | |
1538 $(SED) \ | |
1539 -e '/^\\bibdata/!d' \ | |
1540 -e 's/\\bibdata{\([^}]*\)}/\1,/' \ | |
1541 -e 's/,\{2,\}/,/g' \ | |
1542 -e 's/[[:space:]]/\\&/g' \ | |
1543 -e 's/,/.bib /g' \ | |
1544 -e 's/ \{1,\}$$//' \ | |
1545 $1 | $(XARGS) $(KPSEWHICH) '#######' | \ | |
1546 $(SED) \ | |
1547 -e 's/^/$2: /' | \ | |
1548 \$(SORT) | $(UNIQ) | |
1549 endef | |
1550 | |
1551 # Makes a an aux file that only has stuff relevant to the target in it | |
1552 # $(call make-auxtarget-file,<flattened-aux>,<new-aux>) | |
1553 define make-auxtarget-file | |
1554 $(SED) \ | |
1555 -e '/^\\newlabel/!d' \ | |
1556 $1 > $2 | |
1557 endef | |
1558 | |
1559 # Makes an aux file that only has stuff relevant to the bbl in it | |
1560 # $(call make-auxbbl-file,<flattened-aux>,<new-aux>) | |
1561 define make-auxbbl-file | |
1562 $(SED) \ | |
1563 -e '/^\\newlabel/d' \ | |
1564 $1 > $2 | |
1565 endef | |
1566 | |
1567 # Makes a .gpi.d file from a .gpi file | |
1568 # $(call make-gpi-d,<.gpi>,<.gpi.d>) | |
1569 define make-gpi-d | |
1570 $(ECHO) '# vim: ft=make' > $2; \ | |
1571 $(ECHO) 'ifndef INCLUDED_$(call cleanse-filename,$2)' >> $2; \ | |
1572 $(ECHO) 'INCLUDED_$(call cleanse-filename,$2) := 1' >> $2; \ | |
1573 $(call get-gpi-deps,$1,$(addprefix $(2:%.gpi.d=%).,$(GNUPLOT_OUTPUT_EXTENSION) gpi.d)) >> $2; \ | |
1574 $(ECHO) 'endif' >> $2; | |
1575 endef | |
1576 | |
1577 # Parse .gpi files for data and loaded dependencies, output to stdout | |
1578 # | |
1579 # The sed script here tries to be clever about obtaining valid | |
1580 # filenames from the gpi file. It assumes that the plot command starts its own | |
1581 # line, which is not too difficult a constraint to satisfy. | |
1582 # | |
1583 # This command script also generates 'include' directives for every 'load' | |
1584 # command in the .gpi file. The load command must appear on a line by itself | |
1585 # and the file it loads must have the suffix .gpi. If you don't want it to be | |
1586 # compiled when running make graphics, then give it a suffix of ._include_.gpi. | |
1587 # | |
1588 # $(call get-gpi-deps,<gpi file>,<targets>) | |
1589 define get-gpi-deps | |
1590 $(SED) \ | |
1591 -e '/^[[:space:]]*s\{0,1\}plot/,/[^\\]$$/{' \ | |
1592 -e ' H' \ | |
1593 -e ' /[^\\]$$/{' \ | |
1594 -e ' s/.*//' \ | |
1595 -e ' x' \ | |
1596 -e ' s/\\\{0,1\}\n//g' \ | |
1597 -e ' s/^[[:space:]]*s\{0,1\}plot[[:space:]]*\(\[[^]]*\][[:space:]]*\)*/,/' \ | |
1598 -e ' s/[[:space:]]*\(['\''"][^'\''"]*['\''"]\)\{0,1\}[^,]*/\1/g' \ | |
1599 -e ' s/,['\''"]-\{0,1\}['\''"]//g' \ | |
1600 -e ' s/[,'\''"]\{1,\}/ /g' \ | |
1601 -e ' s!.*!$2: &!' \ | |
1602 -e ' p' \ | |
1603 -e ' }' \ | |
1604 -e ' d' \ | |
1605 -e '}' \ | |
1606 -e 's/^[[:space:]]*load[[:space:]]*['\''"]\([^'\''"]*\.gpi\)['\''"].*$$/-include \1.d/p' \ | |
1607 -e 'd' \ | |
1608 $1 | |
1609 endef | |
1610 | |
1611 # Colorizes real, honest-to-goodness LaTeX errors that can't be overcome with | |
1612 # recompilation. | |
1613 # | |
1614 # Note that we only ignore file not found errors for things that we know how to | |
1615 # build, like graphics files. | |
1616 # | |
1617 # $(call colorize-latex-errors,<log file>) | |
1618 define colorize-latex-errors | |
1619 $(SED) \ | |
1620 -e '$$ b para' \ | |
1621 -e '/^$$/b para' \ | |
1622 -e 'H' \ | |
1623 -e 'd' \ | |
1624 -e ':para' \ | |
1625 -e 'x' \ | |
1626 -e '/^$$/d' \ | |
1627 -e 's/^\n*//' \ | |
1628 -e '/^! LaTeX Error: File /{' \ | |
1629 -e ' s/^/::DOUBLE_PARAGRAPH::/' \ | |
1630 -e ' h' \ | |
1631 -e ' d' \ | |
1632 -e '}' \ | |
1633 -e 's/^::DOUBLE_PARAGRAPH:://' \ | |
1634 -e '/could not locate the file with any of these extensions:/d' \ | |
1635 -e '/Missing .begin.document/{' \ | |
1636 -e ' h' \ | |
1637 -e ' s/.*/Are you trying to build an include file?/' \ | |
1638 -e ' x' \ | |
1639 -e ' G' \ | |
1640 -e '}' \ | |
1641 -e '/ LaTeX Error: Cannot determine size/d' \ | |
1642 -e 's/.* LaTeX Error .*/$(C_ERROR)&$(C_RESET)/p' \ | |
1643 -e 's/Error: pdflatex (file .*/$(C_ERROR)& - try specifying it without an extension$(C_RESET)/p' \ | |
1644 -e '/.*\*hyperref using.*driver \(.*\)\*.*/{' \ | |
1645 -e ' s//\1/' \ | |
1646 -e ' /^$(hyperref_driver_pattern)$$/!{' \ | |
1647 -e ' s/.*//' \ | |
1648 -e ' p' \ | |
1649 -e ' s/.*/$(C_ERROR)--- Using incorrect driver for hyperref! ---$(C_RESET)/' \ | |
1650 -e ' p' \ | |
1651 -e ' s/.*/$(C_ERROR)$(hyperref_driver_error)$(C_RESET)/' \ | |
1652 -e ' p' \ | |
1653 -e ' }' \ | |
1654 -e ' d' \ | |
1655 -e '}' \ | |
1656 -e '/ LaTeX Error: Unknown graphics extension/{' \ | |
1657 -e ' s/^/ /' \ | |
1658 -e ' h' \ | |
1659 -e ' s/.*/--- Graphics extension error:/' \ | |
1660 -e ' G' \ | |
1661 -e ' h' \ | |
1662 -e ' s/.*/--- If you specified the extension explicitly in your .tex file, try removing it./' \ | |
1663 -e ' H' \ | |
1664 -e ' g' \ | |
1665 -e ' s/.*/$(C_ERROR)&$(C_RESET)/' \ | |
1666 -e ' p' \ | |
1667 -e ' s/.*//' \ | |
1668 -e ' h' \ | |
1669 -e ' b' \ | |
1670 -e '}' \ | |
1671 -e 's/.*\(\n\{0,\}! .*\)/$(C_ERROR)\1$(C_RESET)/p' \ | |
1672 -e 'd' \ | |
1673 $1 | |
1674 endef | |
1675 | |
1676 # Colorize Makeindex errors | |
1677 define colorize-makeindex-errors | |
1678 $(SED) \ | |
1679 -e '/^!! /{' \ | |
1680 -e ' N' \ | |
1681 -e ' s/^.*$$/$(C_ERROR)&$(C_RESET)/' \ | |
1682 -e ' p' \ | |
1683 -e '}' \ | |
1684 -e 'd' \ | |
1685 $1 | |
1686 endef | |
1687 | |
1688 # Colorize epstopdf errors | |
1689 # | |
1690 # $(call colorize-epstopdf-errors,<log file>) | |
1691 define colorize-epstopdf-errors | |
1692 $(SED) \ | |
1693 -e '/^Error:/,/^Execution stack:/{' \ | |
1694 -e ' /^Execution stack:/d' \ | |
1695 -e ' s/.*/$(C_ERROR)&$(C_RESET)/' \ | |
1696 -e ' p' \ | |
1697 -e '}' \ | |
1698 -e 'd' \ | |
1699 $1 | |
1700 endef | |
1701 | |
1702 # Colorize GNUplot errors | |
1703 # | |
1704 # $(call colorize-gnuplot-errors,<log file>) | |
1705 define colorize-gnuplot-errors | |
1706 $(SED) \ | |
1707 -e '/, line [0-9]*:/!{' \ | |
1708 -e ' H' \ | |
1709 -e ' x' \ | |
1710 -e ' s/.*\n\(.*\n.*\)$$/\1/' \ | |
1711 -e ' x' \ | |
1712 -e '}' \ | |
1713 -e '/, line [0-9]*:/{' \ | |
1714 -e ' H' \ | |
1715 -e ' /unknown.*terminal type/{' \ | |
1716 -e ' s/.*/--- Try changing the GNUPLOT_OUTPUT_EXTENSION variable to 'eps'./' \ | |
1717 -e ' H' \ | |
1718 -e ' }' \ | |
1719 -e ' /gpihead/{' \ | |
1720 -e ' s/.*/--- This could be a Makefile bug - contact the maintainer./' \ | |
1721 -e ' H' \ | |
1722 -e ' }' \ | |
1723 -e ' g' \ | |
1724 -e ' s/.*/$(C_ERROR)&$(C_RESET)/' \ | |
1725 -e ' p' \ | |
1726 -e '}' \ | |
1727 -e '/^gnuplot>/,/^$$/{' \ | |
1728 -e ' s/^gnuplot.*/$(C_ERROR)&/' \ | |
1729 -e ' s/^$$/$(C_RESET)/' \ | |
1730 -e ' p' \ | |
1731 -e '}' \ | |
1732 -e 'd' \ | |
1733 $1 | |
1734 endef | |
1735 | |
1736 # Colorize GraphViz errors | |
1737 # | |
1738 # $(call colorize-dot-errors,<log file>) | |
1739 define colorize-dot-errors | |
1740 $(SED) \ | |
1741 -e '/^Error:/,/context:/s/.*/$(C_ERROR)&$(C_RESET)/p' \ | |
1742 -e 's/^Warning:.*/$(C_WARNING)&$(C_RESET)/p' \ | |
1743 -e 'd' \ | |
1744 '$1' | |
1745 endef | |
1746 | |
1747 # Get all important .aux files from the top-level .aux file and merges them all | |
1748 # into a single file, which it outputs to stdout. | |
1749 # | |
1750 # $(call flatten-aux,<toplevel aux>,<output file>) | |
1751 define flatten-aux | |
1752 $(SED) \ | |
1753 -e '/\\@input{\(.*\)}/{' \ | |
1754 -e 's//\1/' \ | |
1755 -e 's![.:]!\\&!g' \ | |
1756 -e 'h' \ | |
1757 -e 's!.*!\\:\\\\@input{&}:{!' \ | |
1758 -e 'p' \ | |
1759 -e 'x' \ | |
1760 -e 's/\\././g' \ | |
1761 -e 's/.*/r &/p' \ | |
1762 -e 's/.*/d/p' \ | |
1763 -e 's/.*/}/p' \ | |
1764 -e 'd' \ | |
1765 -e '}' \ | |
1766 -e 'd' \ | |
1767 '$1' > "$1.$$$$.sed.make"; \ | |
1768 $(SED) -f "$1.$$$$.sed.make" '$1' > "$1.$$$$.make"; \ | |
1769 $(SED) \ | |
1770 -e '/^\\relax/d' \ | |
1771 -e '/^\\bibcite/d' \ | |
1772 -e 's/^\(\\newlabel{[^}]\{1,\}}\).*/\1/' \ | |
1773 "$1.$$$$.make" | $(SORT) > '$2'; \ | |
1774 $(call remove-temporary-files,$1.$$$$.make $1.$$$$.sed.make) | |
1775 endef | |
1776 | |
1777 # Generate pdf from postscript | |
1778 # | |
1779 # Note that we don't just call ps2pdf, since there are so many versions of that | |
1780 # script on various systems. Instead, we call the postscript interpreter | |
1781 # directly. | |
1782 # | |
1783 # $(call ps2pdf,infile,outfile,[embed fonts]) | |
1784 define ps2pdf | |
1785 $(GS) \ | |
1786 -dSAFER -dCompatibilityLevel=$(PS_COMPATIBILITY) \ | |
1787 $(if $3,$(PS_EMBED_OPTIONS)) \ | |
1788 -q -dNOPAUSE -dBATCH \ | |
1789 -sDEVICE=pdfwrite -sstdout=%stderr \ | |
1790 '-sOutputFile=$2' \ | |
1791 -dSAFER -dCompatibilityLevel=$(PS_COMPATIBILITY) \ | |
1792 $(if $3,$(PS_EMBED_OPTIONS)) \ | |
1793 -c .setpdfwrite \ | |
1794 -f '$1' | |
1795 endef | |
1796 | |
1797 # Colorize LaTeX output. | |
1798 # This uses a neat trick from the Sed & Awk Book from O'Reilly: | |
1799 # 1) If a line has a single ending paren, delete it to make a blank line (so | |
1800 # that we catch the first error, which is not always preceded by a blank | |
1801 # line). | |
1802 # 2) Ensure that the last line of the file gets appended to the hold buffer, | |
1803 # and blank it out to trigger end-of-paragraph logic below. | |
1804 # 3) When encountering a blank line (LaTeX output helpfully breaks output on | |
1805 # newlines) | |
1806 # a) swap the hold buffer (containing the paragraph) into the pattern buffer (putting a blank line into the hold buffer), | |
1807 # b) remove the newline at the beginning (don't ask), | |
1808 # c) apply any colorizing substitutions necessary to ensure happiness. | |
1809 # d) get the newline out of the hold buffer and append it | |
1810 # e) profit! (print) | |
1811 # 4) Anything not colorized is deleted, unless in verbose mode. | |
1812 color_tex := \ | |
1813 $(SED) \ | |
1814 -e '$${' \ | |
1815 -e ' /^$$/!{' \ | |
1816 -e ' H' \ | |
1817 -e ' s/.*//' \ | |
1818 -e ' }' \ | |
1819 -e '}' \ | |
1820 -e '/^$$/!{' \ | |
1821 -e ' H' \ | |
1822 -e ' d' \ | |
1823 -e '}' \ | |
1824 -e '/^$$/{' \ | |
1825 -e ' x' \ | |
1826 -e ' s/^\n//' \ | |
1827 -e ' /Output written on /{' \ | |
1828 -e ' s/.*Output written on \([^(]*\) (\([^)]\{1,\}\)).*/Success! Wrote \2 to \1/' \ | |
1829 -e ' s/[[:digit:]]\{1,\}/$(C_PAGES)&$(C_RESET)/g' \ | |
1830 -e ' s/Success!/$(C_SUCCESS)&$(C_RESET)/g' \ | |
1831 -e ' s/to \(.*\)$$/to $(C_SUCCESS)\1$(C_RESET)/' \ | |
1832 -e ' b end' \ | |
1833 -e ' }' \ | |
1834 -e ' / *LaTeX Error:.*/{' \ | |
1835 -e ' s/.*\( *LaTeX Error:.*\)/$(C_ERROR)\1$(C_RESET)/' \ | |
1836 -e ' b end' \ | |
1837 -e ' }' \ | |
1838 -e ' /.*Warning:.*/{' \ | |
1839 -e ' s//$(C_WARNING)&$(C_RESET)/' \ | |
1840 -e ' b end' \ | |
1841 -e ' }' \ | |
1842 -e ' /Underfull.*/{' \ | |
1843 -e ' s/.*\(Underfull.*\)/$(C_UNDERFULL)\1$(C_RESET)/' \ | |
1844 -e ' b end' \ | |
1845 -e ' }' \ | |
1846 -e ' /Overfull.*/{' \ | |
1847 -e ' s/.*\(Overfull.*\)/$(C_OVERFULL)\1$(C_RESET)/' \ | |
1848 -e ' b end' \ | |
1849 -e ' }' \ | |
1850 $(if $(VERBOSE),,-e ' d') \ | |
1851 -e ' :end' \ | |
1852 -e ' G' \ | |
1853 -e '}' \ | |
1854 | |
1855 # Colorize BibTeX output. | |
1856 color_bib := \ | |
1857 $(SED) \ | |
1858 -e 's/^Warning--.*/$(C_WARNING)&$(C_RESET)/' -e 't' \ | |
1859 -e '/---/,/^.[^:]/{' \ | |
1860 -e ' H' \ | |
1861 -e ' /^.[^:]/{' \ | |
1862 -e ' x' \ | |
1863 -e ' s/\n\(.*\)/$(C_ERROR)\1$(C_RESET)/' \ | |
1864 -e ' p' \ | |
1865 -e ' s/.*//' \ | |
1866 -e ' h' \ | |
1867 -e ' d' \ | |
1868 -e ' }' \ | |
1869 -e ' d' \ | |
1870 -e '}' \ | |
1871 -e '/(.*error.*)/s//$(C_ERROR)&$(C_RESET)/' \ | |
1872 $(if $(VERBOSE),,-e 'd') | |
1873 | |
1874 | |
1875 # Make beamer output big enough to print on a full page. Landscape doesn't | |
1876 # seem to work correctly. | |
1877 enlarge_beamer = $(PSNUP) -l -1 -W128mm -H96mm -pletter | |
1878 | |
1879 # $(call test-run-again,<source stem>) | |
1880 test-run-again = $(EGREP) -q '^(.*Rerun .*|No file $1\.[^.]+\.)$$' $1.log | |
1881 | |
1882 # This tests whether the build target commands should be run at all, from | |
1883 # viewing the log file. | |
1884 # $(call test-log-for-need-to-run,<source stem>) | |
1885 define test-log-for-need-to-run | |
1886 $(SED) \ | |
1887 -e '/^No file $(call escape-dots,$1)\.aux\./d' \ | |
1888 $1.log \ | |
1889 | $(EGREP) -q '^(.*Rerun .*|No file $1\.[^.]+\.|No file .+\.tex\.|LaTeX Warning: File.*)$$' | |
1890 endef | |
1891 | |
1892 # LaTeX invocations | |
1893 # | |
1894 # $(call latex,<tex file>,[<extra LaTeX args>]) | |
1895 run-latex = $(latex_build_program) --interaction=batchmode $(if $2,$2,) $1 > /dev/null | |
1896 | |
1897 # $(call latex-color-log,<LaTeX stem>) | |
1898 latex-color-log = $(color_tex) $1.log | |
1899 | |
1900 # $(call run-makeindex,<input>,<output>,<log>,<extra flags>) | |
1901 define run-makeindex | |
1902 success=1; \ | |
1903 if ! $(MAKEINDEX) -q $1 -t $3 -o $2 $4 > /dev/null || $(EGREP) -q '^!!' $3; then \ | |
1904 $(call colorize-makeindex-errors,$3); \ | |
1905 $(RM) -f '$2'; \ | |
1906 success=0; \ | |
1907 fi; \ | |
1908 [ "$$success" = "1" ] && $(sh_true) || $(sh_false); | |
1909 endef | |
1910 | |
1911 # This runs the given script to generate output, and it uses MAKE_RESTARTS to | |
1912 # ensure that it never runs it more than once for a particular root make | |
1913 # invocation. | |
1914 # | |
1915 # $(call run-script,<interpreter>,<input>,<output>) | |
1916 define run-script | |
1917 [ ! -e '$2.cookie' ] && $(ECHO) "restarts=$(RESTARTS)" > $2.cookie && $(ECHO) "level=$(MAKELEVEL)" >> $2.cookie; \ | |
1918 restarts=`$(SED) -n -e 's/^restarts=//p' $2.cookie`; \ | |
1919 level=`$(SED) -n -e 's/^level=//p' $2.cookie`; \ | |
1920 if $(EXPR) $(MAKELEVEL) '<=' $$level '&' $(RESTARTS) '<=' $$restarts >/dev/null; then \ | |
1921 $(call echo-build,$2,$3,$(RESTARTS)-$(MAKELEVEL)); \ | |
1922 $1 '$2' '$3'; \ | |
1923 $(ECHO) "restarts=$(RESTARTS)" > '$2.cookie'; \ | |
1924 $(ECHO) "level=$(MAKELEVEL)" >> '$2.cookie'; \ | |
1925 fi | |
1926 endef | |
1927 | |
1928 # BibTeX invocations | |
1929 # | |
1930 # $(call run-bibtex,<tex stem>) | |
1931 run-bibtex = $(BIBTEX) $1 | $(color_bib) | |
1932 | |
1933 | |
1934 # $(call convert-eps-to-pdf,<eps file>,<pdf file>,[gray]) | |
1935 # Note that we don't use the --filter flag because it has trouble with bounding boxes that way. | |
1936 define convert-eps-to-pdf | |
1937 $(if $3,$(CAT) '$1' | $(call kill-ps-color) > '$1.cookie',$(CP) '$1' '$1.cookie'); \ | |
1938 $(EPSTOPDF) '$1.cookie' --outfile='$2' > $1.log; \ | |
1939 $(call colorize-epstopdf-errors,$1.log); | |
1940 endef | |
1941 | |
1942 # $(call convert-gpi,<gpi file>,<output file>,[gray]) | |
1943 # | |
1944 define convert-gpi | |
1945 $(ECHO) 'set terminal $(if $(filter %.pdf,$2),pdf enhanced,postscript enhanced eps)' \ | |
1946 $(if $(filter %.pdf,$2),fsize ,)$(call get-default,$(strip \ | |
1947 $(firstword \ | |
1948 $(shell \ | |
1949 $(SED) \ | |
1950 -e 's/^\#\#FONTSIZE=\([[:digit:]]\{1,\}\)/\1/p' \ | |
1951 -e 'd' \ | |
1952 $1 $(strip $(gpi_global)) \ | |
1953 ) \ | |
1954 ) \ | |
1955 ),$(if $(filter %.pdf,$2),$(DEFAULT_GPI_PDF_FONTSIZE),$(DEFAULT_GPI_EPS_FONTSIZE))) \ | |
1956 $(strip $(if $3,monochrome,$(if \ | |
1957 $(shell $(EGREP) '^\#\#[[:space:]]*GRAY[[:space:]]*$$' $< $(gpi_global)),\ | |
1958 ,color))) > $1head.make; \ | |
1959 $(ECHO) 'set output "$2"' >> $1head.make; \ | |
1960 $(if $(gpi_global),$(CAT) $(gpi_global) >> $1head.make;,) \ | |
1961 fnames='$1head.make $1';\ | |
1962 $(if $(gpi_sed),\ | |
1963 $(SED) -f '$(gpi_sed)' $$fnames > $1.temp.make; \ | |
1964 fnames=$1.temp.make;,\ | |
1965 ) \ | |
1966 success=1; \ | |
1967 if ! $(GNUPLOT) $$fnames 2>$1.log; then \ | |
1968 $(call colorize-gnuplot-errors,$1.log); \ | |
1969 success=0; \ | |
1970 fi; \ | |
1971 $(if $(gpi_sed),$(call remove-temporary-files,$1.temp.make);,) \ | |
1972 $(call remove-temporary-files,$1head.make); \ | |
1973 [ "$$success" = "1" ] && $(sh_true) || $(sh_false); | |
1974 endef | |
1975 | |
1976 # Creation of .eps files from .png files | |
1977 # | |
1978 # The intermediate step of PNM (using NetPBM) produces much nicer output than | |
1979 # ImageMagick's "convert" binary. I couldn't get the right combination of | |
1980 # flags to make it look nice, anyway. | |
1981 # | |
1982 # To handle gray scale conversion, we pipe things through ppmtopgm in the | |
1983 # middle. | |
1984 # | |
1985 # $(call convert-png,<png file>,<eps file>) | |
1986 define convert-png | |
1987 $(PNGTOPNM) "$1" \ | |
1988 $(if $3,| $(PPMTOPGM),) \ | |
1989 | $(PNMTOPS) -noturn \ | |
1990 > "$2" | |
1991 endef | |
1992 | |
1993 # Creation of .eps files from .jpg files | |
1994 # | |
1995 # Thanks to brubakee for this solution. | |
1996 # | |
1997 # Uses Postscript level 2 to avoid file size bloat | |
1998 # $(call convert-jpg,<jpg file>,<eps file>) | |
1999 define convert-jpg | |
2000 $(CONVERT) $(if $3,-type Grayscale,) '$1' eps2:'$2' | |
2001 endef | |
2002 | |
2003 # Creation of .eps files from .fig files | |
2004 # $(call convert-fig,<fig file>,<output file>,[gray]) | |
2005 convert-fig = $(FIG2DEV) -L $(if $(filter %.pdf,$2),pdf,eps) $(if $3,-N,) $1 $2 | |
2006 | |
2007 # Creation of .pstex files from .fig files | |
2008 # $(call convert-fig-pstex,<fig file>,<pstex file>) | |
2009 convert-fig-pstex = $(FIG2DEV) -L pstex $1 $2 > /dev/null 2>&1 | |
2010 | |
2011 # Creation of .pstex_t files from .fig files | |
2012 # $(call convert-fig-pstex-t,<fig file>,<pstex file>,<pstex_t file>) | |
2013 convert-fig-pstex-t = $(FIG2DEV) -L pstex_t -p $3 $1 $2 > /dev/null 2>&1 | |
2014 | |
2015 # Creation of .dot_t files from .dot files | |
2016 # #(call convert-dot-tex,<dot file>,<dot_t file>) | |
2017 convert-dot-tex = $(DOT2TEX) '$1' > '$2' | |
2018 | |
2019 # Converts svg files into .eps files | |
2020 # | |
2021 # $(call convert-svg,<svg file>,<eps file>,[gray]) | |
2022 convert-svg = $(INKSCAPE) --export-eps='$2' '$1' | |
2023 | |
2024 # Converts xvg files into .eps files | |
2025 # | |
2026 # $(call convert-xvg,<xvg file>,<eps file>,[gray]) | |
2027 convert-xvg = $(XMGRACE) '$1' -printfile - -hardcopy -hdevice $(if $3,-mono,) EPS > '$2' | |
2028 | |
2029 # Converts .eps.gz files into .eps files | |
2030 # | |
2031 # $(call convert-epsgz,<eps.gz file>,<eps file>,[gray]) | |
2032 convert-epsgz = $(GUNZIP) -c '$1' $(if $3,| $(call kill-ps-color)) > '$2' | |
2033 | |
2034 # Converts .eps files into .eps files (usually a no-op, but can make grayscale) | |
2035 # | |
2036 # $(call convert-eps,<in file>,<out file>,[gray]) | |
2037 convert-eps = $(if $3,$(call kill-ps-color) $1 > $2) | |
2038 | |
2039 # The name of the file containing special postscript commands for grayscale | |
2040 gray_eps_file := gray.eps.make | |
2041 | |
2042 # Changes sethsbcolor and setrgbcolor calls in postscript to always produce | |
2043 # grayscale. In general, this is accomplished by writing new versions of those | |
2044 # functions into the user dictionary space, which is looked up before the | |
2045 # global or system dictionaries (userdict is one of the permanent dictionaries | |
2046 # in postscript and is not read-only like systemdict). | |
2047 # | |
2048 # For setrgbcolor, the weighted average of the triple is computed and the | |
2049 # triple is replaced with three copies of that average before the original | |
2050 # procedure is called: .299R + .587G + .114B | |
2051 # | |
2052 # For sethsbcolor, the color is first converted to RGB, then to grayscale by | |
2053 # the new setrgbcolor operator as described above. Why is this done? | |
2054 # Because simply using the value component will tend to make pure colors | |
2055 # white, a very undesirable thing. Pure blue should not translate to white, | |
2056 # but to some level of gray. Conversion to RGB does the right thing. It's | |
2057 # messy, but it works. | |
2058 # | |
2059 # From | |
2060 # http://en.wikipedia.org/wiki/HSV_color_space#Transformation_from_HSV_to_RGB, | |
2061 # HSB = HSV (Value = Brightness), and the formula used to convert to RGB is | |
2062 # as follows: | |
2063 # | |
2064 # Hi = int(floor(6 * H)) mod 6 | |
2065 # f = 6 * H - Hi | |
2066 # p = V(1-S) | |
2067 # q = V(1-fS) | |
2068 # t = V(1-(1-f)S) | |
2069 # if Hi = 0: R G B <-- V t p | |
2070 # if Hi = 1: R G B <-- q V p | |
2071 # if Hi = 2: R G B <-- p V t | |
2072 # if Hi = 3: R G B <-- p q V | |
2073 # if Hi = 4: R G B <-- t p V | |
2074 # if Hi = 5: R G B <-- V p q | |
2075 # | |
2076 # The messy stack-based implementation is below | |
2077 # $(call create-gray-eps-file,filename) | |
2078 define create-gray-eps-file | |
2079 $(ECHO) -n -e '\ | |
2080 /OLDRGB /setrgbcolor load def\n\ | |
2081 /setrgbcolor {\n\ | |
2082 .114 mul exch\n\ | |
2083 .587 mul add exch\n\ | |
2084 .299 mul add\n\ | |
2085 dup dup\n\ | |
2086 OLDRGB\n\ | |
2087 } bind def\n\ | |
2088 /OLDHSB /sethsbcolor load def\n\ | |
2089 /sethsbcolor {\n\ | |
2090 2 index % H V S H\n\ | |
2091 6 mul floor cvi 6 mod % Hi V S H\n\ | |
2092 3 index % H Hi V S H\n\ | |
2093 6 mul % 6H Hi V S H\n\ | |
2094 1 index % Hi 6H Hi V S H\n\ | |
2095 sub % f Hi V S H\n\ | |
2096 2 index 1 % 1 V f Hi V S H\n\ | |
2097 4 index % S 1 V f Hi V S H\n\ | |
2098 sub mul % p f Hi V S H\n\ | |
2099 3 index 1 % 1 V p f Hi V S H\n\ | |
2100 6 index % S 1 V p f Hi V S H\n\ | |
2101 4 index % f S 1 V p f Hi V S H\n\ | |
2102 mul sub mul % q p f Hi V S H\n\ | |
2103 4 index 1 1 % 1 1 V q p f Hi V S H\n\ | |
2104 5 index % f 1 1 V q p f Hi V S H\n\ | |
2105 sub % (1-f) 1 V q p f Hi V S H\n\ | |
2106 8 index % S (1-f) 1 V q p f Hi V S H\n\ | |
2107 mul sub mul % t q p f Hi V S H\n\ | |
2108 4 -1 roll pop % t q p Hi V S H\n\ | |
2109 7 -2 roll pop pop % t q p Hi V\n\ | |
2110 5 -2 roll % Hi V t q p\n\ | |
2111 dup 0 eq\n\ | |
2112 {1 index 3 index 6 index}\n\ | |
2113 {\n\ | |
2114 dup 1 eq\n\ | |
2115 {3 index 2 index 6 index}\n\ | |
2116 {\n\ | |
2117 dup 2 eq\n\ | |
2118 {4 index 2 index 4 index}\n\ | |
2119 {\n\ | |
2120 dup 3 eq\n\ | |
2121 {4 index 4 index 3 index}\n\ | |
2122 {\n\ | |
2123 dup 4 eq\n\ | |
2124 {2 index 5 index 3 index}\n\ | |
2125 {\n\ | |
2126 dup 5 eq\n\ | |
2127 {1 index 5 index 5 index}\n\ | |
2128 {0 0 0}\n\ | |
2129 ifelse\n\ | |
2130 }\n\ | |
2131 ifelse\n\ | |
2132 }\n\ | |
2133 ifelse\n\ | |
2134 }\n\ | |
2135 ifelse\n\ | |
2136 }\n\ | |
2137 ifelse\n\ | |
2138 }\n\ | |
2139 ifelse % B G R Hi V t q p\n\ | |
2140 setrgbcolor\n\ | |
2141 5 {pop} repeat\n\ | |
2142 } bind def\n'\ | |
2143 > $1 | |
2144 endef | |
2145 | |
2146 # This actually inserts the color-killing code into a postscript file | |
2147 # $(call kill-ps-color) | |
2148 define kill-ps-color | |
2149 $(SED) -e '/%%EndComments/r $(gray_eps_file)' | |
2150 endef | |
2151 | |
2152 # Converts graphviz .dot files into .eps files | |
2153 # Grayscale is not directly supported by dot, so we pipe it through fig2dev in | |
2154 # that case. | |
2155 # $(call convert-dot,<dot file>,<eps file>,<log file>,[gray]) | |
2156 define convert-dot | |
2157 $(DOT) -Tps '$1' 2>'$3' $(if $4,| $(call kill-ps-color)) > $2; \ | |
2158 $(call colorize-dot-errors,$3) | |
2159 endef | |
2160 | |
2161 # Convert DVI to Postscript | |
2162 # $(call make-ps,<dvi file>,<ps file>,<log file>,[<paper size>]) | |
2163 make-ps = \ | |
2164 $(DVIPS) -o '$2' $(if $(filter-out BEAMER,$4),-t$(firstword $4),) '$1' \ | |
2165 $(if $(filter BEAMER,$4),| $(enlarge_beamer)) > $3 2>&1 | |
2166 | |
2167 # Convert Postscript to PDF | |
2168 # $(call make-pdf,<ps file>,<pdf file>,<log file>,<embed file>) | |
2169 make-pdf = \ | |
2170 $(call ps2pdf,$1,$2,$(filter 1,$(shell $(CAT) '$4'))) > '$3' 2>&1 | |
2171 | |
2172 # Display information about what is being done | |
2173 # $(call echo-build,<input file>,<output file>,[<run number>]) | |
2174 echo-build = $(ECHO) "$(C_BUILD)= $1 --> $2$(if $3, ($3),) =$(C_RESET)" | |
2175 echo-graphic = $(ECHO) "$(C_GRAPHIC)= $1 --> $2 =$(C_RESET)" | |
2176 echo-dep = $(ECHO) "$(C_DEP)= $1 --> $2 =$(C_RESET)" | |
2177 | |
2178 # Display a list of something | |
2179 # $(call echo-list,<values>) | |
2180 echo-list = for x in $1; do $(ECHO) "$$x"; done | |
2181 | |
2182 # | |
2183 # DEFAULT TARGET | |
2184 # | |
2185 | |
2186 .PHONY: all | |
2187 all: $(default_pdf_targets) ; | |
2188 | |
2189 .PHONY: all-pdf | |
2190 all-pdf: $(default_pdf_targets) ; | |
2191 | |
2192 ifneq "$(strip $(BUILD_STRATEGY))" "pdflatex" | |
2193 .PHONY: all-ps | |
2194 all-ps: $(default_ps_targets) ; | |
2195 | |
2196 .PHONY: all-dvi | |
2197 all-dvi: $(default_dvi_targets) ; | |
2198 endif | |
2199 | |
2200 # | |
2201 # VIEWING TARGET | |
2202 # | |
2203 .PHONY: show | |
2204 show: all | |
2205 $(QUIET)for x in $(default_pdf_targets); do \ | |
2206 [ -e "$$x" ] && $(VIEW_PDF) $$x & \ | |
2207 done | |
2208 | |
2209 # | |
2210 # INCLUDES | |
2211 # | |
2212 source_includes := $(addsuffix .d,$(source_stems_to_include)) | |
2213 graphic_includes := $(addsuffix .gpi.d,$(graphic_stems_to_include)) | |
2214 | |
2215 # Include only the dependencies used | |
2216 ifneq "" "$(source_includes)" | |
2217 include $(source_includes)$(call include-message,$(source_includes)) | |
2218 endif | |
2219 ifneq "" "$(graphic_includes)" | |
2220 include $(graphic_includes)$(call include-message,$(graphic_includes)) | |
2221 endif | |
2222 | |
2223 # | |
2224 # MAIN TARGETS | |
2225 # | |
2226 | |
2227 # Note that we don't just say %: %.pdf here - this can tend to mess up our | |
2228 # includes, which detect what kind of file we are asking for. For example, | |
2229 # asking to build foo.pdf is much different than asking to build foo when | |
2230 # foo.gpi exists, because we look through all of the goals for *.pdf that | |
2231 # matches *.gpi, then use that to determine which include files we need to | |
2232 # build. | |
2233 # | |
2234 # Thus, we invoke make recursively with better arugments instead, restarting | |
2235 # all of the appropriate machinery. | |
2236 .PHONY: $(default_stems_ss) | |
2237 $(default_stems_ss): %: %.pdf ; | |
2238 | |
2239 # This builds and displays the wanted file. | |
2240 .PHONY: $(addsuffix ._show,$(stems_ssg)) | |
2241 %._show: %.pdf | |
2242 $(QUIET)$(VIEW_PDF) $< & | |
2243 | |
2244 ifneq "$(strip $(BUILD_STRATEGY))" "pdflatex" | |
2245 .SECONDARY: $(all_pdf_targets) | |
2246 %.pdf: %.ps %.embed.make | |
2247 $(QUIET)$(call echo-build,$<,$@) | |
2248 $(QUIET)$(call make-pdf,$<,$@.temp,$@.log,$*.embed.make); \ | |
2249 if [ x"$$?" = x"0" ]; then \ | |
2250 $(if $(VERBOSE),$(CAT) $@.log,:); \ | |
2251 $(RM) -f '$@'; \ | |
2252 $(MV) '$@.temp' '$@'; \ | |
2253 $(TOUCH) '$@'; \ | |
2254 $(call copy-with-logging,$@,$(BINARY_TARGET_DIR)); \ | |
2255 else \ | |
2256 $(CAT) $@.log; \ | |
2257 $(call remove-temporary-files,'$@.temp'); \ | |
2258 $(sh_false); \ | |
2259 fi | |
2260 | |
2261 .SECONDARY: $(all_ps_targets) | |
2262 %.ps: %.dvi %.paper.make | |
2263 $(QUIET)$(call echo-build,$<,$@) | |
2264 $(QUIET)$(call make-ps,$<,$@.temp,$@.log,\ | |
2265 $(firstword $(shell $(CAT) $*.paper.make))); \ | |
2266 if [ x"$$?" = x"0" ]; then \ | |
2267 $(if $(VERBOSE),$(CAT) $@.log,:); \ | |
2268 $(RM) -f '$@'; \ | |
2269 $(MV) '$@.temp' '$@'; \ | |
2270 $(TOUCH) '$@'; \ | |
2271 $(call copy-with-logging,$@,$(BINARY_TARGET_DIR)); \ | |
2272 else \ | |
2273 $(CAT) $@.log; \ | |
2274 $(call remove-temporary-files,'$@.temp'); \ | |
2275 $(sh_false); \ | |
2276 fi | |
2277 endif | |
2278 | |
2279 # Build the final target (dvi or pdf) file. This is a very tricky rule because | |
2280 # of the way that latex runs multiple times, needs graphics after the first run | |
2281 # (or maybe already has them), and relies on bibliographies or indices that may | |
2282 # not exist. | |
2283 # | |
2284 # Check the log for fatal errors. If they exist, colorize and bail. | |
2285 # | |
2286 # Create the .auxtarget.cookie file. (Needed for next time if not present) | |
2287 # | |
2288 # If any of the following are true, we must rebuild at least one time: | |
2289 # | |
2290 # * the .bbl was recently rebuilt | |
2291 # | |
2292 # check a cookie, then delete it | |
2293 # | |
2294 # * any of several output files was created or changed: | |
2295 # | |
2296 # check $*.run.cookie, then delete it | |
2297 # | |
2298 # * the .aux file changed in a way that necessitates attention | |
2299 # | |
2300 # Note that if the .auxtarget.make file doesn't exist, this means | |
2301 # that we are doing a clean build, so it doesn't figure into the | |
2302 # test for running again. | |
2303 # | |
2304 # compare against .auxtarget.make | |
2305 # | |
2306 # move if different, remove if not | |
2307 # | |
2308 # * the .log file has errors or warnings requiring at least one more run | |
2309 # | |
2310 # We use a loop over a single item to simplify the process of breaking | |
2311 # out when we find one of the conditions to be true. | |
2312 # | |
2313 # If we do NOT need to run latex here, then we move the $@.1st.make file | |
2314 # over to $@ because the target file has already been built by the first | |
2315 # dependency run and is valid. | |
2316 # | |
2317 # If we do, we delete that cookie file and do the normal multiple-runs | |
2318 # routine. | |
2319 # | |
2320 ifneq "$(strip $(BUILD_STRATEGY))" "pdflatex" | |
2321 .SECONDARY: $(all_dvi_targets) | |
2322 endif | |
2323 %.$(build_target_extension): %.bbl %.aux %.$(build_target_extension).1st.make | |
2324 $(QUIET)\ | |
2325 fatal=`$(call colorize-latex-errors,$*.log)`; \ | |
2326 if [ x"$$fatal" != x"" ]; then \ | |
2327 $(ECHO) "$$fatal"; \ | |
2328 exit 1; \ | |
2329 fi; \ | |
2330 $(call make-auxtarget-file,$*.aux.make,$*.auxtarget.cookie); \ | |
2331 run=0; \ | |
2332 for i in 1; do \ | |
2333 if $(call test-exists,$*.bbl.cookie); then \ | |
2334 run=1; \ | |
2335 break; \ | |
2336 fi; \ | |
2337 if $(call test-exists,$*.run.cookie); then \ | |
2338 run=1; \ | |
2339 break; \ | |
2340 fi; \ | |
2341 if $(call \ | |
2342 test-exists-and-different,$*.auxtarget.cookie,$*.auxtarget.make);\ | |
2343 then \ | |
2344 run=1; \ | |
2345 break; \ | |
2346 fi; \ | |
2347 if $(call test-log-for-need-to-run,$*); then \ | |
2348 run=1; \ | |
2349 break; \ | |
2350 fi; \ | |
2351 done; \ | |
2352 $(call remove-temporary-files,$*.bbl.cookie $*.run.cookie); \ | |
2353 $(MV) $*.auxtarget.cookie $*.auxtarget.make; \ | |
2354 if [ x"$$run" = x"1" ]; then \ | |
2355 $(call remove-files,$@.1st.make); \ | |
2356 for i in 2 3 4 5; do \ | |
2357 $(if $(findstring 3.79,$(MAKE_VERSION)),\ | |
2358 $(call echo-build,$*.tex,$@,$(RESTARTS)-$$$$i),\ | |
2359 $(call echo-build,$*.tex,$@,$(RESTARTS)-$$i)\ | |
2360 ); \ | |
2361 $(call run-latex,$*); \ | |
2362 $(CP) '$*.log' '$*.'$(RESTARTS)-$$i'.log'; \ | |
2363 $(call test-run-again,$*) || break; \ | |
2364 done; \ | |
2365 else \ | |
2366 $(MV) '$@.1st.make' '$@'; \ | |
2367 fi; \ | |
2368 $(call copy-with-logging,$@,$(BINARY_TARGET_DIR)); \ | |
2369 $(call latex-color-log,$*) | |
2370 | |
2371 # Build the .bbl file. When dependencies are included, this will (or will | |
2372 # not!) depend on something.bib, which we detect, acting accordingly. The | |
2373 # dependency creation also produces the %.auxbbl.make file. BibTeX is a bit | |
2374 # finicky about what you call the actual files, but we can rest assured that if | |
2375 # a .auxbbl.make file exists, then the .aux file does, as well. The | |
2376 # .auxbbl.make file is a cookie indicating whether the .bbl needs to be | |
2377 # rewritten. It only changes if the .aux file changes in ways relevant to .bbl | |
2378 # creation. | |
2379 # | |
2380 # Note that we do NOT touch the .bbl file if there is no need to | |
2381 # create/recreate it. We would like to leave existing files alone if they | |
2382 # don't need to be changed, thus possibly avoiding a rebuild trigger. | |
2383 %.bbl: %.auxbbl.make | |
2384 $(QUIET)\ | |
2385 $(if $(filter %.bib,$^),\ | |
2386 $(call echo-build,$(filter %.bib,$?) $*.aux,$@); \ | |
2387 $(call run-bibtex,$*); \ | |
2388 $(TOUCH) $@.cookie; \ | |
2389 ) \ | |
2390 if $(EGREP) -q 'bibstyle.(apacann|chcagoa|[^}]*annot)' '$*.aux'; then \ | |
2391 $(call echo-build,** annotated extra latex **,output ignored,$(RESTARTS)-1); \ | |
2392 $(call run-latex,$*); \ | |
2393 $(CP) '$*.log' '$*.$(RESTARTS)-annotated.log'; \ | |
2394 $(if $(filter %.bib,$^),\ | |
2395 $(call echo-build,** annotated extra bibtex ** $(filter %.bib,$?) $*.aux,$@); \ | |
2396 $(call run-bibtex,$*); \ | |
2397 $(TOUCH) $@.cookie; \ | |
2398 ) \ | |
2399 $(call echo-build,** annotated extra latex **,output ignored,$(RESTARTS)-2); \ | |
2400 $(call run-latex,$*); \ | |
2401 fi | |
2402 | |
2403 # Create the index file - note that we do *not* depend on %.tex here, since | |
2404 # that unnecessarily restricts the kinds of indices that we can build to those | |
2405 # with exactly the same stem as the source file. Things like splitidx create | |
2406 # idx files with other names. | |
2407 # | |
2408 # Therefore, we add the .tex dependency in the sourcestem.d file in the call to | |
2409 # get index file dependencies from the logs. | |
2410 %.ind: %.idx | |
2411 $(QUIET)$(call echo-build,$<,$@) | |
2412 $(QUIET)$(call run-makeindex,$<,$@,$*.ilg) | |
2413 | |
2414 # Create the glossary file | |
2415 %.gls: %.glo %.tex | |
2416 $(QUIET)$(call echo-build,$<,$@) | |
2417 $(QUIET)$(call run-makeindex,$<,$@,$*.glg,-s nomencl.ist) | |
2418 | |
2419 # Create the nomenclature file | |
2420 %.nls: %.nlo %.tex | |
2421 $(QUIET)$(call echo-build,$<,$@) | |
2422 $(QUIET)$(call run-makeindex,$<,$@,$*.nlg,-s nomencl.ist) | |
2423 | |
2424 # SCRIPTED LaTeX TARGETS | |
2425 # | |
2426 # Keep the generated .tex files around for debugging if needed. | |
2427 .SECONDARY: $(all_tex_targets) | |
2428 | |
2429 %.tex:: %.tex.sh | |
2430 $(QUIET)$(call run-script,$(SHELL),$<,$@) | |
2431 | |
2432 %.tex:: %.tex.py | |
2433 $(QUIET)$(call run-script,$(PYTHON),$<,$@) | |
2434 | |
2435 %.tex:: %.tex.pl | |
2436 $(QUIET)$(call run-script,$(PERL),$<,$@) | |
2437 | |
2438 %.tex:: %.rst $(RST_STYLE_FILE) | |
2439 $(QUIET)\ | |
2440 $(call run-script,$(RST2LATEX)\ | |
2441 --documentoptions=letterpaper\ | |
2442 $(if $(RST_STYLE_FILE),--stylesheet=$(RST_STYLE_FILE),),$<,$@) | |
2443 | |
2444 # | |
2445 # GRAPHICS TARGETS | |
2446 # | |
2447 .PHONY: all-graphics | |
2448 all-graphics: $(all_graphics_targets); | |
2449 | |
2450 ifneq "$(strip $(BUILD_STRATEGY))" "pdflatex" | |
2451 .PHONY: all-pstex | |
2452 all-pstex: $(all_pstex_targets); | |
2453 endif | |
2454 | |
2455 .PHONY: all-dot2tex | |
2456 all-dot2tex: $(all_dot2tex_targets); | |
2457 | |
2458 .PHONY: show-graphics | |
2459 show-graphics: all-graphics | |
2460 $(VIEW_GRAPHICS) $(all_known_graphics) | |
2461 | |
2462 $(gray_eps_file): | |
2463 $(QUIET)$(call echo-build,$^,$@) | |
2464 $(QUIET)$(call create-gray-eps-file,$@) | |
2465 | |
2466 ifeq "$(strip $(BUILD_STRATEGY))" "pdflatex" | |
2467 %.pdf: %.eps $(if $(GRAY),$(gray_eps_file)) | |
2468 $(QUIET)$(call echo-graphic,$^,$@) | |
2469 $(QUIET)$(call convert-eps-to-pdf,$<,$@,$(GRAY)) | |
2470 | |
2471 ifeq "$(strip $(GNUPLOT_OUTPUT_EXTENSION))" "pdf" | |
2472 %.pdf: %.gpi %.gpi.d $(gpi_sed) | |
2473 $(QUIET)$(call echo-graphic,$^,$@) | |
2474 $(QUIET)$(call convert-gpi,$<,$@,$(GRAY)) | |
2475 endif | |
2476 | |
2477 %.pdf: %.fig | |
2478 $(QUIET)$(call echo-graphic,$^,$@) | |
2479 $(QUIET)$(call convert-fig,$<,$@,$(GRAY)) | |
2480 | |
2481 endif | |
2482 | |
2483 %.eps: %.gpi %.gpi.d $(gpi_sed) | |
2484 $(QUIET)$(call echo-graphic,$^,$@) | |
2485 $(QUIET)$(call convert-gpi,$<,$@,$(GRAY)) | |
2486 | |
2487 %.eps: %.fig | |
2488 $(QUIET)$(call echo-graphic,$^,$@) | |
2489 $(QUIET)$(call convert-fig,$<,$@,$(GRAY)) | |
2490 | |
2491 %.eps: %.dot $(if $(GRAY),$(gray_eps_file)) | |
2492 $(QUIET)$(call echo-graphic,$^,$@) | |
2493 $(QUIET)$(call convert-dot,$<,$@,$<.log,$(GRAY)) | |
2494 | |
2495 %.eps: %.xvg $(if $(GRAY),$(gray_eps_file)) | |
2496 $(QUIET)$(call echo-graphic,$^,$@) | |
2497 $(QUIET)$(call convert-xvg,$<,$@,$(GRAY)) | |
2498 | |
2499 %.eps: %.svg $(if $(GRAY),$(gray_eps_file)) | |
2500 $(QUIET)$(call echo-graphic,$^,$@) | |
2501 $(QUIET)$(call convert-svg,$<,$@,$(GRAY)) | |
2502 | |
2503 %.eps: %.jpg $(if $(GRAY),$(gray_eps_file)) | |
2504 $(QUIET)$(call echo-graphic,$^,$@) | |
2505 $(QUIET)$(call convert-jpg,$<,$@,$(GRAY)) | |
2506 | |
2507 %.eps: %.png $(if $(GRAY),$(gray_eps_file)) | |
2508 $(QUIET)$(call echo-graphic,$^,$@) | |
2509 $(QUIET)$(call convert-png,$<,$@,$(GRAY)) | |
2510 | |
2511 %.eps: %.eps.gz $(if $(GRAY),$(gray_eps_file)) | |
2512 $(QUIET)$(call echo-graphic,$^,$@) | |
2513 $(QUIET)$(call convert-epsgz,$<,$@,$(GRAY)) | |
2514 | |
2515 %.pstex: %.fig | |
2516 $(QUIET)$(call echo-graphic,$^,$@) | |
2517 $(QUIET)$(call convert-fig-pstex,$<,$@,$(GRAY)) | |
2518 | |
2519 %.pstex_t: %.fig %.pstex | |
2520 $(QUIET)$(call echo-graphic,$^,$@) | |
2521 $(QUIET)$(call convert-fig-pstex-t,$<,$@,$*.pstex,$(GRAY)) | |
2522 | |
2523 %.dot_t: %.dot | |
2524 $(QUIET)$(call echo-graphic,$^,$@) | |
2525 $(QUIET)$(call convert-dot-tex,$<,$@) | |
2526 | |
2527 # | |
2528 # DEPENDENCY-RELATED TARGETS. | |
2529 # | |
2530 | |
2531 # Generate all of the information needed to get dependencies | |
2532 # As a side effect, this creates a .dvi or .pdf file (depending on the build | |
2533 # strategy). We need to be sure to remove it if there are errors. Errors can | |
2534 # take several forms and all of them are found within the log file: | |
2535 # * There was a LaTeX error | |
2536 # * A needed file was not found | |
2537 # * Cross references need adjustment | |
2538 # | |
2539 # Behavior: | |
2540 # This rule is responsible for generating the following: | |
2541 # %.aux | |
2542 # %.d | |
2543 # %.aux.make | |
2544 # %.(pdf|dvi).1st.make (the .pdf or .dvi output file, moved) | |
2545 # | |
2546 # Steps: | |
2547 # | |
2548 # Run latex | |
2549 # Move .pdf or .dvi somewhere else (make no judgements about success) | |
2550 # Flatten the .aux file into another file | |
2551 # Add source dependencies | |
2552 # Add graphic dependencies | |
2553 # Add bib dependencies | |
2554 # | |
2555 # Create cookies for various suffixes that may represent files that | |
2556 # need to be read by LaTeX in order for it to function properly. | |
2557 # | |
2558 # Note that if some of the dependencies are discovered because they turn | |
2559 # up missing in the log file, we really need the .d file to be reloaded. | |
2560 # Adding a sleep command helps with this. Otherwise make is extremely | |
2561 # nondeterministic, sometimes working, sometimes not. | |
2562 # | |
2563 # Usually we can force this by simply removing the generated pdf file and | |
2564 # not creating a .1st.make file.. | |
2565 # | |
2566 %.$(build_target_extension).1st.make %.d %.aux %.aux.make %.fls: %.tex | |
2567 $(QUIET)$(call echo-build,$<,$*.d $*.$(build_target_extension).1st.make,$(RESTARTS)-1) | |
2568 $(QUIET)\ | |
2569 $(call run-latex,$<,--recorder) || $(sh_true); \ | |
2570 $(CP) '$*.log' '$*.$(RESTARTS)-1.log'; \ | |
2571 $(call die-on-dot2tex,$*.log); \ | |
2572 $(call die-on-no-aux,$*); \ | |
2573 $(call flatten-aux,$*.aux,$*.aux.make); \ | |
2574 $(ECHO) "# vim: ft=make" > $*.d; \ | |
2575 $(ECHO) ".PHONY: $*._graphics" >> $*.d; \ | |
2576 $(call get-inputs,$*.fls,$(addprefix $*.,aux aux.make d $(build_target_extension))) >> $*.d; \ | |
2577 $(call get-missing-inputs,$*.log,$(addprefix $*.,aux aux.make d $(build_target_extension))) >> $*.d; \ | |
2578 $(ECHO) ".SECONDEXPANSION:" >> $*.d; \ | |
2579 $(call get-graphics,$*) >> $*.d; \ | |
2580 $(call get-log-index,$*,$(addprefix $*.,d aux aux.make)) >> $*.d; \ | |
2581 $(call get-bibs,$*.aux.make,$(addprefix $*.,bbl aux aux.make)) >> $*.d; \ | |
2582 $(EGREP) -q "# MISSING" $*.d && $(SLEEP) 1 && $(RM) $*.pdf; \ | |
2583 $(call move-if-exists,$*.$(build_target_extension),$*.$(build_target_extension).1st.make); \ | |
2584 for s in toc out lot lof lol nav; do \ | |
2585 if [ -e "$*.$$s" ]; then \ | |
2586 if ! $(DIFF) -q $*.$$s $*.$$s.make >/dev/null 2>&1; then \ | |
2587 $(TOUCH) $*.run.cookie; \ | |
2588 fi; \ | |
2589 $(CP) $*.$$s $*.$$s.make; \ | |
2590 fi; \ | |
2591 done | |
2592 | |
2593 # This is a cookie that is updated if the flattened aux file has changed in a | |
2594 # way that affects the bibliography generation. | |
2595 .SECONDARY: $(addsuffix .auxbbl.make,$(stems_ssg)) | |
2596 %.auxbbl.make: %.aux.make | |
2597 $(QUIET)\ | |
2598 $(call make-auxbbl-file,$<,$@.temp); \ | |
2599 $(call replace-if-different-and-remove,$@.temp,$@) | |
2600 | |
2601 # Build a dependency file for .gpi files. These often plot data files that | |
2602 # also reside in the directory, so if a data file changes, it's nice to know | |
2603 # about it. This also handles loaded .gpi files, whose filename should have | |
2604 # _include_. in it. | |
2605 %.gpi.d: %.gpi | |
2606 $(QUIET)$(call echo-build,$<,$@) | |
2607 $(QUIET)$(call make-gpi-d,$<,$@) | |
2608 | |
2609 # Store the paper size for this document -- note that if beamer is used we set | |
2610 # it to the special BEAMER paper size. We only do this, however, if the | |
2611 # special comment exists, in which case we enlarge the output with psnup. | |
2612 # | |
2613 # The paper size is extracted from a documentclass attribute. | |
2614 %.paper.make: %.tex | |
2615 $(QUIET)$(SED) \ | |
2616 -e '/\\documentclass/,/}/{' \ | |
2617 -e ' s/%.*//' \ | |
2618 -e ' H' \ | |
2619 -e ' /}/{' \ | |
2620 -e ' s/.*//' \ | |
2621 -e ' x' \ | |
2622 -e ' /\\documentclass/!d' \ | |
2623 -e ' s/[\n[:space:]]*//g' \ | |
2624 -e ' s/\([,{[]\)\([[:alnum:]]\{1,\}\)paper\([],}]\)/\1%-\2-%\3/g' \ | |
2625 -e ' s/\([,{[]\)\(landscape\)\([],}]\)/\1%-\2-%\3/g' \ | |
2626 -e ' s/^[^%]*%-//' \ | |
2627 -e ' s/-%[^%]*$$//' \ | |
2628 -e ' s/-%[^%]%-/ /g' \ | |
2629 -e ' p' \ | |
2630 -e ' }' \ | |
2631 -e ' d' \ | |
2632 -e '}' \ | |
2633 -e 'd' \ | |
2634 $< > $@; \ | |
2635 $(EGREP) -q '^[^%]*\\documentclass[^{]*{beamer}' $< && \ | |
2636 (\ | |
2637 $(EGREP) -q '^%%[[:space:]]*BEAMER[[:space:]]*LARGE$$' $< && \ | |
2638 $(ECHO) "BEAMER" > $@ || \ | |
2639 : > $@ \ | |
2640 ) || $(sh_true) | |
2641 | |
2642 # Store embedding instructions for this document using a special comment | |
2643 %.embed.make: %.tex | |
2644 $(QUIET)$(EGREP) '^%%[[:space:]]*NO[[:space:]]*EMBED[[:space:]]*$$' $< \ | |
2645 && $(ECHO) '' > $@ \ | |
2646 || $(ECHO) '1' > $@; | |
2647 | |
2648 # | |
2649 # HELPFUL PHONY TARGETS | |
2650 # | |
2651 | |
2652 .PHONY: _all_programs | |
2653 _all_programs: | |
2654 $(QUIET)$(ECHO) "== All External Programs Used ==" | |
2655 $(QUIET)$(call output-all-programs) | |
2656 | |
2657 .PHONY: _check_programs | |
2658 _check_programs: | |
2659 $(QUIET)$(ECHO) "== Checking Makefile Dependencies =="; $(ECHO) | |
2660 $(QUIET) \ | |
2661 $(ECHO) hi; \ | |
2662 allprogs=`\ | |
2663 ($(call output-all-programs)) | \ | |
2664 $(SED) \ | |
2665 -e 's/^[[:space:]]*//' \ | |
2666 -e '/^#/d' \ | |
2667 -e 's/[[:space:]]*#.*//' \ | |
2668 -e '/^=/s/[[:space:]]/_/g' \ | |
2669 -e '/^[[:space:]]*$$/d' \ | |
2670 -e 's/^[^=].*=[[:space:]]*\([^[:space:]]\{1,\}\).*$$/\\1/' \ | |
2671 `; \ | |
2672 spaces=' '; \ | |
2673 for p in $${allprogs}; do \ | |
2674 case $$p in \ | |
2675 =*) $(ECHO); $(ECHO) "$$p";; \ | |
2676 *) \ | |
2677 $(ECHO) -n "$$p:$$spaces" | $(SED) -e 's/^\(.\{0,20\}\).*$$/\1/'; \ | |
2678 loc=`$(WHICH) $$p`; \ | |
2679 if [ x"$$?" = x"0" ]; then \ | |
2680 $(ECHO) "$(C_SUCCESS)Found:$(C_RESET) $$loc"; \ | |
2681 else \ | |
2682 $(ECHO) "$(C_FAILURE)Not Found$(C_RESET)"; \ | |
2683 fi; \ | |
2684 ;; \ | |
2685 esac; \ | |
2686 done | |
2687 | |
2688 .PHONY: _check_gpi_files | |
2689 _check_gpi_files: | |
2690 $(QUIET)$(ECHO) "== Checking all .gpi files for common errors =="; \ | |
2691 $(ECHO); \ | |
2692 for f in $(files.gpi); do \ | |
2693 result=`$(EGREP) '^([^#]*set terminal |set output )' $$f`; \ | |
2694 $(ECHO) -n "$$f: "; \ | |
2695 if [ x"$$result" = x"" ]; then \ | |
2696 $(ECHO) "$(C_SUCCESS)Okay$(C_RESET)"; \ | |
2697 else \ | |
2698 $(ECHO) "$(C_FAILURE)Warning: Problematic commands:$(C_RESET)";\ | |
2699 $(ECHO) "$(C_ERROR)$$result$(C_RESET)"; \ | |
2700 fi; \ | |
2701 done; \ | |
2702 $(ECHO) | |
2703 | |
2704 .PHONY: _all_stems | |
2705 _all_stems: | |
2706 $(QUIET)$(ECHO) "== All Stems ==" | |
2707 $(QUIET)$(call echo-list,$(sort $(default_stems_ss))) | |
2708 | |
2709 .PHONY: _includes | |
2710 _includes: | |
2711 $(QUIET)$(ECHO) "== Include Stems ==" | |
2712 $(QUIET)$(ECHO) "=== Sources ===" | |
2713 $(QUIET)$(call echo-list,$(sort $(source_includes))) | |
2714 $(QUIET)$(ECHO) "=== Graphics ===" | |
2715 $(QUIET)$(call echo-list,$(sort $(graphic_includes))) | |
2716 | |
2717 .PHONY: _all_sources | |
2718 _all_sources: | |
2719 $(QUIET)$(ECHO) "== All Sources ==" | |
2720 $(QUIET)$(call echo-list,$(sort $(all_files.tex))) | |
2721 | |
2722 .PHONY: _dependency_graph | |
2723 _dependency_graph: | |
2724 $(QUIET)$(ECHO) "/* LaTeX Dependency Graph */" | |
2725 $(QUIET)$(call output-dependency-graph) | |
2726 | |
2727 .PHONY: _show_dependency_graph | |
2728 _show_dependency_graph: | |
2729 $(QUIET)$(call output-dependency-graph,$(graph_stem).dot) | |
2730 $(QUIET)$(DOT) -Tps -o $(graph_stem).eps $(graph_stem).dot | |
2731 $(QUIET)$(VIEW_POSTSCRIPT) $(graph_stem).eps | |
2732 $(QUIET)$(call remove-temporary-files,$(graph_stem).*) | |
2733 | |
2734 .PHONY: _sources | |
2735 _sources: | |
2736 $(QUIET)$(ECHO) "== Sources ==" | |
2737 $(QUIET)$(call echo-list,$(sort $(files.tex))) | |
2738 | |
2739 .PHONY: _scripts | |
2740 _scripts: | |
2741 $(QUIET)$(ECHO) "== Scripts ==" | |
2742 $(QUIET)$(call echo-list,$(sort $(files_scripts))) | |
2743 | |
2744 .PHONY: _graphic_outputs | |
2745 _graphic_outputs: | |
2746 $(QUIET)$(ECHO) "== Graphic Outputs ==" | |
2747 $(QUIET)$(call echo-list,$(sort $(all_graphics_targets))) | |
2748 | |
2749 .PHONY: _env | |
2750 _env: | |
2751 ifdef .VARIABLES | |
2752 $(QUIET)$(ECHO) "== MAKE VARIABLES ==" | |
2753 $(QUIET)$(call echo-list,$(foreach var,$(sort $(.VARIABLES)),'$(var)')) | |
2754 endif | |
2755 $(QUIET)$(ECHO) "== ENVIRONMENT ==" | |
2756 $(QUIET)$(ENV) | |
2757 | |
2758 # | |
2759 # CLEAN TARGETS | |
2760 # | |
2761 # clean-generated is somewhat unique - it relies on the .fls file being | |
2762 # properly built so that it can determine which of the files was generated, and | |
2763 # which was not. Expect it to silently fail if the .fls file is missing. | |
2764 # | |
2765 # This is used to, e.g., clean up index files that are generated by the LaTeX. | |
2766 .PHONY: clean-generated | |
2767 clean-generated: | |
2768 $(QUIET)$(call clean-files,$(foreach e,$(addsuffix .fls,$(all_stems_source)),\ | |
2769 $(shell $(call get-generated-names,$e)))) | |
2770 | |
2771 .PHONY: clean-deps | |
2772 clean-deps: | |
2773 $(QUIET)$(call clean-files,$(all_d_targets) *.make *.make.temp *.cookie) | |
2774 | |
2775 .PHONY: clean-tex | |
2776 clean-tex: clean-deps | |
2777 $(QUIET)$(call clean-files,$(rm_tex)) | |
2778 | |
2779 .PHONY: clean-graphics | |
2780 # TODO: This *always* deletes pstex files, even if they were not generated by | |
2781 # anything.... In other words, if you create a pstex and pstex_t pair by hand | |
2782 # an drop them in here without the generating fig file, they will be deleted | |
2783 # and you won't get them back. It's a hack put in here because I'm not sure we | |
2784 # even want to keep pstex functionality, so my motivation is not terribly high | |
2785 # for doing it right. | |
2786 clean-graphics: | |
2787 $(QUIET)$(call clean-files,$(all_graphics_targets) $(intermediate_graphics_targets) *.gpi.d *.pstex *.pstex_t *.dot_t) | |
2788 | |
2789 .PHONY: clean-backups | |
2790 clean-backups: | |
2791 $(QUIET)$(call clean-files,$(backup_patterns) *.temp) | |
2792 | |
2793 .PHONY: clean-auxiliary | |
2794 clean-auxiliary: | |
2795 $(QUIET)$(call clean-files,$(graph_stem).*) | |
2796 | |
2797 .PHONY: clean-nographics | |
2798 clean-nographics: clean-tex clean-deps clean-backups clean-auxiliary ; | |
2799 | |
2800 .PHONY: clean | |
2801 clean: clean-generated clean-tex clean-graphics clean-deps clean-backups clean-auxiliary | |
2802 | |
2803 # | |
2804 # HELP TARGETS | |
2805 # | |
2806 | |
2807 .PHONY: help | |
2808 help: | |
2809 $(help_text) | |
2810 | |
2811 .PHONY: version | |
2812 version: | |
2813 $(QUIET)\ | |
2814 $(ECHO) "$(fileinfo) Version $(version)"; \ | |
2815 $(ECHO) "by $(author)"; \ | |
2816 | |
2817 # | |
2818 # HELP TEXT | |
2819 # | |
2820 | |
2821 define help_text | |
2822 # $(fileinfo) Version $(version) | |
2823 # | |
2824 # by $(author) | |
2825 # | |
2826 # Generates a number of possible output files from a LaTeX document and its | |
2827 # various dependencies. Handles .bib files, \include and \input, and .eps | |
2828 # graphics. All dependencies are handled automatically by running LaTeX over | |
2829 # the source. | |
2830 # | |
2831 # USAGE: | |
2832 # | |
2833 # make [GRAY=1] [VERBOSE=1] [SHELL_DEBUG=1] <target(s)> | |
2834 # | |
2835 # STANDARD OPTIONS: | |
2836 # GRAY: | |
2837 # Setting this variable forces all recompiled graphics to be grayscale. | |
2838 # It is useful when creating a document for printing. The default is | |
2839 # to allow colors. Note that it only changes graphics that need to be | |
2840 # rebuilt! It is usually a good idea to do a 'make clean' first. | |
2841 # | |
2842 # VERBOSE: | |
2843 # This turns off all @ prefixes for commands invoked by make. Thus, | |
2844 # you get to see all of the gory details of what is going on. | |
2845 # | |
2846 # SHELL_DEBUG: | |
2847 # This enables the -x option for sh, meaning that everything it does is | |
2848 # echoed to stderr. This is particularly useful for debugging | |
2849 # what is going on in $$(shell ...) invocations. One of my favorite | |
2850 # debugging tricks is to do this: | |
2851 # | |
2852 # make -d SHELL_DEBUG=1 VERBOSE=1 2>&1 | less | |
2853 # | |
2854 # STANDARD AUXILIARY FILES: | |
2855 # | |
2856 # Makefile.ini | |
2857 # | |
2858 # This file can contain variable declarations that override various | |
2859 # aspects of the makefile. For example, one might specify | |
2860 # | |
2861 # neverclean := *.pdf *.ps | |
2862 # onlysources.tex := main.tex | |
2863 # LATEX_COLOR_WARNING := 'bold red uline' | |
2864 # | |
2865 # And this would override the neverclean setting to ensure that pdf | |
2866 # and ps files always remain behind, set the makefile to treat all | |
2867 # .tex files that are not "main.tex" as includes (and therefore not | |
2868 # default targets). It also changes the LaTeX warning output to be | |
2869 # red, bold, and underlined. | |
2870 # | |
2871 # There are numerous variables in this file that can be overridden in | |
2872 # this way. Search for '?=' to find them all. | |
2873 # | |
2874 # Also, you can put arbitrary targets into it if, for example, you | |
2875 # want your source built from something else, e.g.: | |
2876 # | |
2877 # generated.tex: generating_script.weird_lang depA depB | |
2878 # ./generating_script.weird_lang > $$@ | |
2879 # | |
2880 # Note that if you are not careful, you can override the default | |
2881 # target (what happens when you type "make" without arguments), so if | |
2882 # you do use Makefile.ini, you probably want to start it with | |
2883 # something like the following line: | |
2884 # | |
2885 # default: all | |
2886 # | |
2887 # Since the first target in any makefile is automatically the default, | |
2888 # and the makefile already has a sensible "all" target, this will do | |
2889 # what you want. | |
2890 # | |
2891 # The Makefile.ini is imported before *anything else* is done, so go | |
2892 # wild with your ideas for changes to this makefile in there. It | |
2893 # makes it easy to test them before submitting patches. | |
2894 # | |
2895 # STANDARD ENVIRONMENT VARIABLES: | |
2896 # | |
2897 # LATEX_COLOR_WARNING '$(LATEX_COLOR_WARNING)' | |
2898 # LATEX_COLOR_ERROR '$(LATEX_COLOR_ERROR)' | |
2899 # LATEX_COLOR_UNDERFULL '$(LATEX_COLOR_UNDERFULL)' | |
2900 # LATEX_COLOR_OVERFULL '$(LATEX_COLOR_OVERFULL)' | |
2901 # LATEX_COLOR_PAGES '$(LATEX_COLOR_PAGES)' | |
2902 # LATEX_COLOR_BUILD '$(LATEX_COLOR_BUILD)' | |
2903 # LATEX_COLOR_GRAPHIC '$(LATEX_COLOR_GRAPHIC)' | |
2904 # LATEX_COLOR_DEP '$(LATEX_COLOR_DEP)' | |
2905 # LATEX_COLOR_SUCCESS '$(LATEX_COLOR_SUCCESS)' | |
2906 # LATEX_COLOR_FAILURE '$(LATEX_COLOR_FAILURE)' | |
2907 # | |
2908 # These may be redefined in your environment to be any of the following: | |
2909 # | |
2910 # black | |
2911 # red | |
2912 # green | |
2913 # yellow | |
2914 # blue | |
2915 # magenta | |
2916 # cyan | |
2917 # white | |
2918 # | |
2919 # Bold or underline may be used, as well, either alone or in combination | |
2920 # with colors: | |
2921 # | |
2922 # bold | |
2923 # uline | |
2924 # | |
2925 # Order is not important. You may want, for example, to specify: | |
2926 # | |
2927 # export LATEX_COLOR_SUCCESS='bold blue uline' | |
2928 # | |
2929 # in your .bashrc file. I don't know why, but you may want to. | |
2930 # | |
2931 # STANDARD TARGETS: | |
2932 # | |
2933 # all: | |
2934 # Make all possible documents in this directory. The documents are | |
2935 # determined by scanning for .tex and .tex.sh (described in more detail | |
2936 # later) and omitting any file that ends in ._include_.tex or | |
2937 # ._nobuild_.tex. The output is a set of .pdf files. | |
2938 # | |
2939 # If you wish to omit files without naming them with the special | |
2940 # underscore names, set the following near the top of the Makefile, | |
2941 # or (this is recommended) within a Makefile.ini in the same directory: | |
2942 # | |
2943 # includes.tex := file1.tex file2.tex | |
2944 # | |
2945 # This will cause the files listed to be considered as include files. | |
2946 # | |
2947 # If you have only few source files, you can set | |
2948 # | |
2949 # onlysources.tex := main.tex | |
2950 # | |
2951 # This will cause only the source files listed to be considered in | |
2952 # dependency detection. All other .tex files will be considered as | |
2953 # include files. Note that these options work for *any* source type, | |
2954 # so you could do something similar with includes.gpi, for example. | |
2955 # Note that this works for *any valid source* target. All of the | |
2956 # onlysources.* variables are commented out in the shipping version of | |
2957 # this file, so it does the right thing when they simply don't exist. | |
2958 # The comments are purely documentation. If you know, for example, that | |
2959 # file.mycoolformat is supported by this Makefile, but don't see the | |
2960 # "onlysources.mycoolformat" declared in the comments, that doesn't mean | |
2961 # you can't use it. Go ahead and set "onlysources.mycoolformat" and it | |
2962 # should do the right thing. | |
2963 # | |
2964 # show: | |
2965 # Builds and displays all documents in this directory. It uses the | |
2966 # environment-overridable value of VIEW_PDF (currently $(VIEW_PDF)) to | |
2967 # do its work. | |
2968 # | |
2969 # all-graphics: | |
2970 # Make all of the graphics in this directory. | |
2971 # | |
2972 # all-pstex (only for BUILD_STRATEGY=latex): | |
2973 # Build all fig files into pstex and pstex_t files. Gray DOES NOT WORK. | |
2974 # | |
2975 # all-gray-pstex (only for BUILD_STRATEGY=latex): | |
2976 # Build all fig files into grayscale pstex and pstex_t files. | |
2977 # | |
2978 # all-dot2tex: | |
2979 # Build all dot files into tex files. | |
2980 # | |
2981 # show-graphics: | |
2982 # Builds and displays all graphics in this directory. Uses the | |
2983 # environment-overridable value of VIEW_GRAPHICS (currently | |
2984 # $(VIEW_GRAPHICS)) to do its work. | |
2985 # | |
2986 # clean: | |
2987 # Remove ALL generated files, leaving only source intact. | |
2988 # This will *always* skip files mentioned in the "neverclean" variable, | |
2989 # either in this file or specified in Makefile.ini: | |
2990 # | |
2991 # neverclean := *.pdf *.ps | |
2992 # | |
2993 # The neverclean variable works on all "clean" targets below, as well. | |
2994 # | |
2995 # clean-graphics: | |
2996 # Remove all generated graphics files. | |
2997 # | |
2998 # clean-backups: | |
2999 # Remove all backup files: $(backup_patterns) | |
3000 # (XFig and other editors have a nasty habit of leaving them around) | |
3001 # Also removes Makefile-generated .temp files | |
3002 # | |
3003 # clean-tex: | |
3004 # Remove all files generated from LaTeX invocations except dependency | |
3005 # information. Leaves graphics alone. | |
3006 # | |
3007 # clean-deps: | |
3008 # Removes all auto-generated dependency information. | |
3009 # | |
3010 # clean-auxiliary: | |
3011 # Removes extra files created by various targets (like the dependency | |
3012 # graph output). | |
3013 # | |
3014 # clean-nographics: | |
3015 # Cleans everything *except* the graphics files. | |
3016 # | |
3017 # help: | |
3018 # This help text. | |
3019 # | |
3020 # version: | |
3021 # Version information about this LaTeX makefile. | |
3022 # | |
3023 # DEBUG TARGETS: | |
3024 # | |
3025 # _all_programs: | |
3026 # A list of the programs used by this makefile. | |
3027 # | |
3028 # _check_programs: | |
3029 # Checks your system for the needed software and reports what it finds. | |
3030 # | |
3031 # _check_gpi_files: | |
3032 # Checks the .gpi files in the current directory for common errors, such | |
3033 # as specification of the terminal or output file inside of the gpi file | |
3034 # itself. | |
3035 # | |
3036 # _dependency_graph: | |
3037 # Outputs a .dot file to stdout that represents a graph of LaTeX | |
3038 # dependencies. To see it, use the _show_dependency_graph target or | |
3039 # direct the output to a file, run dot on it, and view the output, e.g.: | |
3040 # | |
3041 # make _dependency_graph > graph.dot | |
3042 # dot -T ps -o graph.eps graph.dot | |
3043 # gv graph.eps | |
3044 # | |
3045 # _show_dependency_graph: | |
3046 # Makes viewing the graph simple: extracts, builds and displays the | |
3047 # dependency graph given in the _dependency_graph target using the value | |
3048 # of the environment-overridable VIEW_POSTSCRIPT variable (currently set | |
3049 # to $(VIEW_POSTSCRIPT)). The postscript viewer is used because it | |
3050 # makes it easier to zoom in on the graph, a critical ability for | |
3051 # something so dense and mysterious. | |
3052 # | |
3053 # _all_sources: | |
3054 # List all .tex files in this directory. | |
3055 # | |
3056 # _sources: | |
3057 # Print out a list of all compilable sources in this directory. This is | |
3058 # useful for determining what make thinks it will be using as the | |
3059 # primary source for 'make all'. | |
3060 # | |
3061 # _scripts: | |
3062 # Print out a list of scripts that make knows can be used to generate | |
3063 # .tex files (described later). | |
3064 # | |
3065 # _all_stems: | |
3066 # Print a list of stems. These represent bare targets that can be | |
3067 # executed. Listing <stem> as a bare target will produce <stem>.pdf. | |
3068 # | |
3069 # _includes: | |
3070 # A list of .d files that would be included in this run if _includes | |
3071 # weren't specified. This target may be used alone or in conjunction | |
3072 # with other targets. | |
3073 # | |
3074 # _graphic_outputs: | |
3075 # A list of all generated .eps files | |
3076 # | |
3077 # _env: | |
3078 # A list of environment variables and their values. If supported by | |
3079 # your version of make, also a list of variables known to make. | |
3080 # | |
3081 # FILE TARGETS: | |
3082 # | |
3083 # %, %.pdf: | |
3084 # Build a PDF file from the corresponding %.tex file. | |
3085 # | |
3086 # If BUILD_STRATEGY=pdflatex, then this builds the pdf directly. | |
3087 # Otherwise, it uses this old-school but effective approach: | |
3088 # | |
3089 # latex -> dvips -> ps2pdf | |
3090 # | |
3091 # The BUILD_STRATEGY can be overridden in Makefile.ini in the same | |
3092 # directory. The default is pdflatex. | |
3093 # | |
3094 # Reasons for using latex -> dvips include the "psfrag" package, and the | |
3095 # generation of postscript instead of PDF. Arguments for using pdflatex | |
3096 # include "new and shiny" and "better supported." I can't argue with | |
3097 # either of those, and supporting them both didn't turn out to be that | |
3098 # difficult, so there you have it. Choices. | |
3099 # | |
3100 # %._show: | |
3101 # A phony target that builds the pdf file and then displays it using the | |
3102 # environment-overridable value of VIEW_PDF ($(VIEW_PDF)). | |
3103 # | |
3104 # %._graphics: | |
3105 # A phony target that generates all graphics on which %.pdf (or %.dvi) | |
3106 # depends. | |
3107 # | |
3108 # %.ps (only for BUILD_STRATEGY=latex): | |
3109 # Build a Postscript file from the corresponding %.tex file. | |
3110 # This is done using dvips. Paper size is automatically | |
3111 # extracted from the declaration | |
3112 # | |
3113 # \documentclass[<something>paper] | |
3114 # | |
3115 # or it is the system default. | |
3116 # | |
3117 # If using beamer (an excellent presentation class), the paper | |
3118 # size is ignored. More on this later. | |
3119 # | |
3120 # %.dvi (only for BUILD_STRATEGY=latex): | |
3121 # Build the DVI file from the corresponding %.tex file. | |
3122 # | |
3123 # %.ind: | |
3124 # Build the index for this %.tex file. | |
3125 # | |
3126 # %.gls: | |
3127 # Build the nomenclature glossary for this %.tex file. | |
3128 # | |
3129 # %.nls: | |
3130 # Build the (newer) nomenclature file for this %.tex file. | |
3131 # | |
3132 # %.eps: | |
3133 # Build an eps file from one of the following file types: | |
3134 # | |
3135 # .dot : graphviz | |
3136 # .gpi : gnuplot | |
3137 # .fig : xfig | |
3138 # .xvg : xmgrace | |
3139 # .svg : scalable vector graphics (goes through inkscape) | |
3140 # .png : png (goes through NetPBM) | |
3141 # .jpg : jpeg (goes through ImageMagick) | |
3142 # .eps.gz : gzipped eps | |
3143 # | |
3144 # The behavior of this makefile with each type is described in | |
3145 # its own section below. | |
3146 # | |
3147 # %.pstex{,_t} (only for BUILD_STRATEGY=latex): | |
3148 # Build a .pstex_t file from a .fig file. | |
3149 # | |
3150 # FEATURES: | |
3151 # | |
3152 # Optional Binary Directory: | |
3153 # If you create the _out_ directory in the same place as the makefile, | |
3154 # it will automatically be used as a dumping ground for .pdf (or .dvi, | |
3155 # .ps, and .pdf) output files. | |
3156 # | |
3157 # Alternatively, you can set the BINARY_TARGET_DIR variable, either as a | |
3158 # make argument or in Makefile.ini, to point to your directory of | |
3159 # choice. Note that no pathname wildcard expansion is done in the | |
3160 # makefile, so make sure that the path is complete before going in | |
3161 # there. E.g., if you want to specify something in your home directory, | |
3162 # use $$HOME/ instead of ~/ so that the shell expands it before it gets | |
3163 # to the makefile. | |
3164 # | |
3165 # External Program Dependencies: | |
3166 # Every external program used by the makefile is represented by an | |
3167 # ALLCAPS variable at the top of this file. This should allow you to | |
3168 # make judgments about whether your system supports the use of this | |
3169 # makefile. The list is available in the ALL_PROGRAMS variable and, | |
3170 # provided that you are using GNU make 3.80 or later (or you haven't | |
3171 # renamed this file to something weird like "mylatexmakefile" and like | |
3172 # invoking it with make -f) can be viewed using | |
3173 # | |
3174 # make _all_programs | |
3175 # | |
3176 # Additionally, the availability of these programs can be checked | |
3177 # automatically for you by running | |
3178 # | |
3179 # make _check_programs | |
3180 # | |
3181 # The programs are categorized according to how important they are and | |
3182 # what function they perform to help you decide which ones you really | |
3183 # need. | |
3184 # | |
3185 # Colorized Output: | |
3186 # The output of commands is colorized to highlight things that are often | |
3187 # important to developers. This includes {underfull,overfull} | |
3188 # {h,v}boxes, general LaTeX Errors, each stage of document building, and | |
3189 # the number of pages in the final document. The colors are obtained | |
3190 # using 'tput', so colorization should work pretty well on any terminal. | |
3191 # | |
3192 # The colors can be customized very simply by setting any of the | |
3193 # LATEX_COLOR_<CONTEXT> variables in your environment (see above). | |
3194 # | |
3195 # Predecessors to TeX Files: | |
3196 # Given a target <target>, if no <target>.tex file exists but a | |
3197 # corresponding script or predecessor file exists, then appropriate | |
3198 # action will be taken to generate the tex file. | |
3199 # | |
3200 # Currently supported script or predecessor languages are: | |
3201 # | |
3202 # sh: %.tex.sh | |
3203 # perl: %.tex.pl | |
3204 # python: %.tex.py | |
3205 # | |
3206 # Calls the script using the appropriate interpreter, assuming that | |
3207 # its output is a .tex file. | |
3208 # | |
3209 # The script is called thus: | |
3210 # | |
3211 # <interpreter> <script file name> <target tex file> | |
3212 # | |
3213 # and therefore sees exactly one parameter: the name of the .tex | |
3214 # file that it is to create. | |
3215 # | |
3216 # Why does this feature exist? I ran into this while working on | |
3217 # my paper dissertation. I wrote a huge bash script that used a | |
3218 # lot of sed to bring together existing papers in LaTeX. It | |
3219 # would have been nice had I had something like this to make my | |
3220 # life easier, since as it stands I have to run the script and | |
3221 # then build the document with make. This feature provides hooks | |
3222 # for complicated stuff that you may want to do, but that I have | |
3223 # not considered. It should work fine with included dependencies, | |
3224 # too. | |
3225 # | |
3226 # Scripts are run every time make is invoked. Some trickery is | |
3227 # employed to make sure that multiple restarts of make don't cause | |
3228 # them to be run again. | |
3229 # | |
3230 # reST: %.rst | |
3231 # | |
3232 # Runs the reST to LaTeX converter to generate a .tex file | |
3233 # If it finds a file names _rststyle_._include_.tex, uses it as | |
3234 # the "stylesheet" option to rst2latex. | |
3235 # | |
3236 # Note that this does not track sub-dependencies in rst files. It | |
3237 # assumes that the top-level rst file will change if you want a | |
3238 # rebuild. | |
3239 # | |
3240 # Dependencies: | |
3241 # | |
3242 # In general, dependencies are extracted directly from LaTeX output on | |
3243 # your document. This includes | |
3244 # | |
3245 # * Bibliography information | |
3246 # * \include or \input files (honoring \includeonly, too) | |
3247 # * Graphics files inserted by the graphicx package | |
3248 # | |
3249 # Where possible, all of these are built correctly and automatically. | |
3250 # In the case of graphics files, these are generated from the following | |
3251 # file types: | |
3252 # | |
3253 # GraphViz: .dot | |
3254 # GNUPlot: .gpi | |
3255 # XFig: .fig | |
3256 # XMgrace: .xvg | |
3257 # SVG: .svg | |
3258 # PNG: .png | |
3259 # JPEG: .jpg | |
3260 # GZipped EPS: .eps.gz | |
3261 # | |
3262 # If the file exists as a .eps already, it is merely used (and will not | |
3263 # be deleted by 'clean'!). | |
3264 # | |
3265 # LaTeX and BibTeX are invoked correctly and the "Rerun to get | |
3266 # cross-references right" warning is heeded a reasonable number of | |
3267 # times. In my experience this is enough for even the most troublesome | |
3268 # documents, but it can be easily changed (if LaTeX has to be run after | |
3269 # BibTeX more than three times, it is likely that something is moving | |
3270 # back and forth between pages, and no amount of LaTeXing will fix | |
3271 # that). | |
3272 # | |
3273 # \includeonly is honored by this system, so files that are not | |
3274 # specified there will not trigger a rebuild when changed. | |
3275 # | |
3276 # Beamer: | |
3277 # A special TeX source comment is recognized by this makefile (only when | |
3278 # BUILD_STRATEGY=latex, since this invokes psnup): | |
3279 # | |
3280 # %%[[:space:]]*BEAMER[[:space:]]*LARGE | |
3281 # | |
3282 # The presence of this comment forces the output of dvips through psnup | |
3283 # to enlarge beamer slides to take up an entire letter-sized page. This | |
3284 # is particularly useful when printing transparencies or paper versions | |
3285 # of the slides. For some reason landscape orientation doesn't appear | |
3286 # to work, though. | |
3287 # | |
3288 # If you want to put multiple slides on a page, use this option and then | |
3289 # print using mpage, a2ps, or psnup to consolidate slides. My personal | |
3290 # favorite is a2ps, but your mileage may vary. | |
3291 # | |
3292 # When beamer is the document class, dvips does NOT receive a paper size | |
3293 # command line attribute, since beamer does special things with sizes. | |
3294 # | |
3295 # GNUPlot Graphics: | |
3296 # When creating a .gpi file, DO NOT INCLUDE the "set terminal" or "set | |
3297 # output" commands! The makefile will include terminal information for | |
3298 # you. Besides being unnecessary and potentially harmful, including the | |
3299 # terminal definition in the .gpi file makes it harder for you, the one | |
3300 # writing the document, to preview your graphics, e.g., with | |
3301 # | |
3302 # gnuplot -persist myfile.gpi | |
3303 # | |
3304 # so don't do specify a terminal or an output file in your .gpi files. | |
3305 # | |
3306 # When building a gpi file into an eps file, there are several features | |
3307 # available to the document designer: | |
3308 # | |
3309 # Global Header: | |
3310 # The makefile searches for the files in the variable GNUPLOT_GLOBAL | |
3311 # in order: | |
3312 # | |
3313 # ($(GNUPLOT_GLOBAL)) | |
3314 # | |
3315 # Only the first found is used. All .gpi files in the directory are | |
3316 # treated as though the contents of GNUPLOT_GLOBAL were directly | |
3317 # included at the top of the file. | |
3318 # | |
3319 # NOTE: This includes special comments! (see below) | |
3320 # | |
3321 # Font Size: | |
3322 # A special comment in a .gpi file (or a globally included file) of | |
3323 # the form | |
3324 # | |
3325 # ## FONTSIZE=<number> | |
3326 # | |
3327 # will change the font size of the GPI output. If font size is | |
3328 # specified in both the global file and the GPI file, the | |
3329 # specification in the individual GPI file is used. | |
3330 # | |
3331 # Grayscale Output: | |
3332 # GNUplot files also support a special comment to force them to be | |
3333 # output in grayscale *no matter what*: | |
3334 # | |
3335 # ## GRAY | |
3336 # | |
3337 # This is not generally advisable, since you can always create a | |
3338 # grayscale document using the forms mentioned above. But, if your | |
3339 # plot simply must be grayscale even in a document that allows | |
3340 # colors, this is how you do it. | |
3341 # | |
3342 # XFig Graphics: | |
3343 # No special handling is done with XFig, except when a global | |
3344 # grayscale method is used, e.g. | |
3345 # | |
3346 # make GRAY=1 document | |
3347 # | |
3348 # In these cases the .eps files is created using the -N switch to | |
3349 # fig2dev to turn off color output. (Only works with eps, not pstex | |
3350 # output) | |
3351 # | |
3352 # GraphVis Graphics: | |
3353 # Color settings are simply ignored here. The 'dot' program is used | |
3354 # to transform a .dot file into a .eps file. | |
3355 # | |
3356 # If you want, you can use the dot2tex program to convert dot files | |
3357 # to tex graphics. The default is to just call dot2tex with no | |
3358 # arguments, but you can change the DOT2TEX definition to include | |
3359 # options as needed (in your Makefile.ini). | |
3360 # | |
3361 # Note that, as with pstex, the makefile cannot use latex's own | |
3362 # output to discover all missing dot_t (output) files, since anytime | |
3363 # TeX includes TeX, it has to bail when it can't find the include | |
3364 # file. It can therefore only stop on the first missing file it | |
3365 # discovers, and we can't get a large list of them out easily. | |
3366 # | |
3367 # So, the makefile errors out if it's missing an included dot_t | |
3368 # file, then prompts the user to run this command manually: | |
3369 # | |
3370 # make all-dot2tex | |
3371 # | |
3372 # GZipped EPS Graphics: | |
3373 # | |
3374 # A .eps.gz file is sometimes a nice thing to have. EPS files can get | |
3375 # very large, especially when created from bitmaps (don't do this if you | |
3376 # don't have to). This makefile will unzip them (not in place) to | |
3377 # create the appropriate EPS file. | |
3378 # | |
3379 endef | |
3380 | |
3381 # | |
3382 # DEPENDENCY CHART: | |
3383 # | |
3384 #digraph "g" { | |
3385 # rankdir=TB | |
3386 # size="9,9" | |
3387 # edge [fontsize=12 weight=10] | |
3388 # node [shape=box fontsize=14 style=rounded] | |
3389 # | |
3390 # eps [ | |
3391 # shape=Mrecord | |
3392 # label="{{<gpi> GNUplot|<epsgz> GZip|<dot> Dot|<fig> XFig}|<eps> eps}" | |
3393 # ] | |
3394 # pstex [label="%.pstex"] | |
3395 # pstex_t [label="%.pstex_t"] | |
3396 # tex_outputs [shape=point] | |
3397 # extra_tex_files [shape=point] | |
3398 # gpi_data [label="<data>"] | |
3399 # gpi_includes [label="_include_.gpi"] | |
3400 # aux [label="%.aux"] | |
3401 # fls [label="%.fls"] | |
3402 # idx [label="%.idx"] | |
3403 # glo [label="%.glo"] | |
3404 # ind [label="%.ind"] | |
3405 # log [label="%.log"] | |
3406 # tex_sh [label="%.tex.sh"] | |
3407 # rst [label="%.rst"] | |
3408 # tex [ | |
3409 # shape=record | |
3410 # label="<tex> %.tex|<include> _include_.tex" | |
3411 # ] | |
3412 # include_aux [label="_include_.aux"] | |
3413 # file_bib [label=".bib"] | |
3414 # bbl [label="%.bbl"] | |
3415 # dvi [label="%.dvi"] | |
3416 # ps [label="%.ps"] | |
3417 # pdf [label="%.pdf"] | |
3418 # fig [label=".fig"] | |
3419 # dot [label=".dot"] | |
3420 # gpi [label=".gpi"] | |
3421 # eps_gz [label=".eps.gz"] | |
3422 # | |
3423 # gpi_files [shape=point] | |
3424 # | |
3425 # rst -> tex:tex [label="reST"] | |
3426 # tex_sh -> tex:tex [label="sh"] | |
3427 # tex_pl -> tex:tex [label="perl"] | |
3428 # tex_py -> tex:tex [label="python"] | |
3429 # tex -> tex_outputs [label="latex"] | |
3430 # tex_outputs -> dvi | |
3431 # tex_outputs -> aux | |
3432 # tex_outputs -> log | |
3433 # tex_outputs -> fls | |
3434 # tex_outputs -> idx | |
3435 # tex_outputs -> include_aux | |
3436 # aux -> bbl [label="bibtex"] | |
3437 # file_bib -> bbl [label="bibtex"] | |
3438 # idx -> ind [label="makeindex"] | |
3439 # glo -> gls [label="makeindex"] | |
3440 # nlo -> nls [label="makeindex"] | |
3441 # gls -> extra_tex_files | |
3442 # nls -> extra_tex_files | |
3443 # ind -> extra_tex_files | |
3444 # bbl -> extra_tex_files | |
3445 # eps -> extra_tex_files | |
3446 # extra_tex_files -> dvi [label="latex"] | |
3447 # gpi_files -> eps:gpi [label="gnuplot"] | |
3448 # gpi -> gpi_files | |
3449 # gpi_data -> gpi_files | |
3450 # gpi_includes -> gpi_files | |
3451 # eps_gz -> eps:epsgz [label="gunzip"] | |
3452 # fig -> eps:fig [label="fig2dev"] | |
3453 # fig -> pstex [label="fig2dev"] | |
3454 # fig -> pstex_t [label="fig2dev"] | |
3455 # pstex -> pstex_t [label="fig2dev"] | |
3456 # dot -> eps:dot [label="dot"] | |
3457 # dvi -> ps [label="dvips"] | |
3458 # include_aux -> bbl [label="bibtex"] | |
3459 # ps -> pdf [label="ps2pdf"] | |
3460 # | |
3461 # edge [ color=blue label="" style=dotted weight=1 fontcolor=blue] | |
3462 # fls -> tex:include [label="INPUT: *.tex"] | |
3463 # fls -> file_bib [label="INPUT: *.aux"] | |
3464 # aux -> file_bib [label="\\bibdata{...}"] | |
3465 # include_aux -> file_bib [label="\\bibdata{...}"] | |
3466 # log -> gpi [label="Graphic file"] | |
3467 # log -> fig [label="Graphic file"] | |
3468 # log -> eps_gz [label="Graphic file"] | |
3469 # log -> dot [label="Graphic file"] | |
3470 # log -> idx [label="No file *.ind"] | |
3471 # log -> glo [label="No file *.gls"] | |
3472 # log -> nlo [label="No file *.nls"] | |
3473 # gpi -> gpi_data [label="plot '...'"] | |
3474 # gpi -> gpi_includes [label="load '...'"] | |
3475 # tex:tex -> ps [label="paper"] | |
3476 # tex:tex -> pdf [label="embedding"] | |
3477 #} | |
3478 | |
3479 # | |
3480 # DEPENDENCY CHART SCRIPT | |
3481 # | |
3482 # $(call output_dependency_graph,[<output file>]) | |
3483 define output-dependency-graph | |
3484 if [ -f '$(this_file)' ]; then \ | |
3485 $(SED) \ | |
3486 -e '/^[[:space:]]*#[[:space:]]*DEPENDENCY CHART:/,/^$$/!d' \ | |
3487 -e '/DEPENDENCY CHART/d' \ | |
3488 -e '/^$$/d' \ | |
3489 -e 's/^[[:space:]]*#//' \ | |
3490 $(this_file) $(if $1,> '$1',); \ | |
3491 else \ | |
3492 $(ECHO) "Cannot determine the name of this makefile."; \ | |
3493 fi | |
3494 endef | |
3495 # vim: noet sts=0 sw=8 ts=8 |