tor-commits

tor-commits@lists.torproject.org

1 participants
216116 discussions

[torbrowser/master] Merge branch 'maint-2.2' into maint-2.3
by erinn＠torproject.org 26 Aug '12

26 Aug '12

commit 0aafb37aa7ba9f597981181793d67696b3668d3b Merge: 5b02117 5239f44 Author: Erinn Clark <erinn(a)torproject.org> Date: Sun Aug 26 10:08:06 2012 +0100 Merge branch 'maint-2.2' into maint-2.3 build-scripts/versions.mk | 2 +- 1 files changed, 1 insertions(+), 1 deletions(-)

1 0

[torbrowser/maint-2.3] bump firefox to 10.0.7esr
by erinn＠torproject.org 26 Aug '12

26 Aug '12

commit 5239f44da93388a40b1ce0337fa42382ebefa686 Author: Erinn Clark <erinn(a)torproject.org> Date: Sun Aug 26 10:07:52 2012 +0100 bump firefox to 10.0.7esr --- build-scripts/versions.mk | 2 +- 1 files changed, 1 insertions(+), 1 deletions(-) diff --git a/build-scripts/versions.mk b/build-scripts/versions.mk index bfba975..e41d0f5 100644 --- a/build-scripts/versions.mk +++ b/build-scripts/versions.mk @@ -10,7 +10,7 @@ VIDALIA_VER=0.2.20 LIBEVENT_VER=2.0.19-stable TOR_VER=0.2.2.38 PIDGIN_VER=2.6.4 -FIREFOX_VER=10.0.6esr +FIREFOX_VER=10.0.7esr MOZBUILD_VER=1.5.1 PYMAKE_VER=87d436cd8974 TORBUTTON_VER=1.4.6

1 0

[research-web/master] Add three reports by Steven/George.
by karsten＠torproject.org 26 Aug '12

26 Aug '12

commit 021fb01029f2dade2d716f4eaa65967b0e618a86 Author: Karsten Loesing <karsten.loesing(a)gmx.net> Date: Sun Aug 26 08:06:59 2012 +0200 Add three reports by Steven/George. --- techreports.html | 15 +++++++++------ 1 files changed, 9 insertions(+), 6 deletions(-) diff --git a/techreports.html b/techreports.html index e2dc191..5032091 100644 --- a/techreports.html +++ b/techreports.html @@ -38,15 +38,17 @@ Tor Tech Report 2012-08-001. August 22, 2012. <a href="techreports/tor-nat-plan-2012-08-22.pdf">PDF</a>.</p> - +<a href="techreports/pluggable-roadmap-2012-03-17.pdf">PDF</a>.</p> - +<a href="techreports/datagram-testing-plan-2012-03-16">PDF</a>.</p> <p>George Kadianakis. <i>Packet Size Pluggable Transport and Traffic Morphing.</i> @@ -74,10 +76,11 @@ Tor Tech Report 2011-11-002. November 29, 2011. <a href="techreports/different-ways-use-bridge-2011-11-29.pdf">PDF</a>.</p> - +<a href="techreports/datagram-comparison-2011-11-07">PDF</a>.</p> <!--<p>Roger Dingledine. <i>Ten ways to discover Tor bridges.</i>

1 0

[tech-reports/master] Update pluggable-roadmap report to new style.
by karsten＠torproject.org 26 Aug '12

26 Aug '12

commit b13fb1c35742121396ef380ce7c2b051c030b5a0 Author: Karsten Loesing <karsten.loesing(a)gmx.net> Date: Wed Aug 8 08:12:15 2012 +0200 Update pluggable-roadmap report to new style. --- 2012/pluggable-roadmap/.gitignore | 8 +- 2012/pluggable-roadmap/Makefile | 3892 -------------------------- 2012/pluggable-roadmap/Targets.ini | 4 - 2012/pluggable-roadmap/easychair.cls | 756 ----- 2012/pluggable-roadmap/pluggable-roadmap.tex | 22 +- 2012/pluggable-roadmap/tortechrep.cls | 1 + 2012/pluggable-roadmap/vc | 24 - 2012/pluggable-roadmap/vc-git.awk | 89 - 8 files changed, 7 insertions(+), 4789 deletions(-) diff --git a/2012/pluggable-roadmap/.gitignore b/2012/pluggable-roadmap/.gitignore index 70fe299..6038581 100644 --- a/2012/pluggable-roadmap/.gitignore +++ b/2012/pluggable-roadmap/.gitignore @@ -1,9 +1,3 @@ -pluggable-roadmap.aux.make -pluggable-roadmap.auxbbl.make -pluggable-roadmap.auxtarget.make -pluggable-roadmap.d -pluggable-roadmap.fls -pluggable-roadmap.out.make pluggable-roadmap.pdf -vc._include_.tex +pluggable-roadmap-2012-03-17.pdf diff --git a/2012/pluggable-roadmap/Makefile b/2012/pluggable-roadmap/Makefile deleted file mode 100644 index 62951f3..0000000 --- a/2012/pluggable-roadmap/Makefile +++ /dev/null @@ -1,3892 +0,0 @@ -# Copyright 2004 Chris Monson (shiblon(a)gmail.com) -# Latest version available at http://www.bouncingchairs.net/oss -# -# This file is part of ``Chris Monson's Free Software''. -# -# ``Chris Monson's Free Software'' is free software; you can redistribute it -# and/or modify it under the terms of the GNU General Public License as -# published by the Free Software Foundation, Version 2. -# -# ``Chris Monson's Free Software'' is distributed in the hope that it will -# be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General -# Public License for more details. -# -# You should have received a copy of the GNU General Public License along -# with ``Chris Monson's Free Software''; if not, write to the Free Software -# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -# -# It is also available on the web at http://www.gnu.org/copyleft/gpl.html -# -# Note that using this makefile to build your documents does NOT place them -# under the GPL unless you, the author, specifically do so. In other words, -# I, Chris Monson, the copyright holder and author of this makefile, -# consider it impossible to ``link'' to this makefile in any way covered by -# the GPL. -# -# -# TO OBTAIN INSTRUCTIONS FOR USING THIS FILE, RUN: -# make help -# -fileinfo := LaTeX Makefile -author := Chris Monson -version := 2.2.0 -# -.DEFAULT_GOAL := all -# Note that the user-global version is imported *after* the source directory, -# so that you can use stuff like ?= to get proper override behavior. -.PHONY: Makefile GNUmakefile Makefile.ini $(HOME)/.latex-makefile/Makefile.ini --include Makefile.ini --include $(HOME)/.latex-makefile/Makefile.ini -# Better names for these things -.PHONY: Variables.ini $(HOME)/.latex-makefile/Variables.ini --include Variables.ini --include $(HOME)/.latex-makefile/Variables.ini -# -# This can be pdflatex or latex - you can change this by adding the following line to your Makefile.ini: -# BUILD_STRATEGY := latex -BUILD_STRATEGY ?= pdflatex -# -# Sets LC_ALL=C, by default, so that the locale-aware tools, like sort, be -# # immune to changes to the locale in the user environment. -export LC_ALL ?= C -# -# -# If you specify sources here, all other files with the same suffix -# will be treated as if they were _include_ files. -#onlysources.tex ?= main.tex -#onlysources.tex.sh ?= -#onlysources.tex.pl ?= -#onlysources.tex.py ?= -#onlysources.rst ?= -#onlysources.fig ?= -#onlysources.gpi ?= -#onlysources.dot ?= -#onlysources.xvg ?= -#onlysources.svg ?= -#onlysources.eps.gz ?= -#onlysources.eps ?= -# -# If you list files here, they will be treated as _include_ files -#includes.tex ?= file1.tex file2.tex -#includes.tex.sh ?= -#includes.tex.pl ?= -#includes.tex.py ?= -#includes.rst ?= -#includes.fig ?= -#includes.gpi ?= -#includes.dot ?= -#includes.xvg ?= -#includes.svg ?= -#includes.eps.gz ?= -#includes.eps ?= -# -# If you list files or wildcards here, they will *not* be cleaned - default is -# to allow everything to be cleaned. -#neverclean ?= *.pdf -# -# Alternatively (recommended), you can add those lines to a Makefile.ini file -# and it will get picked up automatically without your having to edit this -# Makefile. -# -# KNOWN ISSUES: -# * The following occurs: -# file with: \usepackage{named}\bibliographystyle{named} -# Compile -# change to: \usepackage{apalike}\bibliographystyle{apalike} -# Compile again -- BARF! -# -# The workaround: make clean-nographics; make -# -# Note that we may not be able to fix this. LaTeX itself barfs -# on this, not the makefile. The very first invocation of LaTeX -# (when something like this has happened) reads the existing .aux -# file and discovers invalid commands like \citeauthoryear that -# are only valid in the package that was just removed. It then -# tries to parse them and explodes. It's not at all clear to me -# how to fix this. I tried removing the .aux files on the first -# run of LaTeX, but that necessarily requires more subsequent -# rebuilds on common edits. There does not appear to be a -# graceful solution to this issue. -# -# -# CHANGES: -# Chris Monson (2011-05-20): -# * Bumped version to 2.2.0 (release!) -# Chris Monson (2011-05-19): -# * Bumped version to 2.2.0-rc15 -# * Issue 125: infinite recursion with nomenclature files -# * Issue 125: removed .d as a target for .nls in get-log-index -# * Cleaned up invocation of run-makeindex to take an optional .ist instead of flags. -# Chris Monson (2011-04-06): -# * Bumped version to 2.2.0-rc14 -# * Issue 121: Added Targets.ini and corresponding help text for it. -# * Issue 121: Added Variables.ini (Makefile.ini still works, though). -# * Issue 121: Added .DEFAULT_GOAL optional setting. -# * Issue 120: xindy compatibility -# Chris Monson (2011-03-16): -# * Bumped version to 2.2.0-rc13 -# * Fixed a bug in kspewhich invocation - random characters and a missing pipe. -# * Added font embedding to gnuplot output. -# Chris Monson (2011-03-15): -# * Bumped version to 2.2.0-rc12 -# * Issue 119: Annoying warning from which if Gnuplot not installed. -# * Fixed catchall error output to show more info from the log. Cutting off the -# first line is too jarring. -# * Issue 118: Better glossary support -# Chris Monson (2011-03-03): -# * Bumped version to 2.2.0-rc11 -# * Issue 112: Fixed regression introduced by use of cygpath (ugly warnings) -# Chris Monson (2011-02-03): -# * Bumped version to 2.2.0-rc10 -# * Issue 112: Added path normalization for cygwin systems -# * Fixed a bug in get-missing-inputs where we weren't specifying target files -# Chris Monson (2011-01-24): -# * Issue 111: Added .jpeg as a possible image extension -# Chris Monson (2011-01-21): -# * Issue 110: Long filenames not produced correctly in .d file -# * Fixed problem with unknown control sequence error parsing -# * Fixed problem with \r in fatal output (was interpreted as LF by echo) -# * Removed a spurious "hi" -# Chris Monson (2011-01-14): -# * Bumped version to 2.2.0-rc8 -# * Issue 107: Removed comment with embedded newline, fixing MinGW on Windows 7. -# Chris Monson (2011-01-07): -# * Emit an error if .gpi.d files have dependencies with : in the name -# Chris Monson (2011-01-05): -# * Bumped version to 2.2.0-rc7 -# * Issue 106: existing graphic dependencies not generated correctly -# Chris Monson (2011-01-04): -# * Issue 106: not cleaning eps log files properly -# * Issue 106: not rebuilding after creating .pdf graphics from .eps -# * Issue 94: svg going unnecessarily through eps (can't reproduce) -# Chris Monson (2010-12-31): -# * Issue 100: make hanging because of faulty graphics detection (sed bug) -# * Issue 108: do not ignore fatal errors from pdftex -# Chris Monson (2010-12-23): -# * Added gpi_global to gnuplot dependencies so that changes are detected -# Chris Monson (2010-12-20): -# * Updated build file to be smarter about Python version detection -# * Created a bunch of test files and supporting scripts -# * Issue 72: added apacite capaability (thanks to matkarat) -# Chris Monson (2010-11-23): -# * Changed to multi-part makefile build (split out sed scripts) -# * Added build script and supporting infrastructure -# * Updated test directory format -# * Added notes about needed test cases -# * Changed to use -file-line-error and fixed multiple inclusion/error bugs -# * Added run_sed.py to allow easy testing of sed scripts outside of make -# Chris Monson (2010-11-11): -# * Bumped version to 2.2.0-rc7 -# * issue 92: broken hyperref driver detection fixed -# * issue 101: Broken inkscape conversion -# * issue 102: Broken specification of font size for gnuplot pdfcairo -# * Added KEEP_TEMP so that we can avoid deleting useful temporaries for debugging -# * Restructured gnuplot code to be easier to follow -# * Fixed a bug in convert-gpi where we were using $< instead of $1 -# Chris Monson (2010-11-03): -# * Bumped version to 2.2.0-rc6 -# * issue 96: Fix sed errors when using make variables in substitutions -# Chris Monson (2010-07-28): -# * Bumped version to 2.2.0-rc5 (rc4 is broken) -# * Bail out when we find the use of the import.sty package -# * Issue 90: Add -z to dvips invocation -# * Issue 67: Add xelatex support (thanks to Nikolai Prokoschenko for the patch!) -# * Issue 85: Add warning about make 3.80 -# Chris Monson (2010-06-20): -# * Bumped version to 2.2.0-rc3 -# * Attempt to fix bug with ! error detection (issue 88) -# * Added svg->pdf direct support (issue 89) -# Chris Monson (2010-04-28): -# * Bumped version to 2.2.0-rc2 -# * Fixed %._show target -# Chris Monson (2010-04-08): -# * Bumped version to 2.2.0-rc1 -# * Added back in the rst_style_file stuff that got broken when switching -# rst -> tex to use the script mechanism -# Chris Monson (2010-03-23): -# * Bumped version to 2.2.0-beta8 -# * Work on issue 76: bad backtick escape for some sed versions, failure -# to clear out the hold buffer when outputting MISSING comment. -# - Backed out 2>&1 to &> (doesn't work in sh) -# - Backed out using . to source variables -# Chris Monson (2010-03-22): -# * Bumped version to 2.2.0-beta7 -# * Issue 72: Fix latex/bibtex invocation order for annotated bib styles -# * Fixed informational output to reflect which LaTeX run we're on -# * Fixed graphic detection to include graphics that are already there in -# .d files -# * Tightened up the .d file output to only make .d depend on graphic -# *source* files. This means that building foo.d no longer -# builds all of the graphics files on which foo.tex depends. -# Had to use .SECONDEXPANSION trickery to make it work. -# * Changed get-graphics to only accept a stem. -# * Fixed build-once logic for scripted .tex to work better -# * Made get-inputs sed script more maintainable. -# * Moved Makefile.ini import up higher. -# * Changed bare stems to not recursively invoke make -# * Updated diff output to be more silent everywhere -# * Added a MISSING comment to the .d file if stuff isn't found - forces -# removal of .1st.make file, which often forces it to try again. -# * Fixed broken graphics-target function -# * Added sleep to .d file generation when stuff is missing - if it -# builds too fast, make doesn't realize it needs to be reloaded, -# and thus never discovers some deeper dependencies (especially -# evident when graphics are included from scripted include -# files). -# Chris Monson (2010-03-17): -# * Bumped version to 2.2.0-beta6 -# * Fixed bareword builds to actually work (requires static patterns) -# * Fixed colorization to work with new paragraph stuff -# Chris Monson (2010-03-17): -# * Bumped version to 2.2.0-beta5 -# * Fixed graphic detection to be much more focused - splits log file -# into paragraphs before doing pattern matching. -# * Fixed make foo to work properly (recursively calls make foo.pdf) -# * Fixed gpi -> pdf generation to not waste time building .eps *after* -# the pdf already exists. -# * Changed log copies to include MAKE_RESTARTS as part of the name. -# * Fixed missing include file detection (also makes use of the paragraph -# stuff) to detect missing scripted include files. -# Chris Monson (2010-03-16): -# * Bumped version to 2.2.0-beta4 -# * issue 70: .pdf not moved out of the way properly on first -# compilation, resulting in early error detection failure. -# * issue 74: fixed broken error on missing .aux files: the -# implementation was masking real errors. -# Chris Monson (2010-03-15): -# * Bumped version to 2.2.0-beta3 -# * issue 71: Made the tput dependency optional -# * issue 73: Made .tex targets not pull in .d files (building them from -# scripts should not require a .d) -# * issue 74: Output a much saner error when a .aux file is not produced -# (e.g., when you are typing "make" without arguments in a -# directory with included .tex files that are not named with -# ._include_.) -# Chris Monson (2010-03-11): -# * Bumped version to 2.2.0-beta2 -# * Fixed clean-graphics to get rid of intermediate .eps files that may -# be hanging around -# * Added an automatic setting to use eps terminals in pdflatex mode for -# gnuplot if it doesn't understand pdf. -# * issue 66: Removed grayscale generation via magic suffix. Grayscale -# generation is now only available via GRAY=1 -# * issue 68: Added explicit handling of LC_ALL for locale-aware tools -# like "sort" -# Chris Monson (2010-03-10): -# * Bumped version to 2.2.0-beta1 -# * Fixed success message to handle output message in different places -# * Added name of produced file to success message -# Chris Monson (2010-03-10): -# * Bumped version to 2.2.0-alpha3 -# * Added meaningful error message for wrong hyperref options -# * Added meaningful error message for incorrect graphics extensions -# Chris Monson (2010-03-09): -# * Bumped version to 2.2.0-alpha2 -# * Updated graphics handling (gnuplot and fig generate pdf natively) -# * Changed xmgrace to output monochrome natively -# Chris Monson (2010-03-09): -# * Bumped version to 2.2.0-alpha1 - major change! -# * Support pdflatex natively and by default (issue 6 - a long time coming) -# * Add ability to have a single $HOME/.latex-makefile/Makefile.ini for -# all invocations -# * Reworked graphic inclusion detection so that extensions need not be -# specified for either build strategy (e.g., -# \includegraphics{test1.eps} -> \includegrahpics{test1}) -# * Changed log format to include filenames and line numbers -# Chris Monson (2010-02-04): -# * Bumped version to 2.1.43 -# * All of the following are for issue 63 (thanks to mojoh81): -# * Added documentation about fixing Makefile.ini default target -# * Added perl and python script targets -# * Fixed run logic to allow included .tex files to be scripted (the -# run-again logic now detects missing .tex files, and the MV -# command has been switched out for a command that only invokes -# MV if the files exist) -# * Changed scripted generation to only run once per make invocation -# * Added dependency on expr -# Chris Monson (2010-01-19): -# * Bumped version to 2.1.42 -# * issue 62: Added .brf extension to cleanable files (backrefs) -# Chris Monson (2010-01-07): -# * Bumped version to 2.1.41 -# * issue 60: bad makeindex runs now error out on subsequent tries -# Chris Monson (2009-12-01): -# * Bumped version to 2.1.40 -# * issue 36: build all indices (for e.g., splitidx usage) -# * issue 59: clean up all generated files (including indices) -# Chris Monson (2009-11-23): -# * Bumped version to 2.1.39 -# * issue 57: change ps2pdf invocations to just use gs directly -# Chris Monson (2009-11-19): -# * Bumped version to 2.1.38 -# * issue 57: Added some limited support for Cygwin (spaces in filenames) -# Chris Monson (2009-11-15): -# * Bumped version to 2.1.37 -# * Removed svninfo, since this is now managed by mercurial -# * Fixed typo in changelist -# * Issue 52: added jpg->eps conversion (thanks to brubakee) -# * Issue 54: fix missing Overfull colorization due to lack of a blank -# line preceding the first error. -# * Issue 51: remove head.tmp and body.tmp in make clean invocation -# * Issue 56: maintain multiple versions of log files (for debugging) -# Chris Monson (2009-11-14): -# * Bumped version to 2.1.36 -# * Issues 53 and 49: added .brf, .mtc, and .maf to the cleanables -# Chris Monson (2009-11-05): -# * Bumped version to 2.1.35 -# * Added nomenclature support (see issue 48) -# Chris Monson (2009-10-29): -# * Bumped version to 2.1.34 -# * Fixed _out_ creation bug introduced in 2.1.33 (it was always created) -# * Fixed erroneous help output for $HOME in BINARY_TARGET_DIR -# * Changed contact email address - bring on the spam! -# Chris Monson (2009-10-21): -# * Bumped version to 2.1.33 -# * Fixed issue 46, adding support for dot2tex (thanks to fdemesmay) -# * Made all_files.* settable in Makefile.ini (using ?= instead of :=) -# * Fixed issue 47, thanks to fdemesmay: add binary copy directory, copy -# dvi, pdf, and ps if it exists -# Chris Monson (2009-09-25): -# * Bumped version to 2.1.32 -# * Fixed so that a changed lol file will cause a rebuild -# * Added .lol files to the cleanable list -# Chris Monson (2009-09-08): -# * Bumped version to 2.1.31 -# * Closed issue 43: evince doesn't notice pdf change w/out touch -# Chris Monson (2009-08-28): -# * Bumped version to 2.1.30 -# * Closed issue 39: Capture multi-line log warnings/errors to output -# Chris Monson (2009-08-26): -# * Bumped version to 2.1.29 -# * Closed issue 42: add svg support using inkscape -# Chris Monson (2009-08-17): -# * Bumped version to 2.1.28 -# * Patch from paul.biggar for issue 38: package warnings are overlooked -# Chris Monson (2009-08-07): -# * Bumped version to 2.1.27 -# * Included patch for issue 37 - removes pdf/ps files before copying, -# allowing some broken viewers to see changes properly. -# Chris Monson (2009-05-15): -# * Bumped version to 2.1.26 -# * Included patch for issue 9 from favonia - detects .fig changes for -# pstex files during regular compilation, so long as the pstex -# has been built at least once with make all-pstex. -# Chris Monson (2009-03-27): -# * Bumped version to 2.1.25 -# * Cleaned up a bunch of variable setting stuff - more stuff is now -# settable from Makefile.ini -# * Cleaned up documentation for various features, especially settable -# variables. -# * issue 28: support for png -> eps conversion (it even looks good!) -# * issue 29: support for "neverclean" files in Makefile.ini -# * issue 30: make ps2pdf14 the default - fall back when not there -# Chris Monson (2009-03-09): -# * Bumped version to 2.1.24 -# * issue 27: xmgrace support (thanks to rolandschulzhd) -# Chris Monson (2008-10-23): -# * Bumped version to 2.1.23 -# * issue 23: fixed _check_programs to not use bash string subs -# Chris Monson (2008-09-02): -# * Bumped version to 2.1.22 -# * Appled patch from Holger <yllohy(a)googlemail.com> to add include -# sources and some documentation updates. -# * Updated backup_patterns to be a bit more aggressive (also thanks to -# Holger) -# Chris Monson (2008-08-30): -# * Bumped version to 2.1.21 -# * Added ability to specify onlysources.* variables to indicate the only -# files that should *not* be considered includes. Thanks to Holger -# <yllohy(a)googlemail.com> for this patch. -# * Added an automatic include of Makefile.ini if it exists. Allows -# settings to be made outside of this makefile. -# Chris Monson (2008-05-21): -# * Bumped version to 2.1.20 -# * Added manual pstex compilation support (run make all-pstex first) -# * Removed all automatic pstex support. It was totally breaking -# everything and is very hard to incorporate into the makefile -# concept because it requires LaTeX to *fail* before it can -# determine that it needs the files. -# Chris Monson (2008-04-17): -# * Bumped version to 2.1.19 -# * Changed the pstex build hack to be on by default -# Chris Monson (2008-04-09): -# * Bumped version to 2.1.18 -# * issue 16: fixed pstex build problems, seems nondeterministic. Added -# gratuitious hack for testing: set PSTEX_BUILD_ALL_HACK=1. -# Chris Monson (2008-04-09): -# * Bumped version to 2.1.17 -# * issue 20: fixed accumulation of <pid>*.make files - wildcard was -# refusing to work on files that are very recently created. -# Chris Monson (2008-04-02): -# * Bumped version to 2.1.16 -# * issue 19: Removed the use of "type" to fix broken "echo" settings -# Chris Monson (2008-03-27): -# * Bumped version to 2.1.15 -# * issue 18: Favors binary echo over builtin, as binary understands -n -# * issue 16: Fixed handling of missing pstex_t files in the log -# * issue 9: Added .SECONDARY target for .pstex files -# Chris Monson (2008-03-21): -# * Bumped version to 2.1.14 -# * Fixed broken aux file flattening, which caused included bibs to be -# missed. -# Chris Monson (2008-03-20): -# * Bumped version to 2.1.13 -# * Changed error output colorization to show errors for missing files -# that are not graphics files. -# Chris Monson (2008-03-20): -# * Bumped version to 2.1.12 -# * Fixed a regression introduced in r28 that makes bibtex fail when -# there is no index file present -# Chris Monson (2008-03-03): -# * Bumped version to 2.1.11 -# * Fixed issue 11 (handle index files, reported by abachn) -# * Cleaned up some comments and help text -# Chris Monson (2008-01-24): -# * Bumped version to 2.1.10 -# * Fixed to work when 'sh' is a POSIX shell like 'dash' -# Chris Monson (2007-12-12): -# * Bumped version to 2.1.9 -# * Fixed documentation and dependency graph for pstex files -# Chris Monson (2007-12-12): -# * Bumped version to 2.1.8 -# * Added basic pstex_t support for fig files (Issue 9 by favonia) -# I still suggest that psfrag be used instead. -# Chris Monson (2007-10-16): -# * Bumped version to 2.1.7 -# * Removed todo item: allow other comment directives for rst conversion -# * Added ability to use global rst style file _rststyle_._include_.tex -# * Added help text to that effect -# Chris Monson (2007-05-20): -# * Bumped version to 2.1.6 -# * Changed default paper size for rst files -# * Added todo item: fix paper size for rst files -# * Added todo item: allow other comment directives for rst conversion -# Chris Monson (2007-04-02): -# * Bumped version to 2.1.5 -# * Addressed Issue 7, incorrect .gpi.d generation in subdirectories -# Chris Monson (2007-03-28): -# * Bumped version to 2.1.4 -# * Fixed syntax error in dot output -# Chris Monson (2007-03-01): -# * Bumped version to 2.1.3 -# * Added reST to the included documentation -# * Fixed graphics and script generation to be settable in the -# environment. -# Chris Monson (2007-02-23): -# * Bumped version to 2.1.2 -# * Added the ability to generate .tex files from .rst files -# Chris Monson (2006-10-17): -# * Bumped version to 2.1.1 -# * Fixed includes from subdirectories (sed-to-sed slash escape problem) -# Chris Monson (2006-10-05): -# * Bumped version to 2.1.0 (pretty serious new feature added) -# * New feature: bib files can now be anywhere on the BIBINPUTS path -# * New programs: kpsewhich (with tetex) and xargs (BSD) -# Chris Monson (2006-09-28): -# * Bumped version to 2.0.9 -# * Added ability to parse more than one bibliography -# Chris Monson (2006-06-01): -# * Bumped version to 2.0.8 -# * Added .vrb to the list of cleaned files -# Chris Monson (2006-04-26): -# * Bumped version to 2.0.7 -# * Fixed so that clean-nographics does not remove .gpi.d files -# * Removed jpg -> eps hack (not working properly -- just pre-convert) -# * Fixed so that postscript grayscale can be done with BSD sed -# Chris Monson (2006-04-25): -# * Bumped version to 2.0.6 -# * Fixed so that changed toc, lot, lof, or out causes a rebuild -# Chris Monson (2006-04-17): -# * Bumped version to 2.0.5 -# * Added jpg -> eps conversion target -# Chris Monson (2006-04-12): -# * Bumped version to 2.0.4 -# * Fixed BSD sed invocation to not use \| as a branch delimiter -# * Added a comment section on what is and is not allowed in BSD sed -# * Made paper size handling more robust while I was at it -# * Fixed postscript RGB grayscale to use a weighted average -# * Fixed postscript HSB grayscale to convert to RGB first -# * Fixed a problem with rebuilding .bbl files -# Chris Monson (2006-04-11): -# * Bumped version to 2.0.3 -# * Fixed some BSD sed problems: can't use \n in substitutions -# Chris Monson (2006-04-10): -# * Bumped version to 2.0.2 -# * Once again removed ability to create .tex files from scripts -# * \includeonly works again -# Chris Monson (2006-04-09): -# * Bumped version to 2.0.1 -# * Fixed grayscale postscript handling to be more robust -# * Added ability to generate ._gray_. files from eps and eps.gz -# * Added ability to clean ._gray_.eps files created from .eps files -# Chris Monson (2006-04-07): -# * Bumped version to 2.0.0 -# * Removed clunky ability to create included .tex files from scripts -# * Added note in the help about included tex scripting not working -# * Fixed the .eps generation to delete %.gpihead.make when finished -# * Abandoned designs to use shell variables to create sed scripts -# * Abandoned __default__.tex.sh idea: it causes recursion with %: . -# * Removed web page to-do. All items are now complete. -# * Added better grayscale conversion for dot figures (direct ps fixup). -# * Include files can now be scripted (at the expense of \includeonly). -# * Updated dependency graph to contain better node names. -# Chris Monson (2006-04-06): -# * Bumped version to 2.0b3 -# * Top level includes now fail if there is no rule to build them -# * A helpful message is printed when they do fail -# * Grayscale has been changed to be ._gray_, other phonies use _ now, too -# * Grayscale handling has been completed -# * Changed _include_stems target to _includes target. -# * Fixed _includes target to be useful by itself. -# * Removed the ability to specify clean and build targets at once -# * Verified that epsfig works fine with current code -# * Fixed included scripts so that they are added to the dep files -# * Fixed so that graphics includes don't happen if they aren't for gpi -# * Fixed dot output to allow grayscale. -# Chris Monson (2006-04-05): -# * Bumped version to 2.0b2 -# * Removed automatic -gray output. It needs fixing in a bad way. -# * Revamped dependency creation completely. -# * Fixed conditional inclusion to actually work (test.nobuild.d, test.d). -# * Fixed clean target to remove log targets -# * Added the 'monochrome' word for gray gpi output -# * Added a _check_gpi_files target that checks for common problems -# * Changed the _version target into the version target (no _) -# * Added better handling of grayscale files. Use the .gray.pdf target. -# * Fixed testing for rebuilds -# Chris Monson (2006-04-04): -# * Bumped version to 2.0b1 -# * Changed colorization of output -# * Made .auxbbl and .auxtex .make files secondary targets -# * Shortened and simplified the final latex invocation loop -# * Added version-specific output ($$i vs. $$$$i) in latex loop -# * Added a build message for the first .dvi run (Building .dvi (0)) -# * Removed some build messages that most people don't care about. -# * Simplified procedure for user-set colors -- simple text specification -# * Fixed diff output to...not output. -# * Fixed rerun bug -- detect not only when preceded with LaTeX Warning -# * Sped up gpi plotting -# * Added error handling and colorized output for gpi failure -# * Documented color changing stuff. -# * Now sort the flattened aux file to avoid false recompilation needs -# * Added clean-nographics target -# * Don't remove self.dvi file if self.aux is missing in the log -# * Clarified some code. Did some very minor adjusting. -# Chris Monson (2006-04-03): -# * Bumped version to 2.0a7 -# * Added .dvi and .ps files as secondary files. -# * Fixed handling of multiple run detection when includeonly is in use. -# * Added code to flatten .aux files. -# * Added more files as .SECONDARY prerequisites to avoid recompilation. -# * Fixed the inputs generation to be much simpler and to use pipes. -# * Added the dependency graph directly into the makefile. -# * Changed flatten-aux to remove \@writefile \relax \newlabel, etc. -# * Undid pipe changes with sed usage (BSD sed doesn't know -f-). -# * Added a _check_programs target that tells you what your system has. -# * Fixed an error in colorization that made unnecessary errors appear -# * Added view targets. -# * Updated help text. -# * Augmented cookies so that .aux can trigger .bbl and .dvi rebuilds -# * Added more informative error handling for dvips and ps2pdf -# Chris Monson (2006-04-02): -# * Bumped version to 2.0a6 -# * Added indirection to .bbl dependencies to avoid rebuilding .bbl files -# * Streamlined the diff invocation to eliminate an existence test -# * Removed special shell quote escape variables -# * Moved includes to a more prominent location -# * Fixed .inputs.make to not contain .aux files -# * Fixed embedding to use a file instead of always grepping. -# * Added *.make.temp to the list of cleanable files -# * Fixed Ruby. It should now be supported properly. -# * Now differentiate between all, default, and buildable files. -# * Fixed to bail out on serious errors. -# * Revised the handling of includable files. Still working on it. -# Chris Monson (2006-03-31): -# * Bumped version to 2.0a5 -# * Fixed a bug with LaTeX error detection (there can be spaces) -# * Added .bbl support, simplifying everything and making it more correct -# * Refactored some tests that muddy the code -# * Did a little cleanup of some shell loops that can safely be make loops -# * Added support for graphviz .dot files -# * Made _all_programs output easier to read -# * Added the ruby support that has long been advertised -# * Font embedding was screwed up for PostScript -- now implicit -# * Changed the generation of -gray.gpi files to a single command -# * Changed any make-generated file that is not included from .d to .make -# Chris Monson (2006-03-30): -# * Bumped version to 2.0a4 -# * Fixed a bug with very long graphics file names -# * Added a todo entry for epsfig support -# * Fixed a bug paper size bug: sometimes more than one entry appears -# * Fixed DVI build echoing to display the number instead of process ID -# * DVI files are now removed on first invocation if ANY file is missing -# * Added a simple grayscale approach: if a file ends with -gray.gpi, it -# is created from the corresponding .gpi file with a special -# comment ##GRAY in its header, which causes coloring to be -# turned off. -# * Fixed a bug in the handling of .tex.sh files. For some reason I had -# neglected to define file stems for scripted output. -# * Removed a trailing ; from the %.graphics dependencies -# * Added dvips embedding (I think it works, anyway) -# Chris Monson (2006-03-29): -# * Bumped version to 2.0a3 -# * Fixed error in make 3.79 with MAKEFILE_LIST usage -# * Added the presumed filename to the _version output -# * Added a vim macro for converting sed scripts to make commands -# * Added gpi dependency support (plotting external files and loading gpi) -# * Allow .gpi files to be ignored if called .include.gpi or .nobuild.gpi -# * Fixed sed invocations where \+ was used. BSD sed uses \{1,\}. -# Chris Monson (2006-03-28): -# * Bumped version to 2.0a2 -# * Added SHELL_DEBUG and VERBOSE options -# * Changed the default shell back to /bin/sh (unset, in other words) -# * Moved .PHONY declarations closer to their targets -# * Moved help text into its own define block to obtain better formatting -# * Removed need for double-entry when adding a new program invocation -# * Moved .SECONDARY declaration closer to its relevant occurrence -# * Commented things more heavily -# * Added help text about setting terminal and output in gnuplot -# * Created more fine-grained clean targets -# * Added a %.graphics target that generates all of %'s graphics -# * Killed backward-compatible graphics generation (e.g., eps.gpi=gpi.eps) -# * For now, we're just GPL 2, not 3. Maybe it will change later -# * Made the version and svninfo into variables -# Chris Monson (2006-03-27): -# * Bumped version to 2.0a1 -# * Huge, sweeping changes -- automatic dependencies -# - -# IMPORTANT! -# -# When adding to the following list, do not introduce any blank lines. The -# list is extracted for documentation using sed and is terminated by a blank -# line. -# -# EXTERNAL PROGRAMS: -# = ESSENTIAL PROGRAMS = -# == Basic Shell Utilities == -CAT ?= cat -CP ?= cp -f -DIFF ?= diff -ECHO ?= echo -EGREP ?= egrep -ENV ?= env -EXPR ?= expr -MV ?= mv -f -SED ?= sed -SORT ?= sort -TOUCH ?= touch -UNIQ ?= uniq -WHICH ?= which -XARGS ?= xargs -SLEEP ?= sleep -# == LaTeX (tetex-provided) == -BIBTEX ?= bibtex -DVIPS ?= dvips -LATEX ?= latex -PDFLATEX ?= pdflatex -XELATEX ?= xelatex -EPSTOPDF ?= epstopdf -MAKEINDEX ?= makeindex -XINDY ?= xindy -KPSEWHICH ?= kpsewhich -GS ?= gs -# = OPTIONAL PROGRAMS = -# == For MikTex under Cygwin, to get path names right -CYGPATH ?= cygpath -# == Makefile Color Output == -TPUT ?= tput -# == TeX Generation == -PERL ?= perl -PYTHON ?= python -RST2LATEX ?= rst2latex.py -# == EPS Generation == -CONVERT ?= convert # ImageMagick -DOT ?= dot # GraphViz -DOT2TEX ?= dot2tex # dot2tex - add options (not -o) as needed -FIG2DEV ?= fig2dev # XFig -GNUPLOT ?= gnuplot # GNUplot -INKSCAPE ?= inkscape # Inkscape (svg support) -XMGRACE ?= xmgrace # XMgrace -PNGTOPNM ?= pngtopnm # From NetPBM - step 1 for png -> eps -PPMTOPGM ?= ppmtopgm # From NetPBM - (gray) step 2 for png -> eps -PNMTOPS ?= pnmtops # From NetPBM - step 3 for png -> eps -GUNZIP ?= gunzip # GZipped EPS -# == Beamer Enlarged Output == -PSNUP ?= psnup -# == Viewing Stuff == -VIEW_POSTSCRIPT ?= gv -VIEW_PDF ?= xpdf -VIEW_GRAPHICS ?= display - -# Xindy glossaries -XINDYLANG ?= english -XINDYENC ?= utf8 - -# If cygpath is present, then we create a path-norm function that uses it, -# otherwise the function is just a no-op. Issue 112 has details. -USE_CYGPATH := $(if $(shell $(WHICH) $(CYGPATH) 2>/dev/null),yes,) - -# $(call get-cygpath,<path>) -define get-cygpath -$(shell $(CYGPATH) -u "$(shell $(CYGPATH) -s -w $1)") -endef - -define path-norm -$(if $(USE_CYGPATH),$(call get-cygpath,$1),$1) -endef - -# Command options for embedding fonts and postscript->pdf conversion -PS_EMBED_OPTIONS ?= -dPDFSETTINGS=/printer -dEmbedAllFonts=true -dSubsetFonts=true -dMaxSubsetPct=100 -PS_COMPATIBILITY ?= 1.4 - -# If set to something, will cause temporary files to not be deleted immediately -KEEP_TEMP ?= - -# Defaults for GPI -DEFAULT_GPI_EPS_FONTSIZE ?= 22 -DEFAULT_GPI_PDF_FONTSIZE ?= 12 - -# Style file for ReST -RST_STYLE_FILE ?= $(wildcard _rststyle_._include_.tex) - -# This ensures that even when echo is a shell builtin, we still use the binary -# (the builtin doesn't always understand -n) -FIXED_ECHO := $(if $(findstring -n,$(shell $(ECHO) -n)),$(shell which echo),$(ECHO)) -ECHO := $(if $(FIXED_ECHO),$(FIXED_ECHO),$(ECHO)) - -define determine-gnuplot-output-extension -$(if $(shell $(WHICH) $(GNUPLOT) 2>/dev/null), - $(if $(findstring unknown or ambiguous, $(shell $(GNUPLOT) -e "set terminal pdf" 2>&1)), - eps, pdf), - none) -endef - -GNUPLOT_OUTPUT_EXTENSION ?= $(strip $(call determine-gnuplot-output-extension)) - -# Internal code should use this because of :=. This means that the potentially -# expensive script invocation used to determine whether pdf is available will -# only be run once. -GPI_OUTPUT_EXTENSION := $(strip $(GNUPLOT_OUTPUT_EXTENSION)) - -# Note, if the terminal *does* understand fsize, then we expect this call to -# create a specific error here: "fsize: expecting font size". Otherwise, we -# assume that fsize is not understood. -GPI_FSIZE_SYNTAX := $(strip \ -$(if \ - $(filter pdf,$(GPI_OUTPUT_EXTENSION)),\ - $(if \ - $(findstring fsize: expecting font size,$(shell $(GNUPLOT) -e "set terminal pdf fsize" 2>&1)),\ - fsize FONTSIZE,\ - font ",FONTSIZE"),\ - FONTSIZE)) - -# Directory into which we place "binaries" if it exists. -# Note that this can be changed on the commandline or in Makefile.ini: -# -# Command line: -# make BINARY_TARGET_DIR=$HOME/pdfs myfile.pdf -# -# Also, you can specify a relative directory (relative to the Makefile): -# make BINARY_TARGET_DIR=pdfs myfile.pdf -# -# Or, you can use Makefile.ini: -# -# BINARY_TARGET_DIR := $(HOME)/bin_out -# -BINARY_TARGET_DIR ?= _out_ - -RESTARTS := $(if $(MAKE_RESTARTS),$(MAKE_RESTARTS),0) -# SH NOTES -# -# On some systems, /bin/sh, which is the default shell, is not linked to -# /bin/bash. While bash is supposed to be sh-compatible when invoked as sh, it -# just isn't. This section details some of the things you have to stay away -# from to remain sh-compatible. -# -# * File pattern expansion does not work for {} -# * [ "$x" = "$y" ] has to be [ x"$x" x"$y" ] -# * &> for stderr redirection doesn't work, use 2>&1 instead -# -# BSD SED NOTES -# -# BSD SED is not very nice compared to GNU sed, but it is the most -# commonly-invoked sed on Macs (being based on BSD), so we have to cater to -# it or require people to install GNU sed. It seems like the GNU -# requirement isn't too bad since this makefile is really a GNU makefile, -# but apparently GNU sed is much less common than GNU make in general, so -# I'm supporting it here. -# -# Sad experience has taught me the following about BSD sed: -# -# * \+ is not understood to mean \{1,\} -# * \| is meaningless (does not branch) -# * \n cannot be used as a substitution character -# * ? does not mean \{0,1\}, but is literal -# * a\ works, but only reliably for a single line if subsequent lines -# have forward slashes in them (as is the case in postscript) -# -# For more info (on the Mac) you can consult -# -# man -M /usr/share/man re_format -# -# And look for the word "Obsolete" near the bottom. - -# -# EXTERNAL PROGRAM DOCUMENTATION SCRIPT -# - -# $(call output-all-programs,[<output file>]) -define output-all-programs - [ -f '$(this_file)' ] && \ - $(SED) \ - -e '/^[[:space:]]*#[[:space:]]*EXTERNAL PROGRAMS:/,/^$$/!d' \ - -e '/EXTERNAL PROGRAMS/d' \ - -e '/^$$/d' \ - -e '/^[[:space:]]*#/i\ '\ - -e 's/^[[:space:]]*#[[:space:]][^=]*//' \ - $(this_file) $(if $1,> '$1',) || \ - $(ECHO) "Cannot determine the name of this makefile." -endef - -# If they misspell gray, it should still work. -GRAY ?= $(call get-default,$(GREY),) - -# -# Utility Functions and Definitions -# - -# Don't call this directly - it is here to avoid calling wildcard more than -# once in remove-files. -remove-files-helper = $(if $1,$(RM) $1,$(sh_true)) - -# $(call remove-files,file1 file2) -remove-files = $(call remove-files-helper,$(wildcard $1)) - -# Removes all cleanable files in the given list -# $(call clean-files,file1 file2 file3 ...) -# Works exactly like remove-files, but filters out files in $(neverclean) -clean-files = \ - $(call remove-files-helper,$(call cleanable-files,$(wildcard $1))) - -# Outputs all generated files to STDOUT, along with some others that are -# created by these (e.g., .idx files end up producing .ilg and .ind files). -# Discovered by reading *.fls OUTPUT lines and producing corresponding .ind -# filenames as needed. -# -# $(call get-generated-names,<source recorder file (*.fls)>) -define get-generated-names -[ -f '$1' ] && \ -$(SED) \ - -e '/^OUTPUT /{' \ - -e ' s///' \ - -e ' p' \ - -e ' s/\.idx/\.ind/p' \ - -e ' s/\.ind/\.ilg/p' \ - -e '}' \ - -e 'd' \ - '$1' \ -| $(SORT) | $(UNIQ) -endef - -# This removes files without checking whether they are there or not. This -# sometimes has to be used when the file is created by a series of shell -# commands, but there ends up being a race condition: make doesn't know about -# the file generation as quickly as the system does, so $(wildcard ...) doesn't -# work right. Blech. -# $(call remove-temporary-files,filenames) -remove-temporary-files = $(if $(KEEP_TEMP),:,$(if $1,$(RM) $1,:)) - -# Create an identifier from a file name -# $(call cleanse-filename,filename) -cleanse-filename = $(subst .,_,$(subst /,__,$1)) - -# Escape dots -# $(call escape-fname-regex,str) -escape-fname-regex = $(subst /,\\/,$(subst .,\\.,$1)) - -# Test that a file exists -# $(call test-exists,file) -test-exists = [ -e '$1' ] - -# $(call move-files,source,destination) -move-if-exists = $(call test-exists,$1) && $(MV) '$1' '$2' - -# Copy file1 to file2 only if file2 doesn't exist or they are different -# $(call copy-if-different,sfile,dfile) -copy-if-different = $(call test-different,$1,$2) && $(CP) '$1' '$2' -copy-if-exists = $(call test-exists,$1) && $(CP) '$1' '$2' -move-if-different = $(call test-different,$1,$2) && $(MV) '$1' '$2' -replace-if-different-and-remove = \ - $(call test-different,$1,$2) \ - && $(MV) '$1' '$2' \ - || $(call remove-files,'$1') - -# Note that $(DIFF) returns success when the files are the SAME.... -# $(call test-different,sfile,dfile) -test-different = ! $(DIFF) -q '$1' '$2' >/dev/null 2>&1 -test-exists-and-different = \ - $(call test-exists,$2) && $(call test-different,$1,$2) - -# Return value 1, or value 2 if value 1 is empty -# $(call get-default,<possibly empty arg>,<default value if empty>) -get-default = $(if $1,$1,$2) - -# Copy a file and log what's going on -# $(call copy-with-logging,<source>,<target>) -define copy-with-logging -if [ -d '$2/' ]; then \ - if $(CP) '$1' '$2/'; then \ - $(ECHO) "$(C_INFO)Copied '$1' to '$2/'$(C_RESET)"; \ - else \ - $(ECHO) "$(C_ERROR)Failed to copy '$1' to '$2/'$(C_RESET)"; \ - fi; \ -fi -endef - -# Gives a reassuring message about the failure to find include files -# $(call include-message,<list of include files>) -define include-message -$(strip \ -$(if $(filter-out $(wildcard $1),$1),\ - $(shell $(ECHO) \ - "$(C_INFO)NOTE: You may ignore warnings about the"\ - "following files:" >&2;\ - $(ECHO) >&2; \ - $(foreach s,$(filter-out $(wildcard $1),$1),$(ECHO) ' $s' >&2;)\ - $(ECHO) "$(C_RESET)" >&2) -)) -endef -# Characters that are hard to specify in certain places -space := $(empty) $(empty) -colon := \: -comma := , - -# Useful shell definitions -sh_true := : -sh_false := ! : - -# Clear out the standard interfering make suffixes -.SUFFIXES: - -# Turn off forceful rm (RM is usually mapped to rm -f) -ifdef SAFE_RM -RM := rm -endif - -# Turn command echoing back on with VERBOSE=1 -ifndef VERBOSE -QUIET := @ -endif - -# Turn on shell debugging with SHELL_DEBUG=1 -# (EVERYTHING is echoed, even $(shell ...) invocations) -ifdef SHELL_DEBUG -SHELL += -x -endif - -# Get the name of this makefile (always right in 3.80, often right in 3.79) -# This is only really used for documentation, so it isn't too serious. -ifdef MAKEFILE_LIST -this_file := $(word $(words $(MAKEFILE_LIST)),$(MAKEFILE_LIST)) -else -this_file := $(wildcard GNUmakefile makefile Makefile) -endif - -# Terminal color definitions - -REAL_TPUT := $(if $(NO_COLOR),,$(shell $(WHICH) $(TPUT))) - -# $(call get-term-code,codeinfo) -# e.g., -# $(call get-term-code,setaf 0) -get-term-code = $(if $(REAL_TPUT),$(shell $(REAL_TPUT) $1),) - -black := $(call get-term-code,setaf 0) -red := $(call get-term-code,setaf 1) -green := $(call get-term-code,setaf 2) -yellow := $(call get-term-code,setaf 3) -blue := $(call get-term-code,setaf 4) -magenta := $(call get-term-code,setaf 5) -cyan := $(call get-term-code,setaf 6) -white := $(call get-term-code,setaf 7) -bold := $(call get-term-code,bold) -uline := $(call get-term-code,smul) -reset := $(call get-term-code,sgr0) - -# -# User-settable definitions -# -LATEX_COLOR_WARNING ?= magenta -LATEX_COLOR_ERROR ?= red -LATEX_COLOR_INFO ?= green -LATEX_COLOR_UNDERFULL ?= magenta -LATEX_COLOR_OVERFULL ?= red bold -LATEX_COLOR_PAGES ?= bold -LATEX_COLOR_BUILD ?= cyan -LATEX_COLOR_GRAPHIC ?= yellow -LATEX_COLOR_DEP ?= green -LATEX_COLOR_SUCCESS ?= green bold -LATEX_COLOR_FAILURE ?= red bold - -# Gets the real color from a simple textual definition like those above -# $(call get-color,ALL_CAPS_COLOR_NAME) -# e.g., $(call get-color,WARNING) -get-color = $(subst $(space),,$(foreach c,$(LATEX_COLOR_$1),$($c))) - -# -# STANDARD COLORS -# -C_WARNING := $(call get-color,WARNING) -C_ERROR := $(call get-color,ERROR) -C_INFO := $(call get-color,INFO) -C_UNDERFULL := $(call get-color,UNDERFULL) -C_OVERFULL := $(call get-color,OVERFULL) -C_PAGES := $(call get-color,PAGES) -C_BUILD := $(call get-color,BUILD) -C_GRAPHIC := $(call get-color,GRAPHIC) -C_DEP := $(call get-color,DEP) -C_SUCCESS := $(call get-color,SUCCESS) -C_FAILURE := $(call get-color,FAILURE) -C_RESET := $(reset) - -# -# PRE-BUILD TESTS -# - -# Check that clean targets are not combined with other targets (weird things -# happen, and it's not easy to fix them) -hascleangoals := $(if $(sort $(filter clean clean-%,$(MAKECMDGOALS))),1) -hasbuildgoals := $(if $(sort $(filter-out clean clean-%,$(MAKECMDGOALS))),1) -ifneq "$(hasbuildgoals)" "" -ifneq "$(hascleangoals)" "" -$(error $(C_ERROR)Clean and build targets specified together$(C_RESET))) -endif -endif - -# -# VARIABLE DECLARATIONS -# - -# Names of sed scripts that morph gnuplot files -- only the first found is used -GNUPLOT_SED := global-gpi.sed gnuplot.sed -GNUPLOT_GLOBAL := global._include_.gpi gnuplot.global - -ifeq "$(strip $(BUILD_STRATEGY))" "latex" -default_graphic_extension ?= eps -latex_build_program ?= $(LATEX) -build_target_extension ?= dvi -hyperref_driver_pattern ?= hdvips -hyperref_driver_error ?= Using dvips: specify ps2pdf in the hyperref options. -endif - -ifeq "$(strip $(BUILD_STRATEGY))" "pdflatex" -default_graphic_extension ?= pdf -latex_build_program ?= $(PDFLATEX) -build_target_extension ?= pdf -hyperref_driver_pattern ?= hpdf.* -hyperref_driver_error ?= Using pdflatex: specify pdftex in the hyperref options (or leave it blank). -endif - -ifeq "$(strip $(BUILD_STRATEGY))" "xelatex" -default_graphic_extension ?= pdf -latex_build_program ?= $(XELATEX) -build_target_extension ?= pdf -hyperref_driver_pattern ?= hdvipdf.* -hyperref_driver_error ?= Using pdflatex: specify pdftex in the hyperref options (or leave it blank). -endif - -# Files of interest -all_files.tex ?= $(wildcard *.tex) -all_files.tex.sh ?= $(wildcard *.tex.sh) -all_files.tex.pl ?= $(wildcard *.tex.pl) -all_files.tex.py ?= $(wildcard *.tex.py) -all_files.rst ?= $(wildcard *.rst) -all_files.fig ?= $(wildcard *.fig) -all_files.gpi ?= $(wildcard *.gpi) -all_files.dot ?= $(wildcard *.dot) -all_files.xvg ?= $(wildcard *.xvg) -all_files.svg ?= $(wildcard *.svg) -all_files.png ?= $(wildcard *.png) -all_files.jpg ?= $(wildcard *.jpg) -all_files.jpeg ?= $(wildcard *.jpeg) -all_files.eps.gz ?= $(wildcard *.eps.gz) -all_files.eps ?= $(wildcard *.eps) - -# Utility function for obtaining all files not specified in $(neverclean) -# $(call cleanable-files,file1 file2 file3 ...) -# Returns the list of files that is not in $(wildcard $(neverclean)) -cleanable-files = $(filter-out $(wildcard $(neverclean)), $1) - -# Utility function for getting all .$1 files that are to be ignored -# * files listed in $(includes.$1) -# * files not listed in $(onlysources.$1) if it is defined -ignore_files = \ - $(includes.$1) \ - $(if $(onlysources.$1),$(filter-out $(onlysources.$1), $(all_files.$1))) - -# Patterns to never be allowed as source targets -ignore_patterns := %._include_ - -# Patterns allowed as source targets but not included in 'all' builds -nodefault_patterns := %._nobuild_ $(ignore_patterns) - -# Utility function for getting targets suitable building -# $(call filter-buildable,suffix) -filter-buildable = \ - $(filter-out $(call ignore_files,$1) \ - $(addsuffix .$1,$(ignore_patterns)),$(all_files.$1)) - -# Utility function for getting targets suitable for 'all' builds -# $(call filter-default,suffix) -filter-default = \ - $(filter-out $(call ignore_files,$1) \ - $(addsuffix .$1,$(nodefault_patterns)),$(all_files.$1)) - -# Top level sources that can be built even when they are not by default -files.tex := $(call filter-buildable,tex) -files.tex.sh := $(call filter-buildable,tex.sh) -files.tex.pl := $(call filter-buildable,tex.pl) -files.tex.py := $(call filter-buildable,tex.py) -files.rst := $(call filter-buildable,rst) -files.gpi := $(call filter-buildable,gpi) -files.dot := $(call filter-buildable,dot) -files.fig := $(call filter-buildable,fig) -files.xvg := $(call filter-buildable,xvg) -files.svg := $(call filter-buildable,svg) -files.png := $(call filter-buildable,png) -files.jpg := $(call filter-buildable,jpg) -files.jpeg := $(call filter-buildable,jpeg) -files.eps.gz := $(call filter-buildable,eps.gz) -files.eps := $(call filter-buildable,eps) - -# Make all pstex targets secondary. The pstex_t target requires the pstex -# target, and nothing else really depends on it, so it often gets deleted. -# This avoids that by allowing *all* fig files to be pstex targets, which is -# perfectly valid and causes no problems even if they're going to become eps -# files in the end. -.SECONDARY: $(patsubst %.fig,%.pstex,$(files.fig)) - -# Top level sources that are built by default targets -default_files.tex := $(call filter-default,tex) -default_files.tex.sh := $(call filter-default,tex.sh) -default_files.tex.pl := $(call filter-default,tex.pl) -default_files.tex.py := $(call filter-default,tex.py) -default_files.rst := $(call filter-default,rst) -default_files.gpi := $(call filter-default,gpi) -default_files.dot := $(call filter-default,dot) -default_files.fig := $(call filter-default,fig) -default_files.xvg := $(call filter-default,xvg) -default_files.svg := $(call filter-default,svg) -default_files.png := $(call filter-default,png) -default_files.jpg := $(call filter-default,jpg) -default_files.jpeg := $(call filter-default,jpeg) -default_files.eps.gz := $(call filter-default,eps.gz) -default_files.eps := $(call filter-default,eps) - -# Utility function for creating larger lists of files -# $(call concat-files,suffixes,[prefix]) -concat-files = $(foreach s,$1,$($(if $2,$2_,)files.$s)) - -# Useful file groupings -all_files_source := $(call concat-files,tex,all) -all_files_scripts := $(call concat-files,tex.sh tex.pl tex.py rst,all) - -.PHONY: $(all_files_scripts) - -default_files_source := $(call concat-files,tex,default) -default_files_scripts := $(call concat-files,tex.sh tex.pl tex.py rst,default) - -files_source := $(call concat-files,tex) -files_scripts := $(call concat-files,tex.sh tex.pl tex.py rst) - -# Utility function for obtaining stems -# $(call get-stems,suffix,[prefix]) -get-stems = $(sort $($(if $2,$2_,)files.$1:%.$1=%)) - -# List of all stems (including ._include_ and ._nobuild_ file stems) -all_stems.tex := $(call get-stems,tex,all) -all_stems.tex.sh := $(call get-stems,tex.sh,all) -all_stems.tex.pl := $(call get-stems,tex.pl,all) -all_stems.tex.py := $(call get-stems,tex.py,all) -all_stems.rst := $(call get-stems,rst,all) -all_stems.fig := $(call get-stems,fig,all) -all_stems.gpi := $(call get-stems,gpi,all) -all_stems.dot := $(call get-stems,dot,all) -all_stems.xvg := $(call get-stems,xvg,all) -all_stems.svg := $(call get-stems,svg,all) -all_stems.png := $(call get-stems,png,all) -all_stems.jpg := $(call get-stems,jpg,all) -all_stems.jpeg := $(call get-stems,jpeg,all) -all_stems.eps.gz := $(call get-stems,eps.gz,all) -all_stems.eps := $(call get-stems,eps,all) - -# List of all default stems (all default PDF targets): -default_stems.tex := $(call get-stems,tex,default) -default_stems.tex.sh := $(call get-stems,tex.sh,default) -default_stems.tex.pl := $(call get-stems,tex.pl,default) -default_stems.tex.py := $(call get-stems,tex.py,default) -default_stems.rst := $(call get-stems,rst,default) -default_stems.fig := $(call get-stems,fig,default) -default_stems.gpi := $(call get-stems,gpi,default) -default_stems.dot := $(call get-stems,dot,default) -default_stems.xvg := $(call get-stems,xvg,default) -default_stems.svg := $(call get-stems,svg,default) -default_stems.png := $(call get-stems,png,default) -default_stems.jpg := $(call get-stems,jpg,default) -default_stems.jpeg := $(call get-stems,jpeg,default) -default_stems.eps.gz := $(call get-stems,eps.gz,default) -default_stems.eps := $(call get-stems,eps,default) - -# List of all stems (all possible bare PDF targets created here): -stems.tex := $(call get-stems,tex) -stems.tex.sh := $(call get-stems,tex.sh) -stems.tex.pl := $(call get-stems,tex.pl) -stems.tex.py := $(call get-stems,tex.py) -stems.rst := $(call get-stems,rst) -stems.fig := $(call get-stems,fig) -stems.gpi := $(call get-stems,gpi) -stems.dot := $(call get-stems,dot) -stems.xvg := $(call get-stems,xvg) -stems.svg := $(call get-stems,svg) -stems.png := $(call get-stems,png) -stems.jpg := $(call get-stems,jpg) -stems.jpeg := $(call get-stems,jpeg) -stems.eps.gz := $(call get-stems,eps.gz) -stems.eps := $(call get-stems,eps) - -# Utility function for creating larger lists of stems -# $(call concat-stems,suffixes,[prefix]) -concat-stems = $(sort $(foreach s,$1,$($(if $2,$2_,)stems.$s))) - -# The most likely to be source but not finished product go first -graphic_source_extensions := fig \ - gpi \ - xvg \ - svg \ - dot \ - eps.gz - -ifeq "$(strip $(BUILD_STRATEGY))" "latex" -graphic_source_extensions += png jpg jpeg -graphic_target_extensions := eps ps -endif - -ifeq "$(strip $(BUILD_STRATEGY))" "pdflatex" -graphic_source_extensions += eps -graphic_target_extensions := pdf png jpg jpeg mps tif -endif - -ifeq "$(strip $(BUILD_STRATEGY))" "xelatex" -graphic_source_extensions += eps -graphic_target_extensions := pdf png jpg jpeg mps tif -endif - -all_stems_source := $(call concat-stems,tex,all) -all_stems_script := $(call concat-stems,tex.sh tex.pl tex.py rst,all) -all_stems_graphic := $(call concat-stems,$(graphic_source_extensions),all) -all_stems_ss := $(sort $(all_stems_source) $(all_stems_script)) -all_stems_sg := $(sort $(all_stems_script)) -all_stems_ssg := $(sort $(all_stems_ss)) - -default_stems_source := $(call concat-stems,tex,default) -default_stems_script := $(call concat-stems,tex.sh tex.pl tex.py rst,default) -default_stems_ss := $(sort $(default_stems_source) $(default_stems_script)) -default_stems_sg := $(sort $(default_stems_script)) -default_stems_ssg := $(sort $(default_stems_ss)) - -stems_source := $(call concat-stems,tex) -stems_script := $(call concat-stems,tex.sh tex.pl tex.py rst) -stems_graphic := $(call concat-stems,$(graphic_source_extensions)) -stems_gg := $(sort $(stems_graphic)) -stems_ss := $(sort $(stems_source) $(stems_script)) -stems_sg := $(sort $(stems_script)) -stems_ssg := $(sort $(stems_ss)) - -# Calculate names that can generate the need for an include file. We can't -# really do this with patterns because it's too easy to screw up, so we create -# an exhaustive list. -allowed_source_suffixes := \ - pdf \ - ps \ - dvi \ - ind \ - nls \ - bbl \ - aux \ - aux.make \ - d \ - auxbbl.make \ - _graphics \ - _show -allowed_source_patterns := $(addprefix %.,$(allowed_source_suffixes)) - -allowed_graphic_suffixes := \ - pdf \ - eps \ - gpihead.make \ - gpi.d -allowed_graphic_patterns := $(addprefix %.,$(allowed_graphic_suffixes)) - -# All targets allowed to build documents -allowed_source_targets := \ - $(foreach suff,$(allowed_source_suffixes),\ - $(addsuffix .$(suff),$(stems_ssg))) - -# All targets allowed to build graphics -allowed_graphic_targets := \ - $(foreach suff,$(allowed_graphic_suffixes),\ - $(addsuffix .$(suff),$(stems_gg))) - -# All targets that build multiple documents (like 'all') -allowed_batch_source_targets := \ - all \ - all-pdf \ - all-ps \ - all-dvi \ - all-bbl \ - all-ind \ - all-gls \ - all-nls \ - show - -# All targets that build multiple graphics (independent of document) -allowed_batch_graphic_targets := \ - all-graphics \ - all-pstex \ - all-dot2tex \ - show-graphics - -# Now we figure out which stuff is available as a make target for THIS RUN. -real_goals := $(call get-default,$(filter-out _includes,$(MAKECMDGOALS)),\ - all) - -specified_source_targets := $(strip \ - $(filter $(allowed_source_targets) $(stems_ssg),$(real_goals)) \ - ) - -specified_batch_source_targets := $(strip \ - $(filter $(allowed_batch_source_targets),$(real_goals)) \ - ) - -specified_graphic_targets := $(strip \ - $(filter $(allowed_graphic_targets),$(real_goals)) \ - ) - -specified_batch_graphic_targets := $(strip \ - $(filter $(allowed_batch_graphic_targets),$(real_goals)) \ - ) - -specified_gpi_targets := $(patsubst %.gpi,%.$(default_graphic_extension),\ - $(filter $(patsubst %.$(default_graphic_extension),%.gpi,$(specified_graphic_targets)),\ - $(all_files.gpi)) \ - ) - -# Determine which .d files need including from the information gained above. -# This is done by first checking whether a batch target exists. If it does, -# then all *default* stems are used to create possible includes (nobuild need -# not apply for batch status). If no batch targets exist, then the individual -# targets are considered and appropriate includes are taken from them. -source_stems_to_include := \ - $(sort\ - $(if $(specified_batch_source_targets),\ - $(default_stems_ss),\ - $(foreach t,$(specified_source_targets),\ - $(foreach p,$(allowed_source_patterns),\ - $(patsubst $p,%,$(filter $p $(stems_ssg),$t)) \ - )) \ - )) - -# Determine which .gpi.d files are needed using the above information. We -# first check whether a batch target is specified, then check individual -# graphics that may have been specified. -graphic_stems_to_include := \ - $(sort\ - $(if $(specified_batch_graphic_targets),\ - $(default_stems.gpi),\ - $(foreach t,$(specified_gpi_targets),\ - $(foreach p,$(allowed_graphic_patterns),\ - $(patsubst $p,%,$(filter $p,$t)) \ - )) \ - )) - -# All dependencies for the 'all' targets -all_pdf_targets := $(addsuffix .pdf,$(stems_ssg)) -all_ps_targets := $(addsuffix .ps,$(stems_ssg)) -all_dvi_targets := $(addsuffix .dvi,$(stems_ssg)) -all_tex_targets := $(addsuffix .tex,$(stems_sg)) -all_d_targets := $(addsuffix .d,$(stems_ssg)) -all_graphics_targets := $(addsuffix .$(default_graphic_extension),$(stems_gg)) -all_pstex_targets := $(addsuffix .pstex_t,$(stems.fig)) -all_dot2tex_targets := $(addsuffix .dot_t,$(stems.dot)) - -all_known_graphics := $(sort $(all_graphics_targets) $(wildcard *.$(default_graphic_extension))) - -default_pdf_targets := $(addsuffix .pdf,$(default_stems_ss)) - -ifeq "$(strip $(BUILD_STRATEGY))" "latex" -default_ps_targets := $(addsuffix .ps,$(default_stems_ss)) -default_dvi_targets := $(addsuffix .dvi,$(default_stems_ss)) -pre_pdf_extensions := dvi ps -endif - -# Extensions generated by LaTeX invocation that can be removed when complete -rm_ext := \ - log *.log aux $(pre_pdf_extensions) pdf blg bbl out nav snm toc lof lot lol pfg \ - fls vrb idx ind ilg glg glo gls lox nls nlo nlg brf mtc maf brf ist -backup_patterns := *~ *.bak *.backup body.tmp head.tmp - -graph_stem := _graph - -# All LaTeX-generated files that can be safely removed - -rm_tex := \ - $(foreach e,$(rm_ext),$(addsuffix .$e,$(all_stems_source))) \ - $(foreach e,$(rm_ext) tex,$(addsuffix .$e,$(all_stems_sg))) \ - $(addsuffix .log,$(all_ps_targets) $(all_pdf_targets)) \ - $(addsuffix .*.log,$(stems_graphic)) - -# These are the files that will affect .gpi transformation for all .gpi files. -# -# Use only the first one found. Backward compatible values are at the end. -# Note that we use foreach, even though wildcard also returns a list, to ensure -# that the order in the uppercase variables is preserved. Directory listings -# provide no such guarantee, so we avoid relying on them. -gpi_sed := $(strip \ - $(firstword $(foreach f,$(GNUPLOT_SED),$(wildcard $f)))) -gpi_global := $(strip \ - $(firstword $(foreach f,$(GNUPLOT_GLOBAL),$(wildcard $f)))) - -# -# Functions used in generating output -# - -# Outputs all source dependencies to stdout. The first argument is the file to -# be parsed, the second is a list of files that will show up as dependencies in -# the new .d file created here. -# -# $(call get-inputs,<parsed file>,<target files>) -define get-inputs -$(SED) \ --e '/^INPUT/!d' \ --e 's!^INPUT $\./$\{0,1\}!!' \ --e 's/[[:space:]]/\\ /g' \ --e 's/$.*$\.aux$$/\1.tex/' \ --e '/\.tex$$/b addtargets' \ --e '/\.cls$$/b addtargets' \ --e '/\.sty$$/b addtargets' \ --e '/\.pstex_t$$/b addtargets' \ --e '/\.dot_t$$/b addtargets' \ --e 'd' \ --e ':addtargets' \ --e 's!.*!$2: $$(call path-norm,&)!' \ -'$1' | $(SORT) | $(UNIQ) -endef - -# $(call get-missing-inputs,<log file>,<target files>) -define get-missing-inputs -$(SED) \ --e '$${' \ --e ' /^$$/!{' \ --e ' H' \ --e ' s/.*//' \ --e ' }' \ --e '}' \ --e '/^$$/!{' \ --e ' H' \ --e ' d' \ --e '}' \ --e '/^$$/{' \ --e ' x' \ --e ' s/^$\n$$.*$/\2\1/' \ --e '}' \ --e '/^::P$P\{1,\}$::/{' \ --e ' s//::\1::/' \ --e ' G' \ --e ' h' \ --e ' d' \ --e '}' \ --e '/^::P::/{' \ --e ' s//::0::/' \ --e ' G' \ --e '}' \ --e 'b start' \ --e ':needonemore' \ --e 's/^/::P::/' \ --e 'G' \ --e 'h' \ --e 'd' \ --e ':needtwomore' \ --e 's/^/::PP::/' \ --e 'G' \ --e 'h' \ --e 'd' \ --e ':needthreemore' \ --e 's/^/::PPP::/' \ --e 'G' \ --e 'h' \ --e 'd' \ --e ':start' \ --e '/^! LaTeX Error: File `/{' \ --e ' b needtwomore' \ --e '}' \ --e '/^::0::$.*$/{' \ --e ' s//\1/' \ --e ' /Default extension: /!d' \ --e ' s/.*File `$[^'"'"']*$'"'"' not found.*/\1/' \ --e ' s/[[:cntrl:]]//' \ --e ' /\.tex/!s/$$/.tex/' \ --e ' s/[[:space:]]/\\ /g' \ --e ' h' \ --e ' s/.*/# MISSING input "&" - (presence of comment affects build)/' \ --e ' p' \ --e ' s/.*//' \ --e ' x' \ --e ' s!^.*!$2: $$(call path-norm,&)!' \ --e ' p' \ --e '}' \ --e 'd' \ -'$1' | $(SORT) | $(UNIQ) -endef - -# Get source file for specified graphics stem. -# -# $(call graphics-source,<stem>) -define graphics-source -$(strip $(firstword \ - $(wildcard \ - $(addprefix $1.,\ - $(graphic_source_extensions))) \ - $1 \ -)) -endef - -# Get the target file for the specified graphics file/stem -# -# $(call graphics-target,<stem>) -define graphics-target -$(strip $(if $(filter $(addprefix %.,$(graphic_target_extensions)),$1), $1, - $(firstword $(patsubst $(addprefix %.,$(graphic_source_extensions) $(graphic_target_extensions)), %, $1).$(default_graphic_extension) $1.$(default_graphic_extension)))) -endef - -# Outputs all of the graphical dependencies to stdout. The first argument is -# the stem of the source file being built, the second is a list of suffixes -# that will show up as dependencies in the generated .d file. -# -# Note that we try to escape spaces in filenames where possible. We have to do -# it with three backslashes so that as the name percolates through the makefile -# it eventually ends up with the proper escaping when the build rule is found. -# Ugly, but it appears to work. Note that graphicx doesn't allow filenames -# with spaces, so this could in many ways be moot unless you're using something -# like grffile. -# -# For pdflatex, we really need the missing file to be specified without an -# extension, otherwise compilation barfs on the first missing file. Truly -# annoying, but there you have it. -# -# It turns out that the graphics errors, although they have lines with empty -# space, are only made of two paragraphs. So, we just use some sed magic to -# get everything into paragraphs, detect when it's a paragraph that interests -# us, and double it up. Then we get the filename only if we're missing -# extensions (a sign that it's graphicx complaining). -# -# $(call get-graphics,<target file stem>) -#.log,$(addprefix $*.,d $(build_target_extension) _graphics) -define get-graphics -$(SED) \ --e '/^File: $.*$ Graphic file (type [^)]*)/{' \ --e ' s//\1/' \ --e ' b addtargets' \ --e '}' \ --e '$${' \ --e ' /^$$/!{' \ --e ' H' \ --e ' s/.*//' \ --e ' }' \ --e '}' \ --e '/^$$/!{' \ --e ' H' \ --e ' d' \ --e '}' \ --e '/^$$/{' \ --e ' x' \ --e ' s/^$\n$$.*$/\2\1/' \ --e '}' \ --e '/^::P$P\{1,\}$::/{' \ --e ' s//::\1::/' \ --e ' G' \ --e ' h' \ --e ' d' \ --e '}' \ --e '/^::P::/{' \ --e ' s//::0::/' \ --e ' G' \ --e '}' \ --e 'b start' \ --e ':needonemore' \ --e 's/^/::P::/' \ --e 'G' \ --e 'h' \ --e 'd' \ --e ':needtwomore' \ --e 's/^/::PP::/' \ --e 'G' \ --e 'h' \ --e 'd' \ --e ':needthreemore' \ --e 's/^/::PPP::/' \ --e 'G' \ --e 'h' \ --e 'd' \ --e ':start' \ --e '/^[^[:cntrl:]:]*:[[:digit:]]\{1,\}: LaTeX Error: File `/{' \ --e ' s/\n//g' \ --e ' b needonemore' \ --e '}' \ --e '/^::0::.*: LaTeX Error: File `/{' \ --e ' /\n\n$$/{' \ --e ' s/^::0:://' \ --e ' b needonemore' \ --e ' }' \ --e ' s/\n\{1,\}/ /g' \ --e ' s/[[:space:]]\{1,\}/ /g' \ --e ' s/^.*File `//' \ --e ' s/'"'"' not found\..*extensions: $[^[:space:]]*$.*/::::\1/' \ --e ' h' \ --e ' s/$.*$::::$.*$/# MISSING stem "\1" - allowed extensions are "\2" - leave comment here - it affects the build/' \ --e ' p' \ --e ' g' \ --e ' s/::::.*//' \ --e ' b addtargets' \ --e '}' \ --e 'd' \ --e ':addtargets' \ --e 's/[[:space:]]/\\\\\\&/g' \ --e 'h' \ --e 's/.*/-include &.gpi.d/' \ --e 'p' \ --e 'g' \ --e 's!.*!$1.d: $$$$(call graphics-source,&)!' \ --e 'p' \ --e 's/.*//' \ --e 'x' \ --e 's!.*!$1.$(build_target_extension) $1._graphics: $$$$(call graphics-target,&)!' \ --e 'p' \ --e 'd' \ -$1.log -endef - -# Checks for build failure due to pstex inclusion, and gives instructions. -# -# $(call die-on-pstexs,<parsed file>) -define die-on-pstexs -if $(EGREP) -q '^! LaTeX Error: File .*\.pstex.* not found' $1; then \ - $(ECHO) "$(C_ERROR)Missing pstex_t file(s)$(C_RESET)"; \ - $(ECHO) "$(C_ERROR)Please run$(C_RESET)"; \ - $(ECHO) "$(C_ERROR) make all-pstex$(C_RESET)"; \ - $(ECHO) "$(C_ERROR)before proceeding.$(C_RESET)"; \ - exit 1; \ -fi -endef - -# Checks for the use of import.sty and bails - we don't support subdirectories -# -# $(call die-on-import-sty,<log file>) -define die-on-import-sty -if $(EGREP) -s '/import.sty\)' '$1'; then \ - $(ECHO) "$(C_ERROR)import.sty is not supported - included files must"; \ - $(ECHO) "$(C_ERROR)be in the same directory as the primary document$(C_RESET)"; \ - exit 1; \ -fi -endef - -# Checks for build failure due to dot2tex, and gives instructions. -# -# $(call die-on-dot2tex,<parsed file>) -define die-on-dot2tex -if $(EGREP) -q ' LaTeX Error: File .*\.dot_t.* not found' $1; then \ - $(ECHO) "$(C_ERROR)Missing dot_t file(s)$(C_RESET)"; \ - $(ECHO) "$(C_ERROR)Please run$(C_RESET)"; \ - $(ECHO) "$(C_ERROR) make all-dot2tex$(C_RESET)"; \ - $(ECHO) "$(C_ERROR)before proceeding.$(C_RESET)"; \ - exit 1; \ -fi -endef - -# Checks for the existence of a .aux file, and dies with an error message if it -# isn't there. Note that we pass the file stem in, not the full filename, -# e.g., to check for foo.aux, we call it thus: $(call die-on-no-aux,foo) -# -# $(call die-on-no-aux,<aux stem>) -define die-on-no-aux -if [ ! -e '$1.aux' ]; then \ - $(call colorize-latex-errors,$1.log); \ - $(ECHO) "$(C_ERROR)Error: failed to create $1.aux$(C_RESET)"; \ - exit 1; \ -fi -endef - -# Outputs all index files to stdout. Arg 1 is the source file stem, arg 2 is -# the list of targets for the discovered dependency. -# -# $(call get-log-index,<log file stem>,<target files>) -define get-log-index -$(SED) \ --e 's/^No file $.*\.ind$\.$$/TARGETS=\1/' \ --e 's/^No file $.*\.[gn]ls$\.$$/TARGETS=\1/' \ --e 's/[[:space:]]/\\&/g' \ --e '/^TARGETS=/{' \ --e ' h' \ --e ' s!^TARGETS=!$2: !p' \ --e ' g' \ --e ' s!^TARGETS=$.*$!\1: $1.tex!p' \ --e '}' \ --e 'd' \ -'$1.log' | $(SORT) | $(UNIQ) -endef - - -# Outputs all bibliography files to stdout. Arg 1 is the source stem, arg 2 is -# a list of targets for each dependency found. -# -# The script kills all lines that do not contain bibdata. Remaining lines have -# the \bibdata macro and delimiters removed to create a dependency list. A -# trailing comma is added, then all adjacent commas are collapsed into a single -# comma. Then commas are replaced with the string .bib[space], and the -# trailing space is killed off. Finally, all filename spaces are escaped. -# This produces a list of space-delimited .bib filenames, which is what the -# make dep file expects to see. -# -# Note that we give kpsewhich a bogus argument so that a failure of sed to -# produce output will not cause an error. -# -# $(call get-bibs,<aux file>,<targets>) -define get-bibs -$(SED) \ --e '/^\\bibdata/!d' \ --e 's/\\bibdata{$[^}]*$}/\1,/' \ --e 's/,\{2,\}/,/g' \ --e 's/[[:space:]]/\\&/g' \ --e 's/,/.bib /g' \ --e 's/ \{1,\}$$//' \ -$1 | $(XARGS) $(KPSEWHICH) '#######' | \ -$(SED) \ --e 's!^!$2: !' | \ -$(SORT) | $(UNIQ) -endef - -# Makes a an aux file that only has stuff relevant to the target in it -# $(call make-auxtarget-file,<flattened-aux>,<new-aux>) -define make-auxtarget-file -$(SED) \ --e '/^\\newlabel/!d' \ -$1 > $2 -endef - -# Makes an aux file that only has stuff relevant to the bbl in it -# $(call make-auxbbl-file,<flattened-aux>,<new-aux>) -define make-auxbbl-file -$(SED) \ --e '/^\\newlabel/d' \ -$1 > $2 -endef - -# Makes a .gpi.d file from a .gpi file -# $(call make-gpi-d,<.gpi>,<.gpi.d>) -define make-gpi-d -$(ECHO) '# vim: ft=make' > $2; \ -$(ECHO) 'ifndef INCLUDED_$(call cleanse-filename,$2)' >> $2; \ -$(ECHO) 'INCLUDED_$(call cleanse-filename,$2) := 1' >> $2; \ -$(call get-gpi-deps,$1,$(addprefix $(2:%.gpi.d=%).,$(GPI_OUTPUT_EXTENSION) gpi.d)) >> $2; \ -$(ECHO) 'endif' >> $2; -endef - -# Parse .gpi files for data and loaded dependencies, output to stdout -# -# The sed script here tries to be clever about obtaining valid -# filenames from the gpi file. It assumes that the plot command starts its own -# line, which is not too difficult a constraint to satisfy. -# -# This command script also generates 'include' directives for every 'load' -# command in the .gpi file. The load command must appear on a line by itself -# and the file it loads must have the suffix .gpi. If you don't want it to be -# compiled when running make graphics, then give it a suffix of ._include_.gpi. -# -# $(call get-gpi-deps,<gpi file>,<targets>) -define get-gpi-deps -$(SED) \ --e '/^[[:space:]]*s\{0,1\}plot/,/[^\\]$$/{' \ --e ' H' \ --e ' /[^\\]$$/{' \ --e ' s/.*//' \ --e ' x' \ --e ' s/\\\{0,1\}\n//g' \ --e ' s/^[[:space:]]*s\{0,1\}plot[[:space:]]*$\[[^]]*\][[:space:]]*$*/,/' \ --e ' s/[[:space:]]*$['"'"'\'"'"''"'"'"][^'"'"'\'"'"''"'"'"]*['"'"'\'"'"''"'"'"]$\{0,1\}[^,]*/\1/g' \ --e ' s/,['"'"'\'"'"''"'"'"]-\{0,1\}['"'"'\'"'"''"'"'"]//g' \ --e ' s/[,'"'"'\'"'"''"'"'"]\{1,\}/ /g' \ --e ' s/.*:.*/$$(error Error: Filenames with colons are not allowed: &)/' \ --e ' s!.*!$2: &!' \ --e ' p' \ --e ' }' \ --e ' d' \ --e '}' \ --e 's/^[[:space:]]*load[[:space:]]*['"'"'\'"'"''"'"'"]$[^'"'"'\'"'"''"'"'"]*\.gpi$['"'"'\'"'"''"'"'"].*$$/-include \1.d/p' \ --e 'd' \ -'$1' -endef - -# Colorizes real, honest-to-goodness LaTeX errors that can't be overcome with -# recompilation. -# -# Note that we only ignore file not found errors for things that we know how to -# build, like graphics files. -# -# Also note that the output of this is piped through sed again to escape any -# backslashes that might have made it through. This is to avoid sending things -# like "\right" to echo, which interprets \r as LF. In bash, we could just do -# ${var//\\/\\\\}, but in other popular sh variants (like dash), this doesn't -# work. -# -# $(call colorize-latex-errors,<log file>) -define colorize-latex-errors -$(SED) \ --e '$${' \ --e ' /^$$/!{' \ --e ' H' \ --e ' s/.*//' \ --e ' }' \ --e '}' \ --e '/^$$/!{' \ --e ' H' \ --e ' d' \ --e '}' \ --e '/^$$/{' \ --e ' x' \ --e ' s/^$\n$$.*$/\2\1/' \ --e '}' \ --e '/^::P$P\{1,\}$::/{' \ --e ' s//::\1::/' \ --e ' G' \ --e ' h' \ --e ' d' \ --e '}' \ --e '/^::P::/{' \ --e ' s//::0::/' \ --e ' G' \ --e '}' \ --e 'b start' \ --e ':needonemore' \ --e 's/^/::P::/' \ --e 'G' \ --e 'h' \ --e 'd' \ --e ':needtwomore' \ --e 's/^/::PP::/' \ --e 'G' \ --e 'h' \ --e 'd' \ --e ':needthreemore' \ --e 's/^/::PPP::/' \ --e 'G' \ --e 'h' \ --e 'd' \ --e ':start' \ --e '/^! LaTeX Error: File /{' \ --e ' s/\n//g' \ --e ' b needtwomore' \ --e '}' \ --e 's/^[^[:cntrl:]:]*:[[:digit:]]\{1,\}:/!!! &/' \ --e 's/^$.*\n$$[^[:cntrl:]:]*:[[:digit:]]\{1,\}: .*$/\1!!! \2/' \ --e '/^!!! .* LaTeX Error: File /{' \ --e ' s/\n//g' \ --e ' b needonemore' \ --e '}' \ --e '/^::0::! LaTeX Error: File .*/{' \ --e ' /\n\n$$/{' \ --e ' s/^::0:://' \ --e ' b needonemore' \ --e ' }' \ --e ' s/^::0::! //' \ --e ' s/^$.*not found.$.*Enter file name:.*\n$.*[[:digit:]]\{1,\}$: Emergency stop.*/\2: \1/' \ --e ' b error' \ --e '}' \ --e '/^::0::!!! .*LaTeX Error: File .*/{' \ --e ' /\n\n$$/{' \ --e ' s/^::0:://' \ --e ' b needonemore' \ --e ' }' \ --e ' s/::0::!!! //' \ --e ' /could not locate.*any of these extensions:/{' \ --e ' d' \ --e ' }' \ --e ' s/$not found\.$.*/\1/' \ --e ' b error' \ --e '}' \ --e '/^$.* LaTeX Error: Missing .begin.document.\.$.*/{' \ --e ' s//\1 --- Are you trying to build an include file?/' \ --e ' b error' \ --e '}' \ --e '/.*$!!! .*Undefined control sequence$[^[:cntrl:]]*$.*$/{' \ --e ' s//\1: \2/' \ --e ' s/\nl\.[[:digit:]][^[:cntrl:]]*$\\[^\\[:cntrl:]]*$.*/\1/' \ --e ' b error' \ --e '}' \ --e '/^$!pdfTeX error:.*$s*/{' \ --e ' b error' \ --e '}' \ --e '/.*$!!! .*$/{' \ --e ' s//\1/' \ --e ' s/[[:cntrl:]]//' \ --e ' s/[[:cntrl:]]$$//' \ --e ' b error' \ --e '}' \ --e 'd' \ --e ':error' \ --e 's/^!$!! $\{0,1\}$.*$/$(C_ERROR)\2$(C_RESET)/' \ --e 'p' \ --e 'd' \ -'$1' | $(SED) -e 's/\\\\/\\\\\\\\/g' -endef - -# Colorize Makeindex errors -define colorize-makeindex-errors -$(SED) \ --e '/^!! /{' \ --e ' N' \ --e ' s/^.*$$/$(C_ERROR)&$(C_RESET)/' \ --e ' p' \ --e '}' \ --e 'd' \ -'$1' -endef - -# Colorize xindy errors -# $(call colorize-xindy-errors,<log file>) -define colorize-xindy-errors -$(SED) \ --e 's/^xindy:.*/$(C_ERROR)&$(C_RESET)/p' \ --e 'd' \ -'$1' -endef - -# Colorize epstopdf errors -# -# $(call colorize-epstopdf-errors,<log file>) -define colorize-epstopdf-errors -$(SED) \ --e '/^Error:/,/^Execution stack:/{' \ --e ' /^Execution stack:/d' \ --e ' s/.*/$(C_ERROR)&$(C_RESET)/' \ --e ' p' \ --e '}' \ --e 'd' \ -'$1' -endef - -# Colorize GNUplot errors -# -# $(call colorize-gnuplot-errors,<log file>) -define colorize-gnuplot-errors -$(SED) \ --e '/, line [0-9]*:/!{' \ --e ' H' \ --e ' x' \ --e ' s/.*\n$.*\n.*$$$/\1/' \ --e ' x' \ --e '}' \ --e '/, line [0-9]*:/{' \ --e ' H' \ --e ' /unknown.*terminal type/{' \ --e ' s/.*/--- Try changing the GNUPLOT_OUTPUT_EXTENSION variable to '"'"'eps'"'"'./' \ --e ' H' \ --e ' }' \ --e ' /gpihead/{' \ --e ' s/.*/--- This could be a Makefile bug - contact the maintainer./' \ --e ' H' \ --e ' }' \ --e ' g' \ --e ' s/.*/$(C_ERROR)&$(C_RESET)/' \ --e ' p' \ --e '}' \ --e '/^gnuplot>/,/^$$/{' \ --e ' s/^gnuplot.*/$(C_ERROR)&/' \ --e ' s/^$$/$(C_RESET)/' \ --e ' p' \ --e '}' \ --e 'd' \ -$1 -endef - -# Colorize GraphViz errors -# -# $(call colorize-dot-errors,<log file>) -define colorize-dot-errors -$(SED) \ --e 's/.*not found.*/$(C_ERROR)&$(C_RESET)/p' \ --e '/^Error:/,/context:/s/.*/$(C_ERROR)&$(C_RESET)/p' \ --e 's/^Warning:.*/$(C_WARNING)&$(C_RESET)/p' \ --e 'd' \ -'$1' -endef - -# Get all important .aux files from the top-level .aux file and merges them all -# into a single file, which it outputs to stdout. -# -# $(call flatten-aux,<toplevel aux>,<output file>) -define flatten-aux -$(SED) \ --e '/\$a)input{\(.*$}/{' \ --e 's//\1/' \ --e 's![.:]!\\&!g' \ --e 'h' \ --e 's!.*!\\:\\\\@input{&}:{!' \ --e 'p' \ --e 'x' \ --e 's/\\././g' \ --e 's/.*/r &/p' \ --e 's/.*/d/p' \ --e 's/.*/}/p' \ --e 'd' \ --e '}' \ --e 'd' \ -'$1' > "$1.$$$$.sed.make"; \ -$(SED) -f "$1.$$$$.sed.make" '$1' > "$1.$$$$.make"; \ -$(SED) \ --e '/^\\relax/d' \ --e '/^\\bibcite/d' \ --e 's/^$\\newlabel{[^}]\{1,\}}$.*/\1/' \ -"$1.$$$$.make" | $(SORT) > '$2'; \ -$(call remove-temporary-files,$1.$$$$.make $1.$$$$.sed.make) -endef - -# Generate pdf from postscript -# -# Note that we don't just call ps2pdf, since there are so many versions of that -# script on various systems. Instead, we call the postscript interpreter -# directly. -# -# $(call ps2pdf,infile,outfile,[embed fonts]) -define ps2pdf - $(GS) \ - -dSAFER -dCompatibilityLevel=$(PS_COMPATIBILITY) \ - $(if $3,$(PS_EMBED_OPTIONS)) \ - -q -dNOPAUSE -dBATCH \ - -sDEVICE=pdfwrite -sstdout=%stderr \ - '-sOutputFile=$2' \ - -dSAFER -dCompatibilityLevel=$(PS_COMPATIBILITY) \ - $(if $3,$(PS_EMBED_OPTIONS)) \ - -c .setpdfwrite \ - -f '$1' -endef - -# Colorize LaTeX output. -color_tex := \ -$(SED) \ --e '$${' \ --e ' /^$$/!{' \ --e ' H' \ --e ' s/.*//' \ --e ' }' \ --e '}' \ --e '/^$$/!{' \ --e ' H' \ --e ' d' \ --e '}' \ --e '/^$$/{' \ --e ' x' \ --e ' s/^\n//' \ --e ' /Output written on /{' \ --e ' s/.*Output written on $[^(]*$ ($[^)]\{1,\}$).*/Success! Wrote \2 to \1/' \ --e ' s/[[:digit:]]\{1,\}/$(C_PAGES)&$(C_RESET)/g' \ --e ' s/Success!/$(C_SUCCESS)&$(C_RESET)/g' \ --e ' s/to $.*$$$/to $(C_SUCCESS)\1$(C_RESET)/' \ --e ' b end' \ --e ' }' \ --e ' / *LaTeX Error:.*/{' \ --e ' s/.*$ *LaTeX Error:.*$/$(C_ERROR)\1$(C_RESET)/' \ --e ' b end' \ --e ' }' \ --e ' /.*Warning:.*/{' \ --e ' s//$(C_WARNING)&$(C_RESET)/' \ --e ' b end' \ --e ' }' \ --e ' /Underfull.*/{' \ --e ' s/.*$Underfull.*$/$(C_UNDERFULL)\1$(C_RESET)/' \ --e ' b end' \ --e ' }' \ --e ' /Overfull.*/{' \ --e ' s/.*$Overfull.*$/$(C_OVERFULL)\1$(C_RESET)/' \ --e ' b end' \ --e ' }' \ --e ' d' \ --e ' :end' \ --e ' G' \ --e '}' - -# Colorize BibTeX output. -color_bib := \ -$(SED) \ --e 's/^Warning--.*/$(C_WARNING)&$(C_RESET)/' \ --e 't' \ --e '/---/,/^.[^:]/{' \ --e ' H' \ --e ' /^.[^:]/{' \ --e ' x' \ --e ' s/\n$.*$/$(C_ERROR)\1$(C_RESET)/' \ --e ' p' \ --e ' s/.*//' \ --e ' h' \ --e ' d' \ --e ' }' \ --e ' d' \ --e '}' \ --e '/(.*error.*)/s//$(C_ERROR)&$(C_RESET)/' \ --e 'd' - -# Make beamer output big enough to print on a full page. Landscape doesn't -# seem to work correctly. -enlarge_beamer = $(PSNUP) -l -1 -W128mm -H96mm -pletter - -# $(call test-run-again,<source stem>) -test-run-again = $(EGREP) -q '^(.*Rerun .*|No file $1\.[^.]+\.)$$' $1.log - -# This tests whether the build target commands should be run at all, from -# viewing the log file. -# $(call test-log-for-need-to-run,<source stem>) -define test-log-for-need-to-run -$(SED) \ --e '/^No file $(call escape-fname-regex,$1)\.aux\./d' \ -$1.log \ -| $(EGREP) -q '^(.*Rerun .*|No file $1\.[^.]+\.|No file .+\.tex\.|LaTeX Warning: File.*)$$' -endef - -# LaTeX invocations -# -# $(call latex,<tex file>,[<extra LaTeX args>]) -run-latex = $(latex_build_program) -interaction=batchmode -file-line-error $(if $2,$2,) $1 > /dev/null - -# $(call latex-color-log,<LaTeX stem>) -latex-color-log = $(color_tex) $1.log - -# $(call run-makeindex,<input>,<output>,<log>,[.ist style file]) -define run-makeindex -success=1; \ -if ! $(MAKEINDEX) -q $1 -t $3 -o $2 $(if $4,-s $4,) > /dev/null || $(EGREP) -q '^!!' $3; \ -then \ - $(call colorize-makeindex-errors,$3); \ - $(RM) -f '$2'; \ - success=0; \ -fi; \ -[ "$$success" = "1" ] && $(sh_true) || $(sh_false); -endef - - -# $(call run-xindy,<input>,<output>,<module>,<log>) -define run-xindy -success=1; \ -if ! $(XINDY) -q -o $2 -L $(XINDYLANG) -C $(XINDYENC) -I xindy -M $3 -t $4 $1 > /dev/null || $(EGREP) -q '^xindy:' $4; then \ - $(call colorize-xindy-errors,$4); \ - $(RM) -f '$2'; \ - success=0; \ -fi; \ -[ "$$success" = "1" ] && $(sh_true) || $(sh_false); -endef - -# This runs the given script to generate output, and it uses MAKE_RESTARTS to -# ensure that it never runs it more than once for a particular root make -# invocation. -# -# $(call run-script,<interpreter>,<input>,<output>) -define run-script -[ ! -e '$2.cookie' ] && $(ECHO) "restarts=$(RESTARTS)" > $2.cookie && $(ECHO) "level=$(MAKELEVEL)" >> $2.cookie; \ -restarts=`$(SED) -n -e 's/^restarts=//p' $2.cookie`; \ -level=`$(SED) -n -e 's/^level=//p' $2.cookie`; \ -if $(EXPR) $(MAKELEVEL) '<=' $$level '&' $(RESTARTS) '<=' $$restarts >/dev/null; then \ - $(call echo-build,$2,$3,$(RESTARTS)-$(MAKELEVEL)); \ - $1 '$2' '$3'; \ - $(ECHO) "restarts=$(RESTARTS)" > '$2.cookie'; \ - $(ECHO) "level=$(MAKELEVEL)" >> '$2.cookie'; \ -fi -endef - -# BibTeX invocations -# -# $(call run-bibtex,<tex stem>) -run-bibtex = $(BIBTEX) $1 | $(color_bib) - - -# $(call convert-eps-to-pdf,<eps file>,<pdf file>,[gray]) -# Note that we don't use the --filter flag because it has trouble with bounding boxes that way. -define convert-eps-to-pdf -$(if $3,$(CAT) '$1' | $(call kill-ps-color) > '$1.cookie',$(CP) '$1' '$1.cookie'); \ -$(EPSTOPDF) '$1.cookie' --outfile='$2' > $1.log; \ -$(call colorize-epstopdf-errors,$1.log); -endef - -# $(call default-gpi-fontsize,<output file>) -# -# Find the default fontsize given the *output* file (it is based on the output extension) -# -default-gpi-fontsize = $(if $(filter %.pdf,$1),$(DEFAULT_GPI_PDF_FONTSIZE),$(DEFAULT_GPI_EPS_FONTSIZE)) - -# $(call gpi-fontsize,<gpi file>,<output file>) -# -# Find out what the gnuplot fontsize should be. Tries, in this order: -# - ##FONTSIZE comment in gpi file -# - ##FONTSIZE comment in global gpi file -# - default fontsize based on output type -define gpi-fontsize -$(strip $(firstword \ - $(shell $(SED) -e 's/^\#\#FONTSIZE=$[[:digit:]]\{1,\}$/\1/p' -e 'd' $1 $(strip $(gpi_global))) \ - $(call default-gpi-fontsize,$2))) -endef - -# $(call gpi-monochrome,<gpi file>,[gray]) -define gpi-monochrome -$(strip $(if $2,monochrome,$(if $(shell $(EGREP) '^\#\#[[:space:]]*GRAY[[:space:]]*$$' $1 $(gpi_global)),monochrome,color))) -endef - -# $(call gpi-font-entry,<output file>,<fontsize>) -# -# Get the font entry given the output file (type) and the font size. For PDF -# it uses fsize or font, for eps it just uses the bare number. -gpi-font-entry = $(if $(filter %.pdf,$1),$(subst FONTSIZE,$2,$(GPI_FSIZE_SYNTAX)),$2) - -# $(call gpi-terminal,<gpi file><output file>,[gray]) -# -# Get the terminal settings for a given gpi and its intended output file -define gpi-terminal -$(if $(filter %.pdf,$2),pdf enhanced,postscript enhanced eps) \ -$(call gpi-font-entry,$2,$(call gpi-fontsize,$1,$2)) \ -$(call gpi-monochrome,$1,$3) -endef - -# $(call gpi-embed-pdf-fonts,<input file>,<output file>) -# -define gpi-embed-pdf-fonts -$(GS) \ - -q \ - -dSAFER \ - -dNOPAUSE \ - -dBATCH \ - -sDEVICE=$(if $(filter pdf,$(GPI_OUTPUT_EXTENSION)),pdfwrite,pswrite) \ - -sOutputFile='$2' \ - -sstdout=%stderr \ - -dCompatibilityLevel=1.5 \ - -dPDFSETTINGS=/prepress \ - -c .setpdfwrite \ - -f '$1' -endef - -# $(call convert-gpi,<gpi file>,<output file>,[gray]) -# -define convert-gpi -$(ECHO) 'set terminal $(call gpi-terminal,$1,$2,$3)' > $1head.make; \ -$(ECHO) 'set output "$2"' >> $1head.make; \ -$(if $(gpi_global),$(CAT) $(gpi_global) >> $1head.make;,) \ -fnames='$1head.make $1';\ -$(if $(gpi_sed),\ - $(SED) -f '$(gpi_sed)' $$fnames > $1.temp.make; \ - fnames=$1.temp.make;,\ -) \ -success=1; \ -if ! $(GNUPLOT) $$fnames 2>$1.log; then \ - $(call colorize-gnuplot-errors,$1.log); \ - success=0; \ -else \ - if ! $(call gpi-embed-pdf-fonts,$2,$2.embed.make); then \ - success = 0; \ - else \ - $(call move-if-exists,$2.embed.make,$2); \ - fi; \ -fi; \ -$(if $(gpi_sed),$(call remove-temporary-files,$1.temp.make);,) \ -$(call remove-temporary-files,$1head.make); \ -[ "$$success" = "1" ] && $(sh_true) || $(sh_false); -endef - -# Creation of .eps files from .png files -# -# The intermediate step of PNM (using NetPBM) produces much nicer output than -# ImageMagick's "convert" binary. I couldn't get the right combination of -# flags to make it look nice, anyway. -# -# To handle gray scale conversion, we pipe things through ppmtopgm in the -# middle. -# -# $(call convert-png,<png file>,<eps file>) -define convert-png -$(PNGTOPNM) "$1" \ - $(if $3,| $(PPMTOPGM),) \ - | $(PNMTOPS) -noturn \ - > "$2" -endef - -# Creation of .eps files from .jpg/.jpeg files -# -# Thanks to brubakee for this solution. -# -# Uses Postscript level 2 to avoid file size bloat -# $(call convert-jpg,<jpg file>,<eps file>) -define convert-jpg -$(CONVERT) $(if $3,-type Grayscale,) '$1' eps2:'$2' -endef - -# Creation of .eps files from .fig files -# $(call convert-fig,<fig file>,<output file>,[gray]) -convert-fig = $(FIG2DEV) -L $(if $(filter %.pdf,$2),pdf,eps) $(if $3,-N,) $1 $2 - -# Creation of .pstex files from .fig files -# $(call convert-fig-pstex,<fig file>,<pstex file>) -convert-fig-pstex = $(FIG2DEV) -L pstex $1 $2 > /dev/null 2>&1 - -# Creation of .pstex_t files from .fig files -# $(call convert-fig-pstex-t,<fig file>,<pstex file>,<pstex_t file>) -convert-fig-pstex-t = $(FIG2DEV) -L pstex_t -p $3 $1 $2 > /dev/null 2>&1 - -# Creation of .dot_t files from .dot files -# #(call convert-dot-tex,<dot file>,<dot_t file>) -convert-dot-tex = $(DOT2TEX) '$1' > '$2' - -# Converts svg files into .eps files -# -# $(call convert-svg,<svg file>,<eps/pdf file>,[gray]) -convert-svg = $(INKSCAPE) --without-gui $(if $(filter %.pdf,$2),--export-pdf,--export-eps)='$2' '$1' - -# Converts xvg files into .eps files -# -# $(call convert-xvg,<xvg file>,<eps file>,[gray]) -convert-xvg = $(XMGRACE) '$1' -printfile - -hardcopy -hdevice $(if $3,-mono,) EPS > '$2' - -# Converts .eps.gz files into .eps files -# -# $(call convert-epsgz,<eps.gz file>,<eps file>,[gray]) -convert-epsgz = $(GUNZIP) -c '$1' $(if $3,| $(call kill-ps-color)) > '$2' - -# Converts .eps files into .eps files (usually a no-op, but can make grayscale) -# -# $(call convert-eps,<in file>,<out file>,[gray]) -convert-eps = $(if $3,$(call kill-ps-color) $1 > $2) - -# The name of the file containing special postscript commands for grayscale -gray_eps_file := gray.eps.make - -# Changes sethsbcolor and setrgbcolor calls in postscript to always produce -# grayscale. In general, this is accomplished by writing new versions of those -# functions into the user dictionary space, which is looked up before the -# global or system dictionaries (userdict is one of the permanent dictionaries -# in postscript and is not read-only like systemdict). -# -# For setrgbcolor, the weighted average of the triple is computed and the -# triple is replaced with three copies of that average before the original -# procedure is called: .299R + .587G + .114B -# -# For sethsbcolor, the color is first converted to RGB, then to grayscale by -# the new setrgbcolor operator as described above. Why is this done? -# Because simply using the value component will tend to make pure colors -# white, a very undesirable thing. Pure blue should not translate to white, -# but to some level of gray. Conversion to RGB does the right thing. It's -# messy, but it works. -# -# From -# http://en.wikipedia.org/wiki/HSV_color_space#Transformation_from_HSV_to_RGB, -# HSB = HSV (Value = Brightness), and the formula used to convert to RGB is -# as follows: -# -# Hi = int(floor(6 * H)) mod 6 -# f = 6 * H - Hi -# p = V(1-S) -# q = V(1-fS) -# t = V(1-(1-f)S) -# if Hi = 0: R G B <-- V t p -# if Hi = 1: R G B <-- q V p -# if Hi = 2: R G B <-- p V t -# if Hi = 3: R G B <-- p q V -# if Hi = 4: R G B <-- t p V -# if Hi = 5: R G B <-- V p q -# -# The messy stack-based implementation is below -# $(call create-gray-eps-file,filename) -define create-gray-eps-file -$(ECHO) -n -e '\ -/OLDRGB /setrgbcolor load def\n\ -/setrgbcolor {\n\ - .114 mul exch\n\ - .587 mul add exch\n\ - .299 mul add\n\ - dup dup\n\ - OLDRGB\n\ -} bind def\n\ -/OLDHSB /sethsbcolor load def\n\ -/sethsbcolor {\n\ - 2 index % H V S H\n\ - 6 mul floor cvi 6 mod % Hi V S H\n\ - 3 index % H Hi V S H\n\ - 6 mul % 6H Hi V S H\n\ - 1 index % Hi 6H Hi V S H\n\ - sub % f Hi V S H\n\ - 2 index 1 % 1 V f Hi V S H\n\ - 4 index % S 1 V f Hi V S H\n\ - sub mul % p f Hi V S H\n\ - 3 index 1 % 1 V p f Hi V S H\n\ - 6 index % S 1 V p f Hi V S H\n\ - 4 index % f S 1 V p f Hi V S H\n\ - mul sub mul % q p f Hi V S H\n\ - 4 index 1 1 % 1 1 V q p f Hi V S H\n\ - 5 index % f 1 1 V q p f Hi V S H\n\ - sub % (1-f) 1 V q p f Hi V S H\n\ - 8 index % S (1-f) 1 V q p f Hi V S H\n\ - mul sub mul % t q p f Hi V S H\n\ - 4 -1 roll pop % t q p Hi V S H\n\ - 7 -2 roll pop pop % t q p Hi V\n\ - 5 -2 roll % Hi V t q p\n\ - dup 0 eq\n\ - {1 index 3 index 6 index}\n\ - {\n\ - dup 1 eq\n\ - {3 index 2 index 6 index}\n\ - {\n\ - dup 2 eq\n\ - {4 index 2 index 4 index}\n\ - {\n\ - dup 3 eq\n\ - {4 index 4 index 3 index}\n\ - {\n\ - dup 4 eq\n\ - {2 index 5 index 3 index}\n\ - {\n\ - dup 5 eq\n\ - {1 index 5 index 5 index}\n\ - {0 0 0}\n\ - ifelse\n\ - }\n\ - ifelse\n\ - }\n\ - ifelse\n\ - }\n\ - ifelse\n\ - }\n\ - ifelse\n\ - }\n\ - ifelse % B G R Hi V t q p\n\ - setrgbcolor\n\ - 5 {pop} repeat\n\ -} bind def\n'\ -> $1 -endef - -# This actually inserts the color-killing code into a postscript file -# $(call kill-ps-color) -define kill-ps-color -$(SED) -e '/%%EndComments/r $(gray_eps_file)' -endef - -# Converts graphviz .dot files into .eps files -# Grayscale is not directly supported by dot, so we pipe it through fig2dev in -# that case. -# $(call convert-dot,<dot file>,<eps file>,<log file>,[gray]) -define convert-dot -$(DOT) -Tps '$1' 2>'$3' $(if $4,| $(call kill-ps-color)) > $2; \ -$(call colorize-dot-errors,$3) -endef - -# Convert DVI to Postscript -# $(call make-ps,<dvi file>,<ps file>,<log file>,[<paper size>]) -make-ps = \ - $(DVIPS) -z -o '$2' $(if $(filter-out BEAMER,$4),-t$(firstword $4),) '$1' \ - $(if $(filter BEAMER,$4),| $(enlarge_beamer)) > $3 2>&1 - -# Convert Postscript to PDF -# $(call make-pdf,<ps file>,<pdf file>,<log file>,<embed file>) -make-pdf = \ - $(call ps2pdf,$1,$2,$(filter 1,$(shell $(CAT) '$4'))) > '$3' 2>&1 - -# Display information about what is being done -# $(call echo-build,<input file>,<output file>,[<run number>]) -echo-build = $(ECHO) "$(C_BUILD)= $1 --> $2$(if $3, ($3),) =$(C_RESET)" -echo-graphic = $(ECHO) "$(C_GRAPHIC)= $1 --> $2 =$(C_RESET)" -echo-dep = $(ECHO) "$(C_DEP)= $1 --> $2 =$(C_RESET)" - -# Display a list of something -# $(call echo-list,<values>) -echo-list = for x in $1; do $(ECHO) "$$x"; done - -# -# DEFAULT TARGET -# - -.PHONY: all -all: $(default_pdf_targets) ; - -.PHONY: all-pdf -all-pdf: $(default_pdf_targets) ; - -ifeq "$(strip $(BUILD_STRATEGY))" "latex" -.PHONY: all-ps -all-ps: $(default_ps_targets) ; - -.PHONY: all-dvi -all-dvi: $(default_dvi_targets) ; -endif - -# -# VIEWING TARGET -# -.PHONY: show -show: all - $(QUIET)for x in $(default_pdf_targets); do \ - [ -e "$$x" ] && $(VIEW_PDF) $$x & \ - done - -# -# INCLUDES -# -source_includes := $(addsuffix .d,$(source_stems_to_include)) -graphic_includes := $(addsuffix .gpi.d,$(graphic_stems_to_include)) - -# Check the version of the makefile -ifneq "" "$(filter 3.79 3.80,$(MAKE_VERSION))" -$(warning $(C_WARNING)Your version of make is too old. Please upgrade.$(C_RESET)) -endif - -# Include only the dependencies used -ifneq "" "$(source_includes)" -include $(source_includes)$(call include-message,$(source_includes)) -endif -ifneq "" "$(graphic_includes)" -include $(graphic_includes)$(call include-message,$(graphic_includes)) -endif - -# -# MAIN TARGETS -# - -# Note that we don't just say %: %.pdf here - this can tend to mess up our -# includes, which detect what kind of file we are asking for. For example, -# asking to build foo.pdf is much different than asking to build foo when -# foo.gpi exists, because we look through all of the goals for *.pdf that -# matches *.gpi, then use that to determine which include files we need to -# build. -# -# Thus, we invoke make recursively with better arugments instead, restarting -# all of the appropriate machinery. -.PHONY: $(default_stems_ss) -$(default_stems_ss): %: %.pdf ; - -# This builds and displays the wanted file. -.PHONY: $(addsuffix ._show,$(stems_ssg)) -$(addsuffix ._show,$(stems_ssg)): %._show: %.pdf - $(QUIET)$(VIEW_PDF) $< & - -ifeq "$(strip $(BUILD_STRATEGY))" "latex" -.SECONDARY: $(all_pdf_targets) -%.pdf: %.ps %.embed.make - $(QUIET)$(call echo-build,$<,$@) - $(QUIET)$(call make-pdf,$<,$@.temp,$@.log,$*.embed.make); \ - if [ x"$$?" = x"0" ]; then \ - $(if $(VERBOSE),$(CAT) $@.log,:); \ - $(RM) -f '$@'; \ - $(MV) '$@.temp' '$@'; \ - $(TOUCH) '$@'; \ - $(call copy-with-logging,$@,$(BINARY_TARGET_DIR)); \ - else \ - $(CAT) $@.log; \ - $(call remove-temporary-files,'$@.temp'); \ - $(sh_false); \ - fi - -.SECONDARY: $(all_ps_targets) -%.ps: %.dvi %.paper.make - $(QUIET)$(call echo-build,$<,$@) - $(QUIET)$(call make-ps,$<,$@.temp,$@.log,\ - $(firstword $(shell $(CAT) $*.paper.make))); \ - if [ x"$$?" = x"0" ]; then \ - $(if $(VERBOSE),$(CAT) $@.log,:); \ - $(RM) -f '$@'; \ - $(MV) '$@.temp' '$@'; \ - $(TOUCH) '$@'; \ - $(call copy-with-logging,$@,$(BINARY_TARGET_DIR)); \ - else \ - $(CAT) $@.log; \ - $(call remove-temporary-files,'$@.temp'); \ - $(sh_false); \ - fi -endif - -# Build the final target (dvi or pdf) file. This is a very tricky rule because -# of the way that latex runs multiple times, needs graphics after the first run -# (or maybe already has them), and relies on bibliographies or indices that may -# not exist. -# -# Check the log for fatal errors. If they exist, colorize and bail. -# -# Create the .auxtarget.cookie file. (Needed for next time if not present) -# -# If any of the following are true, we must rebuild at least one time: -# -# * the .bbl was recently rebuilt -# -# check a cookie, then delete it -# -# * any of several output files was created or changed: -# -# check $*.run.cookie, then delete it -# -# * the .aux file changed in a way that necessitates attention -# -# Note that if the .auxtarget.make file doesn't exist, this means -# that we are doing a clean build, so it doesn't figure into the -# test for running again. -# -# compare against .auxtarget.make -# -# move if different, remove if not -# -# * the .log file has errors or warnings requiring at least one more run -# -# We use a loop over a single item to simplify the process of breaking -# out when we find one of the conditions to be true. -# -# If we do NOT need to run latex here, then we move the $@.1st.make file -# over to $@ because the target file has already been built by the first -# dependency run and is valid. -# -# If we do, we delete that cookie file and do the normal multiple-runs -# routine. -# -ifeq "$(strip $(BUILD_STRATEGY))" "latex" -.SECONDARY: $(all_dvi_targets) -endif -%.$(build_target_extension): %.bbl %.aux %.$(build_target_extension).1st.make - $(QUIET)\ - fatal=`$(call colorize-latex-errors,$*.log)`; \ - if [ x"$$fatal" != x"" ]; then \ - $(ECHO) "$$fatal"; \ - exit 1; \ - fi; \ - $(call make-auxtarget-file,$*.aux.make,$*.auxtarget.cookie); \ - run=0; \ - for i in 1; do \ - if $(call test-exists,$*.bbl.cookie); then \ - run=1; \ - break; \ - fi; \ - if $(call test-exists,$*.run.cookie); then \ - run=1; \ - break; \ - fi; \ - if $(call \ - test-exists-and-different,$*.auxtarget.cookie,$*.auxtarget.make);\ - then \ - run=1; \ - break; \ - fi; \ - if $(call test-log-for-need-to-run,$*); then \ - run=1; \ - break; \ - fi; \ - if [ ! -e $*.1st.*.make ]; then \ - run=1; \ - break; \ - fi; \ - done; \ - $(call remove-temporary-files,$*.bbl.cookie $*.run.cookie); \ - $(MV) $*.auxtarget.cookie $*.auxtarget.make; \ - if [ x"$$run" = x"1" ]; then \ - $(call remove-files,$@.1st.make); \ - for i in 2 3 4 5; do \ - $(if $(findstring 3.79,$(MAKE_VERSION)),\ - $(call echo-build,$*.tex,$@,$(RESTARTS)-$$$$i),\ - $(call echo-build,$*.tex,$@,$(RESTARTS)-$$i)\ - ); \ - $(call run-latex,$*); \ - $(CP) '$*.log' '$*.'$(RESTARTS)-$$i'.log'; \ - $(call test-run-again,$*) || break; \ - done; \ - else \ - $(MV) '$@.1st.make' '$@'; \ - fi; \ - $(call copy-with-logging,$@,$(BINARY_TARGET_DIR)); \ - $(call latex-color-log,$*) - -# Build the .bbl file. When dependencies are included, this will (or will -# not!) depend on something.bib, which we detect, acting accordingly. The -# dependency creation also produces the %.auxbbl.make file. BibTeX is a bit -# finicky about what you call the actual files, but we can rest assured that if -# a .auxbbl.make file exists, then the .aux file does, as well. The -# .auxbbl.make file is a cookie indicating whether the .bbl needs to be -# rewritten. It only changes if the .aux file changes in ways relevant to .bbl -# creation. -# -# Note that we do NOT touch the .bbl file if there is no need to -# create/recreate it. We would like to leave existing files alone if they -# don't need to be changed, thus possibly avoiding a rebuild trigger. -%.bbl: %.auxbbl.make - $(QUIET)\ - $(if $(filter %.bib,$^),\ - $(call echo-build,$(filter %.bib,$?) $*.aux,$@); \ - $(call run-bibtex,$*); \ - $(TOUCH) $@.cookie; \ - ) \ - if $(EGREP) -q 'bibstyle.(apacite|apacann|chcagoa|[^}]*annot)' '$*.aux'; then \ - $(call echo-build,** annotated extra latex **,output ignored,$(RESTARTS)-1); \ - $(call run-latex,$*); \ - $(CP) '$*.log' '$*.$(RESTARTS)-annotated.log'; \ - $(if $(filter %.bib,$^),\ - $(call echo-build,** annotated extra bibtex ** $(filter %.bib,$?) $*.aux,$@); \ - $(call run-bibtex,$*); \ - $(TOUCH) $@.cookie; \ - ) \ - $(call echo-build,** annotated extra latex **,output ignored,$(RESTARTS)-2); \ - $(call run-latex,$*); \ - fi - -# Create the index file - note that we do *not* depend on %.tex here, since -# that unnecessarily restricts the kinds of indices that we can build to those -# with exactly the same stem as the source file. Things like splitidx create -# idx files with other names. -# -# Therefore, we add the .tex dependency in the sourcestem.d file in the call to -# get index file dependencies from the logs. -%.ind: %.idx - $(QUIET)$(call echo-build,$<,$@) - $(QUIET)$(call run-makeindex,$<,$(a),$*.ilg) - -# Create a glossary file from a .ist file -%.gls: %.glo %.tex %.ist - $(QUIET)$(call echo-build,$<,$@) - $(QUIET)$(call run-makeindex,$<,$(a),$*.glg,$*.ist) - -# Create a glossary file from a glossary input formatted for xindy -%.gls: %.glo %.tex %.xdy - $(QUIET)$(call echo-build,$<,$@) - $(QUIET)$(call run-xindy,$<,$(a),$*,$*.glg) - -# Create the glossary file from a nomenclature file -%.gls: %.glo %.tex nomencl.ist - $(QUIET)$(call echo-build,$<,$@) - $(QUIET)$(call run-makeindex,$<,$(a),$*.glg,nomencl.ist) - -# Create the nomenclature file -%.nls: %.nlo %.tex nomencl.ist - $(QUIET)$(call echo-build,$<,$@) - $(QUIET)$(call run-makeindex,$<,$(a),$*.nlg,nomencl.ist) - -# SCRIPTED LaTeX TARGETS -# -# Keep the generated .tex files around for debugging if needed. -.SECONDARY: $(all_tex_targets) - -%.tex:: %.tex.sh - $(QUIET)$(call run-script,$(SHELL),$<,$@) - -%.tex:: %.tex.py - $(QUIET)$(call run-script,$(PYTHON),$<,$@) - -%.tex:: %.tex.pl - $(QUIET)$(call run-script,$(PERL),$<,$@) - -%.tex:: %.rst $(RST_STYLE_FILE) - $(QUIET)\ - $(call run-script,$(RST2LATEX)\ - --documentoptions=letterpaper\ - $(if $(RST_STYLE_FILE),--stylesheet=$(RST_STYLE_FILE),),$<,$@) - -# -# GRAPHICS TARGETS -# -.PHONY: all-graphics -all-graphics: $(all_graphics_targets); - -ifeq "$(strip $(BUILD_STRATEGY))" "latex" -.PHONY: all-pstex -all-pstex: $(all_pstex_targets); -endif - -.PHONY: all-dot2tex -all-dot2tex: $(all_dot2tex_targets); - -.PHONY: show-graphics -show-graphics: all-graphics - $(VIEW_GRAPHICS) $(all_known_graphics) - -$(gray_eps_file): - $(QUIET)$(call echo-build,$^,$@) - $(QUIET)$(call create-gray-eps-file,$@) - -ifeq "$(strip $(BUILD_STRATEGY))" "pdflatex" -%.pdf: %.eps $(if $(GRAY),$(gray_eps_file)) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-eps-to-pdf,$<,$@,$(GRAY)) - -ifeq "$(strip $(GPI_OUTPUT_EXTENSION))" "pdf" -%.pdf: %.gpi %.gpi.d $(gpi_sed) $(gpi_global) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-gpi,$<,$@,$(GRAY)) -endif - -%.pdf: %.fig - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-fig,$<,$@,$(GRAY)) - -%.pdf: %.svg - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-svg,$<,$@,$(GRAY)) -endif - -ifeq "$(strip $(BUILD_STRATEGY))" "xelatex" -%.pdf: %.eps $(if $(GRAY),$(gray_eps_file)) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-eps-to-pdf,$<,$@,$(GRAY)) - -ifeq "$(strip $(GPI_OUTPUT_EXTENSION))" "pdf" -%.pdf: %.gpi %.gpi.d $(gpi_sed) $(gpi_global) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-gpi,$<,$@,$(GRAY)) -endif - -%.pdf: %.fig - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-fig,$<,$@,$(GRAY)) - -endif - - -%.eps: %.gpi %.gpi.d $(gpi_sed) $(gpi_global) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-gpi,$<,$@,$(GRAY)) - -%.eps: %.fig - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-fig,$<,$@,$(GRAY)) - -%.eps: %.dot $(if $(GRAY),$(gray_eps_file)) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-dot,$<,$@,$<.log,$(GRAY)) - -%.eps: %.xvg $(if $(GRAY),$(gray_eps_file)) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-xvg,$<,$@,$(GRAY)) - -ifneq "$(default_graphic_extension)" "pdf" -# We have a perfectly good build rule for svg to pdf, so we eliminate this to -# avoid confusing make (it sometimes chooses to go svg -> eps -> pdf). -%.eps: %.svg $(if $(GRAY),$(gray_eps_file)) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-svg,$<,$@,$(GRAY)) - -# Similarly for these, we don't need eps if we have supported extensions -# already. -%.eps: %.jpg $(if $(GRAY),$(gray_eps_file)) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-jpg,$<,$@,$(GRAY)) - -%.eps: %.jpeg $(if $(GRAY),$(gray_eps_file)) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-jpg,$<,$@,$(GRAY)) - -%.eps: %.png $(if $(GRAY),$(gray_eps_file)) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-png,$<,$@,$(GRAY)) -endif - -%.eps: %.eps.gz $(if $(GRAY),$(gray_eps_file)) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-epsgz,$<,$@,$(GRAY)) - -%.pstex: %.fig - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-fig-pstex,$<,$@,$(GRAY)) - -%.pstex_t: %.fig %.pstex - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-fig-pstex-t,$<,$(a),$*.pstex,$(GRAY)) - -%.dot_t: %.dot - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-dot-tex,$<,$@) - -# -# DEPENDENCY-RELATED TARGETS. -# - -# Generate all of the information needed to get dependencies -# As a side effect, this creates a .dvi or .pdf file (depending on the build -# strategy). We need to be sure to remove it if there are errors. Errors can -# take several forms and all of them are found within the log file: -# * There was a LaTeX error -# * A needed file was not found -# * Cross references need adjustment -# -# Behavior: -# This rule is responsible for generating the following: -# %.aux -# %.d -# %.aux.make -# %.(pdf|dvi).1st.make (the .pdf or .dvi output file, moved) -# -# Steps: -# -# Run latex -# Move .pdf or .dvi somewhere else (make no judgements about success) -# Flatten the .aux file into another file -# Add source dependencies -# Add graphic dependencies -# Add bib dependencies -# -# Create cookies for various suffixes that may represent files that -# need to be read by LaTeX in order for it to function properly. -# -# Note that if some of the dependencies are discovered because they turn -# up missing in the log file, we really need the .d file to be reloaded. -# Adding a sleep command helps with this. Otherwise make is extremely -# nondeterministic, sometimes working, sometimes not. -# -# Usually we can force this by simply removing the generated pdf file and -# not creating a .1st.make file.. -# -%.$(build_target_extension).1st.make %.d %.aux %.aux.make %.fls: %.tex - $(QUIET)$(call echo-build,$<,$*.d $*.$(build_target_extension).1st.make,$(RESTARTS)-1) - $(QUIET)\ - $(call run-latex,$<,-recorder) || $(sh_true); \ - $(CP) '$*.log' '$*.$(RESTARTS)-1.log'; \ - $(call die-on-import-sty,$*.log); \ - $(call die-on-dot2tex,$*.log); \ - $(call die-on-no-aux,$*); \ - $(call flatten-aux,$*.aux,$*.aux.make); \ - $(ECHO) "# vim: ft=make" > $*.d; \ - $(ECHO) ".PHONY: $*._graphics" >> $*.d; \ - $(call get-inputs,$*.fls,$(addprefix $*.,aux aux.make d $(build_target_extension))) >> $*.d; \ - $(call get-missing-inputs,$*.log,$(addprefix $*.,aux aux.make d $(build_target_extension))) >> $*.d; \ - $(ECHO) ".SECONDEXPANSION:" >> $*.d; \ - $(call get-graphics,$*) >> $*.d; \ - $(call get-log-index,$*,$(addprefix $*.,aux aux.make)) >> $*.d; \ - $(call get-bibs,$*.aux.make,$(addprefix $*.,bbl aux aux.make)) >> $*.d; \ - $(EGREP) -q "# MISSING" $*.d && $(SLEEP) 1 && $(RM) $*.pdf; \ - $(call move-if-exists,$*.$(build_target_extension),$*.$(build_target_extension).1st.make); \ - for s in toc out lot lof lol nav; do \ - if [ -e "$*.$$s" ]; then \ - if ! $(DIFF) -q $*.$$s $*.$$s.make >/dev/null 2>&1; then \ - $(TOUCH) $*.run.cookie; \ - fi; \ - $(CP) $*.$$s $*.$$s.make; \ - fi; \ - done - -# This is a cookie that is updated if the flattened aux file has changed in a -# way that affects the bibliography generation. -.SECONDARY: $(addsuffix .auxbbl.make,$(stems_ssg)) -%.auxbbl.make: %.aux.make - $(QUIET)\ - $(call make-auxbbl-file,$<,$@.temp); \ - $(call replace-if-different-and-remove,$@.temp,$@) - -# Build a dependency file for .gpi files. These often plot data files that -# also reside in the directory, so if a data file changes, it's nice to know -# about it. This also handles loaded .gpi files, whose filename should have -# _include_. in it. -%.gpi.d: %.gpi - $(QUIET)$(call echo-build,$<,$@) - $(QUIET)$(call make-gpi-d,$<,$@) - -# Store the paper size for this document -- note that if beamer is used we set -# it to the special BEAMER paper size. We only do this, however, if the -# special comment exists, in which case we enlarge the output with psnup. -# -# The paper size is extracted from a documentclass attribute. -%.paper.make: %.tex - $(QUIET)$(SED) \ - -e '/\\documentclass/,/}/{' \ - -e ' s/%.*//' \ - -e ' H' \ - -e ' /}/{' \ - -e ' s/.*//' \ - -e ' x' \ - -e ' /\\documentclass/!d' \ - -e ' s/[\n[:space:]]*//g' \ - -e ' s/$[,{[]$$[[:alnum:]]\{1,\}$paper$[],}]$/\1%-\2-%\3/g' \ - -e ' s/$[,{[]$$landscape$$[],}]$/\1%-\2-%\3/g' \ - -e ' s/^[^%]*%-//' \ - -e ' s/-%[^%]*$$//' \ - -e ' s/-%[^%]%-/ /g' \ - -e ' p' \ - -e ' }' \ - -e ' d' \ - -e '}' \ - -e 'd' \ - $< > $@; \ - $(EGREP) -q '^[^%]*\\documentclass[^{]*{beamer}' $< && \ - (\ - $(EGREP) -q '^%%[[:space:]]*BEAMER[[:space:]]*LARGE$$' $< && \ - $(ECHO) "BEAMER" > $@ || \ - : > $@ \ - ) || $(sh_true) - -# Store embedding instructions for this document using a special comment -%.embed.make: %.tex - $(QUIET)$(EGREP) '^%%[[:space:]]*NO[[:space:]]*EMBED[[:space:]]*$$' $< \ - && $(ECHO) '' > $@ \ - || $(ECHO) '1' > $@; - -# -# HELPFUL PHONY TARGETS -# - -.PHONY: _all_programs -_all_programs: - $(QUIET)$(ECHO) "== All External Programs Used ==" - $(QUIET)$(call output-all-programs) - -.PHONY: _check_programs -_check_programs: - $(QUIET)$(ECHO) "== Checking Makefile Dependencies =="; $(ECHO) - $(QUIET) \ - allprogs=`\ - ($(call output-all-programs)) | \ - $(SED) \ - -e 's/^[[:space:]]*//' \ - -e '/^#/d' \ - -e 's/[[:space:]]*#.*//' \ - -e '/^=/s/[[:space:]]/_/g' \ - -e '/^[[:space:]]*$$/d' \ - -e 's/^[^=].*=[[:space:]]*$[^[:space:]]\{1,\}$.*$$/\\1/' \ - `; \ - spaces=' '; \ - for p in $${allprogs}; do \ - case $$p in \ - =*) $(ECHO); $(ECHO) "$$p";; \ - *) \ - $(ECHO) -n "$$p:$$spaces" | $(SED) -e 's/^$.\{0,20\}$.*$$/\1/'; \ - loc=`$(WHICH) $$p`; \ - if [ x"$$?" = x"0" ]; then \ - $(ECHO) "$(C_SUCCESS)Found:$(C_RESET) $$loc"; \ - else \ - $(ECHO) "$(C_FAILURE)Not Found$(C_RESET)"; \ - fi; \ - ;; \ - esac; \ - done - -.PHONY: _check_gpi_files -_check_gpi_files: - $(QUIET)$(ECHO) "== Checking all .gpi files for common errors =="; \ - $(ECHO); \ - for f in $(files.gpi); do \ - result=`$(EGREP) '^([^#]*set terminal |set output )' $$f`; \ - $(ECHO) -n "$$f: "; \ - if [ x"$$result" = x"" ]; then \ - $(ECHO) "$(C_SUCCESS)Okay$(C_RESET)"; \ - else \ - $(ECHO) "$(C_FAILURE)Warning: Problematic commands:$(C_RESET)";\ - $(ECHO) "$(C_ERROR)$$result$(C_RESET)"; \ - fi; \ - done; \ - $(ECHO) - -.PHONY: _all_stems -_all_stems: - $(QUIET)$(ECHO) "== All Stems ==" - $(QUIET)$(call echo-list,$(sort $(default_stems_ss))) - -.PHONY: _includes -_includes: - $(QUIET)$(ECHO) "== Include Stems ==" - $(QUIET)$(ECHO) "=== Sources ===" - $(QUIET)$(call echo-list,$(sort $(source_includes))) - $(QUIET)$(ECHO) "=== Graphics ===" - $(QUIET)$(call echo-list,$(sort $(graphic_includes))) - -.PHONY: _all_sources -_all_sources: - $(QUIET)$(ECHO) "== All Sources ==" - $(QUIET)$(call echo-list,$(sort $(all_files.tex))) - -.PHONY: _dependency_graph -_dependency_graph: - $(QUIET)$(ECHO) "/* LaTeX Dependency Graph */" - $(QUIET)$(call output-dependency-graph) - -.PHONY: _show_dependency_graph -_show_dependency_graph: - $(QUIET)$(call output-dependency-graph,$(graph_stem).dot) - $(QUIET)$(DOT) -Tps -o $(graph_stem).eps $(graph_stem).dot - $(QUIET)$(VIEW_POSTSCRIPT) $(graph_stem).eps - $(QUIET)$(call remove-temporary-files,$(graph_stem).*) - -.PHONY: _sources -_sources: - $(QUIET)$(ECHO) "== Sources ==" - $(QUIET)$(call echo-list,$(sort $(files.tex))) - -.PHONY: _scripts -_scripts: - $(QUIET)$(ECHO) "== Scripts ==" - $(QUIET)$(call echo-list,$(sort $(files_scripts))) - -.PHONY: _graphic_outputs -_graphic_outputs: - $(QUIET)$(ECHO) "== Graphic Outputs ==" - $(QUIET)$(call echo-list,$(sort $(all_graphics_targets))) - -.PHONY: _env -_env: -ifdef .VARIABLES - $(QUIET)$(ECHO) "== MAKE VARIABLES ==" - $(QUIET)$(call echo-list,$(foreach var,$(sort $(.VARIABLES)),'$(var)')) -endif - $(QUIET)$(ECHO) "== ENVIRONMENT ==" - $(QUIET)$(ENV) - -# -# CLEAN TARGETS -# -# clean-generated is somewhat unique - it relies on the .fls file being -# properly built so that it can determine which of the files was generated, and -# which was not. Expect it to silently fail if the .fls file is missing. -# -# This is used to, e.g., clean up index files that are generated by the LaTeX. -.PHONY: clean-generated -clean-generated: - $(QUIET)$(call clean-files,$(foreach e,$(addsuffix .fls,$(all_stems_source)),\ - $(shell $(call get-generated-names,$e)))) - -.PHONY: clean-deps -clean-deps: - $(QUIET)$(call clean-files,$(all_d_targets) *.make *.make.temp *.cookie) - -.PHONY: clean-tex -clean-tex: clean-deps - $(QUIET)$(call clean-files,$(rm_tex)) - -.PHONY: clean-graphics -# TODO: This *always* deletes pstex files, even if they were not generated by -# anything.... In other words, if you create a pstex and pstex_t pair by hand -# an drop them in here without the generating fig file, they will be deleted -# and you won't get them back. It's a hack put in here because I'm not sure we -# even want to keep pstex functionality, so my motivation is not terribly high -# for doing it right. -clean-graphics: - $(QUIET)$(call clean-files,$(all_graphics_targets) *.gpi.d *.pstex *.pstex_t *.dot_t) - -.PHONY: clean-backups -clean-backups: - $(QUIET)$(call clean-files,$(backup_patterns) *.temp) - -.PHONY: clean-auxiliary -clean-auxiliary: - $(QUIET)$(call clean-files,$(graph_stem).*) - -.PHONY: clean-nographics -clean-nographics: clean-tex clean-deps clean-backups clean-auxiliary ; - -.PHONY: clean -clean: clean-generated clean-tex clean-graphics clean-deps clean-backups clean-auxiliary ; - -# -# HELP TARGETS -# - -.PHONY: help -help: - $(help_text) - -.PHONY: version -version: - $(QUIET)\ - $(ECHO) "$(fileinfo) Version $(version)"; \ - $(ECHO) "by $(author)"; \ - -# -# HELP TEXT -# - -define help_text -# $(fileinfo) Version $(version) -# -# by $(author) -# -# Generates a number of possible output files from a LaTeX document and its -# various dependencies. Handles .bib files, \include and \input, and .eps -# graphics. All dependencies are handled automatically by running LaTeX over -# the source. -# -# USAGE: -# -# make [GRAY=1] [VERBOSE=1] [SHELL_DEBUG=1] <target(s)> -# -# STANDARD OPTIONS: -# GRAY: -# Setting this variable forces all recompiled graphics to be grayscale. -# It is useful when creating a document for printing. The default is -# to allow colors. Note that it only changes graphics that need to be -# rebuilt! It is usually a good idea to do a 'make clean' first. -# -# VERBOSE: -# This turns off all @ prefixes for commands invoked by make. Thus, -# you get to see all of the gory details of what is going on. -# -# SHELL_DEBUG: -# This enables the -x option for sh, meaning that everything it does is -# echoed to stderr. This is particularly useful for debugging -# what is going on in $$(shell ...) invocations. One of my favorite -# debugging tricks is to do this: -# -# make -d SHELL_DEBUG=1 VERBOSE=1 2>&1 | less -# -# KEEP_TEMP: -# When set, this allows .make and other temporary files to stick around -# long enough to do some debugging. This can be useful when trying to -# figure out why gnuplot is not doing the right things, for example -# (e.g., look for *head.make). -# -# STANDARD AUXILIARY FILES: -# -# Variables.ini (formerly Makefile.ini, which still works) -# -# This file can contain variable declarations that override various -# aspects of the makefile. For example, one might specify -# -# neverclean := *.pdf *.ps -# onlysources.tex := main.tex -# LATEX_COLOR_WARNING := 'bold red uline' -# -# And this would override the neverclean setting to ensure that pdf -# and ps files always remain behind, set the makefile to treat all -# .tex files that are not "main.tex" as includes (and therefore not -# default targets). It also changes the LaTeX warning output to be -# red, bold, and underlined. -# -# There are numerous variables in this file that can be overridden in -# this way. Search for '?=' to find them all. -# -# The Variables.ini is imported before *anything else* is done, so go -# wild with your ideas for changes to this makefile in there. It -# makes it easy to test them before submitting patches. -# -# If you're adding rules or targets, however, see Targets.ini below. -# -# Targets.ini -# -# This is included much later in the makefile, after all variables and -# targets are defined. This is where you would put new make rules, -# e.g., -# -# generated.tex: generating_script.weird_lang depA depB -# ./generating_script.weird_lang > $$@ -# -# In this file, you have access to all of the variables that the -# makefile creates, like $(onlysources.tex). While accessing those can -# be somewhat brittle (they are implementation details and may change), -# it is a great way to test your ideas when submitting feature requests. -# -# STANDARD ENVIRONMENT VARIABLES: -# -# LATEX_COLOR_WARNING '$(LATEX_COLOR_WARNING)' -# LATEX_COLOR_ERROR '$(LATEX_COLOR_ERROR)' -# LATEX_COLOR_UNDERFULL '$(LATEX_COLOR_UNDERFULL)' -# LATEX_COLOR_OVERFULL '$(LATEX_COLOR_OVERFULL)' -# LATEX_COLOR_PAGES '$(LATEX_COLOR_PAGES)' -# LATEX_COLOR_BUILD '$(LATEX_COLOR_BUILD)' -# LATEX_COLOR_GRAPHIC '$(LATEX_COLOR_GRAPHIC)' -# LATEX_COLOR_DEP '$(LATEX_COLOR_DEP)' -# LATEX_COLOR_SUCCESS '$(LATEX_COLOR_SUCCESS)' -# LATEX_COLOR_FAILURE '$(LATEX_COLOR_FAILURE)' -# -# These may be redefined in your environment to be any of the following: -# -# black -# red -# green -# yellow -# blue -# magenta -# cyan -# white -# -# Bold or underline may be used, as well, either alone or in combination -# with colors: -# -# bold -# uline -# -# Order is not important. You may want, for example, to specify: -# -# export LATEX_COLOR_SUCCESS='bold blue uline' -# -# in your .bashrc file. I don't know why, but you may want to. -# -# STANDARD TARGETS: -# -# all: -# Make all possible documents in this directory. The documents are -# determined by scanning for .tex and .tex.sh (described in more detail -# later) and omitting any file that ends in ._include_.tex or -# ._nobuild_.tex. The output is a set of .pdf files. -# -# If you wish to omit files without naming them with the special -# underscore names, set the following near the top of the Makefile, -# or (this is recommended) within a Makefile.ini in the same directory: -# -# includes.tex := file1.tex file2.tex -# -# This will cause the files listed to be considered as include files. -# -# If you have only few source files, you can set -# -# onlysources.tex := main.tex -# -# This will cause only the source files listed to be considered in -# dependency detection. All other .tex files will be considered as -# include files. Note that these options work for *any* source type, -# so you could do something similar with includes.gpi, for example. -# Note that this works for *any valid source* target. All of the -# onlysources.* variables are commented out in the shipping version of -# this file, so it does the right thing when they simply don't exist. -# The comments are purely documentation. If you know, for example, that -# file.mycoolformat is supported by this Makefile, but don't see the -# "onlysources.mycoolformat" declared in the comments, that doesn't mean -# you can't use it. Go ahead and set "onlysources.mycoolformat" and it -# should do the right thing. -# -# show: -# Builds and displays all documents in this directory. It uses the -# environment-overridable value of VIEW_PDF (currently $(VIEW_PDF)) to -# do its work. -# -# all-graphics: -# Make all of the graphics in this directory. -# -# all-pstex (only for BUILD_STRATEGY=latex): -# Build all fig files into pstex and pstex_t files. Gray DOES NOT WORK. -# -# all-gray-pstex (only for BUILD_STRATEGY=latex): -# Build all fig files into grayscale pstex and pstex_t files. -# -# all-dot2tex: -# Build all dot files into tex files. -# -# show-graphics: -# Builds and displays all graphics in this directory. Uses the -# environment-overridable value of VIEW_GRAPHICS (currently -# $(VIEW_GRAPHICS)) to do its work. -# -# clean: -# Remove ALL generated files, leaving only source intact. -# This will *always* skip files mentioned in the "neverclean" variable, -# either in this file or specified in Makefile.ini: -# -# neverclean := *.pdf *.ps -# -# The neverclean variable works on all "clean" targets below, as well. -# -# clean-graphics: -# Remove all generated graphics files. -# -# clean-backups: -# Remove all backup files: $(backup_patterns) -# (XFig and other editors have a nasty habit of leaving them around) -# Also removes Makefile-generated .temp files -# -# clean-tex: -# Remove all files generated from LaTeX invocations except dependency -# information. Leaves graphics alone. -# -# clean-deps: -# Removes all auto-generated dependency information. -# -# clean-auxiliary: -# Removes extra files created by various targets (like the dependency -# graph output). -# -# clean-nographics: -# Cleans everything *except* the graphics files. -# -# help: -# This help text. -# -# version: -# Version information about this LaTeX makefile. -# -# DEBUG TARGETS: -# -# _all_programs: -# A list of the programs used by this makefile. -# -# _check_programs: -# Checks your system for the needed software and reports what it finds. -# -# _check_gpi_files: -# Checks the .gpi files in the current directory for common errors, such -# as specification of the terminal or output file inside of the gpi file -# itself. -# -# _dependency_graph: -# Outputs a .dot file to stdout that represents a graph of LaTeX -# dependencies. To see it, use the _show_dependency_graph target or -# direct the output to a file, run dot on it, and view the output, e.g.: -# -# make _dependency_graph > graph.dot -# dot -T ps -o graph.eps graph.dot -# gv graph.eps -# -# _show_dependency_graph: -# Makes viewing the graph simple: extracts, builds and displays the -# dependency graph given in the _dependency_graph target using the value -# of the environment-overridable VIEW_POSTSCRIPT variable (currently set -# to $(VIEW_POSTSCRIPT)). The postscript viewer is used because it -# makes it easier to zoom in on the graph, a critical ability for -# something so dense and mysterious. -# -# _all_sources: -# List all .tex files in this directory. -# -# _sources: -# Print out a list of all compilable sources in this directory. This is -# useful for determining what make thinks it will be using as the -# primary source for 'make all'. -# -# _scripts: -# Print out a list of scripts that make knows can be used to generate -# .tex files (described later). -# -# _all_stems: -# Print a list of stems. These represent bare targets that can be -# executed. Listing <stem> as a bare target will produce <stem>.pdf. -# -# _includes: -# A list of .d files that would be included in this run if _includes -# weren't specified. This target may be used alone or in conjunction -# with other targets. -# -# _graphic_outputs: -# A list of all generated .eps files -# -# _env: -# A list of environment variables and their values. If supported by -# your version of make, also a list of variables known to make. -# -# FILE TARGETS: -# -# %, %.pdf: -# Build a PDF file from the corresponding %.tex file. -# -# If BUILD_STRATEGY=pdflatex, then this builds the pdf directly. -# Otherwise, it uses this old-school but effective approach: -# -# latex -> dvips -> ps2pdf -# -# The BUILD_STRATEGY can be overridden in Makefile.ini in the same -# directory. The default is pdflatex. -# -# Reasons for using latex -> dvips include the "psfrag" package, and the -# generation of postscript instead of PDF. Arguments for using pdflatex -# include "new and shiny" and "better supported." I can't argue with -# either of those, and supporting them both didn't turn out to be that -# difficult, so there you have it. Choices. -# -# %._show: -# A phony target that builds the pdf file and then displays it using the -# environment-overridable value of VIEW_PDF ($(VIEW_PDF)). -# -# %._graphics: -# A phony target that generates all graphics on which %.pdf (or %.dvi) -# depends. -# -# %.ps (only for BUILD_STRATEGY=latex): -# Build a Postscript file from the corresponding %.tex file. -# This is done using dvips. Paper size is automatically -# extracted from the declaration -# -# \documentclass[<something>paper] -# -# or it is the system default. -# -# If using beamer (an excellent presentation class), the paper -# size is ignored. More on this later. -# -# %.dvi (only for BUILD_STRATEGY=latex): -# Build the DVI file from the corresponding %.tex file. -# -# %.ind: -# Build the index for this %.tex file. -# -# %.gls: -# Build the nomenclature glossary for this %.tex file. -# -# %.nls: -# Build the (newer) nomenclature file for this %.tex file. -# -# %.eps: -# Build an eps file from one of the following file types: -# -# .dot : graphviz -# .gpi : gnuplot -# .fig : xfig -# .xvg : xmgrace -# .svg : scalable vector graphics (goes through inkscape) -# .png : png (goes through NetPBM) -# .jpg : jpeg (goes through ImageMagick) -# .eps.gz : gzipped eps -# -# The behavior of this makefile with each type is described in -# its own section below. -# -# %.pstex{,_t} (only for BUILD_STRATEGY=latex): -# Build a .pstex_t file from a .fig file. -# -# FEATURES: -# -# Optional Binary Directory: -# If you create the _out_ directory in the same place as the makefile, -# it will automatically be used as a dumping ground for .pdf (or .dvi, -# .ps, and .pdf) output files. -# -# Alternatively, you can set the BINARY_TARGET_DIR variable, either as a -# make argument or in Makefile.ini, to point to your directory of -# choice. Note that no pathname wildcard expansion is done in the -# makefile, so make sure that the path is complete before going in -# there. E.g., if you want to specify something in your home directory, -# use $$HOME/ instead of ~/ so that the shell expands it before it gets -# to the makefile. -# -# External Program Dependencies: -# Every external program used by the makefile is represented by an -# ALLCAPS variable at the top of this file. This should allow you to -# make judgments about whether your system supports the use of this -# makefile. The list is available in the ALL_PROGRAMS variable and, -# provided that you are using GNU make 3.80 or later (or you haven't -# renamed this file to something weird like "mylatexmakefile" and like -# invoking it with make -f) can be viewed using -# -# make _all_programs -# -# Additionally, the availability of these programs can be checked -# automatically for you by running -# -# make _check_programs -# -# The programs are categorized according to how important they are and -# what function they perform to help you decide which ones you really -# need. -# -# Colorized Output: -# The output of commands is colorized to highlight things that are often -# important to developers. This includes {underfull,overfull} -# {h,v}boxes, general LaTeX Errors, each stage of document building, and -# the number of pages in the final document. The colors are obtained -# using 'tput', so colorization should work pretty well on any terminal. -# -# The colors can be customized very simply by setting any of the -# LATEX_COLOR_<CONTEXT> variables in your environment (see above). -# -# Predecessors to TeX Files: -# Given a target <target>, if no <target>.tex file exists but a -# corresponding script or predecessor file exists, then appropriate -# action will be taken to generate the tex file. -# -# Currently supported script or predecessor languages are: -# -# sh: %.tex.sh -# perl: %.tex.pl -# python: %.tex.py -# -# Calls the script using the appropriate interpreter, assuming that -# its output is a .tex file. -# -# The script is called thus: -# -# <interpreter> <script file name> <target tex file> -# -# and therefore sees exactly one parameter: the name of the .tex -# file that it is to create. -# -# Why does this feature exist? I ran into this while working on -# my paper dissertation. I wrote a huge bash script that used a -# lot of sed to bring together existing papers in LaTeX. It -# would have been nice had I had something like this to make my -# life easier, since as it stands I have to run the script and -# then build the document with make. This feature provides hooks -# for complicated stuff that you may want to do, but that I have -# not considered. It should work fine with included dependencies, -# too. -# -# Scripts are run every time make is invoked. Some trickery is -# employed to make sure that multiple restarts of make don't cause -# them to be run again. -# -# reST: %.rst -# -# Runs the reST to LaTeX converter to generate a .tex file -# If it finds a file names _rststyle_._include_.tex, uses it as -# the "stylesheet" option to rst2latex. -# -# Note that this does not track sub-dependencies in rst files. It -# assumes that the top-level rst file will change if you want a -# rebuild. -# -# Dependencies: -# -# In general, dependencies are extracted directly from LaTeX output on -# your document. This includes -# -# * Bibliography information -# * \include or \input files (honoring \includeonly, too) -# * Graphics files inserted by the graphicx package -# -# Where possible, all of these are built correctly and automatically. -# In the case of graphics files, these are generated from the following -# file types: -# -# GraphViz: .dot -# GNUPlot: .gpi -# XFig: .fig -# XMgrace: .xvg -# SVG: .svg -# PNG: .png -# JPEG: .jpg -# GZipped EPS: .eps.gz -# -# If the file exists as a .eps already, it is merely used (and will not -# be deleted by 'clean'!). -# -# LaTeX and BibTeX are invoked correctly and the "Rerun to get -# cross-references right" warning is heeded a reasonable number of -# times. In my experience this is enough for even the most troublesome -# documents, but it can be easily changed (if LaTeX has to be run after -# BibTeX more than three times, it is likely that something is moving -# back and forth between pages, and no amount of LaTeXing will fix -# that). -# -# \includeonly is honored by this system, so files that are not -# specified there will not trigger a rebuild when changed. -# -# Beamer: -# A special TeX source comment is recognized by this makefile (only when -# BUILD_STRATEGY=latex, since this invokes psnup): -# -# %%[[:space:]]*BEAMER[[:space:]]*LARGE -# -# The presence of this comment forces the output of dvips through psnup -# to enlarge beamer slides to take up an entire letter-sized page. This -# is particularly useful when printing transparencies or paper versions -# of the slides. For some reason landscape orientation doesn't appear -# to work, though. -# -# If you want to put multiple slides on a page, use this option and then -# print using mpage, a2ps, or psnup to consolidate slides. My personal -# favorite is a2ps, but your mileage may vary. -# -# When beamer is the document class, dvips does NOT receive a paper size -# command line attribute, since beamer does special things with sizes. -# -# GNUPlot Graphics: -# When creating a .gpi file, DO NOT INCLUDE the "set terminal" or "set -# output" commands! The makefile will include terminal information for -# you. Besides being unnecessary and potentially harmful, including the -# terminal definition in the .gpi file makes it harder for you, the one -# writing the document, to preview your graphics, e.g., with -# -# gnuplot -persist myfile.gpi -# -# so don't do specify a terminal or an output file in your .gpi files. -# -# When building a gpi file into an eps file, there are several features -# available to the document designer: -# -# Global Header: -# The makefile searches for the files in the variable GNUPLOT_GLOBAL -# in order: -# -# ($(GNUPLOT_GLOBAL)) -# -# Only the first found is used. All .gpi files in the directory are -# treated as though the contents of GNUPLOT_GLOBAL were directly -# included at the top of the file. -# -# NOTE: This includes special comments! (see below) -# -# Font Size: -# A special comment in a .gpi file (or a globally included file) of -# the form -# -# ## FONTSIZE=<number> -# -# will change the font size of the GPI output. If font size is -# specified in both the global file and the GPI file, the -# specification in the individual GPI file is used. -# -# Grayscale Output: -# GNUplot files also support a special comment to force them to be -# output in grayscale *no matter what*: -# -# ## GRAY -# -# This is not generally advisable, since you can always create a -# grayscale document using the forms mentioned above. But, if your -# plot simply must be grayscale even in a document that allows -# colors, this is how you do it. -# -# XFig Graphics: -# No special handling is done with XFig, except when a global -# grayscale method is used, e.g. -# -# make GRAY=1 document -# -# In these cases the .eps files is created using the -N switch to -# fig2dev to turn off color output. (Only works with eps, not pstex -# output) -# -# GraphVis Graphics: -# Color settings are simply ignored here. The 'dot' program is used -# to transform a .dot file into a .eps file. -# -# If you want, you can use the dot2tex program to convert dot files -# to tex graphics. The default is to just call dot2tex with no -# arguments, but you can change the DOT2TEX definition to include -# options as needed (in your Makefile.ini). -# -# Note that, as with pstex, the makefile cannot use latex's own -# output to discover all missing dot_t (output) files, since anytime -# TeX includes TeX, it has to bail when it can't find the include -# file. It can therefore only stop on the first missing file it -# discovers, and we can't get a large list of them out easily. -# -# So, the makefile errors out if it's missing an included dot_t -# file, then prompts the user to run this command manually: -# -# make all-dot2tex -# -# GZipped EPS Graphics: -# -# A .eps.gz file is sometimes a nice thing to have. EPS files can get -# very large, especially when created from bitmaps (don't do this if you -# don't have to). This makefile will unzip them (not in place) to -# create the appropriate EPS file. -# -# -endef - -# -# DEPENDENCY CHART: -# -# digraph "g" { -# rankdir=TB -# size="9,9" -# edge [fontsize=12 weight=10] -# node [shape=box fontsize=14 style=rounded] -# -# eps [ -# shape=Mrecord -# label="{{<gpi> GNUplot|<epsgz> GZip|<dot> Dot|<fig> XFig}|<eps> eps}" -# ] -# pstex [label="%.pstex"] -# pstex_t [label="%.pstex_t"] -# tex_outputs [shape=point] -# extra_tex_files [shape=point] -# gpi_data [label="<data>"] -# gpi_includes [label="_include_.gpi"] -# aux [label="%.aux"] -# fls [label="%.fls"] -# idx [label="%.idx"] -# glo [label="%.glo"] -# ind [label="%.ind"] -# log [label="%.log"] -# tex_sh [label="%.tex.sh"] -# rst [label="%.rst"] -# tex [ -# shape=record -# label="<tex> %.tex|<include> _include_.tex" -# ] -# include_aux [label="_include_.aux"] -# file_bib [label=".bib"] -# bbl [label="%.bbl"] -# dvi [label="%.dvi"] -# ps [label="%.ps"] -# pdf [label="%.pdf"] -# fig [label=".fig"] -# dot [label=".dot"] -# gpi [label=".gpi"] -# eps_gz [label=".eps.gz"] -# -# gpi_files [shape=point] -# -# rst -> tex:tex [label="reST"] -# tex_sh -> tex:tex [label="sh"] -# tex_pl -> tex:tex [label="perl"] -# tex_py -> tex:tex [label="python"] -# tex -> tex_outputs [label="latex"] -# tex_outputs -> dvi -# tex_outputs -> aux -# tex_outputs -> log -# tex_outputs -> fls -# tex_outputs -> idx -# tex_outputs -> include_aux -# aux -> bbl [label="bibtex"] -# file_bib -> bbl [label="bibtex"] -# idx -> ind [label="makeindex"] -# glo -> gls [label="makeindex"] -# nlo -> nls [label="makeindex"] -# gls -> extra_tex_files -# nls -> extra_tex_files -# ind -> extra_tex_files -# bbl -> extra_tex_files -# eps -> extra_tex_files -# extra_tex_files -> dvi [label="latex"] -# gpi_files -> eps:gpi [label="gnuplot"] -# gpi -> gpi_files -# gpi_data -> gpi_files -# gpi_includes -> gpi_files -# eps_gz -> eps:epsgz [label="gunzip"] -# fig -> eps:fig [label="fig2dev"] -# fig -> pstex [label="fig2dev"] -# fig -> pstex_t [label="fig2dev"] -# pstex -> pstex_t [label="fig2dev"] -# dot -> eps:dot [label="dot"] -# dvi -> ps [label="dvips"] -# include_aux -> bbl [label="bibtex"] -# ps -> pdf [label="ps2pdf"] -# -# edge [ color=blue label="" style=dotted weight=1 fontcolor=blue] -# fls -> tex:include [label="INPUT: *.tex"] -# fls -> file_bib [label="INPUT: *.aux"] -# aux -> file_bib [label="\\bibdata{...}"] -# include_aux -> file_bib [label="\\bibdata{...}"] -# log -> gpi [label="Graphic file"] -# log -> fig [label="Graphic file"] -# log -> eps_gz [label="Graphic file"] -# log -> dot [label="Graphic file"] -# log -> idx [label="No file *.ind"] -# log -> glo [label="No file *.gls"] -# log -> nlo [label="No file *.nls"] -# gpi -> gpi_data [label="plot '...'"] -# gpi -> gpi_includes [label="load '...'"] -# tex:tex -> ps [label="paper"] -# tex:tex -> pdf [label="embedding"] -# } -# - -# -# DEPENDENCY CHART SCRIPT -# -# $(call output_dependency_graph,[<output file>]) -define output-dependency-graph - if [ -f '$(this_file)' ]; then \ - $(SED) \ - -e '/^[[:space:]]*#[[:space:]]*DEPENDENCY CHART:/,/^$$/!d' \ - -e '/DEPENDENCY CHART/d' \ - -e '/^$$/d' \ - -e 's/^[[:space:]]*#//' \ - $(this_file) $(if $1,> '$1',); \ - else \ - $(ECHO) "Cannot determine the name of this makefile."; \ - fi -endef -# -.PHONY: Targets.ini $(HOME)/.latex-makefile/Targets.ini --include Targets.ini --include $(HOME)/.latex-makefile/Targets.ini -# -# vim: noet sts=0 sw=8 ts=8 - diff --git a/2012/pluggable-roadmap/Targets.ini b/2012/pluggable-roadmap/Targets.ini deleted file mode 100644 index 1466882..0000000 --- a/2012/pluggable-roadmap/Targets.ini +++ /dev/null @@ -1,4 +0,0 @@ -pluggable-roadmap.d: vc._include_.tex - -vc._include_.tex: vc pluggable-roadmap.tex pluggable-roadmap.bib - ./vc -m && mv vc.tex $@ diff --git a/2012/pluggable-roadmap/easychair.cls b/2012/pluggable-roadmap/easychair.cls deleted file mode 100755 index 47e0ee3..0000000 --- a/2012/pluggable-roadmap/easychair.cls +++ /dev/null @@ -1,756 +0,0 @@ -% -% Some credits -% - -\def\easychairstyleauthor{easychair class style, by Serguei A. Mokhov, with changes by Andrei Voronkov <24 October 2011>} -\def\easychairstylerevision{CVS Revision: $Id: easychair.cls,v 3.0 2011/10/24 20:26:32 voronkov Exp $} -\def\easychairstylepurpose{Designed for EasyChair.org, under guidelines and suggestions of} -\def\easychairstylevoronkov{\space\space\space\space\space\space\space\space\space\space\space\space\space Andrei Voronkov <www.voronkov.com>, and} -\def\easychairstylesutcliffe{\space\space\space\space\space\space\space\space\space\space\space\space\space Geoff Sutcliffe <www.cs.miami.edu/^geoff>} -\def\easychairstylecopyright{Copyright terms are that of EasyChair.org} -\def\easychairstylebugs{For bug reports, please contact <andrei(a)voronkov.com>} - -\everyjob{\typeout{\easychairstyleauthor}} -\everyjob{\typeout{\easychairstylerevision}} -\everyjob{\typeout{\easychairstylepurpose}} -\everyjob{\typeout{\easychairstylevoronkov}} -\everyjob{\typeout{\easychairstylesutcliffe}} -\everyjob{\typeout{\easychairstylecopyright}} -\everyjob{\typeout{\easychairstylebugs}} - -\immediate\write10{\easychairstyleauthor} -\immediate\write10{\easychairstylerevision} -\immediate\write10{\easychairstylepurpose} -\immediate\write10{\easychairstylevoronkov} -\immediate\write10{\easychairstylesutcliffe} -\immediate\write10{\easychairstylecopyright} -\immediate\write10{\easychairstylebugs} - -% -% Require LaTeX 2.09 or later -% - -\NeedsTeXFormat{LaTeX2e}[1995/12/01] -\ProvidesClass{easychair}[2011/05/02 v3.0] -\def\@tempa#1#2\@nil{\edef\@classname{#1}} -\expandafter\@tempa\@currnamestack{}{}{}\@nil -\ifx\@classname\@empty \edef\@classname{\@currname}\fi - - -% -% Debug -% - -\def\easychairdebug#1{\gdef\@EasyDebug{#1}} -\def\@EasyDebug{} - -\newif\ifdebug -\debugfalse - -\DeclareOption{debug}{\debugtrue} - -\def\easychairframe#1{\gdef\@EasyFrame{#1}} -\def\@EasyFrame{} - -\newif\ifframe -\framefalse - -\DeclareOption{frame}{\frametrue} - -\def\easychairverbose#1{\gdef\@EasyVerbose{#1}} -\def\@EasyVerbose{} - -\newif\ifverbose -\verbosefalse - -\DeclareOption{verbose}{\verbosetrue} - - -% -% Thesis -% Perh Geoff, February 23, 2010 with support from Andrei -% - -\def\easythesis#1{\gdef\@EasyThesis{#1}} -\def\@EasyThesis{} - -\newif\ifthesis -\thesisfalse - -\DeclareOption{thesis}{\thesistrue} - - -% -% Times New Roman or not -% - -\def\easytimes#1{\gdef\@EasyTimes{#1}} -\def\@EasyTimes{} - -\newif\ifnotimes -\notimesfalse - -\DeclareOption{notimes}{\notimestrue} - -\newif\ifwithtimes -\withtimesfalse - -\DeclareOption{withtimes}{\withtimestrue} - - -\newif\ifauthorundefined -\authorundefinedtrue - -\let\oldauthor=\author -\renewcommand - {\author} - [1] - {% - \ifauthorundefined - \oldauthor{#1} - \authorundefinedfalse - \else - \PackageWarning{easychair}{Another use of author ignored} - \fi - } - -\newif\iftitleundefined -\titleundefinedtrue - -\let\oldtitle=\title -\renewcommand - {\title} - [1] - { - \iftitleundefined - \oldtitle{#1} - \titleundefinedfalse - \else - \PackageWarning{easychair}{Another use of title ignored} - \fi - } - - -% -% Running heads definitions -% - -%\def\titlerunning#1{\gdef\@titleRunning{#1}} -%\def\authorrunning#1{\gdef\@authorRunning{#1}} -%\titlerunning{easychair: Running title head is undefined.} -%\authorrunning{easychair: Running author head is undefined.} - -\newif\iftitlerunningundefined -\titlerunningundefinedtrue - -\newif\ifauthorrunningundefined -\authorrunningundefinedtrue - -\gdef\@titleRunning{easychair: Running title head is undefined.} -\gdef\@authorRunning{easychair: Running author head is undefined.} - -\def\titlerunning#1 -{ - \iftitlerunningundefined - \gdef\@titleRunning{#1} - \titlerunningundefinedfalse - \else - \PackageWarning{easychair}{Another use of titlerunning ignored} - \fi -} - -\def\authorrunning#1 -{ - \ifauthorrunningundefined - \gdef\@authorRunning{#1} - \authorrunningundefinedfalse - \else - \PackageWarning{easychair}{Another use of authorrunning ignored} - \fi -} - -% -% Affiliations -% - -\newcommand{\affiliation}[1]{\small{#1}\vspace{-3pt}} - - -% -% Decide between letter and A4 paper formats -% as well as orientation -% - -% Default is 'letterpaper' -\def\paperformat#1{\gdef\@PaperFormat{#1}} -\def\@PaperFormat{letterpaper} - -\newif\ifletterpaper -\newif\ifafourpaper -\newif\ifcustompaper - -\letterpapertrue - -\DeclareOption{letterpaper}{\paperformat{letterpaper}\afourpaperfalse\custompaperfalse} -\DeclareOption{a4paper}{\paperformat{a4paper}\afourpapertrue\letterpaperfalse\custompaperfalse} -\DeclareOption{custompaper}{\paperformat{letterpaper}\afourpaperfalse\letterpaperfalse\custompapertrue} - - -\newlength{\@LMarginSize} -\newlength{\@RMarginSize} -\newlength{\@TMarginSize} -\newlength{\@BMarginSize} - -\DeclareOption{lmargin}{} -\DeclareOption{rmargin}{} -\DeclareOption{tmargin}{} -\DeclareOption{bmargin}{} - - -% Default is portrait {} -\def\paperorientation#1{\gdef\@PaperOrientation{#1}} -\def\@PaperOrientation{} - -\DeclareOption{portrait}{\paperorientation{}} -\DeclareOption{landscape}{\paperorientation{landscape}} - -% Two sided running heads for titlerunning and author running -% twosided is the default -\newif\iftwosided -\twosidedfalse - -\DeclareOption{onesided}{} -\DeclareOption{twosided}{\twosidedtrue} - - -% -% Decide between 1- or 2-column formats -% - -\def\columnCount#1{\gdef\@ColumnCount{#1}} -\def\@ColumnCount{onecolumn} - -\DeclareOption{onecolumn}{} -\DeclareOption{twocolumn}{\columnCount{twocolumn}} - - -% -% Decide on line spacing -% - -\def\lineSpacing#1{\gdef\@LineSpacing{#1}} -\def\(a)LineSpacing{1.0} - -\DeclareOption{zerospacing}{\lineSpacing{0.0}} -\DeclareOption{singlespacing}{\lineSpacing{1.0}} -\DeclareOption{lineandhalfspacing}{\lineSpacing{1.5}} -\DeclareOption{doublespacing}{\lineSpacing{2.0}} - -\DeclareOption{0.0}{\lineSpacing{0.0}} -\DeclareOption{1.0}{\lineSpacing{1.0}} -\DeclareOption{1.5}{\lineSpacing{1.5}} -\DeclareOption{2.0}{\lineSpacing{2.0}} - -\DeclareOption{0.0pt}{\lineSpacing{0.0}} -\DeclareOption{1.0pt}{\lineSpacing{1.0}} -\DeclareOption{1.5pt}{\lineSpacing{1.5}} -\DeclareOption{2.0pt}{\lineSpacing{2.0}} - - -% -% Font point size; default is 10pt -% -% The \headheight will have to be changed later accordingly -% such that fancyhdr does not complain it is too small. -% - -\def\baseFontSize#1{\gdef\@BaseFontSize{#1}} -\def\headHeightSize#1{\gdef\@HeadHeightSize{#1}} -\def\headSepSize#1{\gdef\@HeadSepSize{#1}} -\def\footSkipSize#1{\gdef\@FootSkipSize{#1}} - -\def\@BaseFontSize{10pt} -\def\(a)HeadHeightSize{12.0pt} -\def\(a)HeadSepSize{16.0pt} % instead of the default 25pt -\def\(a)FootSkipSize{26.0pt} % instead of the default 30pt - -\DeclareOption{8pt}{\PackageWarning{easychair}{Option '\CurrentOption' is not supported.}} -\DeclareOption{9pt}{\PackageWarning{easychair}{Option '\CurrentOption' is not supported.}} -\DeclareOption{10pt}{\baseFontSize{10pt}\headHeightSize{12.0pt}\headSepSize{16.0pt}\footSkipSize{26pt}} -\DeclareOption{11pt}{\baseFontSize{11pt}\headHeightSize{13.6pt}\headSepSize{23.0pt}\footSkipSize{28pt}} -\DeclareOption{12pt}{\baseFontSize{12pt}\headHeightSize{14.5pt}\headSepSize{25.0pt}\footSkipSize{30pt}} -\ExecuteOptions{10pt} - -% -% Page sizing -% - -%\newif\iffullpage -%\newif\ifsavetrees -% -%\DeclareOption{fullpage}{\fullpagetrue} -%\DeclareOption{savetrees}{\savetreestrue} - - -% Bark at any unknown package option -\DeclareOption*{\PackageWarning{easychair}{Unknown option '\CurrentOption'}} -\DeclareOption*{\PassOptionsToPackage{\CurrentOption}{geometry}} -%\DeclareOption*{\PassOptionsToClass{\CurrentOption}{article}} - -%\ExecuteOptions{centertags,portrait,10pt,twoside,onecolumn,final} -%\ExecuteOptions{} -\ProcessOptions\relax - - -% -% Required packages and classes. -% -% All must be standard as per most common LaTeX -% distributions. -% - -\ifthesis - \LoadClass[\@PaperFormat,\@PaperOrientation,\@ColumnCount,\@BaseFontSize,twoside]{report} - \RequirePackage{makeidx} -\else - % We are an article (more customized later) - \LoadClass[\@PaperFormat,\@PaperOrientation,\@ColumnCount,\@BaseFontSize,twoside]{article} - %\LoadClass[\@PaperFormat,\@PaperOrientation,\@ColumnCount,\@BaseFontSize]{article} -\fi - -% Require UTF8 encoding, per Andrei Voronkov, to accomodate -% all sorts of author names. -\RequirePackage[utf8]{inputenc} - -% All \urls will be hyperlinked and will deal properly with special characters -% XXX: url is included by hyperref -%\RequirePackage{url} - -% To ensure the footnotes are always at the bottom. -% IMPORTANT: footmisc should precede hyperref for the footnotes to hyperlink -% correctly to their pages where they are at instead of always at -% page 1. Per bug reports from a couple of users and a suggestion by -% Uwe Pfeiffer. -\RequirePackage[bottom]{footmisc} - -%% TOC/thumbnail LHS preview in the PDFs as well as active URLs and other cross-refs -%% Newer versions of hyperref declare a4paper or letterpaper as obsolete and issue warnings -%%\RequirePackage[\(a)PaperFormat,pdfcreator=easychair.cls-2.0]{hyperref} -%\RequirePackage[linktocpage,pdfcreator=easychair.cls-2.0-Beta-3]{hyperref} - -% Traditional graphics processing -\RequirePackage{graphicx} -%\RequirePackage{pdflscape} -%\RequirePackage{lscape} - - -%% Fonts, generally more compact but preserving point size - -% Pick "Times Roman" as a base font unless explicitly told not to -\ifnotimes - \ifwithtimes - \PackageWarning{easychair}{Cannot really use 'notimes' and 'withtimes' together} - \PackageWarning{easychair}{Defaulting to 'notimes'...} - \else - \PackageWarning{easychair}{'notimes' has been deprecated as it is the default in 2.0} - \fi -\else - \ifwithtimes - \RequirePackage{mathptmx} - \fi -\fi - -% Pick "Helvetica" as a "Sans-Serif" font -\RequirePackage[scaled=.85]{helvet} - -% For algorithm and source code listings -\RequirePackage{listings} - -%% Different Math and non-Math symbols and definitions - -\RequirePackage{latexsym} -\RequirePackage{amsthm} -\RequirePackage{empheq} - - -%% Line spacing to be applied AFTER the above space saving packages - -\renewcommand{\baselinestretch}{\@LineSpacing} - -%% Final text printing area, per Geoff Sutcliffe - -\RequirePackage{keyval} - -\define@key{Ec}{lmargin}{\Ec@defbylen{lmargin}{#1}} - -\newlength{\@MarginSize} -\setlength{\@MarginSize}{1in} - -\setlength{\@LMarginSize}{\@MarginSize} -%\setlength{\@LMarginSize}{\Ec@lmargin} -\setlength{\@RMarginSize}{\@MarginSize} -\setlength{\@TMarginSize}{\@MarginSize} -\setlength{\@BMarginSize}{\@MarginSize} - - -% Head height is dependent on the font point size -\setlength{\headheight}{\@HeadHeightSize} -\setlength{\headsep}{\@HeadSepSize} -\setlength{\footskip}{\@FootSkipSize} - -\ifletterpaper - \immediate\write10{easychair: Selecting letter paper margin sizes.} - \RequirePackage[% - papersize={8.5in,11in}, - total={145mm,224mm}, - centering, - twoside, - includeheadfoot]{geometry} -\fi -\ifafourpaper - \immediate\write10{easychair: Selecting A4 paper margin sizes.} - \RequirePackage[% - papersize={210mm,297mm}, - total={145mm,224mm}, - centering, - twoside, - includeheadfoot]{geometry} -\fi - -\ifcustompaper - \immediate\write10{easychair: Selecting custom paper margin sizes.} - \RequirePackage[% - papersize={189mm,246mm}, - total={145mm,224mm}, - top=9mm, - left=24mm, - twoside, - includeheadfoot]{geometry} - \headHeightSize{12.0pt} - \headSepSize{16.0pt} - \footSkipSize{26pt} -\fi - -%\setlength{\textwidth}{16cm} -%\setlength{\textheight}{9in} - - -% -% Volume -% - -\RequirePackage{lastpage} - -\newif\ifvolumeundefined -\volumeundefinedtrue - -% e.g. -% \volumeinfo -% {J. Bloe} % editor(s) #1 -% {1} % No. of editors #2 -% {LICS 2008} % event title #3 -% {1} % volume number #4 -% {4} % issue #5 -% {134} % start page #6 - -\def\@EasyFontStyle{\footnotesize} -\newcommand{\headfootstyle}[1]{\def\@EasyFontStyle{#1}} - -\def\@EasyVolumeInfo{} - -\ifthesis - \newcommand{\volumeinfo}[6] - {\PackageWarning{easychair}{Cannot use volumeinfo with 'thesis' option. Ignoring...}} -\else - \newcommand{\volumeinfo}[6]{% - \ifvolumeundefined - % \def\@makefntext##1{\noindent ##1}% - \def\@EasyEdsNames{#1}% - \def\(a)EasyEds{ed.}% - \def\@EasyEvent{#3}% - \def\@EasyVolume{}% - \def\@EasyIssue{}% - \def\@EasyFirstPage{#6}% - \ifnum #2>1 \gdef\(a)EasyEds{eds.}\fi% - \ifnum #4>0 \gdef\@EasyVolume{; Volume #4}\fi% - \ifnum #5>0 \gdef\@EasyIssue{, issue: #5} \fi% - % \footnotetext[0]{\sf \@EasyEdsNames (\@EasyEds); \@EasyEvent\@EasyVolume\@EasyIssue, pp. #6-\pageref{LastPage}}% - % \def\@EasyVolumeInfo{\footnotesize{\sf\@EasyEdsNames~(\@EasyEds); \@EasyEvent\@EasyVolume\@EasyIssue, pp. \@EasyFirstPage--\pageref{LastPage}}}% - \def\@EasyVolumeInfo{\@EasyFontStyle\@EasyEdsNames~(\@EasyEds); \@EasyEvent\@EasyVolume\@EasyIssue, pp. \@EasyFirstPage--\pageref{LastPage}}% - %\def\@makefntext##1{\noindent\@makefnmark##1}% - \setcounter{page}{\@EasyFirstPage} - \volumeundefinedfalse - \else - {\PackageWarning{easychair}{May not redefine volumeinfo}} - \fi - } -\fi - -\def\@EventInfo{} -\def\@VolumeInfo{} - -\newif\ifvolumeecpsundefined -\volumeecpsundefinedtrue - -\newcommand{\volumeinfoECPS}[2]{% - \ifvolumeecpsundefined - \def\@EventInfo{#1}% - \def\@VolumeInfo{#2}% - \volumeecpsundefinedfalse - \else - {\PackageWarning{easychair}{Ignoring another definition of volumeinfoECPS}} - \fi -} - - -% -% Allow for more space to place floats. -% - -\renewcommand{\topfraction}{0.95} -\renewcommand{\bottomfraction}{0.95} -\renewcommand{\textfraction}{0.05} -\renewcommand{\floatpagefraction}{0.8} - - -% -% Running heads and ``foots'' -% - -\RequirePackage{fancyhdr} -\pagestyle{fancy} - -\fancyhead{} -%\ifdebug -% \iftwosided -% \fancyhead[RE]{\overline{\@titleRunning}} -% \fancyhead[RO]{\overline{\@authorRunning}} -% \else -% \fancyhead[LO,LE]{\begin{math}\overline{\mbox{\@titleRunning}}\end{math}} -% \fancyhead[RO,RE]{\begin{math}\overline{\mbox{\@authorRunning}}\end{math}} -% \fi -%\else - \iftwosided - \fancyhead[RE]{{\@EasyFontStyle\@titleRunning}} - \fancyhead[RO]{{\@EasyFontStyle\@authorRunning}} - \else - \fancyhead[LO,LE]{{\@EasyFontStyle\@titleRunning}} - \fancyhead[RO,RE]{{\@EasyFontStyle\@authorRunning}} - \fi -%\fi - -\fancyfoot{} -%\ifdebug -% \fancyfoot[CO,CE]{\underline{\thepage}} -% \renewcommand{\headrulewidth}{1pt} -% \renewcommand{\footrulewidth}{1pt} -%\else -% \fancyfoot[CO,CE]{\thepage} -% \fancyfoot[LO]{{\footnotesize{\sf\@EventInfo}}} -% \fancyfoot[LE]{{\footnotesize{\sf\@VolumeInfo}}} -% \fancyfoot[LO]{{\@EasyFontStyle\@EventInfo}} -% \fancyfoot[LE]{{\@EasyFontStyle\@VolumeInfo}} -\ifodd\c@page - \fancyfoot[LO]{{\@EasyFontStyle\@VolumeInfo}} - \fancyfoot[RE]{{\@EasyFontStyle\@EventInfo}} -\else - \fancyfoot[RE]{{\@EasyFontStyle\@VolumeInfo}} - \fancyfoot[LO]{{\@EasyFontStyle\@EventInfo}} -\fi -% \fancyfoot[LO,LE] -% { -%\volumeinfoECPS -% {A. Editor, B. Editor} % editors -% {2} % number of editors -% {EVENT, Month YEAR} % event -% {1} % volume -% } -% \fancyfoot[RO,RE]{{\@EasyFontStyle\thepage}} -% \fancyfoot[RO]{{\@EasyFontStyle\thepage}} -% \fancyfoot[LE]{{\@EasyFontStyle\thepage}} -\ifodd\c@page - \fancyfoot[RO]{{\normalsize\thepage}} - \fancyfoot[LE]{{\normalsize\thepage}} -\else - \fancyfoot[LE]{{\normalsize\thepage}} - \fancyfoot[RO]{{\normalsize\thepage}} -\fi - \renewcommand{\headrulewidth}{0pt} - \renewcommand{\footrulewidth}{0pt} -%\fi - -% Suppress the default date, per Geoff -\date{} - -% For the first page -\fancypagestyle{plain}{% -\fancyhf{} % clear all header and footer fields -\ifodd\c@page - \fancyfoot[L]{\@EasyVolumeInfo}% - \fancyfoot[R]{{\normalsize\thepage}} % except the center -\else - \fancyfoot[R]{\@EasyVolumeInfo}% - \fancyfoot[L]{{\normalsize\thepage}} % except the center -\fi -\renewcommand{\headrulewidth}{0pt} -\renewcommand{\footrulewidth}{0pt}} - - -\let\oldmaketitle=\maketitle -\def\@maketitle{% - \newpage - \null - % Facelift a bit the title and make it bold, per Geoff - \vspace{-1cm} - \begin{center}% - \let\footnote\thanks% - % Do not bold Times title, per Geoff - \ifwithtimes - {\LARGE{\@title}\par} - \else - {\LARGE{\bf \@title}\par} - \fi - \vskip 0.5\baselineskip - \begin{tabular}[t]{c}% - \@author - \end{tabular}\par - \@date - \end{center}% - %\volumeinfoECPS{\@EventInfo}{\@VolumeInfo} - %\titlerunning{EMPTY}% - %\authorrunning{EMPTY}% - %\authorrunning{\@authorRunning}% - %\renewcommand{\titlerunning}[1]{} - %\renewcommand{\authorrunning}[1]{} - %%\renewcommand{\volumeinfoECPS}[2]{}% - %%\renewcommand{\volumeinfo}[6]{} - %\gdef\@authorRunning{Gooo\@authorRunning}% - %\gdef\@EasyVolumeInfo{Foo\@authorRunning}% - %\gdef\@EventInfo{} - %\gdef\@VolumeInfo{} -%\volumeinfo - %{NNNNOT A. Voronkov} % editors - %{1} % number of editors - %{NYO-YO} % event - %{44} % volume - %{1} % issue - %{45} % starting page number -%\volumeinfoECPS - %{NNNNOT Super EasyChair Workshop Proceedings} - %{NNNNOT ECPS vol. 43} - \par - %\relax -} - - -% TOC/thumbnail LHS preview in the PDFs as well as active URLs and other cross-refs -% Newer versions of hyperref declare a4paper or letterpaper as obsolete and issue warnings -\RequirePackage[linktocpage,pdfcreator=easychair.cls-3.0]{hyperref} - - -% Tighten up bibliography -\let\oldthebibliography=\thebibliography -\let\endoldthebibliography=\endthebibliography -\renewenvironment{thebibliography}[1] -{ - \small - \begin{oldthebibliography}{#1} - \setlength{\parskip}{2pt} - \setlength{\itemsep}{0pt} -} -{ - \end{oldthebibliography} -} - -\ifdebug - \ifverbose - \RequirePackage[colorgrid,pscoord]{eso-pic}% - \else - \RequirePackage[pscoord]{eso-pic} - \newcommand\ShowFramePicture{% - \begingroup - \color{red} - \AtTextLowerLeft{\framebox(\LenToUnit{\textwidth},\LenToUnit{\textheight}){}}% - \AtTextUpperLeft{\put(0,\LenToUnit{\headsep}){\framebox(\LenToUnit{\textwidth},\LenToUnit{\headheight}){}}}% - \AtTextLowerLeft{\put(0,\LenToUnit{-\footskip}){\framebox(\LenToUnit{\textwidth},\LenToUnit{\headheight}){}}}% - \endgroup - } - \AddToShipoutPicture{\ShowFramePicture} - \fi - %\RequirePackage[a4,cam,center]{crop}% - %\RequirePackage[cam,center]{crop}% -\fi - -\ifframe - \ifverbose - \RequirePackage[colorgrid,pscoord]{eso-pic}% - \else - \RequirePackage[pscoord]{eso-pic} - \newcommand\ShowBlueFrame{% - \begingroup - \color{blue} - % odd page -% \AtTextLowerLeft{\put(\LenToUnit{-23.6mm},\LenToUnit{-21.8mm}){\framebox(\LenToUnit{188.3mm},\LenToUnit{245.4mm}){}}}% - % even page -% \AtTextLowerLeft{\put(\LenToUnit{-19.6mm},\LenToUnit{-21.8mm}){\framebox(\LenToUnit{188.3mm},\LenToUnit{245.4mm}){}}}% - \endgroup - } - \AddToShipoutPicture{\ShowBlueFrame} - \fi -\fi - -% \geometry{papersize={170mm,240mm},total={124mm,185mm}} - -%% Indexing options for proceedings to link up people's names to their -%% various participation and affiliation options. - -\newcommand - {\indexedperson} - [3] - {\index{#2!#1}\index{#1}\index{#1!#3}} - -\newcommand - {\indexedauthor} - [1] - {\indexedperson{#1}{Authors}{Author}} - -\newcommand - {\indexededitor} - [1] - {\indexedperson{#1}{Editors}{Editor}} - -\newcommand - {\indexedpcmember} - [1] - {\indexedperson{#1}{PC Members}{PC Member}} - -\newcommand - {\indexedreviewer} - [1] - {\indexedperson{#1}{Reviewers}{Reviewer}} - -\newcommand - {\indexedorganizer} - [1] - {\indexedperson{#1}{Organizers}{Organizer}} - -\newcommand - {\indexedwebmaster} - [1] - {\indexedperson{#1}{Webmasters}{Webmaster}} - -\newcommand - {\indexedaffiliation} - [2] - {\indexedperson{#1}{#2}{#2}} - -\newcommand - {\indexedsupervisor} - [2] - {\indexedperson{#1}{}{Supervisor: #2}\indexedperson{#2}{Supervisors}{Supervisor}} - -\endinput - -% \crop[font=\upshape\mdseries\small\textsf] - -% EOF diff --git a/2012/pluggable-roadmap/pluggable-roadmap.tex b/2012/pluggable-roadmap/pluggable-roadmap.tex index f1a3474..00ff356 100644 --- a/2012/pluggable-roadmap/pluggable-roadmap.tex +++ b/2012/pluggable-roadmap/pluggable-roadmap.tex @@ -1,11 +1,10 @@ -\documentclass[a4paper,withtimes]{easychair} +\documentclass{tortechrep} \usepackage{doc} \usepackage{xspace} \usepackage{fancyhdr} \usepackage{color} \usepackage{graphicx} -\input{vc._include_.tex} \usepackage{prettyref} %% Non-breaking space should really be used @@ -28,25 +27,14 @@ \newcommand{\ia}{inter alia\xspace} \makeatother -\pagestyle{fancy} -\fancyhf{} - -\fancyhead[C]{\sc revision \VCRevisionMod~(\VCDateISO~\VCTime)} -\fancyfoot[C]{\thepage} - \begin{document} \title{Pluggable Transports Roadmap} -\author{Steven J. Murdoch \and George Kadianakis} - -\date{\VCDateISO} - -% \authorrunning{} has to be set for the shorter version of the authors' names; -% otherwise a warning will be rendered in the running heads. -% -\authorrunning{Murdoch and Kadianakis} -\titlerunning{Pluggable Transports Roadmap} +\author{Steven J. Murdoch and George Kadianakis} +\contact{steven.murdoch@cl.cam.ac.uk,desnacked@riseup.net} +\date{March 17, 2012} +\reportid{2012-03-003} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \maketitle diff --git a/2012/pluggable-roadmap/tortechrep.cls b/2012/pluggable-roadmap/tortechrep.cls new file mode 120000 index 0000000..4c24db2 --- /dev/null +++ b/2012/pluggable-roadmap/tortechrep.cls @@ -0,0 +1 @@ +../../tortechrep.cls \ No newline at end of file diff --git a/2012/pluggable-roadmap/vc b/2012/pluggable-roadmap/vc deleted file mode 100755 index 5c5a1b3..0000000 --- a/2012/pluggable-roadmap/vc +++ /dev/null @@ -1,24 +0,0 @@ -#!/bin/sh -# This is file 'vc' from the vc bundle for TeX. -# The original file can be found at CTAN:support/vc. -# This file is Public Domain. - -# Parse command line options. -full=0 -mod=0 -while [ -n "$(echo $1 | grep '-')" ]; do - case $1 in - -f ) full=1 ;; - -m ) mod=1 ;; - * ) echo 'usage: vc [-f] [-m]' - exit 1 - esac - shift -done -# English locale. -LC_ALL=C -git --no-pager log -1 HEAD --pretty=format:"Hash: %H%nAbr. Hash: %h%nParent Hashes: %P%nAbr. Parent Hashes: %p%nAuthor Name: %an%nAuthor Email: %ae%nAuthor Date: %ai%nCommitter Name: %cn%nCommitter Email: %ce%nCommitter Date: %ci%n" |gawk -v script=log -v full=$full -f vc-git.awk > vc.tex -if [ "$mod" = 1 ] -then - git status |gawk -v script=status -f vc-git.awk >> vc.tex -fi diff --git a/2012/pluggable-roadmap/vc-git.awk b/2012/pluggable-roadmap/vc-git.awk deleted file mode 100644 index 66b3526..0000000 --- a/2012/pluggable-roadmap/vc-git.awk +++ /dev/null @@ -1,89 +0,0 @@ -# This is file 'vc-git.awk' from the vc bundle for TeX. -# The original file can be found at CTAN:support/vc. -# This file is Public Domain. -BEGIN { - -### Process output of "git status". - if (script=="status") { - modified = 0 - } - -} - - - -### Process output of "git log". -script=="log" && /^Hash:/ { Hash = substr($0, 2+match($0, ":")) } -script=="log" && /^Abr. Hash:/ { AbrHash = substr($0, 2+match($0, ":")) } -script=="log" && /^Parent Hashes:/ { ParentHashes = substr($0, 2+match($0, ":")) } -script=="log" && /^Abr. Parent Hashes:/ { AbrParentHashes = substr($0, 2+match($0, ":")) } -script=="log" && /^Author Name:/ { AuthorName = substr($0, 2+match($0, ":")) } -script=="log" && /^Author Email:/ { AuthorEmail = substr($0, 2+match($0, ":")) } -script=="log" && /^Author Date:/ { AuthorDate = substr($0, 2+match($0, ":")) } -script=="log" && /^Committer Name:/ { CommitterName = substr($0, 2+match($0, ":")) } -script=="log" && /^Committer Email:/ { CommitterEmail = substr($0, 2+match($0, ":")) } -script=="log" && /^Committer Date:/ { CommitterDate = substr($0, 2+match($0, ":")) } - -### Process output of "git status". -### Changed index? -script=="status" && /^# Changes to be committed:/ { modified = 1 } -### Unstaged modifications? -script=="status" && /^# Changed but not updated:/ { modified = 2 } - - - -END { - -### Process output of "git log". - if (script=="log") { -### Standard encoding is UTF-8. - if (Encoding == "") Encoding = "UTF-8" -### Extract relevant information from variables. - LongDate = substr(AuthorDate, 1, 25) - DateRAW = substr(LongDate, 1, 10) - DateISO = DateRAW - DateTEX = DateISO - gsub("-", "/", DateTEX) - Time = substr(LongDate, 12, 14) -### Write file identification to vc.tex. - print "%%% This file has been generated by the vc bundle for TeX." - print "%%% Do not edit this file!" - print "%%%" -### Write Git specific macros. - print "%%% Define Git specific macros." - print "\\gdef\\GITHash{" Hash "}%" - print "\\gdef\\GITAbrHash{" AbrHash "}%" - print "\\gdef\\GITParentHashes{" ParentHashes "}%" - print "\\gdef\\GITAbrParentHashes{" AbrParentHashes "}%" - print "\\gdef\\GITAuthorName{" AuthorName "}%" - print "\\gdef\\GITAuthorEmail{" AuthorEmail "}%" - print "\\gdef\\GITAuthorDate{" AuthorDate "}%" - print "\\gdef\\GITCommitterName{" CommitterName "}%" - print "\\gdef\\GITCommitterEmail{" CommitterEmail "}%" - print "\\gdef\\GITCommitterDate{" CommitterDate "}%" -### Write generic version control macros. - print "%%% Define generic version control macros." - print "\\gdef\\VCRevision{\\GITAbrHash}%" - print "\\gdef\\VCAuthor{\\GITAuthorName}%" - print "\\gdef\\VCDateRAW{" DateRAW "}%" - print "\\gdef\\VCDateISO{" DateISO "}%" - print "\\gdef\\VCDateTEX{" DateTEX "}%" - print "\\gdef\\VCTime{" Time "}%" - print "\\gdef\\VCModifiedText{\\textcolor{red}{with local modifications!}}%" - print "%%% Assume clean working copy." - print "\\gdef\\VCModified{0}%" - print "\\gdef\\VCRevisionMod{\\VCRevision}%" - } - -### Process output of "git status". - if (script=="status") { - print "%%% Is working copy modified?" - print "\\gdef\\VCModified{" modified "}%" - if (modified==0) { - print "\\gdef\\VCRevisionMod{\\VCRevision}%" - } else { - print "\\gdef\\VCRevisionMod{\\VCRevision~\\VCModifiedText}%" - } - } - -}

1 0

[tech-reports/master] Add raw datagram-testing-plan report from Steven's repo.
by karsten＠torproject.org 26 Aug '12

26 Aug '12

commit 377f7d752c19d644a5b92cb2d693dd3dd2082fa1 Author: Karsten Loesing <karsten.loesing(a)gmx.net> Date: Wed Aug 8 08:15:13 2012 +0200 Add raw datagram-testing-plan report from Steven's repo. https://gitweb.torproject.org/sjm217/torspec.git/tree/refs/heads/project468… --- 2012/datagram-testing-plan/.gitignore | 9 + 2012/datagram-testing-plan/Makefile | 3892 ++++++++++++++++++++ 2012/datagram-testing-plan/Targets.ini | 4 + .../datagram-testing-plan.bib | 24 + .../datagram-testing-plan.tex | 150 + 2012/datagram-testing-plan/easychair.cls | 756 ++++ 2012/datagram-testing-plan/vc | 24 + 2012/datagram-testing-plan/vc-git.awk | 89 + 8 files changed, 4948 insertions(+), 0 deletions(-) diff --git a/2012/datagram-testing-plan/.gitignore b/2012/datagram-testing-plan/.gitignore new file mode 100644 index 0000000..e696f73 --- /dev/null +++ b/2012/datagram-testing-plan/.gitignore @@ -0,0 +1,9 @@ +datagram-testing-plan.aux.make +datagram-testing-plan.auxbbl.make +datagram-testing-plan.auxtarget.make +datagram-testing-plan.d +datagram-testing-plan.fls +datagram-testing-plan.out.make +datagram-testing-plan.pdf +vc._include_.tex + diff --git a/2012/datagram-testing-plan/Makefile b/2012/datagram-testing-plan/Makefile new file mode 100644 index 0000000..62951f3 --- /dev/null +++ b/2012/datagram-testing-plan/Makefile @@ -0,0 +1,3892 @@ +# Copyright 2004 Chris Monson (shiblon(a)gmail.com) +# Latest version available at http://www.bouncingchairs.net/oss +# +# This file is part of ``Chris Monson's Free Software''. +# +# ``Chris Monson's Free Software'' is free software; you can redistribute it +# and/or modify it under the terms of the GNU General Public License as +# published by the Free Software Foundation, Version 2. +# +# ``Chris Monson's Free Software'' is distributed in the hope that it will +# be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General +# Public License for more details. +# +# You should have received a copy of the GNU General Public License along +# with ``Chris Monson's Free Software''; if not, write to the Free Software +# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA +# +# It is also available on the web at http://www.gnu.org/copyleft/gpl.html +# +# Note that using this makefile to build your documents does NOT place them +# under the GPL unless you, the author, specifically do so. In other words, +# I, Chris Monson, the copyright holder and author of this makefile, +# consider it impossible to ``link'' to this makefile in any way covered by +# the GPL. +# +# +# TO OBTAIN INSTRUCTIONS FOR USING THIS FILE, RUN: +# make help +# +fileinfo := LaTeX Makefile +author := Chris Monson +version := 2.2.0 +# +.DEFAULT_GOAL := all +# Note that the user-global version is imported *after* the source directory, +# so that you can use stuff like ?= to get proper override behavior. +.PHONY: Makefile GNUmakefile Makefile.ini $(HOME)/.latex-makefile/Makefile.ini +-include Makefile.ini +-include $(HOME)/.latex-makefile/Makefile.ini +# Better names for these things +.PHONY: Variables.ini $(HOME)/.latex-makefile/Variables.ini +-include Variables.ini +-include $(HOME)/.latex-makefile/Variables.ini +# +# This can be pdflatex or latex - you can change this by adding the following line to your Makefile.ini: +# BUILD_STRATEGY := latex +BUILD_STRATEGY ?= pdflatex +# +# Sets LC_ALL=C, by default, so that the locale-aware tools, like sort, be +# # immune to changes to the locale in the user environment. +export LC_ALL ?= C +# +# +# If you specify sources here, all other files with the same suffix +# will be treated as if they were _include_ files. +#onlysources.tex ?= main.tex +#onlysources.tex.sh ?= +#onlysources.tex.pl ?= +#onlysources.tex.py ?= +#onlysources.rst ?= +#onlysources.fig ?= +#onlysources.gpi ?= +#onlysources.dot ?= +#onlysources.xvg ?= +#onlysources.svg ?= +#onlysources.eps.gz ?= +#onlysources.eps ?= +# +# If you list files here, they will be treated as _include_ files +#includes.tex ?= file1.tex file2.tex +#includes.tex.sh ?= +#includes.tex.pl ?= +#includes.tex.py ?= +#includes.rst ?= +#includes.fig ?= +#includes.gpi ?= +#includes.dot ?= +#includes.xvg ?= +#includes.svg ?= +#includes.eps.gz ?= +#includes.eps ?= +# +# If you list files or wildcards here, they will *not* be cleaned - default is +# to allow everything to be cleaned. +#neverclean ?= *.pdf +# +# Alternatively (recommended), you can add those lines to a Makefile.ini file +# and it will get picked up automatically without your having to edit this +# Makefile. +# +# KNOWN ISSUES: +# * The following occurs: +# file with: \usepackage{named}\bibliographystyle{named} +# Compile +# change to: \usepackage{apalike}\bibliographystyle{apalike} +# Compile again -- BARF! +# +# The workaround: make clean-nographics; make +# +# Note that we may not be able to fix this. LaTeX itself barfs +# on this, not the makefile. The very first invocation of LaTeX +# (when something like this has happened) reads the existing .aux +# file and discovers invalid commands like \citeauthoryear that +# are only valid in the package that was just removed. It then +# tries to parse them and explodes. It's not at all clear to me +# how to fix this. I tried removing the .aux files on the first +# run of LaTeX, but that necessarily requires more subsequent +# rebuilds on common edits. There does not appear to be a +# graceful solution to this issue. +# +# +# CHANGES: +# Chris Monson (2011-05-20): +# * Bumped version to 2.2.0 (release!) +# Chris Monson (2011-05-19): +# * Bumped version to 2.2.0-rc15 +# * Issue 125: infinite recursion with nomenclature files +# * Issue 125: removed .d as a target for .nls in get-log-index +# * Cleaned up invocation of run-makeindex to take an optional .ist instead of flags. +# Chris Monson (2011-04-06): +# * Bumped version to 2.2.0-rc14 +# * Issue 121: Added Targets.ini and corresponding help text for it. +# * Issue 121: Added Variables.ini (Makefile.ini still works, though). +# * Issue 121: Added .DEFAULT_GOAL optional setting. +# * Issue 120: xindy compatibility +# Chris Monson (2011-03-16): +# * Bumped version to 2.2.0-rc13 +# * Fixed a bug in kspewhich invocation - random characters and a missing pipe. +# * Added font embedding to gnuplot output. +# Chris Monson (2011-03-15): +# * Bumped version to 2.2.0-rc12 +# * Issue 119: Annoying warning from which if Gnuplot not installed. +# * Fixed catchall error output to show more info from the log. Cutting off the +# first line is too jarring. +# * Issue 118: Better glossary support +# Chris Monson (2011-03-03): +# * Bumped version to 2.2.0-rc11 +# * Issue 112: Fixed regression introduced by use of cygpath (ugly warnings) +# Chris Monson (2011-02-03): +# * Bumped version to 2.2.0-rc10 +# * Issue 112: Added path normalization for cygwin systems +# * Fixed a bug in get-missing-inputs where we weren't specifying target files +# Chris Monson (2011-01-24): +# * Issue 111: Added .jpeg as a possible image extension +# Chris Monson (2011-01-21): +# * Issue 110: Long filenames not produced correctly in .d file +# * Fixed problem with unknown control sequence error parsing +# * Fixed problem with \r in fatal output (was interpreted as LF by echo) +# * Removed a spurious "hi" +# Chris Monson (2011-01-14): +# * Bumped version to 2.2.0-rc8 +# * Issue 107: Removed comment with embedded newline, fixing MinGW on Windows 7. +# Chris Monson (2011-01-07): +# * Emit an error if .gpi.d files have dependencies with : in the name +# Chris Monson (2011-01-05): +# * Bumped version to 2.2.0-rc7 +# * Issue 106: existing graphic dependencies not generated correctly +# Chris Monson (2011-01-04): +# * Issue 106: not cleaning eps log files properly +# * Issue 106: not rebuilding after creating .pdf graphics from .eps +# * Issue 94: svg going unnecessarily through eps (can't reproduce) +# Chris Monson (2010-12-31): +# * Issue 100: make hanging because of faulty graphics detection (sed bug) +# * Issue 108: do not ignore fatal errors from pdftex +# Chris Monson (2010-12-23): +# * Added gpi_global to gnuplot dependencies so that changes are detected +# Chris Monson (2010-12-20): +# * Updated build file to be smarter about Python version detection +# * Created a bunch of test files and supporting scripts +# * Issue 72: added apacite capaability (thanks to matkarat) +# Chris Monson (2010-11-23): +# * Changed to multi-part makefile build (split out sed scripts) +# * Added build script and supporting infrastructure +# * Updated test directory format +# * Added notes about needed test cases +# * Changed to use -file-line-error and fixed multiple inclusion/error bugs +# * Added run_sed.py to allow easy testing of sed scripts outside of make +# Chris Monson (2010-11-11): +# * Bumped version to 2.2.0-rc7 +# * issue 92: broken hyperref driver detection fixed +# * issue 101: Broken inkscape conversion +# * issue 102: Broken specification of font size for gnuplot pdfcairo +# * Added KEEP_TEMP so that we can avoid deleting useful temporaries for debugging +# * Restructured gnuplot code to be easier to follow +# * Fixed a bug in convert-gpi where we were using $< instead of $1 +# Chris Monson (2010-11-03): +# * Bumped version to 2.2.0-rc6 +# * issue 96: Fix sed errors when using make variables in substitutions +# Chris Monson (2010-07-28): +# * Bumped version to 2.2.0-rc5 (rc4 is broken) +# * Bail out when we find the use of the import.sty package +# * Issue 90: Add -z to dvips invocation +# * Issue 67: Add xelatex support (thanks to Nikolai Prokoschenko for the patch!) +# * Issue 85: Add warning about make 3.80 +# Chris Monson (2010-06-20): +# * Bumped version to 2.2.0-rc3 +# * Attempt to fix bug with ! error detection (issue 88) +# * Added svg->pdf direct support (issue 89) +# Chris Monson (2010-04-28): +# * Bumped version to 2.2.0-rc2 +# * Fixed %._show target +# Chris Monson (2010-04-08): +# * Bumped version to 2.2.0-rc1 +# * Added back in the rst_style_file stuff that got broken when switching +# rst -> tex to use the script mechanism +# Chris Monson (2010-03-23): +# * Bumped version to 2.2.0-beta8 +# * Work on issue 76: bad backtick escape for some sed versions, failure +# to clear out the hold buffer when outputting MISSING comment. +# - Backed out 2>&1 to &> (doesn't work in sh) +# - Backed out using . to source variables +# Chris Monson (2010-03-22): +# * Bumped version to 2.2.0-beta7 +# * Issue 72: Fix latex/bibtex invocation order for annotated bib styles +# * Fixed informational output to reflect which LaTeX run we're on +# * Fixed graphic detection to include graphics that are already there in +# .d files +# * Tightened up the .d file output to only make .d depend on graphic +# *source* files. This means that building foo.d no longer +# builds all of the graphics files on which foo.tex depends. +# Had to use .SECONDEXPANSION trickery to make it work. +# * Changed get-graphics to only accept a stem. +# * Fixed build-once logic for scripted .tex to work better +# * Made get-inputs sed script more maintainable. +# * Moved Makefile.ini import up higher. +# * Changed bare stems to not recursively invoke make +# * Updated diff output to be more silent everywhere +# * Added a MISSING comment to the .d file if stuff isn't found - forces +# removal of .1st.make file, which often forces it to try again. +# * Fixed broken graphics-target function +# * Added sleep to .d file generation when stuff is missing - if it +# builds too fast, make doesn't realize it needs to be reloaded, +# and thus never discovers some deeper dependencies (especially +# evident when graphics are included from scripted include +# files). +# Chris Monson (2010-03-17): +# * Bumped version to 2.2.0-beta6 +# * Fixed bareword builds to actually work (requires static patterns) +# * Fixed colorization to work with new paragraph stuff +# Chris Monson (2010-03-17): +# * Bumped version to 2.2.0-beta5 +# * Fixed graphic detection to be much more focused - splits log file +# into paragraphs before doing pattern matching. +# * Fixed make foo to work properly (recursively calls make foo.pdf) +# * Fixed gpi -> pdf generation to not waste time building .eps *after* +# the pdf already exists. +# * Changed log copies to include MAKE_RESTARTS as part of the name. +# * Fixed missing include file detection (also makes use of the paragraph +# stuff) to detect missing scripted include files. +# Chris Monson (2010-03-16): +# * Bumped version to 2.2.0-beta4 +# * issue 70: .pdf not moved out of the way properly on first +# compilation, resulting in early error detection failure. +# * issue 74: fixed broken error on missing .aux files: the +# implementation was masking real errors. +# Chris Monson (2010-03-15): +# * Bumped version to 2.2.0-beta3 +# * issue 71: Made the tput dependency optional +# * issue 73: Made .tex targets not pull in .d files (building them from +# scripts should not require a .d) +# * issue 74: Output a much saner error when a .aux file is not produced +# (e.g., when you are typing "make" without arguments in a +# directory with included .tex files that are not named with +# ._include_.) +# Chris Monson (2010-03-11): +# * Bumped version to 2.2.0-beta2 +# * Fixed clean-graphics to get rid of intermediate .eps files that may +# be hanging around +# * Added an automatic setting to use eps terminals in pdflatex mode for +# gnuplot if it doesn't understand pdf. +# * issue 66: Removed grayscale generation via magic suffix. Grayscale +# generation is now only available via GRAY=1 +# * issue 68: Added explicit handling of LC_ALL for locale-aware tools +# like "sort" +# Chris Monson (2010-03-10): +# * Bumped version to 2.2.0-beta1 +# * Fixed success message to handle output message in different places +# * Added name of produced file to success message +# Chris Monson (2010-03-10): +# * Bumped version to 2.2.0-alpha3 +# * Added meaningful error message for wrong hyperref options +# * Added meaningful error message for incorrect graphics extensions +# Chris Monson (2010-03-09): +# * Bumped version to 2.2.0-alpha2 +# * Updated graphics handling (gnuplot and fig generate pdf natively) +# * Changed xmgrace to output monochrome natively +# Chris Monson (2010-03-09): +# * Bumped version to 2.2.0-alpha1 - major change! +# * Support pdflatex natively and by default (issue 6 - a long time coming) +# * Add ability to have a single $HOME/.latex-makefile/Makefile.ini for +# all invocations +# * Reworked graphic inclusion detection so that extensions need not be +# specified for either build strategy (e.g., +# \includegraphics{test1.eps} -> \includegrahpics{test1}) +# * Changed log format to include filenames and line numbers +# Chris Monson (2010-02-04): +# * Bumped version to 2.1.43 +# * All of the following are for issue 63 (thanks to mojoh81): +# * Added documentation about fixing Makefile.ini default target +# * Added perl and python script targets +# * Fixed run logic to allow included .tex files to be scripted (the +# run-again logic now detects missing .tex files, and the MV +# command has been switched out for a command that only invokes +# MV if the files exist) +# * Changed scripted generation to only run once per make invocation +# * Added dependency on expr +# Chris Monson (2010-01-19): +# * Bumped version to 2.1.42 +# * issue 62: Added .brf extension to cleanable files (backrefs) +# Chris Monson (2010-01-07): +# * Bumped version to 2.1.41 +# * issue 60: bad makeindex runs now error out on subsequent tries +# Chris Monson (2009-12-01): +# * Bumped version to 2.1.40 +# * issue 36: build all indices (for e.g., splitidx usage) +# * issue 59: clean up all generated files (including indices) +# Chris Monson (2009-11-23): +# * Bumped version to 2.1.39 +# * issue 57: change ps2pdf invocations to just use gs directly +# Chris Monson (2009-11-19): +# * Bumped version to 2.1.38 +# * issue 57: Added some limited support for Cygwin (spaces in filenames) +# Chris Monson (2009-11-15): +# * Bumped version to 2.1.37 +# * Removed svninfo, since this is now managed by mercurial +# * Fixed typo in changelist +# * Issue 52: added jpg->eps conversion (thanks to brubakee) +# * Issue 54: fix missing Overfull colorization due to lack of a blank +# line preceding the first error. +# * Issue 51: remove head.tmp and body.tmp in make clean invocation +# * Issue 56: maintain multiple versions of log files (for debugging) +# Chris Monson (2009-11-14): +# * Bumped version to 2.1.36 +# * Issues 53 and 49: added .brf, .mtc, and .maf to the cleanables +# Chris Monson (2009-11-05): +# * Bumped version to 2.1.35 +# * Added nomenclature support (see issue 48) +# Chris Monson (2009-10-29): +# * Bumped version to 2.1.34 +# * Fixed _out_ creation bug introduced in 2.1.33 (it was always created) +# * Fixed erroneous help output for $HOME in BINARY_TARGET_DIR +# * Changed contact email address - bring on the spam! +# Chris Monson (2009-10-21): +# * Bumped version to 2.1.33 +# * Fixed issue 46, adding support for dot2tex (thanks to fdemesmay) +# * Made all_files.* settable in Makefile.ini (using ?= instead of :=) +# * Fixed issue 47, thanks to fdemesmay: add binary copy directory, copy +# dvi, pdf, and ps if it exists +# Chris Monson (2009-09-25): +# * Bumped version to 2.1.32 +# * Fixed so that a changed lol file will cause a rebuild +# * Added .lol files to the cleanable list +# Chris Monson (2009-09-08): +# * Bumped version to 2.1.31 +# * Closed issue 43: evince doesn't notice pdf change w/out touch +# Chris Monson (2009-08-28): +# * Bumped version to 2.1.30 +# * Closed issue 39: Capture multi-line log warnings/errors to output +# Chris Monson (2009-08-26): +# * Bumped version to 2.1.29 +# * Closed issue 42: add svg support using inkscape +# Chris Monson (2009-08-17): +# * Bumped version to 2.1.28 +# * Patch from paul.biggar for issue 38: package warnings are overlooked +# Chris Monson (2009-08-07): +# * Bumped version to 2.1.27 +# * Included patch for issue 37 - removes pdf/ps files before copying, +# allowing some broken viewers to see changes properly. +# Chris Monson (2009-05-15): +# * Bumped version to 2.1.26 +# * Included patch for issue 9 from favonia - detects .fig changes for +# pstex files during regular compilation, so long as the pstex +# has been built at least once with make all-pstex. +# Chris Monson (2009-03-27): +# * Bumped version to 2.1.25 +# * Cleaned up a bunch of variable setting stuff - more stuff is now +# settable from Makefile.ini +# * Cleaned up documentation for various features, especially settable +# variables. +# * issue 28: support for png -> eps conversion (it even looks good!) +# * issue 29: support for "neverclean" files in Makefile.ini +# * issue 30: make ps2pdf14 the default - fall back when not there +# Chris Monson (2009-03-09): +# * Bumped version to 2.1.24 +# * issue 27: xmgrace support (thanks to rolandschulzhd) +# Chris Monson (2008-10-23): +# * Bumped version to 2.1.23 +# * issue 23: fixed _check_programs to not use bash string subs +# Chris Monson (2008-09-02): +# * Bumped version to 2.1.22 +# * Appled patch from Holger <yllohy(a)googlemail.com> to add include +# sources and some documentation updates. +# * Updated backup_patterns to be a bit more aggressive (also thanks to +# Holger) +# Chris Monson (2008-08-30): +# * Bumped version to 2.1.21 +# * Added ability to specify onlysources.* variables to indicate the only +# files that should *not* be considered includes. Thanks to Holger +# <yllohy(a)googlemail.com> for this patch. +# * Added an automatic include of Makefile.ini if it exists. Allows +# settings to be made outside of this makefile. +# Chris Monson (2008-05-21): +# * Bumped version to 2.1.20 +# * Added manual pstex compilation support (run make all-pstex first) +# * Removed all automatic pstex support. It was totally breaking +# everything and is very hard to incorporate into the makefile +# concept because it requires LaTeX to *fail* before it can +# determine that it needs the files. +# Chris Monson (2008-04-17): +# * Bumped version to 2.1.19 +# * Changed the pstex build hack to be on by default +# Chris Monson (2008-04-09): +# * Bumped version to 2.1.18 +# * issue 16: fixed pstex build problems, seems nondeterministic. Added +# gratuitious hack for testing: set PSTEX_BUILD_ALL_HACK=1. +# Chris Monson (2008-04-09): +# * Bumped version to 2.1.17 +# * issue 20: fixed accumulation of <pid>*.make files - wildcard was +# refusing to work on files that are very recently created. +# Chris Monson (2008-04-02): +# * Bumped version to 2.1.16 +# * issue 19: Removed the use of "type" to fix broken "echo" settings +# Chris Monson (2008-03-27): +# * Bumped version to 2.1.15 +# * issue 18: Favors binary echo over builtin, as binary understands -n +# * issue 16: Fixed handling of missing pstex_t files in the log +# * issue 9: Added .SECONDARY target for .pstex files +# Chris Monson (2008-03-21): +# * Bumped version to 2.1.14 +# * Fixed broken aux file flattening, which caused included bibs to be +# missed. +# Chris Monson (2008-03-20): +# * Bumped version to 2.1.13 +# * Changed error output colorization to show errors for missing files +# that are not graphics files. +# Chris Monson (2008-03-20): +# * Bumped version to 2.1.12 +# * Fixed a regression introduced in r28 that makes bibtex fail when +# there is no index file present +# Chris Monson (2008-03-03): +# * Bumped version to 2.1.11 +# * Fixed issue 11 (handle index files, reported by abachn) +# * Cleaned up some comments and help text +# Chris Monson (2008-01-24): +# * Bumped version to 2.1.10 +# * Fixed to work when 'sh' is a POSIX shell like 'dash' +# Chris Monson (2007-12-12): +# * Bumped version to 2.1.9 +# * Fixed documentation and dependency graph for pstex files +# Chris Monson (2007-12-12): +# * Bumped version to 2.1.8 +# * Added basic pstex_t support for fig files (Issue 9 by favonia) +# I still suggest that psfrag be used instead. +# Chris Monson (2007-10-16): +# * Bumped version to 2.1.7 +# * Removed todo item: allow other comment directives for rst conversion +# * Added ability to use global rst style file _rststyle_._include_.tex +# * Added help text to that effect +# Chris Monson (2007-05-20): +# * Bumped version to 2.1.6 +# * Changed default paper size for rst files +# * Added todo item: fix paper size for rst files +# * Added todo item: allow other comment directives for rst conversion +# Chris Monson (2007-04-02): +# * Bumped version to 2.1.5 +# * Addressed Issue 7, incorrect .gpi.d generation in subdirectories +# Chris Monson (2007-03-28): +# * Bumped version to 2.1.4 +# * Fixed syntax error in dot output +# Chris Monson (2007-03-01): +# * Bumped version to 2.1.3 +# * Added reST to the included documentation +# * Fixed graphics and script generation to be settable in the +# environment. +# Chris Monson (2007-02-23): +# * Bumped version to 2.1.2 +# * Added the ability to generate .tex files from .rst files +# Chris Monson (2006-10-17): +# * Bumped version to 2.1.1 +# * Fixed includes from subdirectories (sed-to-sed slash escape problem) +# Chris Monson (2006-10-05): +# * Bumped version to 2.1.0 (pretty serious new feature added) +# * New feature: bib files can now be anywhere on the BIBINPUTS path +# * New programs: kpsewhich (with tetex) and xargs (BSD) +# Chris Monson (2006-09-28): +# * Bumped version to 2.0.9 +# * Added ability to parse more than one bibliography +# Chris Monson (2006-06-01): +# * Bumped version to 2.0.8 +# * Added .vrb to the list of cleaned files +# Chris Monson (2006-04-26): +# * Bumped version to 2.0.7 +# * Fixed so that clean-nographics does not remove .gpi.d files +# * Removed jpg -> eps hack (not working properly -- just pre-convert) +# * Fixed so that postscript grayscale can be done with BSD sed +# Chris Monson (2006-04-25): +# * Bumped version to 2.0.6 +# * Fixed so that changed toc, lot, lof, or out causes a rebuild +# Chris Monson (2006-04-17): +# * Bumped version to 2.0.5 +# * Added jpg -> eps conversion target +# Chris Monson (2006-04-12): +# * Bumped version to 2.0.4 +# * Fixed BSD sed invocation to not use \| as a branch delimiter +# * Added a comment section on what is and is not allowed in BSD sed +# * Made paper size handling more robust while I was at it +# * Fixed postscript RGB grayscale to use a weighted average +# * Fixed postscript HSB grayscale to convert to RGB first +# * Fixed a problem with rebuilding .bbl files +# Chris Monson (2006-04-11): +# * Bumped version to 2.0.3 +# * Fixed some BSD sed problems: can't use \n in substitutions +# Chris Monson (2006-04-10): +# * Bumped version to 2.0.2 +# * Once again removed ability to create .tex files from scripts +# * \includeonly works again +# Chris Monson (2006-04-09): +# * Bumped version to 2.0.1 +# * Fixed grayscale postscript handling to be more robust +# * Added ability to generate ._gray_. files from eps and eps.gz +# * Added ability to clean ._gray_.eps files created from .eps files +# Chris Monson (2006-04-07): +# * Bumped version to 2.0.0 +# * Removed clunky ability to create included .tex files from scripts +# * Added note in the help about included tex scripting not working +# * Fixed the .eps generation to delete %.gpihead.make when finished +# * Abandoned designs to use shell variables to create sed scripts +# * Abandoned __default__.tex.sh idea: it causes recursion with %: . +# * Removed web page to-do. All items are now complete. +# * Added better grayscale conversion for dot figures (direct ps fixup). +# * Include files can now be scripted (at the expense of \includeonly). +# * Updated dependency graph to contain better node names. +# Chris Monson (2006-04-06): +# * Bumped version to 2.0b3 +# * Top level includes now fail if there is no rule to build them +# * A helpful message is printed when they do fail +# * Grayscale has been changed to be ._gray_, other phonies use _ now, too +# * Grayscale handling has been completed +# * Changed _include_stems target to _includes target. +# * Fixed _includes target to be useful by itself. +# * Removed the ability to specify clean and build targets at once +# * Verified that epsfig works fine with current code +# * Fixed included scripts so that they are added to the dep files +# * Fixed so that graphics includes don't happen if they aren't for gpi +# * Fixed dot output to allow grayscale. +# Chris Monson (2006-04-05): +# * Bumped version to 2.0b2 +# * Removed automatic -gray output. It needs fixing in a bad way. +# * Revamped dependency creation completely. +# * Fixed conditional inclusion to actually work (test.nobuild.d, test.d). +# * Fixed clean target to remove log targets +# * Added the 'monochrome' word for gray gpi output +# * Added a _check_gpi_files target that checks for common problems +# * Changed the _version target into the version target (no _) +# * Added better handling of grayscale files. Use the .gray.pdf target. +# * Fixed testing for rebuilds +# Chris Monson (2006-04-04): +# * Bumped version to 2.0b1 +# * Changed colorization of output +# * Made .auxbbl and .auxtex .make files secondary targets +# * Shortened and simplified the final latex invocation loop +# * Added version-specific output ($$i vs. $$$$i) in latex loop +# * Added a build message for the first .dvi run (Building .dvi (0)) +# * Removed some build messages that most people don't care about. +# * Simplified procedure for user-set colors -- simple text specification +# * Fixed diff output to...not output. +# * Fixed rerun bug -- detect not only when preceded with LaTeX Warning +# * Sped up gpi plotting +# * Added error handling and colorized output for gpi failure +# * Documented color changing stuff. +# * Now sort the flattened aux file to avoid false recompilation needs +# * Added clean-nographics target +# * Don't remove self.dvi file if self.aux is missing in the log +# * Clarified some code. Did some very minor adjusting. +# Chris Monson (2006-04-03): +# * Bumped version to 2.0a7 +# * Added .dvi and .ps files as secondary files. +# * Fixed handling of multiple run detection when includeonly is in use. +# * Added code to flatten .aux files. +# * Added more files as .SECONDARY prerequisites to avoid recompilation. +# * Fixed the inputs generation to be much simpler and to use pipes. +# * Added the dependency graph directly into the makefile. +# * Changed flatten-aux to remove \@writefile \relax \newlabel, etc. +# * Undid pipe changes with sed usage (BSD sed doesn't know -f-). +# * Added a _check_programs target that tells you what your system has. +# * Fixed an error in colorization that made unnecessary errors appear +# * Added view targets. +# * Updated help text. +# * Augmented cookies so that .aux can trigger .bbl and .dvi rebuilds +# * Added more informative error handling for dvips and ps2pdf +# Chris Monson (2006-04-02): +# * Bumped version to 2.0a6 +# * Added indirection to .bbl dependencies to avoid rebuilding .bbl files +# * Streamlined the diff invocation to eliminate an existence test +# * Removed special shell quote escape variables +# * Moved includes to a more prominent location +# * Fixed .inputs.make to not contain .aux files +# * Fixed embedding to use a file instead of always grepping. +# * Added *.make.temp to the list of cleanable files +# * Fixed Ruby. It should now be supported properly. +# * Now differentiate between all, default, and buildable files. +# * Fixed to bail out on serious errors. +# * Revised the handling of includable files. Still working on it. +# Chris Monson (2006-03-31): +# * Bumped version to 2.0a5 +# * Fixed a bug with LaTeX error detection (there can be spaces) +# * Added .bbl support, simplifying everything and making it more correct +# * Refactored some tests that muddy the code +# * Did a little cleanup of some shell loops that can safely be make loops +# * Added support for graphviz .dot files +# * Made _all_programs output easier to read +# * Added the ruby support that has long been advertised +# * Font embedding was screwed up for PostScript -- now implicit +# * Changed the generation of -gray.gpi files to a single command +# * Changed any make-generated file that is not included from .d to .make +# Chris Monson (2006-03-30): +# * Bumped version to 2.0a4 +# * Fixed a bug with very long graphics file names +# * Added a todo entry for epsfig support +# * Fixed a bug paper size bug: sometimes more than one entry appears +# * Fixed DVI build echoing to display the number instead of process ID +# * DVI files are now removed on first invocation if ANY file is missing +# * Added a simple grayscale approach: if a file ends with -gray.gpi, it +# is created from the corresponding .gpi file with a special +# comment ##GRAY in its header, which causes coloring to be +# turned off. +# * Fixed a bug in the handling of .tex.sh files. For some reason I had +# neglected to define file stems for scripted output. +# * Removed a trailing ; from the %.graphics dependencies +# * Added dvips embedding (I think it works, anyway) +# Chris Monson (2006-03-29): +# * Bumped version to 2.0a3 +# * Fixed error in make 3.79 with MAKEFILE_LIST usage +# * Added the presumed filename to the _version output +# * Added a vim macro for converting sed scripts to make commands +# * Added gpi dependency support (plotting external files and loading gpi) +# * Allow .gpi files to be ignored if called .include.gpi or .nobuild.gpi +# * Fixed sed invocations where \+ was used. BSD sed uses \{1,\}. +# Chris Monson (2006-03-28): +# * Bumped version to 2.0a2 +# * Added SHELL_DEBUG and VERBOSE options +# * Changed the default shell back to /bin/sh (unset, in other words) +# * Moved .PHONY declarations closer to their targets +# * Moved help text into its own define block to obtain better formatting +# * Removed need for double-entry when adding a new program invocation +# * Moved .SECONDARY declaration closer to its relevant occurrence +# * Commented things more heavily +# * Added help text about setting terminal and output in gnuplot +# * Created more fine-grained clean targets +# * Added a %.graphics target that generates all of %'s graphics +# * Killed backward-compatible graphics generation (e.g., eps.gpi=gpi.eps) +# * For now, we're just GPL 2, not 3. Maybe it will change later +# * Made the version and svninfo into variables +# Chris Monson (2006-03-27): +# * Bumped version to 2.0a1 +# * Huge, sweeping changes -- automatic dependencies +# + +# IMPORTANT! +# +# When adding to the following list, do not introduce any blank lines. The +# list is extracted for documentation using sed and is terminated by a blank +# line. +# +# EXTERNAL PROGRAMS: +# = ESSENTIAL PROGRAMS = +# == Basic Shell Utilities == +CAT ?= cat +CP ?= cp -f +DIFF ?= diff +ECHO ?= echo +EGREP ?= egrep +ENV ?= env +EXPR ?= expr +MV ?= mv -f +SED ?= sed +SORT ?= sort +TOUCH ?= touch +UNIQ ?= uniq +WHICH ?= which +XARGS ?= xargs +SLEEP ?= sleep +# == LaTeX (tetex-provided) == +BIBTEX ?= bibtex +DVIPS ?= dvips +LATEX ?= latex +PDFLATEX ?= pdflatex +XELATEX ?= xelatex +EPSTOPDF ?= epstopdf +MAKEINDEX ?= makeindex +XINDY ?= xindy +KPSEWHICH ?= kpsewhich +GS ?= gs +# = OPTIONAL PROGRAMS = +# == For MikTex under Cygwin, to get path names right +CYGPATH ?= cygpath +# == Makefile Color Output == +TPUT ?= tput +# == TeX Generation == +PERL ?= perl +PYTHON ?= python +RST2LATEX ?= rst2latex.py +# == EPS Generation == +CONVERT ?= convert # ImageMagick +DOT ?= dot # GraphViz +DOT2TEX ?= dot2tex # dot2tex - add options (not -o) as needed +FIG2DEV ?= fig2dev # XFig +GNUPLOT ?= gnuplot # GNUplot +INKSCAPE ?= inkscape # Inkscape (svg support) +XMGRACE ?= xmgrace # XMgrace +PNGTOPNM ?= pngtopnm # From NetPBM - step 1 for png -> eps +PPMTOPGM ?= ppmtopgm # From NetPBM - (gray) step 2 for png -> eps +PNMTOPS ?= pnmtops # From NetPBM - step 3 for png -> eps +GUNZIP ?= gunzip # GZipped EPS +# == Beamer Enlarged Output == +PSNUP ?= psnup +# == Viewing Stuff == +VIEW_POSTSCRIPT ?= gv +VIEW_PDF ?= xpdf +VIEW_GRAPHICS ?= display + +# Xindy glossaries +XINDYLANG ?= english +XINDYENC ?= utf8 + +# If cygpath is present, then we create a path-norm function that uses it, +# otherwise the function is just a no-op. Issue 112 has details. +USE_CYGPATH := $(if $(shell $(WHICH) $(CYGPATH) 2>/dev/null),yes,) + +# $(call get-cygpath,<path>) +define get-cygpath +$(shell $(CYGPATH) -u "$(shell $(CYGPATH) -s -w $1)") +endef + +define path-norm +$(if $(USE_CYGPATH),$(call get-cygpath,$1),$1) +endef + +# Command options for embedding fonts and postscript->pdf conversion +PS_EMBED_OPTIONS ?= -dPDFSETTINGS=/printer -dEmbedAllFonts=true -dSubsetFonts=true -dMaxSubsetPct=100 +PS_COMPATIBILITY ?= 1.4 + +# If set to something, will cause temporary files to not be deleted immediately +KEEP_TEMP ?= + +# Defaults for GPI +DEFAULT_GPI_EPS_FONTSIZE ?= 22 +DEFAULT_GPI_PDF_FONTSIZE ?= 12 + +# Style file for ReST +RST_STYLE_FILE ?= $(wildcard _rststyle_._include_.tex) + +# This ensures that even when echo is a shell builtin, we still use the binary +# (the builtin doesn't always understand -n) +FIXED_ECHO := $(if $(findstring -n,$(shell $(ECHO) -n)),$(shell which echo),$(ECHO)) +ECHO := $(if $(FIXED_ECHO),$(FIXED_ECHO),$(ECHO)) + +define determine-gnuplot-output-extension +$(if $(shell $(WHICH) $(GNUPLOT) 2>/dev/null), + $(if $(findstring unknown or ambiguous, $(shell $(GNUPLOT) -e "set terminal pdf" 2>&1)), + eps, pdf), + none) +endef + +GNUPLOT_OUTPUT_EXTENSION ?= $(strip $(call determine-gnuplot-output-extension)) + +# Internal code should use this because of :=. This means that the potentially +# expensive script invocation used to determine whether pdf is available will +# only be run once. +GPI_OUTPUT_EXTENSION := $(strip $(GNUPLOT_OUTPUT_EXTENSION)) + +# Note, if the terminal *does* understand fsize, then we expect this call to +# create a specific error here: "fsize: expecting font size". Otherwise, we +# assume that fsize is not understood. +GPI_FSIZE_SYNTAX := $(strip \ +$(if \ + $(filter pdf,$(GPI_OUTPUT_EXTENSION)),\ + $(if \ + $(findstring fsize: expecting font size,$(shell $(GNUPLOT) -e "set terminal pdf fsize" 2>&1)),\ + fsize FONTSIZE,\ + font ",FONTSIZE"),\ + FONTSIZE)) + +# Directory into which we place "binaries" if it exists. +# Note that this can be changed on the commandline or in Makefile.ini: +# +# Command line: +# make BINARY_TARGET_DIR=$HOME/pdfs myfile.pdf +# +# Also, you can specify a relative directory (relative to the Makefile): +# make BINARY_TARGET_DIR=pdfs myfile.pdf +# +# Or, you can use Makefile.ini: +# +# BINARY_TARGET_DIR := $(HOME)/bin_out +# +BINARY_TARGET_DIR ?= _out_ + +RESTARTS := $(if $(MAKE_RESTARTS),$(MAKE_RESTARTS),0) +# SH NOTES +# +# On some systems, /bin/sh, which is the default shell, is not linked to +# /bin/bash. While bash is supposed to be sh-compatible when invoked as sh, it +# just isn't. This section details some of the things you have to stay away +# from to remain sh-compatible. +# +# * File pattern expansion does not work for {} +# * [ "$x" = "$y" ] has to be [ x"$x" x"$y" ] +# * &> for stderr redirection doesn't work, use 2>&1 instead +# +# BSD SED NOTES +# +# BSD SED is not very nice compared to GNU sed, but it is the most +# commonly-invoked sed on Macs (being based on BSD), so we have to cater to +# it or require people to install GNU sed. It seems like the GNU +# requirement isn't too bad since this makefile is really a GNU makefile, +# but apparently GNU sed is much less common than GNU make in general, so +# I'm supporting it here. +# +# Sad experience has taught me the following about BSD sed: +# +# * \+ is not understood to mean \{1,\} +# * \| is meaningless (does not branch) +# * \n cannot be used as a substitution character +# * ? does not mean \{0,1\}, but is literal +# * a\ works, but only reliably for a single line if subsequent lines +# have forward slashes in them (as is the case in postscript) +# +# For more info (on the Mac) you can consult +# +# man -M /usr/share/man re_format +# +# And look for the word "Obsolete" near the bottom. + +# +# EXTERNAL PROGRAM DOCUMENTATION SCRIPT +# + +# $(call output-all-programs,[<output file>]) +define output-all-programs + [ -f '$(this_file)' ] && \ + $(SED) \ + -e '/^[[:space:]]*#[[:space:]]*EXTERNAL PROGRAMS:/,/^$$/!d' \ + -e '/EXTERNAL PROGRAMS/d' \ + -e '/^$$/d' \ + -e '/^[[:space:]]*#/i\ '\ + -e 's/^[[:space:]]*#[[:space:]][^=]*//' \ + $(this_file) $(if $1,> '$1',) || \ + $(ECHO) "Cannot determine the name of this makefile." +endef + +# If they misspell gray, it should still work. +GRAY ?= $(call get-default,$(GREY),) + +# +# Utility Functions and Definitions +# + +# Don't call this directly - it is here to avoid calling wildcard more than +# once in remove-files. +remove-files-helper = $(if $1,$(RM) $1,$(sh_true)) + +# $(call remove-files,file1 file2) +remove-files = $(call remove-files-helper,$(wildcard $1)) + +# Removes all cleanable files in the given list +# $(call clean-files,file1 file2 file3 ...) +# Works exactly like remove-files, but filters out files in $(neverclean) +clean-files = \ + $(call remove-files-helper,$(call cleanable-files,$(wildcard $1))) + +# Outputs all generated files to STDOUT, along with some others that are +# created by these (e.g., .idx files end up producing .ilg and .ind files). +# Discovered by reading *.fls OUTPUT lines and producing corresponding .ind +# filenames as needed. +# +# $(call get-generated-names,<source recorder file (*.fls)>) +define get-generated-names +[ -f '$1' ] && \ +$(SED) \ + -e '/^OUTPUT /{' \ + -e ' s///' \ + -e ' p' \ + -e ' s/\.idx/\.ind/p' \ + -e ' s/\.ind/\.ilg/p' \ + -e '}' \ + -e 'd' \ + '$1' \ +| $(SORT) | $(UNIQ) +endef + +# This removes files without checking whether they are there or not. This +# sometimes has to be used when the file is created by a series of shell +# commands, but there ends up being a race condition: make doesn't know about +# the file generation as quickly as the system does, so $(wildcard ...) doesn't +# work right. Blech. +# $(call remove-temporary-files,filenames) +remove-temporary-files = $(if $(KEEP_TEMP),:,$(if $1,$(RM) $1,:)) + +# Create an identifier from a file name +# $(call cleanse-filename,filename) +cleanse-filename = $(subst .,_,$(subst /,__,$1)) + +# Escape dots +# $(call escape-fname-regex,str) +escape-fname-regex = $(subst /,\\/,$(subst .,\\.,$1)) + +# Test that a file exists +# $(call test-exists,file) +test-exists = [ -e '$1' ] + +# $(call move-files,source,destination) +move-if-exists = $(call test-exists,$1) && $(MV) '$1' '$2' + +# Copy file1 to file2 only if file2 doesn't exist or they are different +# $(call copy-if-different,sfile,dfile) +copy-if-different = $(call test-different,$1,$2) && $(CP) '$1' '$2' +copy-if-exists = $(call test-exists,$1) && $(CP) '$1' '$2' +move-if-different = $(call test-different,$1,$2) && $(MV) '$1' '$2' +replace-if-different-and-remove = \ + $(call test-different,$1,$2) \ + && $(MV) '$1' '$2' \ + || $(call remove-files,'$1') + +# Note that $(DIFF) returns success when the files are the SAME.... +# $(call test-different,sfile,dfile) +test-different = ! $(DIFF) -q '$1' '$2' >/dev/null 2>&1 +test-exists-and-different = \ + $(call test-exists,$2) && $(call test-different,$1,$2) + +# Return value 1, or value 2 if value 1 is empty +# $(call get-default,<possibly empty arg>,<default value if empty>) +get-default = $(if $1,$1,$2) + +# Copy a file and log what's going on +# $(call copy-with-logging,<source>,<target>) +define copy-with-logging +if [ -d '$2/' ]; then \ + if $(CP) '$1' '$2/'; then \ + $(ECHO) "$(C_INFO)Copied '$1' to '$2/'$(C_RESET)"; \ + else \ + $(ECHO) "$(C_ERROR)Failed to copy '$1' to '$2/'$(C_RESET)"; \ + fi; \ +fi +endef + +# Gives a reassuring message about the failure to find include files +# $(call include-message,<list of include files>) +define include-message +$(strip \ +$(if $(filter-out $(wildcard $1),$1),\ + $(shell $(ECHO) \ + "$(C_INFO)NOTE: You may ignore warnings about the"\ + "following files:" >&2;\ + $(ECHO) >&2; \ + $(foreach s,$(filter-out $(wildcard $1),$1),$(ECHO) ' $s' >&2;)\ + $(ECHO) "$(C_RESET)" >&2) +)) +endef +# Characters that are hard to specify in certain places +space := $(empty) $(empty) +colon := \: +comma := , + +# Useful shell definitions +sh_true := : +sh_false := ! : + +# Clear out the standard interfering make suffixes +.SUFFIXES: + +# Turn off forceful rm (RM is usually mapped to rm -f) +ifdef SAFE_RM +RM := rm +endif + +# Turn command echoing back on with VERBOSE=1 +ifndef VERBOSE +QUIET := @ +endif + +# Turn on shell debugging with SHELL_DEBUG=1 +# (EVERYTHING is echoed, even $(shell ...) invocations) +ifdef SHELL_DEBUG +SHELL += -x +endif + +# Get the name of this makefile (always right in 3.80, often right in 3.79) +# This is only really used for documentation, so it isn't too serious. +ifdef MAKEFILE_LIST +this_file := $(word $(words $(MAKEFILE_LIST)),$(MAKEFILE_LIST)) +else +this_file := $(wildcard GNUmakefile makefile Makefile) +endif + +# Terminal color definitions + +REAL_TPUT := $(if $(NO_COLOR),,$(shell $(WHICH) $(TPUT))) + +# $(call get-term-code,codeinfo) +# e.g., +# $(call get-term-code,setaf 0) +get-term-code = $(if $(REAL_TPUT),$(shell $(REAL_TPUT) $1),) + +black := $(call get-term-code,setaf 0) +red := $(call get-term-code,setaf 1) +green := $(call get-term-code,setaf 2) +yellow := $(call get-term-code,setaf 3) +blue := $(call get-term-code,setaf 4) +magenta := $(call get-term-code,setaf 5) +cyan := $(call get-term-code,setaf 6) +white := $(call get-term-code,setaf 7) +bold := $(call get-term-code,bold) +uline := $(call get-term-code,smul) +reset := $(call get-term-code,sgr0) + +# +# User-settable definitions +# +LATEX_COLOR_WARNING ?= magenta +LATEX_COLOR_ERROR ?= red +LATEX_COLOR_INFO ?= green +LATEX_COLOR_UNDERFULL ?= magenta +LATEX_COLOR_OVERFULL ?= red bold +LATEX_COLOR_PAGES ?= bold +LATEX_COLOR_BUILD ?= cyan +LATEX_COLOR_GRAPHIC ?= yellow +LATEX_COLOR_DEP ?= green +LATEX_COLOR_SUCCESS ?= green bold +LATEX_COLOR_FAILURE ?= red bold + +# Gets the real color from a simple textual definition like those above +# $(call get-color,ALL_CAPS_COLOR_NAME) +# e.g., $(call get-color,WARNING) +get-color = $(subst $(space),,$(foreach c,$(LATEX_COLOR_$1),$($c))) + +# +# STANDARD COLORS +# +C_WARNING := $(call get-color,WARNING) +C_ERROR := $(call get-color,ERROR) +C_INFO := $(call get-color,INFO) +C_UNDERFULL := $(call get-color,UNDERFULL) +C_OVERFULL := $(call get-color,OVERFULL) +C_PAGES := $(call get-color,PAGES) +C_BUILD := $(call get-color,BUILD) +C_GRAPHIC := $(call get-color,GRAPHIC) +C_DEP := $(call get-color,DEP) +C_SUCCESS := $(call get-color,SUCCESS) +C_FAILURE := $(call get-color,FAILURE) +C_RESET := $(reset) + +# +# PRE-BUILD TESTS +# + +# Check that clean targets are not combined with other targets (weird things +# happen, and it's not easy to fix them) +hascleangoals := $(if $(sort $(filter clean clean-%,$(MAKECMDGOALS))),1) +hasbuildgoals := $(if $(sort $(filter-out clean clean-%,$(MAKECMDGOALS))),1) +ifneq "$(hasbuildgoals)" "" +ifneq "$(hascleangoals)" "" +$(error $(C_ERROR)Clean and build targets specified together$(C_RESET))) +endif +endif + +# +# VARIABLE DECLARATIONS +# + +# Names of sed scripts that morph gnuplot files -- only the first found is used +GNUPLOT_SED := global-gpi.sed gnuplot.sed +GNUPLOT_GLOBAL := global._include_.gpi gnuplot.global + +ifeq "$(strip $(BUILD_STRATEGY))" "latex" +default_graphic_extension ?= eps +latex_build_program ?= $(LATEX) +build_target_extension ?= dvi +hyperref_driver_pattern ?= hdvips +hyperref_driver_error ?= Using dvips: specify ps2pdf in the hyperref options. +endif + +ifeq "$(strip $(BUILD_STRATEGY))" "pdflatex" +default_graphic_extension ?= pdf +latex_build_program ?= $(PDFLATEX) +build_target_extension ?= pdf +hyperref_driver_pattern ?= hpdf.* +hyperref_driver_error ?= Using pdflatex: specify pdftex in the hyperref options (or leave it blank). +endif + +ifeq "$(strip $(BUILD_STRATEGY))" "xelatex" +default_graphic_extension ?= pdf +latex_build_program ?= $(XELATEX) +build_target_extension ?= pdf +hyperref_driver_pattern ?= hdvipdf.* +hyperref_driver_error ?= Using pdflatex: specify pdftex in the hyperref options (or leave it blank). +endif + +# Files of interest +all_files.tex ?= $(wildcard *.tex) +all_files.tex.sh ?= $(wildcard *.tex.sh) +all_files.tex.pl ?= $(wildcard *.tex.pl) +all_files.tex.py ?= $(wildcard *.tex.py) +all_files.rst ?= $(wildcard *.rst) +all_files.fig ?= $(wildcard *.fig) +all_files.gpi ?= $(wildcard *.gpi) +all_files.dot ?= $(wildcard *.dot) +all_files.xvg ?= $(wildcard *.xvg) +all_files.svg ?= $(wildcard *.svg) +all_files.png ?= $(wildcard *.png) +all_files.jpg ?= $(wildcard *.jpg) +all_files.jpeg ?= $(wildcard *.jpeg) +all_files.eps.gz ?= $(wildcard *.eps.gz) +all_files.eps ?= $(wildcard *.eps) + +# Utility function for obtaining all files not specified in $(neverclean) +# $(call cleanable-files,file1 file2 file3 ...) +# Returns the list of files that is not in $(wildcard $(neverclean)) +cleanable-files = $(filter-out $(wildcard $(neverclean)), $1) + +# Utility function for getting all .$1 files that are to be ignored +# * files listed in $(includes.$1) +# * files not listed in $(onlysources.$1) if it is defined +ignore_files = \ + $(includes.$1) \ + $(if $(onlysources.$1),$(filter-out $(onlysources.$1), $(all_files.$1))) + +# Patterns to never be allowed as source targets +ignore_patterns := %._include_ + +# Patterns allowed as source targets but not included in 'all' builds +nodefault_patterns := %._nobuild_ $(ignore_patterns) + +# Utility function for getting targets suitable building +# $(call filter-buildable,suffix) +filter-buildable = \ + $(filter-out $(call ignore_files,$1) \ + $(addsuffix .$1,$(ignore_patterns)),$(all_files.$1)) + +# Utility function for getting targets suitable for 'all' builds +# $(call filter-default,suffix) +filter-default = \ + $(filter-out $(call ignore_files,$1) \ + $(addsuffix .$1,$(nodefault_patterns)),$(all_files.$1)) + +# Top level sources that can be built even when they are not by default +files.tex := $(call filter-buildable,tex) +files.tex.sh := $(call filter-buildable,tex.sh) +files.tex.pl := $(call filter-buildable,tex.pl) +files.tex.py := $(call filter-buildable,tex.py) +files.rst := $(call filter-buildable,rst) +files.gpi := $(call filter-buildable,gpi) +files.dot := $(call filter-buildable,dot) +files.fig := $(call filter-buildable,fig) +files.xvg := $(call filter-buildable,xvg) +files.svg := $(call filter-buildable,svg) +files.png := $(call filter-buildable,png) +files.jpg := $(call filter-buildable,jpg) +files.jpeg := $(call filter-buildable,jpeg) +files.eps.gz := $(call filter-buildable,eps.gz) +files.eps := $(call filter-buildable,eps) + +# Make all pstex targets secondary. The pstex_t target requires the pstex +# target, and nothing else really depends on it, so it often gets deleted. +# This avoids that by allowing *all* fig files to be pstex targets, which is +# perfectly valid and causes no problems even if they're going to become eps +# files in the end. +.SECONDARY: $(patsubst %.fig,%.pstex,$(files.fig)) + +# Top level sources that are built by default targets +default_files.tex := $(call filter-default,tex) +default_files.tex.sh := $(call filter-default,tex.sh) +default_files.tex.pl := $(call filter-default,tex.pl) +default_files.tex.py := $(call filter-default,tex.py) +default_files.rst := $(call filter-default,rst) +default_files.gpi := $(call filter-default,gpi) +default_files.dot := $(call filter-default,dot) +default_files.fig := $(call filter-default,fig) +default_files.xvg := $(call filter-default,xvg) +default_files.svg := $(call filter-default,svg) +default_files.png := $(call filter-default,png) +default_files.jpg := $(call filter-default,jpg) +default_files.jpeg := $(call filter-default,jpeg) +default_files.eps.gz := $(call filter-default,eps.gz) +default_files.eps := $(call filter-default,eps) + +# Utility function for creating larger lists of files +# $(call concat-files,suffixes,[prefix]) +concat-files = $(foreach s,$1,$($(if $2,$2_,)files.$s)) + +# Useful file groupings +all_files_source := $(call concat-files,tex,all) +all_files_scripts := $(call concat-files,tex.sh tex.pl tex.py rst,all) + +.PHONY: $(all_files_scripts) + +default_files_source := $(call concat-files,tex,default) +default_files_scripts := $(call concat-files,tex.sh tex.pl tex.py rst,default) + +files_source := $(call concat-files,tex) +files_scripts := $(call concat-files,tex.sh tex.pl tex.py rst) + +# Utility function for obtaining stems +# $(call get-stems,suffix,[prefix]) +get-stems = $(sort $($(if $2,$2_,)files.$1:%.$1=%)) + +# List of all stems (including ._include_ and ._nobuild_ file stems) +all_stems.tex := $(call get-stems,tex,all) +all_stems.tex.sh := $(call get-stems,tex.sh,all) +all_stems.tex.pl := $(call get-stems,tex.pl,all) +all_stems.tex.py := $(call get-stems,tex.py,all) +all_stems.rst := $(call get-stems,rst,all) +all_stems.fig := $(call get-stems,fig,all) +all_stems.gpi := $(call get-stems,gpi,all) +all_stems.dot := $(call get-stems,dot,all) +all_stems.xvg := $(call get-stems,xvg,all) +all_stems.svg := $(call get-stems,svg,all) +all_stems.png := $(call get-stems,png,all) +all_stems.jpg := $(call get-stems,jpg,all) +all_stems.jpeg := $(call get-stems,jpeg,all) +all_stems.eps.gz := $(call get-stems,eps.gz,all) +all_stems.eps := $(call get-stems,eps,all) + +# List of all default stems (all default PDF targets): +default_stems.tex := $(call get-stems,tex,default) +default_stems.tex.sh := $(call get-stems,tex.sh,default) +default_stems.tex.pl := $(call get-stems,tex.pl,default) +default_stems.tex.py := $(call get-stems,tex.py,default) +default_stems.rst := $(call get-stems,rst,default) +default_stems.fig := $(call get-stems,fig,default) +default_stems.gpi := $(call get-stems,gpi,default) +default_stems.dot := $(call get-stems,dot,default) +default_stems.xvg := $(call get-stems,xvg,default) +default_stems.svg := $(call get-stems,svg,default) +default_stems.png := $(call get-stems,png,default) +default_stems.jpg := $(call get-stems,jpg,default) +default_stems.jpeg := $(call get-stems,jpeg,default) +default_stems.eps.gz := $(call get-stems,eps.gz,default) +default_stems.eps := $(call get-stems,eps,default) + +# List of all stems (all possible bare PDF targets created here): +stems.tex := $(call get-stems,tex) +stems.tex.sh := $(call get-stems,tex.sh) +stems.tex.pl := $(call get-stems,tex.pl) +stems.tex.py := $(call get-stems,tex.py) +stems.rst := $(call get-stems,rst) +stems.fig := $(call get-stems,fig) +stems.gpi := $(call get-stems,gpi) +stems.dot := $(call get-stems,dot) +stems.xvg := $(call get-stems,xvg) +stems.svg := $(call get-stems,svg) +stems.png := $(call get-stems,png) +stems.jpg := $(call get-stems,jpg) +stems.jpeg := $(call get-stems,jpeg) +stems.eps.gz := $(call get-stems,eps.gz) +stems.eps := $(call get-stems,eps) + +# Utility function for creating larger lists of stems +# $(call concat-stems,suffixes,[prefix]) +concat-stems = $(sort $(foreach s,$1,$($(if $2,$2_,)stems.$s))) + +# The most likely to be source but not finished product go first +graphic_source_extensions := fig \ + gpi \ + xvg \ + svg \ + dot \ + eps.gz + +ifeq "$(strip $(BUILD_STRATEGY))" "latex" +graphic_source_extensions += png jpg jpeg +graphic_target_extensions := eps ps +endif + +ifeq "$(strip $(BUILD_STRATEGY))" "pdflatex" +graphic_source_extensions += eps +graphic_target_extensions := pdf png jpg jpeg mps tif +endif + +ifeq "$(strip $(BUILD_STRATEGY))" "xelatex" +graphic_source_extensions += eps +graphic_target_extensions := pdf png jpg jpeg mps tif +endif + +all_stems_source := $(call concat-stems,tex,all) +all_stems_script := $(call concat-stems,tex.sh tex.pl tex.py rst,all) +all_stems_graphic := $(call concat-stems,$(graphic_source_extensions),all) +all_stems_ss := $(sort $(all_stems_source) $(all_stems_script)) +all_stems_sg := $(sort $(all_stems_script)) +all_stems_ssg := $(sort $(all_stems_ss)) + +default_stems_source := $(call concat-stems,tex,default) +default_stems_script := $(call concat-stems,tex.sh tex.pl tex.py rst,default) +default_stems_ss := $(sort $(default_stems_source) $(default_stems_script)) +default_stems_sg := $(sort $(default_stems_script)) +default_stems_ssg := $(sort $(default_stems_ss)) + +stems_source := $(call concat-stems,tex) +stems_script := $(call concat-stems,tex.sh tex.pl tex.py rst) +stems_graphic := $(call concat-stems,$(graphic_source_extensions)) +stems_gg := $(sort $(stems_graphic)) +stems_ss := $(sort $(stems_source) $(stems_script)) +stems_sg := $(sort $(stems_script)) +stems_ssg := $(sort $(stems_ss)) + +# Calculate names that can generate the need for an include file. We can't +# really do this with patterns because it's too easy to screw up, so we create +# an exhaustive list. +allowed_source_suffixes := \ + pdf \ + ps \ + dvi \ + ind \ + nls \ + bbl \ + aux \ + aux.make \ + d \ + auxbbl.make \ + _graphics \ + _show +allowed_source_patterns := $(addprefix %.,$(allowed_source_suffixes)) + +allowed_graphic_suffixes := \ + pdf \ + eps \ + gpihead.make \ + gpi.d +allowed_graphic_patterns := $(addprefix %.,$(allowed_graphic_suffixes)) + +# All targets allowed to build documents +allowed_source_targets := \ + $(foreach suff,$(allowed_source_suffixes),\ + $(addsuffix .$(suff),$(stems_ssg))) + +# All targets allowed to build graphics +allowed_graphic_targets := \ + $(foreach suff,$(allowed_graphic_suffixes),\ + $(addsuffix .$(suff),$(stems_gg))) + +# All targets that build multiple documents (like 'all') +allowed_batch_source_targets := \ + all \ + all-pdf \ + all-ps \ + all-dvi \ + all-bbl \ + all-ind \ + all-gls \ + all-nls \ + show + +# All targets that build multiple graphics (independent of document) +allowed_batch_graphic_targets := \ + all-graphics \ + all-pstex \ + all-dot2tex \ + show-graphics + +# Now we figure out which stuff is available as a make target for THIS RUN. +real_goals := $(call get-default,$(filter-out _includes,$(MAKECMDGOALS)),\ + all) + +specified_source_targets := $(strip \ + $(filter $(allowed_source_targets) $(stems_ssg),$(real_goals)) \ + ) + +specified_batch_source_targets := $(strip \ + $(filter $(allowed_batch_source_targets),$(real_goals)) \ + ) + +specified_graphic_targets := $(strip \ + $(filter $(allowed_graphic_targets),$(real_goals)) \ + ) + +specified_batch_graphic_targets := $(strip \ + $(filter $(allowed_batch_graphic_targets),$(real_goals)) \ + ) + +specified_gpi_targets := $(patsubst %.gpi,%.$(default_graphic_extension),\ + $(filter $(patsubst %.$(default_graphic_extension),%.gpi,$(specified_graphic_targets)),\ + $(all_files.gpi)) \ + ) + +# Determine which .d files need including from the information gained above. +# This is done by first checking whether a batch target exists. If it does, +# then all *default* stems are used to create possible includes (nobuild need +# not apply for batch status). If no batch targets exist, then the individual +# targets are considered and appropriate includes are taken from them. +source_stems_to_include := \ + $(sort\ + $(if $(specified_batch_source_targets),\ + $(default_stems_ss),\ + $(foreach t,$(specified_source_targets),\ + $(foreach p,$(allowed_source_patterns),\ + $(patsubst $p,%,$(filter $p $(stems_ssg),$t)) \ + )) \ + )) + +# Determine which .gpi.d files are needed using the above information. We +# first check whether a batch target is specified, then check individual +# graphics that may have been specified. +graphic_stems_to_include := \ + $(sort\ + $(if $(specified_batch_graphic_targets),\ + $(default_stems.gpi),\ + $(foreach t,$(specified_gpi_targets),\ + $(foreach p,$(allowed_graphic_patterns),\ + $(patsubst $p,%,$(filter $p,$t)) \ + )) \ + )) + +# All dependencies for the 'all' targets +all_pdf_targets := $(addsuffix .pdf,$(stems_ssg)) +all_ps_targets := $(addsuffix .ps,$(stems_ssg)) +all_dvi_targets := $(addsuffix .dvi,$(stems_ssg)) +all_tex_targets := $(addsuffix .tex,$(stems_sg)) +all_d_targets := $(addsuffix .d,$(stems_ssg)) +all_graphics_targets := $(addsuffix .$(default_graphic_extension),$(stems_gg)) +all_pstex_targets := $(addsuffix .pstex_t,$(stems.fig)) +all_dot2tex_targets := $(addsuffix .dot_t,$(stems.dot)) + +all_known_graphics := $(sort $(all_graphics_targets) $(wildcard *.$(default_graphic_extension))) + +default_pdf_targets := $(addsuffix .pdf,$(default_stems_ss)) + +ifeq "$(strip $(BUILD_STRATEGY))" "latex" +default_ps_targets := $(addsuffix .ps,$(default_stems_ss)) +default_dvi_targets := $(addsuffix .dvi,$(default_stems_ss)) +pre_pdf_extensions := dvi ps +endif + +# Extensions generated by LaTeX invocation that can be removed when complete +rm_ext := \ + log *.log aux $(pre_pdf_extensions) pdf blg bbl out nav snm toc lof lot lol pfg \ + fls vrb idx ind ilg glg glo gls lox nls nlo nlg brf mtc maf brf ist +backup_patterns := *~ *.bak *.backup body.tmp head.tmp + +graph_stem := _graph + +# All LaTeX-generated files that can be safely removed + +rm_tex := \ + $(foreach e,$(rm_ext),$(addsuffix .$e,$(all_stems_source))) \ + $(foreach e,$(rm_ext) tex,$(addsuffix .$e,$(all_stems_sg))) \ + $(addsuffix .log,$(all_ps_targets) $(all_pdf_targets)) \ + $(addsuffix .*.log,$(stems_graphic)) + +# These are the files that will affect .gpi transformation for all .gpi files. +# +# Use only the first one found. Backward compatible values are at the end. +# Note that we use foreach, even though wildcard also returns a list, to ensure +# that the order in the uppercase variables is preserved. Directory listings +# provide no such guarantee, so we avoid relying on them. +gpi_sed := $(strip \ + $(firstword $(foreach f,$(GNUPLOT_SED),$(wildcard $f)))) +gpi_global := $(strip \ + $(firstword $(foreach f,$(GNUPLOT_GLOBAL),$(wildcard $f)))) + +# +# Functions used in generating output +# + +# Outputs all source dependencies to stdout. The first argument is the file to +# be parsed, the second is a list of files that will show up as dependencies in +# the new .d file created here. +# +# $(call get-inputs,<parsed file>,<target files>) +define get-inputs +$(SED) \ +-e '/^INPUT/!d' \ +-e 's!^INPUT $\./$\{0,1\}!!' \ +-e 's/[[:space:]]/\\ /g' \ +-e 's/$.*$\.aux$$/\1.tex/' \ +-e '/\.tex$$/b addtargets' \ +-e '/\.cls$$/b addtargets' \ +-e '/\.sty$$/b addtargets' \ +-e '/\.pstex_t$$/b addtargets' \ +-e '/\.dot_t$$/b addtargets' \ +-e 'd' \ +-e ':addtargets' \ +-e 's!.*!$2: $$(call path-norm,&)!' \ +'$1' | $(SORT) | $(UNIQ) +endef + +# $(call get-missing-inputs,<log file>,<target files>) +define get-missing-inputs +$(SED) \ +-e '$${' \ +-e ' /^$$/!{' \ +-e ' H' \ +-e ' s/.*//' \ +-e ' }' \ +-e '}' \ +-e '/^$$/!{' \ +-e ' H' \ +-e ' d' \ +-e '}' \ +-e '/^$$/{' \ +-e ' x' \ +-e ' s/^$\n$$.*$/\2\1/' \ +-e '}' \ +-e '/^::P$P\{1,\}$::/{' \ +-e ' s//::\1::/' \ +-e ' G' \ +-e ' h' \ +-e ' d' \ +-e '}' \ +-e '/^::P::/{' \ +-e ' s//::0::/' \ +-e ' G' \ +-e '}' \ +-e 'b start' \ +-e ':needonemore' \ +-e 's/^/::P::/' \ +-e 'G' \ +-e 'h' \ +-e 'd' \ +-e ':needtwomore' \ +-e 's/^/::PP::/' \ +-e 'G' \ +-e 'h' \ +-e 'd' \ +-e ':needthreemore' \ +-e 's/^/::PPP::/' \ +-e 'G' \ +-e 'h' \ +-e 'd' \ +-e ':start' \ +-e '/^! LaTeX Error: File `/{' \ +-e ' b needtwomore' \ +-e '}' \ +-e '/^::0::$.*$/{' \ +-e ' s//\1/' \ +-e ' /Default extension: /!d' \ +-e ' s/.*File `$[^'"'"']*$'"'"' not found.*/\1/' \ +-e ' s/[[:cntrl:]]//' \ +-e ' /\.tex/!s/$$/.tex/' \ +-e ' s/[[:space:]]/\\ /g' \ +-e ' h' \ +-e ' s/.*/# MISSING input "&" - (presence of comment affects build)/' \ +-e ' p' \ +-e ' s/.*//' \ +-e ' x' \ +-e ' s!^.*!$2: $$(call path-norm,&)!' \ +-e ' p' \ +-e '}' \ +-e 'd' \ +'$1' | $(SORT) | $(UNIQ) +endef + +# Get source file for specified graphics stem. +# +# $(call graphics-source,<stem>) +define graphics-source +$(strip $(firstword \ + $(wildcard \ + $(addprefix $1.,\ + $(graphic_source_extensions))) \ + $1 \ +)) +endef + +# Get the target file for the specified graphics file/stem +# +# $(call graphics-target,<stem>) +define graphics-target +$(strip $(if $(filter $(addprefix %.,$(graphic_target_extensions)),$1), $1, + $(firstword $(patsubst $(addprefix %.,$(graphic_source_extensions) $(graphic_target_extensions)), %, $1).$(default_graphic_extension) $1.$(default_graphic_extension)))) +endef + +# Outputs all of the graphical dependencies to stdout. The first argument is +# the stem of the source file being built, the second is a list of suffixes +# that will show up as dependencies in the generated .d file. +# +# Note that we try to escape spaces in filenames where possible. We have to do +# it with three backslashes so that as the name percolates through the makefile +# it eventually ends up with the proper escaping when the build rule is found. +# Ugly, but it appears to work. Note that graphicx doesn't allow filenames +# with spaces, so this could in many ways be moot unless you're using something +# like grffile. +# +# For pdflatex, we really need the missing file to be specified without an +# extension, otherwise compilation barfs on the first missing file. Truly +# annoying, but there you have it. +# +# It turns out that the graphics errors, although they have lines with empty +# space, are only made of two paragraphs. So, we just use some sed magic to +# get everything into paragraphs, detect when it's a paragraph that interests +# us, and double it up. Then we get the filename only if we're missing +# extensions (a sign that it's graphicx complaining). +# +# $(call get-graphics,<target file stem>) +#.log,$(addprefix $*.,d $(build_target_extension) _graphics) +define get-graphics +$(SED) \ +-e '/^File: $.*$ Graphic file (type [^)]*)/{' \ +-e ' s//\1/' \ +-e ' b addtargets' \ +-e '}' \ +-e '$${' \ +-e ' /^$$/!{' \ +-e ' H' \ +-e ' s/.*//' \ +-e ' }' \ +-e '}' \ +-e '/^$$/!{' \ +-e ' H' \ +-e ' d' \ +-e '}' \ +-e '/^$$/{' \ +-e ' x' \ +-e ' s/^$\n$$.*$/\2\1/' \ +-e '}' \ +-e '/^::P$P\{1,\}$::/{' \ +-e ' s//::\1::/' \ +-e ' G' \ +-e ' h' \ +-e ' d' \ +-e '}' \ +-e '/^::P::/{' \ +-e ' s//::0::/' \ +-e ' G' \ +-e '}' \ +-e 'b start' \ +-e ':needonemore' \ +-e 's/^/::P::/' \ +-e 'G' \ +-e 'h' \ +-e 'd' \ +-e ':needtwomore' \ +-e 's/^/::PP::/' \ +-e 'G' \ +-e 'h' \ +-e 'd' \ +-e ':needthreemore' \ +-e 's/^/::PPP::/' \ +-e 'G' \ +-e 'h' \ +-e 'd' \ +-e ':start' \ +-e '/^[^[:cntrl:]:]*:[[:digit:]]\{1,\}: LaTeX Error: File `/{' \ +-e ' s/\n//g' \ +-e ' b needonemore' \ +-e '}' \ +-e '/^::0::.*: LaTeX Error: File `/{' \ +-e ' /\n\n$$/{' \ +-e ' s/^::0:://' \ +-e ' b needonemore' \ +-e ' }' \ +-e ' s/\n\{1,\}/ /g' \ +-e ' s/[[:space:]]\{1,\}/ /g' \ +-e ' s/^.*File `//' \ +-e ' s/'"'"' not found\..*extensions: $[^[:space:]]*$.*/::::\1/' \ +-e ' h' \ +-e ' s/$.*$::::$.*$/# MISSING stem "\1" - allowed extensions are "\2" - leave comment here - it affects the build/' \ +-e ' p' \ +-e ' g' \ +-e ' s/::::.*//' \ +-e ' b addtargets' \ +-e '}' \ +-e 'd' \ +-e ':addtargets' \ +-e 's/[[:space:]]/\\\\\\&/g' \ +-e 'h' \ +-e 's/.*/-include &.gpi.d/' \ +-e 'p' \ +-e 'g' \ +-e 's!.*!$1.d: $$$$(call graphics-source,&)!' \ +-e 'p' \ +-e 's/.*//' \ +-e 'x' \ +-e 's!.*!$1.$(build_target_extension) $1._graphics: $$$$(call graphics-target,&)!' \ +-e 'p' \ +-e 'd' \ +$1.log +endef + +# Checks for build failure due to pstex inclusion, and gives instructions. +# +# $(call die-on-pstexs,<parsed file>) +define die-on-pstexs +if $(EGREP) -q '^! LaTeX Error: File .*\.pstex.* not found' $1; then \ + $(ECHO) "$(C_ERROR)Missing pstex_t file(s)$(C_RESET)"; \ + $(ECHO) "$(C_ERROR)Please run$(C_RESET)"; \ + $(ECHO) "$(C_ERROR) make all-pstex$(C_RESET)"; \ + $(ECHO) "$(C_ERROR)before proceeding.$(C_RESET)"; \ + exit 1; \ +fi +endef + +# Checks for the use of import.sty and bails - we don't support subdirectories +# +# $(call die-on-import-sty,<log file>) +define die-on-import-sty +if $(EGREP) -s '/import.sty\)' '$1'; then \ + $(ECHO) "$(C_ERROR)import.sty is not supported - included files must"; \ + $(ECHO) "$(C_ERROR)be in the same directory as the primary document$(C_RESET)"; \ + exit 1; \ +fi +endef + +# Checks for build failure due to dot2tex, and gives instructions. +# +# $(call die-on-dot2tex,<parsed file>) +define die-on-dot2tex +if $(EGREP) -q ' LaTeX Error: File .*\.dot_t.* not found' $1; then \ + $(ECHO) "$(C_ERROR)Missing dot_t file(s)$(C_RESET)"; \ + $(ECHO) "$(C_ERROR)Please run$(C_RESET)"; \ + $(ECHO) "$(C_ERROR) make all-dot2tex$(C_RESET)"; \ + $(ECHO) "$(C_ERROR)before proceeding.$(C_RESET)"; \ + exit 1; \ +fi +endef + +# Checks for the existence of a .aux file, and dies with an error message if it +# isn't there. Note that we pass the file stem in, not the full filename, +# e.g., to check for foo.aux, we call it thus: $(call die-on-no-aux,foo) +# +# $(call die-on-no-aux,<aux stem>) +define die-on-no-aux +if [ ! -e '$1.aux' ]; then \ + $(call colorize-latex-errors,$1.log); \ + $(ECHO) "$(C_ERROR)Error: failed to create $1.aux$(C_RESET)"; \ + exit 1; \ +fi +endef + +# Outputs all index files to stdout. Arg 1 is the source file stem, arg 2 is +# the list of targets for the discovered dependency. +# +# $(call get-log-index,<log file stem>,<target files>) +define get-log-index +$(SED) \ +-e 's/^No file $.*\.ind$\.$$/TARGETS=\1/' \ +-e 's/^No file $.*\.[gn]ls$\.$$/TARGETS=\1/' \ +-e 's/[[:space:]]/\\&/g' \ +-e '/^TARGETS=/{' \ +-e ' h' \ +-e ' s!^TARGETS=!$2: !p' \ +-e ' g' \ +-e ' s!^TARGETS=$.*$!\1: $1.tex!p' \ +-e '}' \ +-e 'd' \ +'$1.log' | $(SORT) | $(UNIQ) +endef + + +# Outputs all bibliography files to stdout. Arg 1 is the source stem, arg 2 is +# a list of targets for each dependency found. +# +# The script kills all lines that do not contain bibdata. Remaining lines have +# the \bibdata macro and delimiters removed to create a dependency list. A +# trailing comma is added, then all adjacent commas are collapsed into a single +# comma. Then commas are replaced with the string .bib[space], and the +# trailing space is killed off. Finally, all filename spaces are escaped. +# This produces a list of space-delimited .bib filenames, which is what the +# make dep file expects to see. +# +# Note that we give kpsewhich a bogus argument so that a failure of sed to +# produce output will not cause an error. +# +# $(call get-bibs,<aux file>,<targets>) +define get-bibs +$(SED) \ +-e '/^\\bibdata/!d' \ +-e 's/\\bibdata{$[^}]*$}/\1,/' \ +-e 's/,\{2,\}/,/g' \ +-e 's/[[:space:]]/\\&/g' \ +-e 's/,/.bib /g' \ +-e 's/ \{1,\}$$//' \ +$1 | $(XARGS) $(KPSEWHICH) '#######' | \ +$(SED) \ +-e 's!^!$2: !' | \ +$(SORT) | $(UNIQ) +endef + +# Makes a an aux file that only has stuff relevant to the target in it +# $(call make-auxtarget-file,<flattened-aux>,<new-aux>) +define make-auxtarget-file +$(SED) \ +-e '/^\\newlabel/!d' \ +$1 > $2 +endef + +# Makes an aux file that only has stuff relevant to the bbl in it +# $(call make-auxbbl-file,<flattened-aux>,<new-aux>) +define make-auxbbl-file +$(SED) \ +-e '/^\\newlabel/d' \ +$1 > $2 +endef + +# Makes a .gpi.d file from a .gpi file +# $(call make-gpi-d,<.gpi>,<.gpi.d>) +define make-gpi-d +$(ECHO) '# vim: ft=make' > $2; \ +$(ECHO) 'ifndef INCLUDED_$(call cleanse-filename,$2)' >> $2; \ +$(ECHO) 'INCLUDED_$(call cleanse-filename,$2) := 1' >> $2; \ +$(call get-gpi-deps,$1,$(addprefix $(2:%.gpi.d=%).,$(GPI_OUTPUT_EXTENSION) gpi.d)) >> $2; \ +$(ECHO) 'endif' >> $2; +endef + +# Parse .gpi files for data and loaded dependencies, output to stdout +# +# The sed script here tries to be clever about obtaining valid +# filenames from the gpi file. It assumes that the plot command starts its own +# line, which is not too difficult a constraint to satisfy. +# +# This command script also generates 'include' directives for every 'load' +# command in the .gpi file. The load command must appear on a line by itself +# and the file it loads must have the suffix .gpi. If you don't want it to be +# compiled when running make graphics, then give it a suffix of ._include_.gpi. +# +# $(call get-gpi-deps,<gpi file>,<targets>) +define get-gpi-deps +$(SED) \ +-e '/^[[:space:]]*s\{0,1\}plot/,/[^\\]$$/{' \ +-e ' H' \ +-e ' /[^\\]$$/{' \ +-e ' s/.*//' \ +-e ' x' \ +-e ' s/\\\{0,1\}\n//g' \ +-e ' s/^[[:space:]]*s\{0,1\}plot[[:space:]]*$\[[^]]*\][[:space:]]*$*/,/' \ +-e ' s/[[:space:]]*$['"'"'\'"'"''"'"'"][^'"'"'\'"'"''"'"'"]*['"'"'\'"'"''"'"'"]$\{0,1\}[^,]*/\1/g' \ +-e ' s/,['"'"'\'"'"''"'"'"]-\{0,1\}['"'"'\'"'"''"'"'"]//g' \ +-e ' s/[,'"'"'\'"'"''"'"'"]\{1,\}/ /g' \ +-e ' s/.*:.*/$$(error Error: Filenames with colons are not allowed: &)/' \ +-e ' s!.*!$2: &!' \ +-e ' p' \ +-e ' }' \ +-e ' d' \ +-e '}' \ +-e 's/^[[:space:]]*load[[:space:]]*['"'"'\'"'"''"'"'"]$[^'"'"'\'"'"''"'"'"]*\.gpi$['"'"'\'"'"''"'"'"].*$$/-include \1.d/p' \ +-e 'd' \ +'$1' +endef + +# Colorizes real, honest-to-goodness LaTeX errors that can't be overcome with +# recompilation. +# +# Note that we only ignore file not found errors for things that we know how to +# build, like graphics files. +# +# Also note that the output of this is piped through sed again to escape any +# backslashes that might have made it through. This is to avoid sending things +# like "\right" to echo, which interprets \r as LF. In bash, we could just do +# ${var//\\/\\\\}, but in other popular sh variants (like dash), this doesn't +# work. +# +# $(call colorize-latex-errors,<log file>) +define colorize-latex-errors +$(SED) \ +-e '$${' \ +-e ' /^$$/!{' \ +-e ' H' \ +-e ' s/.*//' \ +-e ' }' \ +-e '}' \ +-e '/^$$/!{' \ +-e ' H' \ +-e ' d' \ +-e '}' \ +-e '/^$$/{' \ +-e ' x' \ +-e ' s/^$\n$$.*$/\2\1/' \ +-e '}' \ +-e '/^::P$P\{1,\}$::/{' \ +-e ' s//::\1::/' \ +-e ' G' \ +-e ' h' \ +-e ' d' \ +-e '}' \ +-e '/^::P::/{' \ +-e ' s//::0::/' \ +-e ' G' \ +-e '}' \ +-e 'b start' \ +-e ':needonemore' \ +-e 's/^/::P::/' \ +-e 'G' \ +-e 'h' \ +-e 'd' \ +-e ':needtwomore' \ +-e 's/^/::PP::/' \ +-e 'G' \ +-e 'h' \ +-e 'd' \ +-e ':needthreemore' \ +-e 's/^/::PPP::/' \ +-e 'G' \ +-e 'h' \ +-e 'd' \ +-e ':start' \ +-e '/^! LaTeX Error: File /{' \ +-e ' s/\n//g' \ +-e ' b needtwomore' \ +-e '}' \ +-e 's/^[^[:cntrl:]:]*:[[:digit:]]\{1,\}:/!!! &/' \ +-e 's/^$.*\n$$[^[:cntrl:]:]*:[[:digit:]]\{1,\}: .*$/\1!!! \2/' \ +-e '/^!!! .* LaTeX Error: File /{' \ +-e ' s/\n//g' \ +-e ' b needonemore' \ +-e '}' \ +-e '/^::0::! LaTeX Error: File .*/{' \ +-e ' /\n\n$$/{' \ +-e ' s/^::0:://' \ +-e ' b needonemore' \ +-e ' }' \ +-e ' s/^::0::! //' \ +-e ' s/^$.*not found.$.*Enter file name:.*\n$.*[[:digit:]]\{1,\}$: Emergency stop.*/\2: \1/' \ +-e ' b error' \ +-e '}' \ +-e '/^::0::!!! .*LaTeX Error: File .*/{' \ +-e ' /\n\n$$/{' \ +-e ' s/^::0:://' \ +-e ' b needonemore' \ +-e ' }' \ +-e ' s/::0::!!! //' \ +-e ' /could not locate.*any of these extensions:/{' \ +-e ' d' \ +-e ' }' \ +-e ' s/$not found\.$.*/\1/' \ +-e ' b error' \ +-e '}' \ +-e '/^$.* LaTeX Error: Missing .begin.document.\.$.*/{' \ +-e ' s//\1 --- Are you trying to build an include file?/' \ +-e ' b error' \ +-e '}' \ +-e '/.*$!!! .*Undefined control sequence$[^[:cntrl:]]*$.*$/{' \ +-e ' s//\1: \2/' \ +-e ' s/\nl\.[[:digit:]][^[:cntrl:]]*$\\[^\\[:cntrl:]]*$.*/\1/' \ +-e ' b error' \ +-e '}' \ +-e '/^$!pdfTeX error:.*$s*/{' \ +-e ' b error' \ +-e '}' \ +-e '/.*$!!! .*$/{' \ +-e ' s//\1/' \ +-e ' s/[[:cntrl:]]//' \ +-e ' s/[[:cntrl:]]$$//' \ +-e ' b error' \ +-e '}' \ +-e 'd' \ +-e ':error' \ +-e 's/^!$!! $\{0,1\}$.*$/$(C_ERROR)\2$(C_RESET)/' \ +-e 'p' \ +-e 'd' \ +'$1' | $(SED) -e 's/\\\\/\\\\\\\\/g' +endef + +# Colorize Makeindex errors +define colorize-makeindex-errors +$(SED) \ +-e '/^!! /{' \ +-e ' N' \ +-e ' s/^.*$$/$(C_ERROR)&$(C_RESET)/' \ +-e ' p' \ +-e '}' \ +-e 'd' \ +'$1' +endef + +# Colorize xindy errors +# $(call colorize-xindy-errors,<log file>) +define colorize-xindy-errors +$(SED) \ +-e 's/^xindy:.*/$(C_ERROR)&$(C_RESET)/p' \ +-e 'd' \ +'$1' +endef + +# Colorize epstopdf errors +# +# $(call colorize-epstopdf-errors,<log file>) +define colorize-epstopdf-errors +$(SED) \ +-e '/^Error:/,/^Execution stack:/{' \ +-e ' /^Execution stack:/d' \ +-e ' s/.*/$(C_ERROR)&$(C_RESET)/' \ +-e ' p' \ +-e '}' \ +-e 'd' \ +'$1' +endef + +# Colorize GNUplot errors +# +# $(call colorize-gnuplot-errors,<log file>) +define colorize-gnuplot-errors +$(SED) \ +-e '/, line [0-9]*:/!{' \ +-e ' H' \ +-e ' x' \ +-e ' s/.*\n$.*\n.*$$$/\1/' \ +-e ' x' \ +-e '}' \ +-e '/, line [0-9]*:/{' \ +-e ' H' \ +-e ' /unknown.*terminal type/{' \ +-e ' s/.*/--- Try changing the GNUPLOT_OUTPUT_EXTENSION variable to '"'"'eps'"'"'./' \ +-e ' H' \ +-e ' }' \ +-e ' /gpihead/{' \ +-e ' s/.*/--- This could be a Makefile bug - contact the maintainer./' \ +-e ' H' \ +-e ' }' \ +-e ' g' \ +-e ' s/.*/$(C_ERROR)&$(C_RESET)/' \ +-e ' p' \ +-e '}' \ +-e '/^gnuplot>/,/^$$/{' \ +-e ' s/^gnuplot.*/$(C_ERROR)&/' \ +-e ' s/^$$/$(C_RESET)/' \ +-e ' p' \ +-e '}' \ +-e 'd' \ +$1 +endef + +# Colorize GraphViz errors +# +# $(call colorize-dot-errors,<log file>) +define colorize-dot-errors +$(SED) \ +-e 's/.*not found.*/$(C_ERROR)&$(C_RESET)/p' \ +-e '/^Error:/,/context:/s/.*/$(C_ERROR)&$(C_RESET)/p' \ +-e 's/^Warning:.*/$(C_WARNING)&$(C_RESET)/p' \ +-e 'd' \ +'$1' +endef + +# Get all important .aux files from the top-level .aux file and merges them all +# into a single file, which it outputs to stdout. +# +# $(call flatten-aux,<toplevel aux>,<output file>) +define flatten-aux +$(SED) \ +-e '/\$a)input{\(.*$}/{' \ +-e 's//\1/' \ +-e 's![.:]!\\&!g' \ +-e 'h' \ +-e 's!.*!\\:\\\\@input{&}:{!' \ +-e 'p' \ +-e 'x' \ +-e 's/\\././g' \ +-e 's/.*/r &/p' \ +-e 's/.*/d/p' \ +-e 's/.*/}/p' \ +-e 'd' \ +-e '}' \ +-e 'd' \ +'$1' > "$1.$$$$.sed.make"; \ +$(SED) -f "$1.$$$$.sed.make" '$1' > "$1.$$$$.make"; \ +$(SED) \ +-e '/^\\relax/d' \ +-e '/^\\bibcite/d' \ +-e 's/^$\\newlabel{[^}]\{1,\}}$.*/\1/' \ +"$1.$$$$.make" | $(SORT) > '$2'; \ +$(call remove-temporary-files,$1.$$$$.make $1.$$$$.sed.make) +endef + +# Generate pdf from postscript +# +# Note that we don't just call ps2pdf, since there are so many versions of that +# script on various systems. Instead, we call the postscript interpreter +# directly. +# +# $(call ps2pdf,infile,outfile,[embed fonts]) +define ps2pdf + $(GS) \ + -dSAFER -dCompatibilityLevel=$(PS_COMPATIBILITY) \ + $(if $3,$(PS_EMBED_OPTIONS)) \ + -q -dNOPAUSE -dBATCH \ + -sDEVICE=pdfwrite -sstdout=%stderr \ + '-sOutputFile=$2' \ + -dSAFER -dCompatibilityLevel=$(PS_COMPATIBILITY) \ + $(if $3,$(PS_EMBED_OPTIONS)) \ + -c .setpdfwrite \ + -f '$1' +endef + +# Colorize LaTeX output. +color_tex := \ +$(SED) \ +-e '$${' \ +-e ' /^$$/!{' \ +-e ' H' \ +-e ' s/.*//' \ +-e ' }' \ +-e '}' \ +-e '/^$$/!{' \ +-e ' H' \ +-e ' d' \ +-e '}' \ +-e '/^$$/{' \ +-e ' x' \ +-e ' s/^\n//' \ +-e ' /Output written on /{' \ +-e ' s/.*Output written on $[^(]*$ ($[^)]\{1,\}$).*/Success! Wrote \2 to \1/' \ +-e ' s/[[:digit:]]\{1,\}/$(C_PAGES)&$(C_RESET)/g' \ +-e ' s/Success!/$(C_SUCCESS)&$(C_RESET)/g' \ +-e ' s/to $.*$$$/to $(C_SUCCESS)\1$(C_RESET)/' \ +-e ' b end' \ +-e ' }' \ +-e ' / *LaTeX Error:.*/{' \ +-e ' s/.*$ *LaTeX Error:.*$/$(C_ERROR)\1$(C_RESET)/' \ +-e ' b end' \ +-e ' }' \ +-e ' /.*Warning:.*/{' \ +-e ' s//$(C_WARNING)&$(C_RESET)/' \ +-e ' b end' \ +-e ' }' \ +-e ' /Underfull.*/{' \ +-e ' s/.*$Underfull.*$/$(C_UNDERFULL)\1$(C_RESET)/' \ +-e ' b end' \ +-e ' }' \ +-e ' /Overfull.*/{' \ +-e ' s/.*$Overfull.*$/$(C_OVERFULL)\1$(C_RESET)/' \ +-e ' b end' \ +-e ' }' \ +-e ' d' \ +-e ' :end' \ +-e ' G' \ +-e '}' + +# Colorize BibTeX output. +color_bib := \ +$(SED) \ +-e 's/^Warning--.*/$(C_WARNING)&$(C_RESET)/' \ +-e 't' \ +-e '/---/,/^.[^:]/{' \ +-e ' H' \ +-e ' /^.[^:]/{' \ +-e ' x' \ +-e ' s/\n$.*$/$(C_ERROR)\1$(C_RESET)/' \ +-e ' p' \ +-e ' s/.*//' \ +-e ' h' \ +-e ' d' \ +-e ' }' \ +-e ' d' \ +-e '}' \ +-e '/(.*error.*)/s//$(C_ERROR)&$(C_RESET)/' \ +-e 'd' + +# Make beamer output big enough to print on a full page. Landscape doesn't +# seem to work correctly. +enlarge_beamer = $(PSNUP) -l -1 -W128mm -H96mm -pletter + +# $(call test-run-again,<source stem>) +test-run-again = $(EGREP) -q '^(.*Rerun .*|No file $1\.[^.]+\.)$$' $1.log + +# This tests whether the build target commands should be run at all, from +# viewing the log file. +# $(call test-log-for-need-to-run,<source stem>) +define test-log-for-need-to-run +$(SED) \ +-e '/^No file $(call escape-fname-regex,$1)\.aux\./d' \ +$1.log \ +| $(EGREP) -q '^(.*Rerun .*|No file $1\.[^.]+\.|No file .+\.tex\.|LaTeX Warning: File.*)$$' +endef + +# LaTeX invocations +# +# $(call latex,<tex file>,[<extra LaTeX args>]) +run-latex = $(latex_build_program) -interaction=batchmode -file-line-error $(if $2,$2,) $1 > /dev/null + +# $(call latex-color-log,<LaTeX stem>) +latex-color-log = $(color_tex) $1.log + +# $(call run-makeindex,<input>,<output>,<log>,[.ist style file]) +define run-makeindex +success=1; \ +if ! $(MAKEINDEX) -q $1 -t $3 -o $2 $(if $4,-s $4,) > /dev/null || $(EGREP) -q '^!!' $3; \ +then \ + $(call colorize-makeindex-errors,$3); \ + $(RM) -f '$2'; \ + success=0; \ +fi; \ +[ "$$success" = "1" ] && $(sh_true) || $(sh_false); +endef + + +# $(call run-xindy,<input>,<output>,<module>,<log>) +define run-xindy +success=1; \ +if ! $(XINDY) -q -o $2 -L $(XINDYLANG) -C $(XINDYENC) -I xindy -M $3 -t $4 $1 > /dev/null || $(EGREP) -q '^xindy:' $4; then \ + $(call colorize-xindy-errors,$4); \ + $(RM) -f '$2'; \ + success=0; \ +fi; \ +[ "$$success" = "1" ] && $(sh_true) || $(sh_false); +endef + +# This runs the given script to generate output, and it uses MAKE_RESTARTS to +# ensure that it never runs it more than once for a particular root make +# invocation. +# +# $(call run-script,<interpreter>,<input>,<output>) +define run-script +[ ! -e '$2.cookie' ] && $(ECHO) "restarts=$(RESTARTS)" > $2.cookie && $(ECHO) "level=$(MAKELEVEL)" >> $2.cookie; \ +restarts=`$(SED) -n -e 's/^restarts=//p' $2.cookie`; \ +level=`$(SED) -n -e 's/^level=//p' $2.cookie`; \ +if $(EXPR) $(MAKELEVEL) '<=' $$level '&' $(RESTARTS) '<=' $$restarts >/dev/null; then \ + $(call echo-build,$2,$3,$(RESTARTS)-$(MAKELEVEL)); \ + $1 '$2' '$3'; \ + $(ECHO) "restarts=$(RESTARTS)" > '$2.cookie'; \ + $(ECHO) "level=$(MAKELEVEL)" >> '$2.cookie'; \ +fi +endef + +# BibTeX invocations +# +# $(call run-bibtex,<tex stem>) +run-bibtex = $(BIBTEX) $1 | $(color_bib) + + +# $(call convert-eps-to-pdf,<eps file>,<pdf file>,[gray]) +# Note that we don't use the --filter flag because it has trouble with bounding boxes that way. +define convert-eps-to-pdf +$(if $3,$(CAT) '$1' | $(call kill-ps-color) > '$1.cookie',$(CP) '$1' '$1.cookie'); \ +$(EPSTOPDF) '$1.cookie' --outfile='$2' > $1.log; \ +$(call colorize-epstopdf-errors,$1.log); +endef + +# $(call default-gpi-fontsize,<output file>) +# +# Find the default fontsize given the *output* file (it is based on the output extension) +# +default-gpi-fontsize = $(if $(filter %.pdf,$1),$(DEFAULT_GPI_PDF_FONTSIZE),$(DEFAULT_GPI_EPS_FONTSIZE)) + +# $(call gpi-fontsize,<gpi file>,<output file>) +# +# Find out what the gnuplot fontsize should be. Tries, in this order: +# - ##FONTSIZE comment in gpi file +# - ##FONTSIZE comment in global gpi file +# - default fontsize based on output type +define gpi-fontsize +$(strip $(firstword \ + $(shell $(SED) -e 's/^\#\#FONTSIZE=$[[:digit:]]\{1,\}$/\1/p' -e 'd' $1 $(strip $(gpi_global))) \ + $(call default-gpi-fontsize,$2))) +endef + +# $(call gpi-monochrome,<gpi file>,[gray]) +define gpi-monochrome +$(strip $(if $2,monochrome,$(if $(shell $(EGREP) '^\#\#[[:space:]]*GRAY[[:space:]]*$$' $1 $(gpi_global)),monochrome,color))) +endef + +# $(call gpi-font-entry,<output file>,<fontsize>) +# +# Get the font entry given the output file (type) and the font size. For PDF +# it uses fsize or font, for eps it just uses the bare number. +gpi-font-entry = $(if $(filter %.pdf,$1),$(subst FONTSIZE,$2,$(GPI_FSIZE_SYNTAX)),$2) + +# $(call gpi-terminal,<gpi file><output file>,[gray]) +# +# Get the terminal settings for a given gpi and its intended output file +define gpi-terminal +$(if $(filter %.pdf,$2),pdf enhanced,postscript enhanced eps) \ +$(call gpi-font-entry,$2,$(call gpi-fontsize,$1,$2)) \ +$(call gpi-monochrome,$1,$3) +endef + +# $(call gpi-embed-pdf-fonts,<input file>,<output file>) +# +define gpi-embed-pdf-fonts +$(GS) \ + -q \ + -dSAFER \ + -dNOPAUSE \ + -dBATCH \ + -sDEVICE=$(if $(filter pdf,$(GPI_OUTPUT_EXTENSION)),pdfwrite,pswrite) \ + -sOutputFile='$2' \ + -sstdout=%stderr \ + -dCompatibilityLevel=1.5 \ + -dPDFSETTINGS=/prepress \ + -c .setpdfwrite \ + -f '$1' +endef + +# $(call convert-gpi,<gpi file>,<output file>,[gray]) +# +define convert-gpi +$(ECHO) 'set terminal $(call gpi-terminal,$1,$2,$3)' > $1head.make; \ +$(ECHO) 'set output "$2"' >> $1head.make; \ +$(if $(gpi_global),$(CAT) $(gpi_global) >> $1head.make;,) \ +fnames='$1head.make $1';\ +$(if $(gpi_sed),\ + $(SED) -f '$(gpi_sed)' $$fnames > $1.temp.make; \ + fnames=$1.temp.make;,\ +) \ +success=1; \ +if ! $(GNUPLOT) $$fnames 2>$1.log; then \ + $(call colorize-gnuplot-errors,$1.log); \ + success=0; \ +else \ + if ! $(call gpi-embed-pdf-fonts,$2,$2.embed.make); then \ + success = 0; \ + else \ + $(call move-if-exists,$2.embed.make,$2); \ + fi; \ +fi; \ +$(if $(gpi_sed),$(call remove-temporary-files,$1.temp.make);,) \ +$(call remove-temporary-files,$1head.make); \ +[ "$$success" = "1" ] && $(sh_true) || $(sh_false); +endef + +# Creation of .eps files from .png files +# +# The intermediate step of PNM (using NetPBM) produces much nicer output than +# ImageMagick's "convert" binary. I couldn't get the right combination of +# flags to make it look nice, anyway. +# +# To handle gray scale conversion, we pipe things through ppmtopgm in the +# middle. +# +# $(call convert-png,<png file>,<eps file>) +define convert-png +$(PNGTOPNM) "$1" \ + $(if $3,| $(PPMTOPGM),) \ + | $(PNMTOPS) -noturn \ + > "$2" +endef + +# Creation of .eps files from .jpg/.jpeg files +# +# Thanks to brubakee for this solution. +# +# Uses Postscript level 2 to avoid file size bloat +# $(call convert-jpg,<jpg file>,<eps file>) +define convert-jpg +$(CONVERT) $(if $3,-type Grayscale,) '$1' eps2:'$2' +endef + +# Creation of .eps files from .fig files +# $(call convert-fig,<fig file>,<output file>,[gray]) +convert-fig = $(FIG2DEV) -L $(if $(filter %.pdf,$2),pdf,eps) $(if $3,-N,) $1 $2 + +# Creation of .pstex files from .fig files +# $(call convert-fig-pstex,<fig file>,<pstex file>) +convert-fig-pstex = $(FIG2DEV) -L pstex $1 $2 > /dev/null 2>&1 + +# Creation of .pstex_t files from .fig files +# $(call convert-fig-pstex-t,<fig file>,<pstex file>,<pstex_t file>) +convert-fig-pstex-t = $(FIG2DEV) -L pstex_t -p $3 $1 $2 > /dev/null 2>&1 + +# Creation of .dot_t files from .dot files +# #(call convert-dot-tex,<dot file>,<dot_t file>) +convert-dot-tex = $(DOT2TEX) '$1' > '$2' + +# Converts svg files into .eps files +# +# $(call convert-svg,<svg file>,<eps/pdf file>,[gray]) +convert-svg = $(INKSCAPE) --without-gui $(if $(filter %.pdf,$2),--export-pdf,--export-eps)='$2' '$1' + +# Converts xvg files into .eps files +# +# $(call convert-xvg,<xvg file>,<eps file>,[gray]) +convert-xvg = $(XMGRACE) '$1' -printfile - -hardcopy -hdevice $(if $3,-mono,) EPS > '$2' + +# Converts .eps.gz files into .eps files +# +# $(call convert-epsgz,<eps.gz file>,<eps file>,[gray]) +convert-epsgz = $(GUNZIP) -c '$1' $(if $3,| $(call kill-ps-color)) > '$2' + +# Converts .eps files into .eps files (usually a no-op, but can make grayscale) +# +# $(call convert-eps,<in file>,<out file>,[gray]) +convert-eps = $(if $3,$(call kill-ps-color) $1 > $2) + +# The name of the file containing special postscript commands for grayscale +gray_eps_file := gray.eps.make + +# Changes sethsbcolor and setrgbcolor calls in postscript to always produce +# grayscale. In general, this is accomplished by writing new versions of those +# functions into the user dictionary space, which is looked up before the +# global or system dictionaries (userdict is one of the permanent dictionaries +# in postscript and is not read-only like systemdict). +# +# For setrgbcolor, the weighted average of the triple is computed and the +# triple is replaced with three copies of that average before the original +# procedure is called: .299R + .587G + .114B +# +# For sethsbcolor, the color is first converted to RGB, then to grayscale by +# the new setrgbcolor operator as described above. Why is this done? +# Because simply using the value component will tend to make pure colors +# white, a very undesirable thing. Pure blue should not translate to white, +# but to some level of gray. Conversion to RGB does the right thing. It's +# messy, but it works. +# +# From +# http://en.wikipedia.org/wiki/HSV_color_space#Transformation_from_HSV_to_RGB, +# HSB = HSV (Value = Brightness), and the formula used to convert to RGB is +# as follows: +# +# Hi = int(floor(6 * H)) mod 6 +# f = 6 * H - Hi +# p = V(1-S) +# q = V(1-fS) +# t = V(1-(1-f)S) +# if Hi = 0: R G B <-- V t p +# if Hi = 1: R G B <-- q V p +# if Hi = 2: R G B <-- p V t +# if Hi = 3: R G B <-- p q V +# if Hi = 4: R G B <-- t p V +# if Hi = 5: R G B <-- V p q +# +# The messy stack-based implementation is below +# $(call create-gray-eps-file,filename) +define create-gray-eps-file +$(ECHO) -n -e '\ +/OLDRGB /setrgbcolor load def\n\ +/setrgbcolor {\n\ + .114 mul exch\n\ + .587 mul add exch\n\ + .299 mul add\n\ + dup dup\n\ + OLDRGB\n\ +} bind def\n\ +/OLDHSB /sethsbcolor load def\n\ +/sethsbcolor {\n\ + 2 index % H V S H\n\ + 6 mul floor cvi 6 mod % Hi V S H\n\ + 3 index % H Hi V S H\n\ + 6 mul % 6H Hi V S H\n\ + 1 index % Hi 6H Hi V S H\n\ + sub % f Hi V S H\n\ + 2 index 1 % 1 V f Hi V S H\n\ + 4 index % S 1 V f Hi V S H\n\ + sub mul % p f Hi V S H\n\ + 3 index 1 % 1 V p f Hi V S H\n\ + 6 index % S 1 V p f Hi V S H\n\ + 4 index % f S 1 V p f Hi V S H\n\ + mul sub mul % q p f Hi V S H\n\ + 4 index 1 1 % 1 1 V q p f Hi V S H\n\ + 5 index % f 1 1 V q p f Hi V S H\n\ + sub % (1-f) 1 V q p f Hi V S H\n\ + 8 index % S (1-f) 1 V q p f Hi V S H\n\ + mul sub mul % t q p f Hi V S H\n\ + 4 -1 roll pop % t q p Hi V S H\n\ + 7 -2 roll pop pop % t q p Hi V\n\ + 5 -2 roll % Hi V t q p\n\ + dup 0 eq\n\ + {1 index 3 index 6 index}\n\ + {\n\ + dup 1 eq\n\ + {3 index 2 index 6 index}\n\ + {\n\ + dup 2 eq\n\ + {4 index 2 index 4 index}\n\ + {\n\ + dup 3 eq\n\ + {4 index 4 index 3 index}\n\ + {\n\ + dup 4 eq\n\ + {2 index 5 index 3 index}\n\ + {\n\ + dup 5 eq\n\ + {1 index 5 index 5 index}\n\ + {0 0 0}\n\ + ifelse\n\ + }\n\ + ifelse\n\ + }\n\ + ifelse\n\ + }\n\ + ifelse\n\ + }\n\ + ifelse\n\ + }\n\ + ifelse % B G R Hi V t q p\n\ + setrgbcolor\n\ + 5 {pop} repeat\n\ +} bind def\n'\ +> $1 +endef + +# This actually inserts the color-killing code into a postscript file +# $(call kill-ps-color) +define kill-ps-color +$(SED) -e '/%%EndComments/r $(gray_eps_file)' +endef + +# Converts graphviz .dot files into .eps files +# Grayscale is not directly supported by dot, so we pipe it through fig2dev in +# that case. +# $(call convert-dot,<dot file>,<eps file>,<log file>,[gray]) +define convert-dot +$(DOT) -Tps '$1' 2>'$3' $(if $4,| $(call kill-ps-color)) > $2; \ +$(call colorize-dot-errors,$3) +endef + +# Convert DVI to Postscript +# $(call make-ps,<dvi file>,<ps file>,<log file>,[<paper size>]) +make-ps = \ + $(DVIPS) -z -o '$2' $(if $(filter-out BEAMER,$4),-t$(firstword $4),) '$1' \ + $(if $(filter BEAMER,$4),| $(enlarge_beamer)) > $3 2>&1 + +# Convert Postscript to PDF +# $(call make-pdf,<ps file>,<pdf file>,<log file>,<embed file>) +make-pdf = \ + $(call ps2pdf,$1,$2,$(filter 1,$(shell $(CAT) '$4'))) > '$3' 2>&1 + +# Display information about what is being done +# $(call echo-build,<input file>,<output file>,[<run number>]) +echo-build = $(ECHO) "$(C_BUILD)= $1 --> $2$(if $3, ($3),) =$(C_RESET)" +echo-graphic = $(ECHO) "$(C_GRAPHIC)= $1 --> $2 =$(C_RESET)" +echo-dep = $(ECHO) "$(C_DEP)= $1 --> $2 =$(C_RESET)" + +# Display a list of something +# $(call echo-list,<values>) +echo-list = for x in $1; do $(ECHO) "$$x"; done + +# +# DEFAULT TARGET +# + +.PHONY: all +all: $(default_pdf_targets) ; + +.PHONY: all-pdf +all-pdf: $(default_pdf_targets) ; + +ifeq "$(strip $(BUILD_STRATEGY))" "latex" +.PHONY: all-ps +all-ps: $(default_ps_targets) ; + +.PHONY: all-dvi +all-dvi: $(default_dvi_targets) ; +endif + +# +# VIEWING TARGET +# +.PHONY: show +show: all + $(QUIET)for x in $(default_pdf_targets); do \ + [ -e "$$x" ] && $(VIEW_PDF) $$x & \ + done + +# +# INCLUDES +# +source_includes := $(addsuffix .d,$(source_stems_to_include)) +graphic_includes := $(addsuffix .gpi.d,$(graphic_stems_to_include)) + +# Check the version of the makefile +ifneq "" "$(filter 3.79 3.80,$(MAKE_VERSION))" +$(warning $(C_WARNING)Your version of make is too old. Please upgrade.$(C_RESET)) +endif + +# Include only the dependencies used +ifneq "" "$(source_includes)" +include $(source_includes)$(call include-message,$(source_includes)) +endif +ifneq "" "$(graphic_includes)" +include $(graphic_includes)$(call include-message,$(graphic_includes)) +endif + +# +# MAIN TARGETS +# + +# Note that we don't just say %: %.pdf here - this can tend to mess up our +# includes, which detect what kind of file we are asking for. For example, +# asking to build foo.pdf is much different than asking to build foo when +# foo.gpi exists, because we look through all of the goals for *.pdf that +# matches *.gpi, then use that to determine which include files we need to +# build. +# +# Thus, we invoke make recursively with better arugments instead, restarting +# all of the appropriate machinery. +.PHONY: $(default_stems_ss) +$(default_stems_ss): %: %.pdf ; + +# This builds and displays the wanted file. +.PHONY: $(addsuffix ._show,$(stems_ssg)) +$(addsuffix ._show,$(stems_ssg)): %._show: %.pdf + $(QUIET)$(VIEW_PDF) $< & + +ifeq "$(strip $(BUILD_STRATEGY))" "latex" +.SECONDARY: $(all_pdf_targets) +%.pdf: %.ps %.embed.make + $(QUIET)$(call echo-build,$<,$@) + $(QUIET)$(call make-pdf,$<,$@.temp,$@.log,$*.embed.make); \ + if [ x"$$?" = x"0" ]; then \ + $(if $(VERBOSE),$(CAT) $@.log,:); \ + $(RM) -f '$@'; \ + $(MV) '$@.temp' '$@'; \ + $(TOUCH) '$@'; \ + $(call copy-with-logging,$@,$(BINARY_TARGET_DIR)); \ + else \ + $(CAT) $@.log; \ + $(call remove-temporary-files,'$@.temp'); \ + $(sh_false); \ + fi + +.SECONDARY: $(all_ps_targets) +%.ps: %.dvi %.paper.make + $(QUIET)$(call echo-build,$<,$@) + $(QUIET)$(call make-ps,$<,$@.temp,$@.log,\ + $(firstword $(shell $(CAT) $*.paper.make))); \ + if [ x"$$?" = x"0" ]; then \ + $(if $(VERBOSE),$(CAT) $@.log,:); \ + $(RM) -f '$@'; \ + $(MV) '$@.temp' '$@'; \ + $(TOUCH) '$@'; \ + $(call copy-with-logging,$@,$(BINARY_TARGET_DIR)); \ + else \ + $(CAT) $@.log; \ + $(call remove-temporary-files,'$@.temp'); \ + $(sh_false); \ + fi +endif + +# Build the final target (dvi or pdf) file. This is a very tricky rule because +# of the way that latex runs multiple times, needs graphics after the first run +# (or maybe already has them), and relies on bibliographies or indices that may +# not exist. +# +# Check the log for fatal errors. If they exist, colorize and bail. +# +# Create the .auxtarget.cookie file. (Needed for next time if not present) +# +# If any of the following are true, we must rebuild at least one time: +# +# * the .bbl was recently rebuilt +# +# check a cookie, then delete it +# +# * any of several output files was created or changed: +# +# check $*.run.cookie, then delete it +# +# * the .aux file changed in a way that necessitates attention +# +# Note that if the .auxtarget.make file doesn't exist, this means +# that we are doing a clean build, so it doesn't figure into the +# test for running again. +# +# compare against .auxtarget.make +# +# move if different, remove if not +# +# * the .log file has errors or warnings requiring at least one more run +# +# We use a loop over a single item to simplify the process of breaking +# out when we find one of the conditions to be true. +# +# If we do NOT need to run latex here, then we move the $@.1st.make file +# over to $@ because the target file has already been built by the first +# dependency run and is valid. +# +# If we do, we delete that cookie file and do the normal multiple-runs +# routine. +# +ifeq "$(strip $(BUILD_STRATEGY))" "latex" +.SECONDARY: $(all_dvi_targets) +endif +%.$(build_target_extension): %.bbl %.aux %.$(build_target_extension).1st.make + $(QUIET)\ + fatal=`$(call colorize-latex-errors,$*.log)`; \ + if [ x"$$fatal" != x"" ]; then \ + $(ECHO) "$$fatal"; \ + exit 1; \ + fi; \ + $(call make-auxtarget-file,$*.aux.make,$*.auxtarget.cookie); \ + run=0; \ + for i in 1; do \ + if $(call test-exists,$*.bbl.cookie); then \ + run=1; \ + break; \ + fi; \ + if $(call test-exists,$*.run.cookie); then \ + run=1; \ + break; \ + fi; \ + if $(call \ + test-exists-and-different,$*.auxtarget.cookie,$*.auxtarget.make);\ + then \ + run=1; \ + break; \ + fi; \ + if $(call test-log-for-need-to-run,$*); then \ + run=1; \ + break; \ + fi; \ + if [ ! -e $*.1st.*.make ]; then \ + run=1; \ + break; \ + fi; \ + done; \ + $(call remove-temporary-files,$*.bbl.cookie $*.run.cookie); \ + $(MV) $*.auxtarget.cookie $*.auxtarget.make; \ + if [ x"$$run" = x"1" ]; then \ + $(call remove-files,$@.1st.make); \ + for i in 2 3 4 5; do \ + $(if $(findstring 3.79,$(MAKE_VERSION)),\ + $(call echo-build,$*.tex,$@,$(RESTARTS)-$$$$i),\ + $(call echo-build,$*.tex,$@,$(RESTARTS)-$$i)\ + ); \ + $(call run-latex,$*); \ + $(CP) '$*.log' '$*.'$(RESTARTS)-$$i'.log'; \ + $(call test-run-again,$*) || break; \ + done; \ + else \ + $(MV) '$@.1st.make' '$@'; \ + fi; \ + $(call copy-with-logging,$@,$(BINARY_TARGET_DIR)); \ + $(call latex-color-log,$*) + +# Build the .bbl file. When dependencies are included, this will (or will +# not!) depend on something.bib, which we detect, acting accordingly. The +# dependency creation also produces the %.auxbbl.make file. BibTeX is a bit +# finicky about what you call the actual files, but we can rest assured that if +# a .auxbbl.make file exists, then the .aux file does, as well. The +# .auxbbl.make file is a cookie indicating whether the .bbl needs to be +# rewritten. It only changes if the .aux file changes in ways relevant to .bbl +# creation. +# +# Note that we do NOT touch the .bbl file if there is no need to +# create/recreate it. We would like to leave existing files alone if they +# don't need to be changed, thus possibly avoiding a rebuild trigger. +%.bbl: %.auxbbl.make + $(QUIET)\ + $(if $(filter %.bib,$^),\ + $(call echo-build,$(filter %.bib,$?) $*.aux,$@); \ + $(call run-bibtex,$*); \ + $(TOUCH) $@.cookie; \ + ) \ + if $(EGREP) -q 'bibstyle.(apacite|apacann|chcagoa|[^}]*annot)' '$*.aux'; then \ + $(call echo-build,** annotated extra latex **,output ignored,$(RESTARTS)-1); \ + $(call run-latex,$*); \ + $(CP) '$*.log' '$*.$(RESTARTS)-annotated.log'; \ + $(if $(filter %.bib,$^),\ + $(call echo-build,** annotated extra bibtex ** $(filter %.bib,$?) $*.aux,$@); \ + $(call run-bibtex,$*); \ + $(TOUCH) $@.cookie; \ + ) \ + $(call echo-build,** annotated extra latex **,output ignored,$(RESTARTS)-2); \ + $(call run-latex,$*); \ + fi + +# Create the index file - note that we do *not* depend on %.tex here, since +# that unnecessarily restricts the kinds of indices that we can build to those +# with exactly the same stem as the source file. Things like splitidx create +# idx files with other names. +# +# Therefore, we add the .tex dependency in the sourcestem.d file in the call to +# get index file dependencies from the logs. +%.ind: %.idx + $(QUIET)$(call echo-build,$<,$@) + $(QUIET)$(call run-makeindex,$<,$(a),$*.ilg) + +# Create a glossary file from a .ist file +%.gls: %.glo %.tex %.ist + $(QUIET)$(call echo-build,$<,$@) + $(QUIET)$(call run-makeindex,$<,$(a),$*.glg,$*.ist) + +# Create a glossary file from a glossary input formatted for xindy +%.gls: %.glo %.tex %.xdy + $(QUIET)$(call echo-build,$<,$@) + $(QUIET)$(call run-xindy,$<,$(a),$*,$*.glg) + +# Create the glossary file from a nomenclature file +%.gls: %.glo %.tex nomencl.ist + $(QUIET)$(call echo-build,$<,$@) + $(QUIET)$(call run-makeindex,$<,$(a),$*.glg,nomencl.ist) + +# Create the nomenclature file +%.nls: %.nlo %.tex nomencl.ist + $(QUIET)$(call echo-build,$<,$@) + $(QUIET)$(call run-makeindex,$<,$(a),$*.nlg,nomencl.ist) + +# SCRIPTED LaTeX TARGETS +# +# Keep the generated .tex files around for debugging if needed. +.SECONDARY: $(all_tex_targets) + +%.tex:: %.tex.sh + $(QUIET)$(call run-script,$(SHELL),$<,$@) + +%.tex:: %.tex.py + $(QUIET)$(call run-script,$(PYTHON),$<,$@) + +%.tex:: %.tex.pl + $(QUIET)$(call run-script,$(PERL),$<,$@) + +%.tex:: %.rst $(RST_STYLE_FILE) + $(QUIET)\ + $(call run-script,$(RST2LATEX)\ + --documentoptions=letterpaper\ + $(if $(RST_STYLE_FILE),--stylesheet=$(RST_STYLE_FILE),),$<,$@) + +# +# GRAPHICS TARGETS +# +.PHONY: all-graphics +all-graphics: $(all_graphics_targets); + +ifeq "$(strip $(BUILD_STRATEGY))" "latex" +.PHONY: all-pstex +all-pstex: $(all_pstex_targets); +endif + +.PHONY: all-dot2tex +all-dot2tex: $(all_dot2tex_targets); + +.PHONY: show-graphics +show-graphics: all-graphics + $(VIEW_GRAPHICS) $(all_known_graphics) + +$(gray_eps_file): + $(QUIET)$(call echo-build,$^,$@) + $(QUIET)$(call create-gray-eps-file,$@) + +ifeq "$(strip $(BUILD_STRATEGY))" "pdflatex" +%.pdf: %.eps $(if $(GRAY),$(gray_eps_file)) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-eps-to-pdf,$<,$@,$(GRAY)) + +ifeq "$(strip $(GPI_OUTPUT_EXTENSION))" "pdf" +%.pdf: %.gpi %.gpi.d $(gpi_sed) $(gpi_global) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-gpi,$<,$@,$(GRAY)) +endif + +%.pdf: %.fig + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-fig,$<,$@,$(GRAY)) + +%.pdf: %.svg + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-svg,$<,$@,$(GRAY)) +endif + +ifeq "$(strip $(BUILD_STRATEGY))" "xelatex" +%.pdf: %.eps $(if $(GRAY),$(gray_eps_file)) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-eps-to-pdf,$<,$@,$(GRAY)) + +ifeq "$(strip $(GPI_OUTPUT_EXTENSION))" "pdf" +%.pdf: %.gpi %.gpi.d $(gpi_sed) $(gpi_global) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-gpi,$<,$@,$(GRAY)) +endif + +%.pdf: %.fig + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-fig,$<,$@,$(GRAY)) + +endif + + +%.eps: %.gpi %.gpi.d $(gpi_sed) $(gpi_global) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-gpi,$<,$@,$(GRAY)) + +%.eps: %.fig + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-fig,$<,$@,$(GRAY)) + +%.eps: %.dot $(if $(GRAY),$(gray_eps_file)) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-dot,$<,$@,$<.log,$(GRAY)) + +%.eps: %.xvg $(if $(GRAY),$(gray_eps_file)) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-xvg,$<,$@,$(GRAY)) + +ifneq "$(default_graphic_extension)" "pdf" +# We have a perfectly good build rule for svg to pdf, so we eliminate this to +# avoid confusing make (it sometimes chooses to go svg -> eps -> pdf). +%.eps: %.svg $(if $(GRAY),$(gray_eps_file)) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-svg,$<,$@,$(GRAY)) + +# Similarly for these, we don't need eps if we have supported extensions +# already. +%.eps: %.jpg $(if $(GRAY),$(gray_eps_file)) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-jpg,$<,$@,$(GRAY)) + +%.eps: %.jpeg $(if $(GRAY),$(gray_eps_file)) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-jpg,$<,$@,$(GRAY)) + +%.eps: %.png $(if $(GRAY),$(gray_eps_file)) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-png,$<,$@,$(GRAY)) +endif + +%.eps: %.eps.gz $(if $(GRAY),$(gray_eps_file)) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-epsgz,$<,$@,$(GRAY)) + +%.pstex: %.fig + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-fig-pstex,$<,$@,$(GRAY)) + +%.pstex_t: %.fig %.pstex + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-fig-pstex-t,$<,$(a),$*.pstex,$(GRAY)) + +%.dot_t: %.dot + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-dot-tex,$<,$@) + +# +# DEPENDENCY-RELATED TARGETS. +# + +# Generate all of the information needed to get dependencies +# As a side effect, this creates a .dvi or .pdf file (depending on the build +# strategy). We need to be sure to remove it if there are errors. Errors can +# take several forms and all of them are found within the log file: +# * There was a LaTeX error +# * A needed file was not found +# * Cross references need adjustment +# +# Behavior: +# This rule is responsible for generating the following: +# %.aux +# %.d +# %.aux.make +# %.(pdf|dvi).1st.make (the .pdf or .dvi output file, moved) +# +# Steps: +# +# Run latex +# Move .pdf or .dvi somewhere else (make no judgements about success) +# Flatten the .aux file into another file +# Add source dependencies +# Add graphic dependencies +# Add bib dependencies +# +# Create cookies for various suffixes that may represent files that +# need to be read by LaTeX in order for it to function properly. +# +# Note that if some of the dependencies are discovered because they turn +# up missing in the log file, we really need the .d file to be reloaded. +# Adding a sleep command helps with this. Otherwise make is extremely +# nondeterministic, sometimes working, sometimes not. +# +# Usually we can force this by simply removing the generated pdf file and +# not creating a .1st.make file.. +# +%.$(build_target_extension).1st.make %.d %.aux %.aux.make %.fls: %.tex + $(QUIET)$(call echo-build,$<,$*.d $*.$(build_target_extension).1st.make,$(RESTARTS)-1) + $(QUIET)\ + $(call run-latex,$<,-recorder) || $(sh_true); \ + $(CP) '$*.log' '$*.$(RESTARTS)-1.log'; \ + $(call die-on-import-sty,$*.log); \ + $(call die-on-dot2tex,$*.log); \ + $(call die-on-no-aux,$*); \ + $(call flatten-aux,$*.aux,$*.aux.make); \ + $(ECHO) "# vim: ft=make" > $*.d; \ + $(ECHO) ".PHONY: $*._graphics" >> $*.d; \ + $(call get-inputs,$*.fls,$(addprefix $*.,aux aux.make d $(build_target_extension))) >> $*.d; \ + $(call get-missing-inputs,$*.log,$(addprefix $*.,aux aux.make d $(build_target_extension))) >> $*.d; \ + $(ECHO) ".SECONDEXPANSION:" >> $*.d; \ + $(call get-graphics,$*) >> $*.d; \ + $(call get-log-index,$*,$(addprefix $*.,aux aux.make)) >> $*.d; \ + $(call get-bibs,$*.aux.make,$(addprefix $*.,bbl aux aux.make)) >> $*.d; \ + $(EGREP) -q "# MISSING" $*.d && $(SLEEP) 1 && $(RM) $*.pdf; \ + $(call move-if-exists,$*.$(build_target_extension),$*.$(build_target_extension).1st.make); \ + for s in toc out lot lof lol nav; do \ + if [ -e "$*.$$s" ]; then \ + if ! $(DIFF) -q $*.$$s $*.$$s.make >/dev/null 2>&1; then \ + $(TOUCH) $*.run.cookie; \ + fi; \ + $(CP) $*.$$s $*.$$s.make; \ + fi; \ + done + +# This is a cookie that is updated if the flattened aux file has changed in a +# way that affects the bibliography generation. +.SECONDARY: $(addsuffix .auxbbl.make,$(stems_ssg)) +%.auxbbl.make: %.aux.make + $(QUIET)\ + $(call make-auxbbl-file,$<,$@.temp); \ + $(call replace-if-different-and-remove,$@.temp,$@) + +# Build a dependency file for .gpi files. These often plot data files that +# also reside in the directory, so if a data file changes, it's nice to know +# about it. This also handles loaded .gpi files, whose filename should have +# _include_. in it. +%.gpi.d: %.gpi + $(QUIET)$(call echo-build,$<,$@) + $(QUIET)$(call make-gpi-d,$<,$@) + +# Store the paper size for this document -- note that if beamer is used we set +# it to the special BEAMER paper size. We only do this, however, if the +# special comment exists, in which case we enlarge the output with psnup. +# +# The paper size is extracted from a documentclass attribute. +%.paper.make: %.tex + $(QUIET)$(SED) \ + -e '/\\documentclass/,/}/{' \ + -e ' s/%.*//' \ + -e ' H' \ + -e ' /}/{' \ + -e ' s/.*//' \ + -e ' x' \ + -e ' /\\documentclass/!d' \ + -e ' s/[\n[:space:]]*//g' \ + -e ' s/$[,{[]$$[[:alnum:]]\{1,\}$paper$[],}]$/\1%-\2-%\3/g' \ + -e ' s/$[,{[]$$landscape$$[],}]$/\1%-\2-%\3/g' \ + -e ' s/^[^%]*%-//' \ + -e ' s/-%[^%]*$$//' \ + -e ' s/-%[^%]%-/ /g' \ + -e ' p' \ + -e ' }' \ + -e ' d' \ + -e '}' \ + -e 'd' \ + $< > $@; \ + $(EGREP) -q '^[^%]*\\documentclass[^{]*{beamer}' $< && \ + (\ + $(EGREP) -q '^%%[[:space:]]*BEAMER[[:space:]]*LARGE$$' $< && \ + $(ECHO) "BEAMER" > $@ || \ + : > $@ \ + ) || $(sh_true) + +# Store embedding instructions for this document using a special comment +%.embed.make: %.tex + $(QUIET)$(EGREP) '^%%[[:space:]]*NO[[:space:]]*EMBED[[:space:]]*$$' $< \ + && $(ECHO) '' > $@ \ + || $(ECHO) '1' > $@; + +# +# HELPFUL PHONY TARGETS +# + +.PHONY: _all_programs +_all_programs: + $(QUIET)$(ECHO) "== All External Programs Used ==" + $(QUIET)$(call output-all-programs) + +.PHONY: _check_programs +_check_programs: + $(QUIET)$(ECHO) "== Checking Makefile Dependencies =="; $(ECHO) + $(QUIET) \ + allprogs=`\ + ($(call output-all-programs)) | \ + $(SED) \ + -e 's/^[[:space:]]*//' \ + -e '/^#/d' \ + -e 's/[[:space:]]*#.*//' \ + -e '/^=/s/[[:space:]]/_/g' \ + -e '/^[[:space:]]*$$/d' \ + -e 's/^[^=].*=[[:space:]]*$[^[:space:]]\{1,\}$.*$$/\\1/' \ + `; \ + spaces=' '; \ + for p in $${allprogs}; do \ + case $$p in \ + =*) $(ECHO); $(ECHO) "$$p";; \ + *) \ + $(ECHO) -n "$$p:$$spaces" | $(SED) -e 's/^$.\{0,20\}$.*$$/\1/'; \ + loc=`$(WHICH) $$p`; \ + if [ x"$$?" = x"0" ]; then \ + $(ECHO) "$(C_SUCCESS)Found:$(C_RESET) $$loc"; \ + else \ + $(ECHO) "$(C_FAILURE)Not Found$(C_RESET)"; \ + fi; \ + ;; \ + esac; \ + done + +.PHONY: _check_gpi_files +_check_gpi_files: + $(QUIET)$(ECHO) "== Checking all .gpi files for common errors =="; \ + $(ECHO); \ + for f in $(files.gpi); do \ + result=`$(EGREP) '^([^#]*set terminal |set output )' $$f`; \ + $(ECHO) -n "$$f: "; \ + if [ x"$$result" = x"" ]; then \ + $(ECHO) "$(C_SUCCESS)Okay$(C_RESET)"; \ + else \ + $(ECHO) "$(C_FAILURE)Warning: Problematic commands:$(C_RESET)";\ + $(ECHO) "$(C_ERROR)$$result$(C_RESET)"; \ + fi; \ + done; \ + $(ECHO) + +.PHONY: _all_stems +_all_stems: + $(QUIET)$(ECHO) "== All Stems ==" + $(QUIET)$(call echo-list,$(sort $(default_stems_ss))) + +.PHONY: _includes +_includes: + $(QUIET)$(ECHO) "== Include Stems ==" + $(QUIET)$(ECHO) "=== Sources ===" + $(QUIET)$(call echo-list,$(sort $(source_includes))) + $(QUIET)$(ECHO) "=== Graphics ===" + $(QUIET)$(call echo-list,$(sort $(graphic_includes))) + +.PHONY: _all_sources +_all_sources: + $(QUIET)$(ECHO) "== All Sources ==" + $(QUIET)$(call echo-list,$(sort $(all_files.tex))) + +.PHONY: _dependency_graph +_dependency_graph: + $(QUIET)$(ECHO) "/* LaTeX Dependency Graph */" + $(QUIET)$(call output-dependency-graph) + +.PHONY: _show_dependency_graph +_show_dependency_graph: + $(QUIET)$(call output-dependency-graph,$(graph_stem).dot) + $(QUIET)$(DOT) -Tps -o $(graph_stem).eps $(graph_stem).dot + $(QUIET)$(VIEW_POSTSCRIPT) $(graph_stem).eps + $(QUIET)$(call remove-temporary-files,$(graph_stem).*) + +.PHONY: _sources +_sources: + $(QUIET)$(ECHO) "== Sources ==" + $(QUIET)$(call echo-list,$(sort $(files.tex))) + +.PHONY: _scripts +_scripts: + $(QUIET)$(ECHO) "== Scripts ==" + $(QUIET)$(call echo-list,$(sort $(files_scripts))) + +.PHONY: _graphic_outputs +_graphic_outputs: + $(QUIET)$(ECHO) "== Graphic Outputs ==" + $(QUIET)$(call echo-list,$(sort $(all_graphics_targets))) + +.PHONY: _env +_env: +ifdef .VARIABLES + $(QUIET)$(ECHO) "== MAKE VARIABLES ==" + $(QUIET)$(call echo-list,$(foreach var,$(sort $(.VARIABLES)),'$(var)')) +endif + $(QUIET)$(ECHO) "== ENVIRONMENT ==" + $(QUIET)$(ENV) + +# +# CLEAN TARGETS +# +# clean-generated is somewhat unique - it relies on the .fls file being +# properly built so that it can determine which of the files was generated, and +# which was not. Expect it to silently fail if the .fls file is missing. +# +# This is used to, e.g., clean up index files that are generated by the LaTeX. +.PHONY: clean-generated +clean-generated: + $(QUIET)$(call clean-files,$(foreach e,$(addsuffix .fls,$(all_stems_source)),\ + $(shell $(call get-generated-names,$e)))) + +.PHONY: clean-deps +clean-deps: + $(QUIET)$(call clean-files,$(all_d_targets) *.make *.make.temp *.cookie) + +.PHONY: clean-tex +clean-tex: clean-deps + $(QUIET)$(call clean-files,$(rm_tex)) + +.PHONY: clean-graphics +# TODO: This *always* deletes pstex files, even if they were not generated by +# anything.... In other words, if you create a pstex and pstex_t pair by hand +# an drop them in here without the generating fig file, they will be deleted +# and you won't get them back. It's a hack put in here because I'm not sure we +# even want to keep pstex functionality, so my motivation is not terribly high +# for doing it right. +clean-graphics: + $(QUIET)$(call clean-files,$(all_graphics_targets) *.gpi.d *.pstex *.pstex_t *.dot_t) + +.PHONY: clean-backups +clean-backups: + $(QUIET)$(call clean-files,$(backup_patterns) *.temp) + +.PHONY: clean-auxiliary +clean-auxiliary: + $(QUIET)$(call clean-files,$(graph_stem).*) + +.PHONY: clean-nographics +clean-nographics: clean-tex clean-deps clean-backups clean-auxiliary ; + +.PHONY: clean +clean: clean-generated clean-tex clean-graphics clean-deps clean-backups clean-auxiliary ; + +# +# HELP TARGETS +# + +.PHONY: help +help: + $(help_text) + +.PHONY: version +version: + $(QUIET)\ + $(ECHO) "$(fileinfo) Version $(version)"; \ + $(ECHO) "by $(author)"; \ + +# +# HELP TEXT +# + +define help_text +# $(fileinfo) Version $(version) +# +# by $(author) +# +# Generates a number of possible output files from a LaTeX document and its +# various dependencies. Handles .bib files, \include and \input, and .eps +# graphics. All dependencies are handled automatically by running LaTeX over +# the source. +# +# USAGE: +# +# make [GRAY=1] [VERBOSE=1] [SHELL_DEBUG=1] <target(s)> +# +# STANDARD OPTIONS: +# GRAY: +# Setting this variable forces all recompiled graphics to be grayscale. +# It is useful when creating a document for printing. The default is +# to allow colors. Note that it only changes graphics that need to be +# rebuilt! It is usually a good idea to do a 'make clean' first. +# +# VERBOSE: +# This turns off all @ prefixes for commands invoked by make. Thus, +# you get to see all of the gory details of what is going on. +# +# SHELL_DEBUG: +# This enables the -x option for sh, meaning that everything it does is +# echoed to stderr. This is particularly useful for debugging +# what is going on in $$(shell ...) invocations. One of my favorite +# debugging tricks is to do this: +# +# make -d SHELL_DEBUG=1 VERBOSE=1 2>&1 | less +# +# KEEP_TEMP: +# When set, this allows .make and other temporary files to stick around +# long enough to do some debugging. This can be useful when trying to +# figure out why gnuplot is not doing the right things, for example +# (e.g., look for *head.make). +# +# STANDARD AUXILIARY FILES: +# +# Variables.ini (formerly Makefile.ini, which still works) +# +# This file can contain variable declarations that override various +# aspects of the makefile. For example, one might specify +# +# neverclean := *.pdf *.ps +# onlysources.tex := main.tex +# LATEX_COLOR_WARNING := 'bold red uline' +# +# And this would override the neverclean setting to ensure that pdf +# and ps files always remain behind, set the makefile to treat all +# .tex files that are not "main.tex" as includes (and therefore not +# default targets). It also changes the LaTeX warning output to be +# red, bold, and underlined. +# +# There are numerous variables in this file that can be overridden in +# this way. Search for '?=' to find them all. +# +# The Variables.ini is imported before *anything else* is done, so go +# wild with your ideas for changes to this makefile in there. It +# makes it easy to test them before submitting patches. +# +# If you're adding rules or targets, however, see Targets.ini below. +# +# Targets.ini +# +# This is included much later in the makefile, after all variables and +# targets are defined. This is where you would put new make rules, +# e.g., +# +# generated.tex: generating_script.weird_lang depA depB +# ./generating_script.weird_lang > $$@ +# +# In this file, you have access to all of the variables that the +# makefile creates, like $(onlysources.tex). While accessing those can +# be somewhat brittle (they are implementation details and may change), +# it is a great way to test your ideas when submitting feature requests. +# +# STANDARD ENVIRONMENT VARIABLES: +# +# LATEX_COLOR_WARNING '$(LATEX_COLOR_WARNING)' +# LATEX_COLOR_ERROR '$(LATEX_COLOR_ERROR)' +# LATEX_COLOR_UNDERFULL '$(LATEX_COLOR_UNDERFULL)' +# LATEX_COLOR_OVERFULL '$(LATEX_COLOR_OVERFULL)' +# LATEX_COLOR_PAGES '$(LATEX_COLOR_PAGES)' +# LATEX_COLOR_BUILD '$(LATEX_COLOR_BUILD)' +# LATEX_COLOR_GRAPHIC '$(LATEX_COLOR_GRAPHIC)' +# LATEX_COLOR_DEP '$(LATEX_COLOR_DEP)' +# LATEX_COLOR_SUCCESS '$(LATEX_COLOR_SUCCESS)' +# LATEX_COLOR_FAILURE '$(LATEX_COLOR_FAILURE)' +# +# These may be redefined in your environment to be any of the following: +# +# black +# red +# green +# yellow +# blue +# magenta +# cyan +# white +# +# Bold or underline may be used, as well, either alone or in combination +# with colors: +# +# bold +# uline +# +# Order is not important. You may want, for example, to specify: +# +# export LATEX_COLOR_SUCCESS='bold blue uline' +# +# in your .bashrc file. I don't know why, but you may want to. +# +# STANDARD TARGETS: +# +# all: +# Make all possible documents in this directory. The documents are +# determined by scanning for .tex and .tex.sh (described in more detail +# later) and omitting any file that ends in ._include_.tex or +# ._nobuild_.tex. The output is a set of .pdf files. +# +# If you wish to omit files without naming them with the special +# underscore names, set the following near the top of the Makefile, +# or (this is recommended) within a Makefile.ini in the same directory: +# +# includes.tex := file1.tex file2.tex +# +# This will cause the files listed to be considered as include files. +# +# If you have only few source files, you can set +# +# onlysources.tex := main.tex +# +# This will cause only the source files listed to be considered in +# dependency detection. All other .tex files will be considered as +# include files. Note that these options work for *any* source type, +# so you could do something similar with includes.gpi, for example. +# Note that this works for *any valid source* target. All of the +# onlysources.* variables are commented out in the shipping version of +# this file, so it does the right thing when they simply don't exist. +# The comments are purely documentation. If you know, for example, that +# file.mycoolformat is supported by this Makefile, but don't see the +# "onlysources.mycoolformat" declared in the comments, that doesn't mean +# you can't use it. Go ahead and set "onlysources.mycoolformat" and it +# should do the right thing. +# +# show: +# Builds and displays all documents in this directory. It uses the +# environment-overridable value of VIEW_PDF (currently $(VIEW_PDF)) to +# do its work. +# +# all-graphics: +# Make all of the graphics in this directory. +# +# all-pstex (only for BUILD_STRATEGY=latex): +# Build all fig files into pstex and pstex_t files. Gray DOES NOT WORK. +# +# all-gray-pstex (only for BUILD_STRATEGY=latex): +# Build all fig files into grayscale pstex and pstex_t files. +# +# all-dot2tex: +# Build all dot files into tex files. +# +# show-graphics: +# Builds and displays all graphics in this directory. Uses the +# environment-overridable value of VIEW_GRAPHICS (currently +# $(VIEW_GRAPHICS)) to do its work. +# +# clean: +# Remove ALL generated files, leaving only source intact. +# This will *always* skip files mentioned in the "neverclean" variable, +# either in this file or specified in Makefile.ini: +# +# neverclean := *.pdf *.ps +# +# The neverclean variable works on all "clean" targets below, as well. +# +# clean-graphics: +# Remove all generated graphics files. +# +# clean-backups: +# Remove all backup files: $(backup_patterns) +# (XFig and other editors have a nasty habit of leaving them around) +# Also removes Makefile-generated .temp files +# +# clean-tex: +# Remove all files generated from LaTeX invocations except dependency +# information. Leaves graphics alone. +# +# clean-deps: +# Removes all auto-generated dependency information. +# +# clean-auxiliary: +# Removes extra files created by various targets (like the dependency +# graph output). +# +# clean-nographics: +# Cleans everything *except* the graphics files. +# +# help: +# This help text. +# +# version: +# Version information about this LaTeX makefile. +# +# DEBUG TARGETS: +# +# _all_programs: +# A list of the programs used by this makefile. +# +# _check_programs: +# Checks your system for the needed software and reports what it finds. +# +# _check_gpi_files: +# Checks the .gpi files in the current directory for common errors, such +# as specification of the terminal or output file inside of the gpi file +# itself. +# +# _dependency_graph: +# Outputs a .dot file to stdout that represents a graph of LaTeX +# dependencies. To see it, use the _show_dependency_graph target or +# direct the output to a file, run dot on it, and view the output, e.g.: +# +# make _dependency_graph > graph.dot +# dot -T ps -o graph.eps graph.dot +# gv graph.eps +# +# _show_dependency_graph: +# Makes viewing the graph simple: extracts, builds and displays the +# dependency graph given in the _dependency_graph target using the value +# of the environment-overridable VIEW_POSTSCRIPT variable (currently set +# to $(VIEW_POSTSCRIPT)). The postscript viewer is used because it +# makes it easier to zoom in on the graph, a critical ability for +# something so dense and mysterious. +# +# _all_sources: +# List all .tex files in this directory. +# +# _sources: +# Print out a list of all compilable sources in this directory. This is +# useful for determining what make thinks it will be using as the +# primary source for 'make all'. +# +# _scripts: +# Print out a list of scripts that make knows can be used to generate +# .tex files (described later). +# +# _all_stems: +# Print a list of stems. These represent bare targets that can be +# executed. Listing <stem> as a bare target will produce <stem>.pdf. +# +# _includes: +# A list of .d files that would be included in this run if _includes +# weren't specified. This target may be used alone or in conjunction +# with other targets. +# +# _graphic_outputs: +# A list of all generated .eps files +# +# _env: +# A list of environment variables and their values. If supported by +# your version of make, also a list of variables known to make. +# +# FILE TARGETS: +# +# %, %.pdf: +# Build a PDF file from the corresponding %.tex file. +# +# If BUILD_STRATEGY=pdflatex, then this builds the pdf directly. +# Otherwise, it uses this old-school but effective approach: +# +# latex -> dvips -> ps2pdf +# +# The BUILD_STRATEGY can be overridden in Makefile.ini in the same +# directory. The default is pdflatex. +# +# Reasons for using latex -> dvips include the "psfrag" package, and the +# generation of postscript instead of PDF. Arguments for using pdflatex +# include "new and shiny" and "better supported." I can't argue with +# either of those, and supporting them both didn't turn out to be that +# difficult, so there you have it. Choices. +# +# %._show: +# A phony target that builds the pdf file and then displays it using the +# environment-overridable value of VIEW_PDF ($(VIEW_PDF)). +# +# %._graphics: +# A phony target that generates all graphics on which %.pdf (or %.dvi) +# depends. +# +# %.ps (only for BUILD_STRATEGY=latex): +# Build a Postscript file from the corresponding %.tex file. +# This is done using dvips. Paper size is automatically +# extracted from the declaration +# +# \documentclass[<something>paper] +# +# or it is the system default. +# +# If using beamer (an excellent presentation class), the paper +# size is ignored. More on this later. +# +# %.dvi (only for BUILD_STRATEGY=latex): +# Build the DVI file from the corresponding %.tex file. +# +# %.ind: +# Build the index for this %.tex file. +# +# %.gls: +# Build the nomenclature glossary for this %.tex file. +# +# %.nls: +# Build the (newer) nomenclature file for this %.tex file. +# +# %.eps: +# Build an eps file from one of the following file types: +# +# .dot : graphviz +# .gpi : gnuplot +# .fig : xfig +# .xvg : xmgrace +# .svg : scalable vector graphics (goes through inkscape) +# .png : png (goes through NetPBM) +# .jpg : jpeg (goes through ImageMagick) +# .eps.gz : gzipped eps +# +# The behavior of this makefile with each type is described in +# its own section below. +# +# %.pstex{,_t} (only for BUILD_STRATEGY=latex): +# Build a .pstex_t file from a .fig file. +# +# FEATURES: +# +# Optional Binary Directory: +# If you create the _out_ directory in the same place as the makefile, +# it will automatically be used as a dumping ground for .pdf (or .dvi, +# .ps, and .pdf) output files. +# +# Alternatively, you can set the BINARY_TARGET_DIR variable, either as a +# make argument or in Makefile.ini, to point to your directory of +# choice. Note that no pathname wildcard expansion is done in the +# makefile, so make sure that the path is complete before going in +# there. E.g., if you want to specify something in your home directory, +# use $$HOME/ instead of ~/ so that the shell expands it before it gets +# to the makefile. +# +# External Program Dependencies: +# Every external program used by the makefile is represented by an +# ALLCAPS variable at the top of this file. This should allow you to +# make judgments about whether your system supports the use of this +# makefile. The list is available in the ALL_PROGRAMS variable and, +# provided that you are using GNU make 3.80 or later (or you haven't +# renamed this file to something weird like "mylatexmakefile" and like +# invoking it with make -f) can be viewed using +# +# make _all_programs +# +# Additionally, the availability of these programs can be checked +# automatically for you by running +# +# make _check_programs +# +# The programs are categorized according to how important they are and +# what function they perform to help you decide which ones you really +# need. +# +# Colorized Output: +# The output of commands is colorized to highlight things that are often +# important to developers. This includes {underfull,overfull} +# {h,v}boxes, general LaTeX Errors, each stage of document building, and +# the number of pages in the final document. The colors are obtained +# using 'tput', so colorization should work pretty well on any terminal. +# +# The colors can be customized very simply by setting any of the +# LATEX_COLOR_<CONTEXT> variables in your environment (see above). +# +# Predecessors to TeX Files: +# Given a target <target>, if no <target>.tex file exists but a +# corresponding script or predecessor file exists, then appropriate +# action will be taken to generate the tex file. +# +# Currently supported script or predecessor languages are: +# +# sh: %.tex.sh +# perl: %.tex.pl +# python: %.tex.py +# +# Calls the script using the appropriate interpreter, assuming that +# its output is a .tex file. +# +# The script is called thus: +# +# <interpreter> <script file name> <target tex file> +# +# and therefore sees exactly one parameter: the name of the .tex +# file that it is to create. +# +# Why does this feature exist? I ran into this while working on +# my paper dissertation. I wrote a huge bash script that used a +# lot of sed to bring together existing papers in LaTeX. It +# would have been nice had I had something like this to make my +# life easier, since as it stands I have to run the script and +# then build the document with make. This feature provides hooks +# for complicated stuff that you may want to do, but that I have +# not considered. It should work fine with included dependencies, +# too. +# +# Scripts are run every time make is invoked. Some trickery is +# employed to make sure that multiple restarts of make don't cause +# them to be run again. +# +# reST: %.rst +# +# Runs the reST to LaTeX converter to generate a .tex file +# If it finds a file names _rststyle_._include_.tex, uses it as +# the "stylesheet" option to rst2latex. +# +# Note that this does not track sub-dependencies in rst files. It +# assumes that the top-level rst file will change if you want a +# rebuild. +# +# Dependencies: +# +# In general, dependencies are extracted directly from LaTeX output on +# your document. This includes +# +# * Bibliography information +# * \include or \input files (honoring \includeonly, too) +# * Graphics files inserted by the graphicx package +# +# Where possible, all of these are built correctly and automatically. +# In the case of graphics files, these are generated from the following +# file types: +# +# GraphViz: .dot +# GNUPlot: .gpi +# XFig: .fig +# XMgrace: .xvg +# SVG: .svg +# PNG: .png +# JPEG: .jpg +# GZipped EPS: .eps.gz +# +# If the file exists as a .eps already, it is merely used (and will not +# be deleted by 'clean'!). +# +# LaTeX and BibTeX are invoked correctly and the "Rerun to get +# cross-references right" warning is heeded a reasonable number of +# times. In my experience this is enough for even the most troublesome +# documents, but it can be easily changed (if LaTeX has to be run after +# BibTeX more than three times, it is likely that something is moving +# back and forth between pages, and no amount of LaTeXing will fix +# that). +# +# \includeonly is honored by this system, so files that are not +# specified there will not trigger a rebuild when changed. +# +# Beamer: +# A special TeX source comment is recognized by this makefile (only when +# BUILD_STRATEGY=latex, since this invokes psnup): +# +# %%[[:space:]]*BEAMER[[:space:]]*LARGE +# +# The presence of this comment forces the output of dvips through psnup +# to enlarge beamer slides to take up an entire letter-sized page. This +# is particularly useful when printing transparencies or paper versions +# of the slides. For some reason landscape orientation doesn't appear +# to work, though. +# +# If you want to put multiple slides on a page, use this option and then +# print using mpage, a2ps, or psnup to consolidate slides. My personal +# favorite is a2ps, but your mileage may vary. +# +# When beamer is the document class, dvips does NOT receive a paper size +# command line attribute, since beamer does special things with sizes. +# +# GNUPlot Graphics: +# When creating a .gpi file, DO NOT INCLUDE the "set terminal" or "set +# output" commands! The makefile will include terminal information for +# you. Besides being unnecessary and potentially harmful, including the +# terminal definition in the .gpi file makes it harder for you, the one +# writing the document, to preview your graphics, e.g., with +# +# gnuplot -persist myfile.gpi +# +# so don't do specify a terminal or an output file in your .gpi files. +# +# When building a gpi file into an eps file, there are several features +# available to the document designer: +# +# Global Header: +# The makefile searches for the files in the variable GNUPLOT_GLOBAL +# in order: +# +# ($(GNUPLOT_GLOBAL)) +# +# Only the first found is used. All .gpi files in the directory are +# treated as though the contents of GNUPLOT_GLOBAL were directly +# included at the top of the file. +# +# NOTE: This includes special comments! (see below) +# +# Font Size: +# A special comment in a .gpi file (or a globally included file) of +# the form +# +# ## FONTSIZE=<number> +# +# will change the font size of the GPI output. If font size is +# specified in both the global file and the GPI file, the +# specification in the individual GPI file is used. +# +# Grayscale Output: +# GNUplot files also support a special comment to force them to be +# output in grayscale *no matter what*: +# +# ## GRAY +# +# This is not generally advisable, since you can always create a +# grayscale document using the forms mentioned above. But, if your +# plot simply must be grayscale even in a document that allows +# colors, this is how you do it. +# +# XFig Graphics: +# No special handling is done with XFig, except when a global +# grayscale method is used, e.g. +# +# make GRAY=1 document +# +# In these cases the .eps files is created using the -N switch to +# fig2dev to turn off color output. (Only works with eps, not pstex +# output) +# +# GraphVis Graphics: +# Color settings are simply ignored here. The 'dot' program is used +# to transform a .dot file into a .eps file. +# +# If you want, you can use the dot2tex program to convert dot files +# to tex graphics. The default is to just call dot2tex with no +# arguments, but you can change the DOT2TEX definition to include +# options as needed (in your Makefile.ini). +# +# Note that, as with pstex, the makefile cannot use latex's own +# output to discover all missing dot_t (output) files, since anytime +# TeX includes TeX, it has to bail when it can't find the include +# file. It can therefore only stop on the first missing file it +# discovers, and we can't get a large list of them out easily. +# +# So, the makefile errors out if it's missing an included dot_t +# file, then prompts the user to run this command manually: +# +# make all-dot2tex +# +# GZipped EPS Graphics: +# +# A .eps.gz file is sometimes a nice thing to have. EPS files can get +# very large, especially when created from bitmaps (don't do this if you +# don't have to). This makefile will unzip them (not in place) to +# create the appropriate EPS file. +# +# +endef + +# +# DEPENDENCY CHART: +# +# digraph "g" { +# rankdir=TB +# size="9,9" +# edge [fontsize=12 weight=10] +# node [shape=box fontsize=14 style=rounded] +# +# eps [ +# shape=Mrecord +# label="{{<gpi> GNUplot|<epsgz> GZip|<dot> Dot|<fig> XFig}|<eps> eps}" +# ] +# pstex [label="%.pstex"] +# pstex_t [label="%.pstex_t"] +# tex_outputs [shape=point] +# extra_tex_files [shape=point] +# gpi_data [label="<data>"] +# gpi_includes [label="_include_.gpi"] +# aux [label="%.aux"] +# fls [label="%.fls"] +# idx [label="%.idx"] +# glo [label="%.glo"] +# ind [label="%.ind"] +# log [label="%.log"] +# tex_sh [label="%.tex.sh"] +# rst [label="%.rst"] +# tex [ +# shape=record +# label="<tex> %.tex|<include> _include_.tex" +# ] +# include_aux [label="_include_.aux"] +# file_bib [label=".bib"] +# bbl [label="%.bbl"] +# dvi [label="%.dvi"] +# ps [label="%.ps"] +# pdf [label="%.pdf"] +# fig [label=".fig"] +# dot [label=".dot"] +# gpi [label=".gpi"] +# eps_gz [label=".eps.gz"] +# +# gpi_files [shape=point] +# +# rst -> tex:tex [label="reST"] +# tex_sh -> tex:tex [label="sh"] +# tex_pl -> tex:tex [label="perl"] +# tex_py -> tex:tex [label="python"] +# tex -> tex_outputs [label="latex"] +# tex_outputs -> dvi +# tex_outputs -> aux +# tex_outputs -> log +# tex_outputs -> fls +# tex_outputs -> idx +# tex_outputs -> include_aux +# aux -> bbl [label="bibtex"] +# file_bib -> bbl [label="bibtex"] +# idx -> ind [label="makeindex"] +# glo -> gls [label="makeindex"] +# nlo -> nls [label="makeindex"] +# gls -> extra_tex_files +# nls -> extra_tex_files +# ind -> extra_tex_files +# bbl -> extra_tex_files +# eps -> extra_tex_files +# extra_tex_files -> dvi [label="latex"] +# gpi_files -> eps:gpi [label="gnuplot"] +# gpi -> gpi_files +# gpi_data -> gpi_files +# gpi_includes -> gpi_files +# eps_gz -> eps:epsgz [label="gunzip"] +# fig -> eps:fig [label="fig2dev"] +# fig -> pstex [label="fig2dev"] +# fig -> pstex_t [label="fig2dev"] +# pstex -> pstex_t [label="fig2dev"] +# dot -> eps:dot [label="dot"] +# dvi -> ps [label="dvips"] +# include_aux -> bbl [label="bibtex"] +# ps -> pdf [label="ps2pdf"] +# +# edge [ color=blue label="" style=dotted weight=1 fontcolor=blue] +# fls -> tex:include [label="INPUT: *.tex"] +# fls -> file_bib [label="INPUT: *.aux"] +# aux -> file_bib [label="\\bibdata{...}"] +# include_aux -> file_bib [label="\\bibdata{...}"] +# log -> gpi [label="Graphic file"] +# log -> fig [label="Graphic file"] +# log -> eps_gz [label="Graphic file"] +# log -> dot [label="Graphic file"] +# log -> idx [label="No file *.ind"] +# log -> glo [label="No file *.gls"] +# log -> nlo [label="No file *.nls"] +# gpi -> gpi_data [label="plot '...'"] +# gpi -> gpi_includes [label="load '...'"] +# tex:tex -> ps [label="paper"] +# tex:tex -> pdf [label="embedding"] +# } +# + +# +# DEPENDENCY CHART SCRIPT +# +# $(call output_dependency_graph,[<output file>]) +define output-dependency-graph + if [ -f '$(this_file)' ]; then \ + $(SED) \ + -e '/^[[:space:]]*#[[:space:]]*DEPENDENCY CHART:/,/^$$/!d' \ + -e '/DEPENDENCY CHART/d' \ + -e '/^$$/d' \ + -e 's/^[[:space:]]*#//' \ + $(this_file) $(if $1,> '$1',); \ + else \ + $(ECHO) "Cannot determine the name of this makefile."; \ + fi +endef +# +.PHONY: Targets.ini $(HOME)/.latex-makefile/Targets.ini +-include Targets.ini +-include $(HOME)/.latex-makefile/Targets.ini +# +# vim: noet sts=0 sw=8 ts=8 + diff --git a/2012/datagram-testing-plan/Targets.ini b/2012/datagram-testing-plan/Targets.ini new file mode 100644 index 0000000..d7c8d16 --- /dev/null +++ b/2012/datagram-testing-plan/Targets.ini @@ -0,0 +1,4 @@ +datagram-testing-plan.d: vc._include_.tex + +vc._include_.tex: datagram-testing-plan.tex datagram-testing-plan.bib + ./vc -m && mv vc.tex $@ diff --git a/2012/datagram-testing-plan/datagram-testing-plan.bib b/2012/datagram-testing-plan/datagram-testing-plan.bib new file mode 100644 index 0000000..e30cfcb --- /dev/null +++ b/2012/datagram-testing-plan/datagram-testing-plan.bib @@ -0,0 +1,24 @@ +@inproceedings{experimentor, + title={Experimen{T}or: A Testbed for Safe and Realistic {T}or Experimentation}, + author={Kevin Bauer and Micah Sherr and Damon McCoy and Dirk Grunwald}, + booktitle={4th USENIX Workshop on Cyber Security Experimentation and Test}, + month={August}, + year={2011}, + note={\url{http://crysp.uwaterloo.ca/software/exptor/}}, +} + +@inproceedings{shadow, + title={Shadow: Running {T}or in a Box for Accurate and Efficient Experimentation}, + author={Rob Jansen and Nicholas Hopper}, + booktitle={Symposium on Network and Distributed System Security (NDSS)}, + year={2012}, + note={\url{http://shadow.cs.umn.edu/}}, +} + +@techreport{datagram-comparison, + title={Comparison of {T}or Datagram Designs}, + author={Murdoch, Steven J.}, + note={\url{https://www.cl.cam.ac.uk/~sjm217/papers/tor11datagramcomparison.pdf}}, + month={November}, + year={2011}, +} diff --git a/2012/datagram-testing-plan/datagram-testing-plan.tex b/2012/datagram-testing-plan/datagram-testing-plan.tex new file mode 100644 index 0000000..b285a6c --- /dev/null +++ b/2012/datagram-testing-plan/datagram-testing-plan.tex @@ -0,0 +1,150 @@ +\documentclass[a4paper,withtimes]{easychair} + +\usepackage{doc} +\usepackage{upgreek} +\usepackage{xspace} +\usepackage{fancyhdr} +\usepackage{color} +\usepackage{graphicx} +\input{vc._include_.tex} + +\usepackage{prettyref} +%% Non-breaking space should really be used +\newrefformat{sec}{Section~\ref{#1}} +%% Page numbers seem a bit redundant in a short paper +\newrefformat{tab}{Table~\ref{#1}} +\newrefformat{fig}{Figure~\ref{#1}} +\newrefformat{cha}{Chapter~\ref{#1}} +\newrefformat{app}{Appendix~\ref{#1}} + +\makeatletter +\newcommand{\ie}{i.e.\@\xspace} +\newcommand{\eg}{e.g.\@\xspace} +\newcommand{\etc}{etc.\@\xspace} +\newcommand{\cf}{cf.\@\xspace} +\newcommand{\vs}{vs.\@\xspace} +\newcommand{\wrt}{w.r.t.\@\xspace} +\newcommand{\etal}{\textit{et al.\@\xspace}} +\newcommand{\detal}{\textit{et al.}} +\newcommand{\ia}{inter alia\xspace} +\makeatother + +\pagestyle{fancy} +\fancyhf{} + +\fancyhead[C]{\sc revision \VCRevisionMod~(\VCDateISO~\VCTime)} +\fancyfoot[C]{\thepage} + +\begin{document} + +\title{Datagram Testing Plan} + +\author{Steven J. Murdoch} + +\date{\VCDateISO} + +% \authorrunning{} has to be set for the shorter version of the authors' names; +% otherwise a warning will be rendered in the running heads. +% +\authorrunning{Murdoch} +\titlerunning{Datagram Testing Plan} + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\maketitle +\thispagestyle{empty} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%------------------------------------------------------------------------------ +% Abstract +% + +%------------------------------------------------------------------------------ +\section{Introduction} +\label{sec:introduction} + +This document discusses current considerations and plans for evaluating approaches for moving to a datagram transport in Tor. +For background, refer to Murdoch~\cite{datagram-comparison}. + +\subsection{Simulation vs Emulation} + +An important design choice for the experiments is whether we run experiments on simulated Tor software, or on the real (but modified) Tor implementation. +The advantage of the former is that it should be easier: only the timing of cells needs to be simulated and nodes have full visibility of the state of other nodes. +The advantage of the latter is that the simulation is more realistic. + +In the absence of a suitable model of Tor, it has been decided to modify the existing Tor implementation. +The Tor network can then be emulated using ExperimenTor~\cite{experimentor} and Shadow~\cite{shadow}. +This does require implementing a datagram variant of Tor sufficiently well to allow clients to route traffic with realistic performance characteristics. + +\subsection{End-to-end vs Hop-by-hop} + +A design choice for a datagram variant of Tor is the end points of the reliability protocol. +Options include OP to destination server (\ie Tor routes IP packets), OP to exit node (\ie the exit node reassembles TCP streams and re-segments them), or hop-by-hop (\ie each node re-assembles streams). +OP to destination server is the most versatile, but makes implementing exit-policies difficult. +OP to exit node is the closest approximation of the end-to-end principle for Internet design, but means that any dropped packet will need to be retransmitted all the way along the circuit. +Hop-by-hop is not as versatile as either of the end-to-end variants, but by providing a reliable tunnel to all nodes it means that Tor's existing cell cryptography and relay protocol could remain unchanged. + +The ease of implementation, coupled with the fact that evaluation has shown good results from the hop-by-hop approach make it the most suitable for further development. +End-to-end variants may however still be worthwhile to examing if time is available. + +\subsection{Transport Protocol} + +Reardon's original implementation used the TCP Daytona stack, which is not available under a Tor compatible license and so cannot be used. +However there are a number of more suitable alternatives. + +\subsubsection{$\upmu$tp} + +The libutp implementation is widely deployed in BitTorrent, although its performance goal of yielding to TCP is not ideal. + +\subsubsection{FreeBSD network stack} + +The FreeBSD network stack is being ported to userspace by Kip Macy, and will provide TCP and SCTP. + +\subsubsection{SCTP} + +A userspace SCTP stack is available\footnote{\url{http://sctp.fh-muenster.de/sctp-user-land-stack.html}}. + +\subsubsection{CurveCP} + +The CurveCP stack is available, although has not had as extensive testing as the other options. + +\section{Development plans} + +Future plans will need to encompass four areas. + +\subsection{Network model} + +A model of the simulated Tor network will need to be developed. +This should include node characteristics (CPU, possibly memory) and network characteristics (capacity, latency, other traffic usage). + +\subsection{User/server model} + +A model will need to be developed of the demands users put on the network, and how servers respond to requests. + +\subsection{Tor implementation} + +Tor will need to be updated to use each of the transport protocols to be tested. + +\subsection{Metrics and Experimentation} + +Finally, performance metrics will need to be developed, and experiments run. + +\section{Schedule and participants} + +Participants who have offered to help are: +\begin{itemize} +\item Rob Jansen (Shadow) working with Kevin Bauer (ExperimenTor) on modeling Tor. +\item Kevin and Mashael AlSabah will be getting Joel Reardon's code working on current Tor +\item Rob will be focusing on hop-by-hop transports, starting with $\upmu$TP. He is currently busy on another project, but will be able to return in early May. +\item Mashael will focus on end-to-end transports, including analyzing how it affects security +\item Steven Murdoch will try to pull everything together and do everything else +\end{itemize} + + +\label{sec:bib} +\bibliographystyle{plain} +%\bibliographystyle{alpha} +%\bibliographystyle{unsrt} +%\bibliographystyle{abbrv} +\bibliography{datagram-testing-plan} +\end{document} + +% EOF diff --git a/2012/datagram-testing-plan/easychair.cls b/2012/datagram-testing-plan/easychair.cls new file mode 100755 index 0000000..47e0ee3 --- /dev/null +++ b/2012/datagram-testing-plan/easychair.cls @@ -0,0 +1,756 @@ +% +% Some credits +% + +\def\easychairstyleauthor{easychair class style, by Serguei A. Mokhov, with changes by Andrei Voronkov <24 October 2011>} +\def\easychairstylerevision{CVS Revision: $Id: easychair.cls,v 3.0 2011/10/24 20:26:32 voronkov Exp $} +\def\easychairstylepurpose{Designed for EasyChair.org, under guidelines and suggestions of} +\def\easychairstylevoronkov{\space\space\space\space\space\space\space\space\space\space\space\space\space Andrei Voronkov <www.voronkov.com>, and} +\def\easychairstylesutcliffe{\space\space\space\space\space\space\space\space\space\space\space\space\space Geoff Sutcliffe <www.cs.miami.edu/^geoff>} +\def\easychairstylecopyright{Copyright terms are that of EasyChair.org} +\def\easychairstylebugs{For bug reports, please contact <andrei(a)voronkov.com>} + +\everyjob{\typeout{\easychairstyleauthor}} +\everyjob{\typeout{\easychairstylerevision}} +\everyjob{\typeout{\easychairstylepurpose}} +\everyjob{\typeout{\easychairstylevoronkov}} +\everyjob{\typeout{\easychairstylesutcliffe}} +\everyjob{\typeout{\easychairstylecopyright}} +\everyjob{\typeout{\easychairstylebugs}} + +\immediate\write10{\easychairstyleauthor} +\immediate\write10{\easychairstylerevision} +\immediate\write10{\easychairstylepurpose} +\immediate\write10{\easychairstylevoronkov} +\immediate\write10{\easychairstylesutcliffe} +\immediate\write10{\easychairstylecopyright} +\immediate\write10{\easychairstylebugs} + +% +% Require LaTeX 2.09 or later +% + +\NeedsTeXFormat{LaTeX2e}[1995/12/01] +\ProvidesClass{easychair}[2011/05/02 v3.0] +\def\@tempa#1#2\@nil{\edef\@classname{#1}} +\expandafter\@tempa\@currnamestack{}{}{}\@nil +\ifx\@classname\@empty \edef\@classname{\@currname}\fi + + +% +% Debug +% + +\def\easychairdebug#1{\gdef\@EasyDebug{#1}} +\def\@EasyDebug{} + +\newif\ifdebug +\debugfalse + +\DeclareOption{debug}{\debugtrue} + +\def\easychairframe#1{\gdef\@EasyFrame{#1}} +\def\@EasyFrame{} + +\newif\ifframe +\framefalse + +\DeclareOption{frame}{\frametrue} + +\def\easychairverbose#1{\gdef\@EasyVerbose{#1}} +\def\@EasyVerbose{} + +\newif\ifverbose +\verbosefalse + +\DeclareOption{verbose}{\verbosetrue} + + +% +% Thesis +% Perh Geoff, February 23, 2010 with support from Andrei +% + +\def\easythesis#1{\gdef\@EasyThesis{#1}} +\def\@EasyThesis{} + +\newif\ifthesis +\thesisfalse + +\DeclareOption{thesis}{\thesistrue} + + +% +% Times New Roman or not +% + +\def\easytimes#1{\gdef\@EasyTimes{#1}} +\def\@EasyTimes{} + +\newif\ifnotimes +\notimesfalse + +\DeclareOption{notimes}{\notimestrue} + +\newif\ifwithtimes +\withtimesfalse + +\DeclareOption{withtimes}{\withtimestrue} + + +\newif\ifauthorundefined +\authorundefinedtrue + +\let\oldauthor=\author +\renewcommand + {\author} + [1] + {% + \ifauthorundefined + \oldauthor{#1} + \authorundefinedfalse + \else + \PackageWarning{easychair}{Another use of author ignored} + \fi + } + +\newif\iftitleundefined +\titleundefinedtrue + +\let\oldtitle=\title +\renewcommand + {\title} + [1] + { + \iftitleundefined + \oldtitle{#1} + \titleundefinedfalse + \else + \PackageWarning{easychair}{Another use of title ignored} + \fi + } + + +% +% Running heads definitions +% + +%\def\titlerunning#1{\gdef\@titleRunning{#1}} +%\def\authorrunning#1{\gdef\@authorRunning{#1}} +%\titlerunning{easychair: Running title head is undefined.} +%\authorrunning{easychair: Running author head is undefined.} + +\newif\iftitlerunningundefined +\titlerunningundefinedtrue + +\newif\ifauthorrunningundefined +\authorrunningundefinedtrue + +\gdef\@titleRunning{easychair: Running title head is undefined.} +\gdef\@authorRunning{easychair: Running author head is undefined.} + +\def\titlerunning#1 +{ + \iftitlerunningundefined + \gdef\@titleRunning{#1} + \titlerunningundefinedfalse + \else + \PackageWarning{easychair}{Another use of titlerunning ignored} + \fi +} + +\def\authorrunning#1 +{ + \ifauthorrunningundefined + \gdef\@authorRunning{#1} + \authorrunningundefinedfalse + \else + \PackageWarning{easychair}{Another use of authorrunning ignored} + \fi +} + +% +% Affiliations +% + +\newcommand{\affiliation}[1]{\small{#1}\vspace{-3pt}} + + +% +% Decide between letter and A4 paper formats +% as well as orientation +% + +% Default is 'letterpaper' +\def\paperformat#1{\gdef\@PaperFormat{#1}} +\def\@PaperFormat{letterpaper} + +\newif\ifletterpaper +\newif\ifafourpaper +\newif\ifcustompaper + +\letterpapertrue + +\DeclareOption{letterpaper}{\paperformat{letterpaper}\afourpaperfalse\custompaperfalse} +\DeclareOption{a4paper}{\paperformat{a4paper}\afourpapertrue\letterpaperfalse\custompaperfalse} +\DeclareOption{custompaper}{\paperformat{letterpaper}\afourpaperfalse\letterpaperfalse\custompapertrue} + + +\newlength{\@LMarginSize} +\newlength{\@RMarginSize} +\newlength{\@TMarginSize} +\newlength{\@BMarginSize} + +\DeclareOption{lmargin}{} +\DeclareOption{rmargin}{} +\DeclareOption{tmargin}{} +\DeclareOption{bmargin}{} + + +% Default is portrait {} +\def\paperorientation#1{\gdef\@PaperOrientation{#1}} +\def\@PaperOrientation{} + +\DeclareOption{portrait}{\paperorientation{}} +\DeclareOption{landscape}{\paperorientation{landscape}} + +% Two sided running heads for titlerunning and author running +% twosided is the default +\newif\iftwosided +\twosidedfalse + +\DeclareOption{onesided}{} +\DeclareOption{twosided}{\twosidedtrue} + + +% +% Decide between 1- or 2-column formats +% + +\def\columnCount#1{\gdef\@ColumnCount{#1}} +\def\@ColumnCount{onecolumn} + +\DeclareOption{onecolumn}{} +\DeclareOption{twocolumn}{\columnCount{twocolumn}} + + +% +% Decide on line spacing +% + +\def\lineSpacing#1{\gdef\@LineSpacing{#1}} +\def\(a)LineSpacing{1.0} + +\DeclareOption{zerospacing}{\lineSpacing{0.0}} +\DeclareOption{singlespacing}{\lineSpacing{1.0}} +\DeclareOption{lineandhalfspacing}{\lineSpacing{1.5}} +\DeclareOption{doublespacing}{\lineSpacing{2.0}} + +\DeclareOption{0.0}{\lineSpacing{0.0}} +\DeclareOption{1.0}{\lineSpacing{1.0}} +\DeclareOption{1.5}{\lineSpacing{1.5}} +\DeclareOption{2.0}{\lineSpacing{2.0}} + +\DeclareOption{0.0pt}{\lineSpacing{0.0}} +\DeclareOption{1.0pt}{\lineSpacing{1.0}} +\DeclareOption{1.5pt}{\lineSpacing{1.5}} +\DeclareOption{2.0pt}{\lineSpacing{2.0}} + + +% +% Font point size; default is 10pt +% +% The \headheight will have to be changed later accordingly +% such that fancyhdr does not complain it is too small. +% + +\def\baseFontSize#1{\gdef\@BaseFontSize{#1}} +\def\headHeightSize#1{\gdef\@HeadHeightSize{#1}} +\def\headSepSize#1{\gdef\@HeadSepSize{#1}} +\def\footSkipSize#1{\gdef\@FootSkipSize{#1}} + +\def\@BaseFontSize{10pt} +\def\(a)HeadHeightSize{12.0pt} +\def\(a)HeadSepSize{16.0pt} % instead of the default 25pt +\def\(a)FootSkipSize{26.0pt} % instead of the default 30pt + +\DeclareOption{8pt}{\PackageWarning{easychair}{Option '\CurrentOption' is not supported.}} +\DeclareOption{9pt}{\PackageWarning{easychair}{Option '\CurrentOption' is not supported.}} +\DeclareOption{10pt}{\baseFontSize{10pt}\headHeightSize{12.0pt}\headSepSize{16.0pt}\footSkipSize{26pt}} +\DeclareOption{11pt}{\baseFontSize{11pt}\headHeightSize{13.6pt}\headSepSize{23.0pt}\footSkipSize{28pt}} +\DeclareOption{12pt}{\baseFontSize{12pt}\headHeightSize{14.5pt}\headSepSize{25.0pt}\footSkipSize{30pt}} +\ExecuteOptions{10pt} + +% +% Page sizing +% + +%\newif\iffullpage +%\newif\ifsavetrees +% +%\DeclareOption{fullpage}{\fullpagetrue} +%\DeclareOption{savetrees}{\savetreestrue} + + +% Bark at any unknown package option +\DeclareOption*{\PackageWarning{easychair}{Unknown option '\CurrentOption'}} +\DeclareOption*{\PassOptionsToPackage{\CurrentOption}{geometry}} +%\DeclareOption*{\PassOptionsToClass{\CurrentOption}{article}} + +%\ExecuteOptions{centertags,portrait,10pt,twoside,onecolumn,final} +%\ExecuteOptions{} +\ProcessOptions\relax + + +% +% Required packages and classes. +% +% All must be standard as per most common LaTeX +% distributions. +% + +\ifthesis + \LoadClass[\@PaperFormat,\@PaperOrientation,\@ColumnCount,\@BaseFontSize,twoside]{report} + \RequirePackage{makeidx} +\else + % We are an article (more customized later) + \LoadClass[\@PaperFormat,\@PaperOrientation,\@ColumnCount,\@BaseFontSize,twoside]{article} + %\LoadClass[\@PaperFormat,\@PaperOrientation,\@ColumnCount,\@BaseFontSize]{article} +\fi + +% Require UTF8 encoding, per Andrei Voronkov, to accomodate +% all sorts of author names. +\RequirePackage[utf8]{inputenc} + +% All \urls will be hyperlinked and will deal properly with special characters +% XXX: url is included by hyperref +%\RequirePackage{url} + +% To ensure the footnotes are always at the bottom. +% IMPORTANT: footmisc should precede hyperref for the footnotes to hyperlink +% correctly to their pages where they are at instead of always at +% page 1. Per bug reports from a couple of users and a suggestion by +% Uwe Pfeiffer. +\RequirePackage[bottom]{footmisc} + +%% TOC/thumbnail LHS preview in the PDFs as well as active URLs and other cross-refs +%% Newer versions of hyperref declare a4paper or letterpaper as obsolete and issue warnings +%%\RequirePackage[\(a)PaperFormat,pdfcreator=easychair.cls-2.0]{hyperref} +%\RequirePackage[linktocpage,pdfcreator=easychair.cls-2.0-Beta-3]{hyperref} + +% Traditional graphics processing +\RequirePackage{graphicx} +%\RequirePackage{pdflscape} +%\RequirePackage{lscape} + + +%% Fonts, generally more compact but preserving point size + +% Pick "Times Roman" as a base font unless explicitly told not to +\ifnotimes + \ifwithtimes + \PackageWarning{easychair}{Cannot really use 'notimes' and 'withtimes' together} + \PackageWarning{easychair}{Defaulting to 'notimes'...} + \else + \PackageWarning{easychair}{'notimes' has been deprecated as it is the default in 2.0} + \fi +\else + \ifwithtimes + \RequirePackage{mathptmx} + \fi +\fi + +% Pick "Helvetica" as a "Sans-Serif" font +\RequirePackage[scaled=.85]{helvet} + +% For algorithm and source code listings +\RequirePackage{listings} + +%% Different Math and non-Math symbols and definitions + +\RequirePackage{latexsym} +\RequirePackage{amsthm} +\RequirePackage{empheq} + + +%% Line spacing to be applied AFTER the above space saving packages + +\renewcommand{\baselinestretch}{\@LineSpacing} + +%% Final text printing area, per Geoff Sutcliffe + +\RequirePackage{keyval} + +\define@key{Ec}{lmargin}{\Ec@defbylen{lmargin}{#1}} + +\newlength{\@MarginSize} +\setlength{\@MarginSize}{1in} + +\setlength{\@LMarginSize}{\@MarginSize} +%\setlength{\@LMarginSize}{\Ec@lmargin} +\setlength{\@RMarginSize}{\@MarginSize} +\setlength{\@TMarginSize}{\@MarginSize} +\setlength{\@BMarginSize}{\@MarginSize} + + +% Head height is dependent on the font point size +\setlength{\headheight}{\@HeadHeightSize} +\setlength{\headsep}{\@HeadSepSize} +\setlength{\footskip}{\@FootSkipSize} + +\ifletterpaper + \immediate\write10{easychair: Selecting letter paper margin sizes.} + \RequirePackage[% + papersize={8.5in,11in}, + total={145mm,224mm}, + centering, + twoside, + includeheadfoot]{geometry} +\fi +\ifafourpaper + \immediate\write10{easychair: Selecting A4 paper margin sizes.} + \RequirePackage[% + papersize={210mm,297mm}, + total={145mm,224mm}, + centering, + twoside, + includeheadfoot]{geometry} +\fi + +\ifcustompaper + \immediate\write10{easychair: Selecting custom paper margin sizes.} + \RequirePackage[% + papersize={189mm,246mm}, + total={145mm,224mm}, + top=9mm, + left=24mm, + twoside, + includeheadfoot]{geometry} + \headHeightSize{12.0pt} + \headSepSize{16.0pt} + \footSkipSize{26pt} +\fi + +%\setlength{\textwidth}{16cm} +%\setlength{\textheight}{9in} + + +% +% Volume +% + +\RequirePackage{lastpage} + +\newif\ifvolumeundefined +\volumeundefinedtrue + +% e.g. +% \volumeinfo +% {J. Bloe} % editor(s) #1 +% {1} % No. of editors #2 +% {LICS 2008} % event title #3 +% {1} % volume number #4 +% {4} % issue #5 +% {134} % start page #6 + +\def\@EasyFontStyle{\footnotesize} +\newcommand{\headfootstyle}[1]{\def\@EasyFontStyle{#1}} + +\def\@EasyVolumeInfo{} + +\ifthesis + \newcommand{\volumeinfo}[6] + {\PackageWarning{easychair}{Cannot use volumeinfo with 'thesis' option. Ignoring...}} +\else + \newcommand{\volumeinfo}[6]{% + \ifvolumeundefined + % \def\@makefntext##1{\noindent ##1}% + \def\@EasyEdsNames{#1}% + \def\(a)EasyEds{ed.}% + \def\@EasyEvent{#3}% + \def\@EasyVolume{}% + \def\@EasyIssue{}% + \def\@EasyFirstPage{#6}% + \ifnum #2>1 \gdef\(a)EasyEds{eds.}\fi% + \ifnum #4>0 \gdef\@EasyVolume{; Volume #4}\fi% + \ifnum #5>0 \gdef\@EasyIssue{, issue: #5} \fi% + % \footnotetext[0]{\sf \@EasyEdsNames (\@EasyEds); \@EasyEvent\@EasyVolume\@EasyIssue, pp. #6-\pageref{LastPage}}% + % \def\@EasyVolumeInfo{\footnotesize{\sf\@EasyEdsNames~(\@EasyEds); \@EasyEvent\@EasyVolume\@EasyIssue, pp. \@EasyFirstPage--\pageref{LastPage}}}% + \def\@EasyVolumeInfo{\@EasyFontStyle\@EasyEdsNames~(\@EasyEds); \@EasyEvent\@EasyVolume\@EasyIssue, pp. \@EasyFirstPage--\pageref{LastPage}}% + %\def\@makefntext##1{\noindent\@makefnmark##1}% + \setcounter{page}{\@EasyFirstPage} + \volumeundefinedfalse + \else + {\PackageWarning{easychair}{May not redefine volumeinfo}} + \fi + } +\fi + +\def\@EventInfo{} +\def\@VolumeInfo{} + +\newif\ifvolumeecpsundefined +\volumeecpsundefinedtrue + +\newcommand{\volumeinfoECPS}[2]{% + \ifvolumeecpsundefined + \def\@EventInfo{#1}% + \def\@VolumeInfo{#2}% + \volumeecpsundefinedfalse + \else + {\PackageWarning{easychair}{Ignoring another definition of volumeinfoECPS}} + \fi +} + + +% +% Allow for more space to place floats. +% + +\renewcommand{\topfraction}{0.95} +\renewcommand{\bottomfraction}{0.95} +\renewcommand{\textfraction}{0.05} +\renewcommand{\floatpagefraction}{0.8} + + +% +% Running heads and ``foots'' +% + +\RequirePackage{fancyhdr} +\pagestyle{fancy} + +\fancyhead{} +%\ifdebug +% \iftwosided +% \fancyhead[RE]{\overline{\@titleRunning}} +% \fancyhead[RO]{\overline{\@authorRunning}} +% \else +% \fancyhead[LO,LE]{\begin{math}\overline{\mbox{\@titleRunning}}\end{math}} +% \fancyhead[RO,RE]{\begin{math}\overline{\mbox{\@authorRunning}}\end{math}} +% \fi +%\else + \iftwosided + \fancyhead[RE]{{\@EasyFontStyle\@titleRunning}} + \fancyhead[RO]{{\@EasyFontStyle\@authorRunning}} + \else + \fancyhead[LO,LE]{{\@EasyFontStyle\@titleRunning}} + \fancyhead[RO,RE]{{\@EasyFontStyle\@authorRunning}} + \fi +%\fi + +\fancyfoot{} +%\ifdebug +% \fancyfoot[CO,CE]{\underline{\thepage}} +% \renewcommand{\headrulewidth}{1pt} +% \renewcommand{\footrulewidth}{1pt} +%\else +% \fancyfoot[CO,CE]{\thepage} +% \fancyfoot[LO]{{\footnotesize{\sf\@EventInfo}}} +% \fancyfoot[LE]{{\footnotesize{\sf\@VolumeInfo}}} +% \fancyfoot[LO]{{\@EasyFontStyle\@EventInfo}} +% \fancyfoot[LE]{{\@EasyFontStyle\@VolumeInfo}} +\ifodd\c@page + \fancyfoot[LO]{{\@EasyFontStyle\@VolumeInfo}} + \fancyfoot[RE]{{\@EasyFontStyle\@EventInfo}} +\else + \fancyfoot[RE]{{\@EasyFontStyle\@VolumeInfo}} + \fancyfoot[LO]{{\@EasyFontStyle\@EventInfo}} +\fi +% \fancyfoot[LO,LE] +% { +%\volumeinfoECPS +% {A. Editor, B. Editor} % editors +% {2} % number of editors +% {EVENT, Month YEAR} % event +% {1} % volume +% } +% \fancyfoot[RO,RE]{{\@EasyFontStyle\thepage}} +% \fancyfoot[RO]{{\@EasyFontStyle\thepage}} +% \fancyfoot[LE]{{\@EasyFontStyle\thepage}} +\ifodd\c@page + \fancyfoot[RO]{{\normalsize\thepage}} + \fancyfoot[LE]{{\normalsize\thepage}} +\else + \fancyfoot[LE]{{\normalsize\thepage}} + \fancyfoot[RO]{{\normalsize\thepage}} +\fi + \renewcommand{\headrulewidth}{0pt} + \renewcommand{\footrulewidth}{0pt} +%\fi + +% Suppress the default date, per Geoff +\date{} + +% For the first page +\fancypagestyle{plain}{% +\fancyhf{} % clear all header and footer fields +\ifodd\c@page + \fancyfoot[L]{\@EasyVolumeInfo}% + \fancyfoot[R]{{\normalsize\thepage}} % except the center +\else + \fancyfoot[R]{\@EasyVolumeInfo}% + \fancyfoot[L]{{\normalsize\thepage}} % except the center +\fi +\renewcommand{\headrulewidth}{0pt} +\renewcommand{\footrulewidth}{0pt}} + + +\let\oldmaketitle=\maketitle +\def\@maketitle{% + \newpage + \null + % Facelift a bit the title and make it bold, per Geoff + \vspace{-1cm} + \begin{center}% + \let\footnote\thanks% + % Do not bold Times title, per Geoff + \ifwithtimes + {\LARGE{\@title}\par} + \else + {\LARGE{\bf \@title}\par} + \fi + \vskip 0.5\baselineskip + \begin{tabular}[t]{c}% + \@author + \end{tabular}\par + \@date + \end{center}% + %\volumeinfoECPS{\@EventInfo}{\@VolumeInfo} + %\titlerunning{EMPTY}% + %\authorrunning{EMPTY}% + %\authorrunning{\@authorRunning}% + %\renewcommand{\titlerunning}[1]{} + %\renewcommand{\authorrunning}[1]{} + %%\renewcommand{\volumeinfoECPS}[2]{}% + %%\renewcommand{\volumeinfo}[6]{} + %\gdef\@authorRunning{Gooo\@authorRunning}% + %\gdef\@EasyVolumeInfo{Foo\@authorRunning}% + %\gdef\@EventInfo{} + %\gdef\@VolumeInfo{} +%\volumeinfo + %{NNNNOT A. Voronkov} % editors + %{1} % number of editors + %{NYO-YO} % event + %{44} % volume + %{1} % issue + %{45} % starting page number +%\volumeinfoECPS + %{NNNNOT Super EasyChair Workshop Proceedings} + %{NNNNOT ECPS vol. 43} + \par + %\relax +} + + +% TOC/thumbnail LHS preview in the PDFs as well as active URLs and other cross-refs +% Newer versions of hyperref declare a4paper or letterpaper as obsolete and issue warnings +\RequirePackage[linktocpage,pdfcreator=easychair.cls-3.0]{hyperref} + + +% Tighten up bibliography +\let\oldthebibliography=\thebibliography +\let\endoldthebibliography=\endthebibliography +\renewenvironment{thebibliography}[1] +{ + \small + \begin{oldthebibliography}{#1} + \setlength{\parskip}{2pt} + \setlength{\itemsep}{0pt} +} +{ + \end{oldthebibliography} +} + +\ifdebug + \ifverbose + \RequirePackage[colorgrid,pscoord]{eso-pic}% + \else + \RequirePackage[pscoord]{eso-pic} + \newcommand\ShowFramePicture{% + \begingroup + \color{red} + \AtTextLowerLeft{\framebox(\LenToUnit{\textwidth},\LenToUnit{\textheight}){}}% + \AtTextUpperLeft{\put(0,\LenToUnit{\headsep}){\framebox(\LenToUnit{\textwidth},\LenToUnit{\headheight}){}}}% + \AtTextLowerLeft{\put(0,\LenToUnit{-\footskip}){\framebox(\LenToUnit{\textwidth},\LenToUnit{\headheight}){}}}% + \endgroup + } + \AddToShipoutPicture{\ShowFramePicture} + \fi + %\RequirePackage[a4,cam,center]{crop}% + %\RequirePackage[cam,center]{crop}% +\fi + +\ifframe + \ifverbose + \RequirePackage[colorgrid,pscoord]{eso-pic}% + \else + \RequirePackage[pscoord]{eso-pic} + \newcommand\ShowBlueFrame{% + \begingroup + \color{blue} + % odd page +% \AtTextLowerLeft{\put(\LenToUnit{-23.6mm},\LenToUnit{-21.8mm}){\framebox(\LenToUnit{188.3mm},\LenToUnit{245.4mm}){}}}% + % even page +% \AtTextLowerLeft{\put(\LenToUnit{-19.6mm},\LenToUnit{-21.8mm}){\framebox(\LenToUnit{188.3mm},\LenToUnit{245.4mm}){}}}% + \endgroup + } + \AddToShipoutPicture{\ShowBlueFrame} + \fi +\fi + +% \geometry{papersize={170mm,240mm},total={124mm,185mm}} + +%% Indexing options for proceedings to link up people's names to their +%% various participation and affiliation options. + +\newcommand + {\indexedperson} + [3] + {\index{#2!#1}\index{#1}\index{#1!#3}} + +\newcommand + {\indexedauthor} + [1] + {\indexedperson{#1}{Authors}{Author}} + +\newcommand + {\indexededitor} + [1] + {\indexedperson{#1}{Editors}{Editor}} + +\newcommand + {\indexedpcmember} + [1] + {\indexedperson{#1}{PC Members}{PC Member}} + +\newcommand + {\indexedreviewer} + [1] + {\indexedperson{#1}{Reviewers}{Reviewer}} + +\newcommand + {\indexedorganizer} + [1] + {\indexedperson{#1}{Organizers}{Organizer}} + +\newcommand + {\indexedwebmaster} + [1] + {\indexedperson{#1}{Webmasters}{Webmaster}} + +\newcommand + {\indexedaffiliation} + [2] + {\indexedperson{#1}{#2}{#2}} + +\newcommand + {\indexedsupervisor} + [2] + {\indexedperson{#1}{}{Supervisor: #2}\indexedperson{#2}{Supervisors}{Supervisor}} + +\endinput + +% \crop[font=\upshape\mdseries\small\textsf] + +% EOF diff --git a/2012/datagram-testing-plan/vc b/2012/datagram-testing-plan/vc new file mode 100755 index 0000000..5c5a1b3 --- /dev/null +++ b/2012/datagram-testing-plan/vc @@ -0,0 +1,24 @@ +#!/bin/sh +# This is file 'vc' from the vc bundle for TeX. +# The original file can be found at CTAN:support/vc. +# This file is Public Domain. + +# Parse command line options. +full=0 +mod=0 +while [ -n "$(echo $1 | grep '-')" ]; do + case $1 in + -f ) full=1 ;; + -m ) mod=1 ;; + * ) echo 'usage: vc [-f] [-m]' + exit 1 + esac + shift +done +# English locale. +LC_ALL=C +git --no-pager log -1 HEAD --pretty=format:"Hash: %H%nAbr. Hash: %h%nParent Hashes: %P%nAbr. Parent Hashes: %p%nAuthor Name: %an%nAuthor Email: %ae%nAuthor Date: %ai%nCommitter Name: %cn%nCommitter Email: %ce%nCommitter Date: %ci%n" |gawk -v script=log -v full=$full -f vc-git.awk > vc.tex +if [ "$mod" = 1 ] +then + git status |gawk -v script=status -f vc-git.awk >> vc.tex +fi diff --git a/2012/datagram-testing-plan/vc-git.awk b/2012/datagram-testing-plan/vc-git.awk new file mode 100644 index 0000000..66b3526 --- /dev/null +++ b/2012/datagram-testing-plan/vc-git.awk @@ -0,0 +1,89 @@ +# This is file 'vc-git.awk' from the vc bundle for TeX. +# The original file can be found at CTAN:support/vc. +# This file is Public Domain. +BEGIN { + +### Process output of "git status". + if (script=="status") { + modified = 0 + } + +} + + + +### Process output of "git log". +script=="log" && /^Hash:/ { Hash = substr($0, 2+match($0, ":")) } +script=="log" && /^Abr. Hash:/ { AbrHash = substr($0, 2+match($0, ":")) } +script=="log" && /^Parent Hashes:/ { ParentHashes = substr($0, 2+match($0, ":")) } +script=="log" && /^Abr. Parent Hashes:/ { AbrParentHashes = substr($0, 2+match($0, ":")) } +script=="log" && /^Author Name:/ { AuthorName = substr($0, 2+match($0, ":")) } +script=="log" && /^Author Email:/ { AuthorEmail = substr($0, 2+match($0, ":")) } +script=="log" && /^Author Date:/ { AuthorDate = substr($0, 2+match($0, ":")) } +script=="log" && /^Committer Name:/ { CommitterName = substr($0, 2+match($0, ":")) } +script=="log" && /^Committer Email:/ { CommitterEmail = substr($0, 2+match($0, ":")) } +script=="log" && /^Committer Date:/ { CommitterDate = substr($0, 2+match($0, ":")) } + +### Process output of "git status". +### Changed index? +script=="status" && /^# Changes to be committed:/ { modified = 1 } +### Unstaged modifications? +script=="status" && /^# Changed but not updated:/ { modified = 2 } + + + +END { + +### Process output of "git log". + if (script=="log") { +### Standard encoding is UTF-8. + if (Encoding == "") Encoding = "UTF-8" +### Extract relevant information from variables. + LongDate = substr(AuthorDate, 1, 25) + DateRAW = substr(LongDate, 1, 10) + DateISO = DateRAW + DateTEX = DateISO + gsub("-", "/", DateTEX) + Time = substr(LongDate, 12, 14) +### Write file identification to vc.tex. + print "%%% This file has been generated by the vc bundle for TeX." + print "%%% Do not edit this file!" + print "%%%" +### Write Git specific macros. + print "%%% Define Git specific macros." + print "\\gdef\\GITHash{" Hash "}%" + print "\\gdef\\GITAbrHash{" AbrHash "}%" + print "\\gdef\\GITParentHashes{" ParentHashes "}%" + print "\\gdef\\GITAbrParentHashes{" AbrParentHashes "}%" + print "\\gdef\\GITAuthorName{" AuthorName "}%" + print "\\gdef\\GITAuthorEmail{" AuthorEmail "}%" + print "\\gdef\\GITAuthorDate{" AuthorDate "}%" + print "\\gdef\\GITCommitterName{" CommitterName "}%" + print "\\gdef\\GITCommitterEmail{" CommitterEmail "}%" + print "\\gdef\\GITCommitterDate{" CommitterDate "}%" +### Write generic version control macros. + print "%%% Define generic version control macros." + print "\\gdef\\VCRevision{\\GITAbrHash}%" + print "\\gdef\\VCAuthor{\\GITAuthorName}%" + print "\\gdef\\VCDateRAW{" DateRAW "}%" + print "\\gdef\\VCDateISO{" DateISO "}%" + print "\\gdef\\VCDateTEX{" DateTEX "}%" + print "\\gdef\\VCTime{" Time "}%" + print "\\gdef\\VCModifiedText{\\textcolor{red}{with local modifications!}}%" + print "%%% Assume clean working copy." + print "\\gdef\\VCModified{0}%" + print "\\gdef\\VCRevisionMod{\\VCRevision}%" + } + +### Process output of "git status". + if (script=="status") { + print "%%% Is working copy modified?" + print "\\gdef\\VCModified{" modified "}%" + if (modified==0) { + print "\\gdef\\VCRevisionMod{\\VCRevision}%" + } else { + print "\\gdef\\VCRevisionMod{\\VCRevision~\\VCModifiedText}%" + } + } + +}

1 0

[tech-reports/master] Add raw datagram-comparison report from Steven's repo.
by karsten＠torproject.org 26 Aug '12

26 Aug '12

commit 77ea7d31353a6efc95ff791a793f5c92641a75dd Author: Karsten Loesing <karsten.loesing(a)gmx.net> Date: Wed Aug 8 08:48:11 2012 +0200 Add raw datagram-comparison report from Steven's repo. https://gitweb.torproject.org/sjm217/torspec.git/tree/datagram_comparison:/… --- 2011/datagram-comparison/.gitignore | 10 + 2011/datagram-comparison/Makefile | 21 + 2011/datagram-comparison/NOTES.txt | 6 + 2011/datagram-comparison/datagram-comparison.mm | 222 ++++++ 2011/datagram-comparison/datagram-comparison.tex | 500 +++++++++++++ 2011/datagram-comparison/freedom-data.svg | 717 +++++++++++++++++++ 2011/datagram-comparison/liberatore-data.svg | 742 +++++++++++++++++++ 2011/datagram-comparison/prettyref.sty | 41 ++ 2011/datagram-comparison/reardon-data.svg | 822 ++++++++++++++++++++++ 2011/datagram-comparison/references.bib | 74 ++ 2011/datagram-comparison/tor-data.svg | 738 +++++++++++++++++++ 2011/datagram-comparison/tor-extension.svg | 617 ++++++++++++++++ 2011/datagram-comparison/vc | 24 + 2011/datagram-comparison/vc-git.awk | 89 +++ 2011/datagram-comparison/viecco-data.svg | 780 ++++++++++++++++++++ 15 files changed, 5403 insertions(+), 0 deletions(-) diff --git a/2011/datagram-comparison/.gitignore b/2011/datagram-comparison/.gitignore new file mode 100644 index 0000000..6060eac --- /dev/null +++ b/2011/datagram-comparison/.gitignore @@ -0,0 +1,10 @@ +*.swp +*.aux +*.log +*.out +*.bbl +*.blg +tor-data.pdf +tor-extension.pdf +datagram-comparison.pdf +vc.tex diff --git a/2011/datagram-comparison/Makefile b/2011/datagram-comparison/Makefile new file mode 100644 index 0000000..05746ab --- /dev/null +++ b/2011/datagram-comparison/Makefile @@ -0,0 +1,21 @@ +all: datagram-comparison.pdf + +%.pdf: %.svg + inkscape --without-gui --export-area-page --export-pdf=`pwd`/$@ `pwd`/$< + +datagram-comparison.pdf: tor-data.pdf tor-extension.pdf reardon-data.pdf viecco-data.pdf \ + liberatore-data.pdf freedom-data.pdf + +%.pdf: %.tex references.bib + ./vc -m + pdflatex $< + bibtex datagram-comparison + pdflatex $< + pdflatex $< + +publish: datagram-comparison.pdf + cp datagram-comparison.pdf ~/public_html/volatile + +clean: + rm -f *.aux *.bbl *.blg *.log *.out \ + tor-data.pdf tor-extension.pdf datagram-comparison.pdf vc.tex diff --git a/2011/datagram-comparison/NOTES.txt b/2011/datagram-comparison/NOTES.txt new file mode 100644 index 0000000..8f1cdee --- /dev/null +++ b/2011/datagram-comparison/NOTES.txt @@ -0,0 +1,6 @@ +20:09 armadev> sjmurdoch: one topic we might also cover is that there's debate in the systems world about whether tcp end-to-end (alice to exit) is better or worse than a bunch + of pairwise tcp connections strung together (alice to 1, 1 to 2, 2 to 3) +20:26 armadev> sjmurdoch: another topic to cover is how many of the congestion control / performance optimizations in tor are actually orthogonal to the choice of transport. + e.g. bandwidth measurement and load balancing, or rate limiting, or the circuit priority designs, or mike's circuit build timeout + +http://en.wikipedia.org/wiki/Micro_Transport_Protocol \ No newline at end of file diff --git a/2011/datagram-comparison/datagram-comparison.mm b/2011/datagram-comparison/datagram-comparison.mm new file mode 100644 index 0000000..a5bfa53 --- /dev/null +++ b/2011/datagram-comparison/datagram-comparison.mm @@ -0,0 +1,222 @@ +<map version="0.9.0"> + +<node CREATED="1304087954084" ID="ID_1996303597" MODIFIED="1304107180657" TEXT="Comparison of datagram Tor designs"> +<node CREATED="1304089363911" ID="ID_153162939" MODIFIED="1304091062666" POSITION="right" TEXT="transport stacks"> +<node CREATED="1304089370380" ID="ID_388108438" MODIFIED="1304089376197" TEXT="TCPSpeaker"> +<node CREATED="1304089400450" ID="ID_680425047" MODIFIED="1304091067933" TEXT="Dan Levin et al."/> +<node CREATED="1304089416796" ID="ID_1839596446" MODIFIED="1304089426116" TEXT="Code available"> +<node CREATED="1304089403740" ID="ID_429696548" MODIFIED="1304089410166" TEXT="BSD-licensed"/> +<node CREATED="1304089431261" ID="ID_417966066" MODIFIED="1304089442693" TEXT="Git"/> +</node> +<node CREATED="1304089618950" ID="ID_1591378814" MODIFIED="1304089629063" TEXT="Designed for Click Modular Router"/> +<node CREATED="1304090298503" ID="ID_967420831" MODIFIED="1304090323733" TEXT="Translator between TCP and a WMN transport"/> +<node CREATED="1304090014004" ID="ID_235507392" MODIFIED="1304090044530" TEXT="Based on 4.4BSD-Lite code annotated by Wright and Stevens"> +<node CREATED="1304090864089" ID="ID_1261469483" MODIFIED="1304090869951" TEXT="Basic features (no SACK)"/> +</node> +</node> +<node CREATED="1304091069140" ID="ID_1395034609" MODIFIED="1304091071337" TEXT="CurveCP"> +<node CREATED="1304091172973" ID="ID_1833837076" MODIFIED="1304091276835" TEXT="Bi directional datagram cryptography and authenticity"> +<node CREATED="1304091399544" ID="ID_589206141" MODIFIED="1304091403341" TEXT="Mandatory"/> +<node CREATED="1304093078164" ID="ID_124252552" MODIFIED="1304093116884" TEXT="Elliptic-curve for setup"/> +<node CREATED="1304093117741" ID="ID_500395405" MODIFIED="1304093122364" TEXT="Symmetric for rest"/> +</node> +<node CREATED="1304091316407" ID="ID_1262220131" MODIFIED="1304091335613" TEXT="Forward secrecy 2 minutes after connection closed"> +<node CREATED="1304091355111" ID="ID_421898858" MODIFIED="1304091357767" TEXT="Short term keys"/> +</node> +<node CREATED="1304091278414" ID="ID_1651297485" MODIFIED="1304091283484" TEXT="Stateless (cookie-based)"/> +<node CREATED="1304092229818" ID="ID_334939707" MODIFIED="1304092245222" TEXT="Stream control messages are authenticated"> +<node CREATED="1304092421326" ID="ID_341859467" MODIFIED="1304092424068" TEXT="Availability"/> +<node CREATED="1304092413742" ID="ID_1112810089" MODIFIED="1304092419885" TEXT="Stops RST injection"/> +</node> +<node CREATED="1304092662730" ID="ID_1441008563" MODIFIED="1304092670073" TEXT="Randomized retransmission times"/> +<node CREATED="1304092746659" ID="ID_1734388509" MODIFIED="1304092756114" TEXT="Amplification resistance"/> +<node CREATED="1304093146166" ID="ID_971688805" MODIFIED="1304093149125" TEXT="Efficiency"> +<node CREATED="1304093152311" ID="ID_610350272" MODIFIED="1304093157821" TEXT="More overhead than TCP"/> +<node CREATED="1304093158607" ID="ID_679923238" MODIFIED="1304093167598" TEXT="Less than SSH/HTTPS"/> +</node> +<node CREATED="1304092811261" ID="ID_1842308607" MODIFIED="1304092815528" TEXT="Needs good clock?"/> +<node CREATED="1304092738500" ID="ID_420056962" MODIFIED="1304092745138" TEXT="No fragmentation"/> +<node CREATED="1304095129344" ID="ID_1930383248" MODIFIED="1304095146049" TEXT="Versatile naming with failover and mobility"/> +</node> +<node CREATED="1304107804374" ID="ID_1554870004" MODIFIED="1304107807009" TEXT="SCTP"/> +</node> +<node CREATED="1304091939284" ID="ID_1184729055" MODIFIED="1304091941290" POSITION="left" TEXT="Layers"> +<node CREATED="1304092121448" ID="ID_395771361" MODIFIED="1304092331218" TEXT="Stream transport"> +<node CREATED="1304092164745" ID="ID_64933482" MODIFIED="1304092168263" TEXT="Flow control"/> +<node CREATED="1304092168681" ID="ID_1612676686" MODIFIED="1304092171032" TEXT="Reliability"/> +</node> +<node CREATED="1304091942533" ID="ID_1601568954" MODIFIED="1304091946891" TEXT="Transport security"> +<node CREATED="1304091949221" ID="ID_1020699600" MODIFIED="1304091952459" TEXT="Currently TLS"/> +<node CREATED="1304091957245" ID="ID_73003985" MODIFIED="1304091974651" TEXT="Provides hop-by-hop confidentiality"/> +<node CREATED="1304091975461" ID="ID_408534541" MODIFIED="1304091982435" TEXT="Hop-by-hop authenticity"> +<node CREATED="1304093032290" ID="ID_1026128709" MODIFIED="1304093037001" TEXT="Is this needed?"/> +</node> +</node> +<node CREATED="1304092343796" ID="ID_522032544" MODIFIED="1304092350699" TEXT="Relay"> +<node CREATED="1304098919529" ID="ID_152396056" MODIFIED="1304098926411" TEXT="Key exchange"/> +<node CREATED="1304092354829" ID="ID_508861285" MODIFIED="1304092360175" TEXT="Stream de-multiplexing"/> +<node CREATED="1304092360613" ID="ID_1313556203" MODIFIED="1304092365963" TEXT="E2E authenticity"> +<node CREATED="1304101448558" ID="ID_659053200" MODIFIED="1304101456586" TEXT="Problem with re-ordering"/> +</node> +</node> +<node CREATED="1304092339236" ID="ID_1371636310" MODIFIED="1304092343099" TEXT="Cell crypto"> +<node CREATED="1304092926480" ID="ID_1895674190" MODIFIED="1304092935798" TEXT="Multiple layers"/> +<node CREATED="1304092941104" ID="ID_588155140" MODIFIED="1304092948830" TEXT="No expansion"> +<node CREATED="1304092970185" ID="ID_1412929151" MODIFIED="1304092975367" TEXT="No authenticity"/> +<node CREATED="1304092950696" ID="ID_848998090" MODIFIED="1304092962695" TEXT="Padding is an alternative"/> +</node> +<node CREATED="1304101464679" ID="ID_982078346" MODIFIED="1304101471144" TEXT="Problem with re-ordering"/> +</node> +</node> +<node CREATED="1304093202993" ID="ID_971176884" MODIFIED="1304093422085" POSITION="right" TEXT="Congestion management"> +<node CREATED="1304093422073" ID="ID_1144330312" MODIFIED="1304093436415" TEXT="Bad Latency"> +<node CREATED="1304093210705" ID="ID_104063654" MODIFIED="1304093214296" TEXT="CUBIC"> +<node CREATED="1304093215497" ID="ID_1613147464" MODIFIED="1304093217079" TEXT="Linux"/> +<node CREATED="1304094569096" ID="ID_376860985" MODIFIED="1304094579047" TEXT="Somewhat unfriendly to NewReno"/> +</node> +<node CREATED="1304093219193" ID="ID_1627762417" MODIFIED="1304093224984" TEXT="NewReno"> +<node CREATED="1304093226881" ID="ID_469434677" MODIFIED="1304093229456" TEXT="FreeBSD"/> +</node> +<node CREATED="1304093231185" ID="ID_803346771" MODIFIED="1304093236944" TEXT="Compound"> +<node CREATED="1304093237562" ID="ID_1725826319" MODIFIED="1304093239672" TEXT="Microsoft"/> +</node> +<node CREATED="1304094182720" ID="ID_137720491" MODIFIED="1304094204224" TEXT="Fixes late-comer advantage by synchronizing congestion cycle"> +<node CREATED="1304094205752" ID="ID_32888713" MODIFIED="1304094249225" TEXT="Each flow notices maximum congestion at the same moment"/> +</node> +</node> +<node CREATED="1304093444848" ID="ID_1332471467" MODIFIED="1304093447623" TEXT="Good Latency"> +<node CREATED="1304093270931" ID="ID_714188122" MODIFIED="1304093771636" TEXT="Chicago"> +<node CREATED="1304093274371" ID="ID_961237127" MODIFIED="1304093279882" TEXT="CurveCP"/> +<node CREATED="1304093282323" ID="ID_1612557903" MODIFIED="1304093288531" TEXT="Handles bufferbloat"/> +<node CREATED="1304093658964" ID="ID_1860265110" MODIFIED="1304093684740" TEXT="Periodic rate reduction"> +<node CREATED="1304093693509" ID="ID_1706752078" MODIFIED="1304093701357" TEXT="Helps RTT unfairness"/> +</node> +<node CREATED="1304094269282" ID="ID_216200716" MODIFIED="1304094280602" TEXT="Tracks long-term delay statistics"/> +<node CREATED="1304094300426" ID="ID_226735320" MODIFIED="1304094321739" TEXT="Creates short congestion cycles with very low levels of congestion"> +<node CREATED="1304094663889" ID="ID_920545038" MODIFIED="1304094677188" TEXT="Notices if other streams not not backing off"/> +</node> +<node CREATED="1304094715554" ID="ID_585093780" MODIFIED="1304094734126" TEXT="Slow-start only continue until delay, not packet loss"/> +<node CREATED="1304094765194" ID="ID_697319518" MODIFIED="1304094780883" TEXT="Differentiates persistent loss with congestion-induced loss"/> +</node> +<node CREATED="1304093456232" ID="ID_1791602590" MODIFIED="1304093460248" TEXT="TCP Vegas"> +<node CREATED="1304093841456" ID="ID_1642916349" MODIFIED="1304093851887" TEXT="Measurines minimum RTT"/> +<node CREATED="1304093852624" ID="ID_1678238940" MODIFIED="1304093864367" TEXT="Rate adjusted to min + delta"> +<node CREATED="1304093865904" ID="ID_209133498" MODIFIED="1304093880552" TEXT="Delta not so large to indicate congestion"/> +<node CREATED="1304093881816" ID="ID_970034761" MODIFIED="1304093892681" TEXT="Not so mall to empty queue"/> +<node CREATED="1304093906449" ID="ID_107042054" MODIFIED="1304093930936" TEXT="Kept for remainder of flow"/> +</node> +<node CREATED="1304094131119" ID="ID_1721932154" MODIFIED="1304094136142" TEXT="Has late-comer advantage"/> +<node CREATED="1304094420349" ID="ID_1523511855" MODIFIED="1304094427037" TEXT="Not widely deployed"> +<node CREATED="1304094428077" ID="ID_1805747402" MODIFIED="1304094435141" TEXT="Probably because it loses out to other schedulers"/> +</node> +</node> +<node CREATED="1304093460904" ID="ID_183771140" MODIFIED="1304093465736" TEXT="LEDBAT"> +<node CREATED="1304093521914" ID="ID_1160560154" MODIFIED="1304093525441" TEXT="Low delay"/> +<node CREATED="1304093525914" ID="ID_1701533" MODIFIED="1304093532619" TEXT="Saturate link"/> +<node CREATED="1304093533082" ID="ID_1600275956" MODIFIED="1304093538593" TEXT="Yield to TCP"/> +</node> +</node> +<node CREATED="1304094801331" ID="ID_441625619" MODIFIED="1304094803483" TEXT="?"> +<node CREATED="1304094804995" ID="ID_208531561" MODIFIED="1304094808355" TEXT="ECN?"/> +</node> +<node CREATED="1304093608268" ID="ID_1321005448" MODIFIED="1304093624299" TEXT="Problems"> +<node CREATED="1304093625500" ID="ID_315096120" MODIFIED="1304093630803" TEXT="RTT unfairness"> +<node CREATED="1304093632660" ID="ID_1167915494" MODIFIED="1304093743675" TEXT="Faster RTT will use more rate than slower if rate adjustment depends on RTT"/> +</node> +<node CREATED="1304093937969" ID="ID_458918323" MODIFIED="1304093953105" TEXT="Late-comer advantge"> +<node CREATED="1304093964393" ID="ID_287336527" MODIFIED="1304094049393" TEXT="Each TCP Vegas flow increases RTT to (minimum RTT + delta)"/> +<node CREATED="1304093994898" ID="ID_1837050260" MODIFIED="1304094056568" TEXT="Second flow will increase RTT to minimum RTT + 2*delta"/> +<node CREATED="1304094071373" ID="ID_501982430" MODIFIED="1304094116386" TEXT="First flow will back off due in increased RTT until it is essentially zero"/> +</node> +<node CREATED="1304093789903" ID="ID_874724416" MODIFIED="1304093795774" TEXT="Rate management"> +<node CREATED="1304093798431" ID="ID_1062057795" MODIFIED="1304093808958" TEXT="Multiplicative decrease on congestion"/> +<node CREATED="1304093809503" ID="ID_1260673199" MODIFIED="1304093818327" TEXT="Additive periodically"/> +</node> +<node CREATED="1304094362724" ID="ID_1581112870" MODIFIED="1304094368299" TEXT="Mixing schedulers"> +<node CREATED="1304094369780" ID="ID_149884440" MODIFIED="1304094379852" TEXT="CUBIC is unfriendly to Vegas"/> +</node> +</node> +</node> +<node CREATED="1304097856546" ID="ID_1088145615" MODIFIED="1304097857650" POSITION="left" TEXT="JAP"> +<node CREATED="1304098822936" ID="ID_371526807" MODIFIED="1304098828105" TEXT="No forward-secrecy"/> +</node> +<node CREATED="1304097908739" ID="ID_797516775" MODIFIED="1304097913139" POSITION="right" TEXT="Considerations"> +<node CREATED="1304104126607" ID="ID_1754174188" MODIFIED="1304104132721" TEXT="Migtation plan"/> +<node CREATED="1304104133407" ID="ID_1705679315" MODIFIED="1304104136193" TEXT="Routing TCP"/> +<node CREATED="1304097915275" ID="ID_1918369911" MODIFIED="1304097923507" TEXT="Triangle-boy"/> +<node CREATED="1304104224584" ID="ID_307070958" MODIFIED="1304104228514" TEXT="Problems"> +<node CREATED="1304104230664" ID="ID_570567475" MODIFIED="1304104238890" TEXT="Double congestion control"/> +<node CREATED="1304104239464" ID="ID_246626855" MODIFIED="1304104255476" TEXT="Unecessary delays due to multiplexing"/> +</node> +</node> +<node CREATED="1304099191142" ID="ID_1705257738" MODIFIED="1304099198566" POSITION="left" TEXT="SHALON"> +<node CREATED="1304099199893" ID="ID_318879649" MODIFIED="1304099215270" TEXT="TCP hop by hop"> +<node CREATED="1304099555835" ID="ID_690755015" MODIFIED="1304099561116" TEXT="No crypto"/> +</node> +<node CREATED="1304099225246" ID="ID_405792291" MODIFIED="1304099294576" TEXT="Nested HTTPS CONNECT E2E"/> +<node CREATED="1304099366048" ID="ID_877404509" MODIFIED="1304099371761" TEXT="No stream multiplexing"> +<node CREATED="1304099879330" ID="ID_228285546" MODIFIED="1304099881594" TEXT="TA problem?"/> +</node> +<node CREATED="1304099372176" ID="ID_825929569" MODIFIED="1304099384337" TEXT="No link encryption multiplexing"> +<node CREATED="1304099883433" ID="ID_1657320227" MODIFIED="1304099885914" TEXT="TA problem?"/> +</node> +<node CREATED="1304099585356" ID="ID_326768749" MODIFIED="1304099592588" TEXT="Standard libraries"/> +<node CREATED="1304099621804" ID="ID_1833209880" MODIFIED="1304099628351" TEXT="No padding"> +<node CREATED="1304100365995" ID="ID_293776859" MODIFIED="1304100414815" TEXT="Intermediate nodes can't introduce padding"/> +<node CREATED="1304100428708" ID="ID_1090141299" MODIFIED="1304100440037" TEXT="Client limited in what padding can be inserted"/> +</node> +<node CREATED="1304099756175" ID="ID_85383112" MODIFIED="1304099760258" TEXT="Variable packet sizes"/> +<node CREATED="1304099715495" ID="ID_729662409" MODIFIED="1304099730479" TEXT="TLS stack fingerprinting?"/> +<node CREATED="1304099960091" ID="ID_540654673" MODIFIED="1304099962108" TEXT="Faster"> +<node CREATED="1304099946651" ID="ID_1028664211" MODIFIED="1304099951109" TEXT="Less decryption"/> +<node CREATED="1304099965819" ID="ID_1483654391" MODIFIED="1304099972838" TEXT="No E2E congestion control"/> +<node CREATED="1304099978299" ID="ID_1523747709" MODIFIED="1304099982460" TEXT="But no multiplexing"/> +<node CREATED="1304100062613" ID="ID_1066842305" MODIFIED="1304100072606" TEXT="Only in lab network"> +<node CREATED="1304100187895" ID="ID_1165709199" MODIFIED="1304100191248" TEXT="CPU bound"/> +</node> +</node> +</node> +<node CREATED="1304100586191" ID="ID_169494020" MODIFIED="1304100590736" POSITION="right" TEXT="Liberatore"> +<node CREATED="1304100608495" ID="ID_107644724" MODIFIED="1304100612088" TEXT="UDP payload"> +<node CREATED="1304100613943" ID="ID_993422442" MODIFIED="1304100620857" TEXT="No congestion management or reliability"/> +</node> +<node CREATED="1304100592335" ID="ID_1033994454" MODIFIED="1304100599408" TEXT="DTLS link-layer crypto"/> +<node CREATED="1304102719307" ID="ID_124649267" MODIFIED="1304103068425" TEXT="Control over TLS/TCP"/> +<node CREATED="1304103298044" ID="ID_228936796" MODIFIED="1304103311205" TEXT="Only RELAY_DATA can go in DTLS"/> +<node CREATED="1304104016445" ID="ID_713518194" MODIFIED="1304104020897" TEXT="Auth only 4 bytes"/> +<node CREATED="1304103511991" ID="ID_1076291370" MODIFIED="1304103528762" TEXT="Sequence number in cell, used for CTR mode"> +<node CREATED="1304103679416" ID="ID_748999637" MODIFIED="1304103683219" TEXT="Set by client"/> +<node CREATED="1304103547903" ID="ID_879907985" MODIFIED="1304103551480" TEXT="Could be a nonce"/> +<node CREATED="1304103551919" ID="ID_515169690" MODIFIED="1304103562496" TEXT="Not re-ordered"/> +<node CREATED="1304103566911" ID="ID_1380084025" MODIFIED="1304103575609" TEXT="Does give away re-ordering"/> +</node> +</node> +<node CREATED="1304104783929" ID="ID_79190564" MODIFIED="1304104790917" POSITION="left" TEXT="Kiraly"> +<node CREATED="1304104792937" ID="ID_9723701" MODIFIED="1304104798747" TEXT="Nested IPSec tunnels"/> +<node CREATED="1304104851810" ID="ID_1220152230" MODIFIED="1304104859731" TEXT="NAT to hide IP addresses"/> +<node CREATED="1304104896123" ID="ID_1715886468" MODIFIED="1304104900268" TEXT="IKE for control"/> +<node CREATED="1304104905251" ID="ID_1088914598" MODIFIED="1304106019775" TEXT="TCP to destination"/> +<node CREATED="1304104944035" ID="ID_793788221" MODIFIED="1304104948765" TEXT="Standards compliant"/> +<node CREATED="1304106245791" ID="ID_1789205175" MODIFIED="1304106255177" TEXT="No scrubbing, but IPSec and TCP needed"/> +</node> +<node CREATED="1304106039107" ID="ID_1294593103" MODIFIED="1304106041870" POSITION="right" TEXT="Viecco"> +<node CREATED="1304106043444" ID="ID_1944305483" MODIFIED="1304106060576" TEXT="TCP/SOCKS to exit"/> +<node CREATED="1304106061076" ID="ID_1331489235" MODIFIED="1304106064478" TEXT="Protocol scrubbing"/> +<node CREATED="1304106180270" ID="ID_831356979" MODIFIED="1304106192569" TEXT="Custom Transport encyrptioon"> +<node CREATED="1304106194038" ID="ID_1724588563" MODIFIED="1304106198664" TEXT="Plan to move to DTLS"/> +</node> +<node CREATED="1304106233583" ID="ID_1784279678" MODIFIED="1304106239593" TEXT="Scrubbing of TCP header"/> +</node> +<node CREATED="1304106756966" ID="ID_642680767" MODIFIED="1304106759137" POSITION="left" TEXT="Cebolla"> +<node CREATED="1304106760390" ID="ID_1045122449" MODIFIED="1304106764145" TEXT="Routes IP"/> +<node CREATED="1304106764583" ID="ID_1496019501" MODIFIED="1304106770201" TEXT="Tunelled over UDP"/> +<node CREATED="1304106770743" ID="ID_1124203747" MODIFIED="1304106774019" TEXT="Nested encryption"/> +</node> +<node CREATED="1304107181901" ID="ID_45616069" MODIFIED="1304107186506" POSITION="right" TEXT="Freedom"> +<node CREATED="1304107186837" ID="ID_1266389197" MODIFIED="1304107220096" TEXT="Scrubbing at stream"/> +<node CREATED="1304107207725" ID="ID_1439067511" MODIFIED="1304107235146" TEXT="Scrubbing at IP packets/encryption"/> +<node CREATED="1304107294207" ID="ID_1626173932" MODIFIED="1304107298306" TEXT="TCP E2E"/> +<node CREATED="1304107362400" ID="ID_495319106" MODIFIED="1304107366588" TEXT="Control over TCP"/> +</node> +</node> +</map> diff --git a/2011/datagram-comparison/datagram-comparison.tex b/2011/datagram-comparison/datagram-comparison.tex new file mode 100644 index 0000000..8a12791 --- /dev/null +++ b/2011/datagram-comparison/datagram-comparison.tex @@ -0,0 +1,500 @@ +\documentclass[a4paper]{article} +\usepackage{a4wide} +\usepackage{upgreek} +\usepackage{palatino} +\usepackage{fancyhdr} +\usepackage{color} +\usepackage{graphicx} +\usepackage{parskip} +%\immediate\write18{sh ./vc} +\input{vc.tex} +%\usepackage{draftwatermark} + +\usepackage{hyperref} +\hypersetup{colorlinks, citecolor=MyDarkRed, filecolor=MyDarkBlue, linkcolor=MyDarkRed, urlcolor=MyDarkBlue} + +\definecolor{MyDarkBlue}{rgb}{0, 0.0, 0.45} +\definecolor{MyDarkRed}{rgb}{0.45, 0.0, 0} +\definecolor{MyDarkGreen}{rgb}{0, 0.45, 0} +\definecolor{MyLightGray}{gray}{.90} +\definecolor{MyLightGreen}{rgb}{0.5, 0.99, 0.5} + +\usepackage{xspace} +\makeatletter +\newcommand{\ie}{i.e.\@\xspace} +\newcommand{\eg}{e.g.\@\xspace} +\newcommand{\etc}{etc.\@\xspace} +\newcommand{\cf}{cf.\@\xspace} +\newcommand{\vs}{vs.\@\xspace} +\newcommand{\wrt}{w.r.t.\@\xspace} +\newcommand{\etal}{\textit{et al.\@\xspace}} +\newcommand{\detal}{\textit{et al.}} +\newcommand{\ia}{inter alia\xspace} +\makeatother + +\usepackage{prettyref} +%% Non-breaking space should really be used +\newrefformat{sec}{Section~\ref{#1}} +%% Page numbers seem a bit redundant in a short paper +\newrefformat{tab}{Table~\ref{#1}} +\newrefformat{fig}{Figure~\ref{#1}} +\newrefformat{cha}{Chapter~\ref{#1}} +\newrefformat{app}{Appendix~\ref{#1}} + +\pagestyle{fancy} +\fancyhf{} + +\fancyhead[C]{\sc revision \VCRevisionMod~(\VCDateISO~\VCTime)} +\fancyfoot[C]{\thepage} + +\newcommand{\figref}[1]{\textsf{#1}} + +\title{Comparison of Tor Datagram Designs} +\author{Steven J. Murdoch} +%\renewcommand{\today}{29 March 2011} + +\begin{document} + +\maketitle + +%\setlength{\parindent}{0pt} +%\nonzeroparskip + +\section{Background} + +A number of performance-related problems have been noted with the current Tor +architecture, resulting in many users restricting their Tor usage to only tasks +which are of high sensitivity, or not using Tor at all. +The most comprehensive analysis of Tor's performance was performed by +Reardon~\cite{reardon-thesis}. +In this work, the author identified the major cause of latency was delay in the +output queue at Tor nodes, resulting from TCP flow control. +This delay is considered higher than necessary due to: +\begin{itemize} +\item High-bandwidth streams unfairly trigger congestion avoidance on +low-bandwidth streams; +\item Packet dropping and re-ordering on one stream triggers unnecessary delay on +other streams. +\end{itemize} + +It has been proposed that to improve performance, the node-to-node +communication should be by unreliable datagrams (UDP), rather than the current +reliable in-order streams (TCP). +This is hoped to improve Tor performance by: +\begin{itemize} +\item Allowing better end-to-end congestion management; +\item Reducing queue lengths on nodes; +\item Preventing cell-loss on one circuit delaying cells on other circuits. +\end{itemize} +Also, moving to an underlying datagram transport may make it easier to support +transporting UDP in addition to TCP. More detailed analysis has been performed +by Reardon and Goldberg~\cite{reardon-usenix}. + +\section{Tor's current architecture} + +To understand proposals for modifications to Tor, it is helpful to understand +the current architecture. +This section will describe Tor's protocol stack, and while it does not use +exactly the same terminology as the Tor Protocol Specification, the description +chosen is designed to make it easier to compare with alternative proposals. + +\subsection{Tor circuit extension} + +\begin{figure} +\begin{center} +\includegraphics[scale=0.7]{tor-extension} +\end{center} +\caption{\label{fig:tor-extension}Protocol stack active when extending a +circuit} +\end{figure} + +\prettyref{fig:tor-extension} shows the scenario when the circuit Initiator +(normally termed the Onion Proxy) has a circuit which currently goes through one +intermediate hop, and terminates on Previous. The Initiator then wishes to +extend this circuit to terminate on Next. In this scenario the active layers +are: + +\paragraph{IP} The host operating system IP stack (and lower layers) is +responsible for \textbf{routing IP +packets} between the host and other Tor-nodes. + +\paragraph{TCP} The host operating system TCP stack is responsible for providing +\textbf{hop-by-hop congestion control}, \textbf{in-order delivery}, and +\textbf{reliability} for TLS data. + +\paragraph{TLS} The TLS stack built into Tor (OpenSSL) is responsible for providing +\textbf{hop-by-hop authentication}, \textbf{integrity} and +\textbf{confidentiality}. + +\paragraph{Circuit} The Tor circuit cryptography layer is responsible for +providing \textbf{confidentiality}. It also \textbf{de-multiplexes} between +different circuits being carried by TLS connections and performs +\textbf{label-switching} routing. + +While the Tor software on all nodes is identical, on intermediate nodes, only +the layers up to and including \figref{Circuit} are active. +Cells received from the incoming TLS connection are decrypted, label-switched, +and routed to the outgoing TLS connection according to its routing table. + +\paragraph{Cell auth} Tor's cell authentication provides \textbf{end-to-end integrity} + +\paragraph{Setup} Tor's setup protocol provides \textbf{connection setup and +management} tightly coupled to \textbf{end-to-end authentication and key +exchange}. It is also responsible for end-to-end congestion control. + +The \figref{Setup} layer can interact directly with the \figref{TLS} layer when +a control message is intended for the directly connected party, or via the +\figref{Circuit} and \figref{Cell Auth} layers when the control message must +pass through intermediaries. + +\subsubsection{The circuit extension process} + +In the case of circuit extension, the \figref{Initiator} first wraps the control +message with authentication (\figref{Cell Auth}), two layers of +encryption (\figref{Circuit}) and passes the cell down to TLS. + +\figref{Intermediate} then removes one layer of encryption and passes the cell down +to TLS. + +When \figref{Previous} receives the cell from \figref{TLS}, the final layer of +encryption is removed, the authentication tag is verified and the control +message is processed. +\figref{Previous} will see that the control message indicates circuit extension +(\texttt{RELAY\_EXTEND}), and will send a \texttt{CREATE} control message to +\figref{Next}. + +\subsection{Data transport} + +\begin{figure} +\includegraphics[scale=0.7]{tor-data} +\caption{\label{fig:tor-data}Protocol stack active when carrying data} +\end{figure} + +When an application wishes to send data over Tor, some additional layers are +brought into play. + +\paragraph{Application} The client application wishes to send some stream data +over Tor. + +\paragraph{SOCKS} The \figref{SOCKS} layer encapsulates the stream data with a +SOCKS header and carries out the SOCKS handshake. + +\paragraph{TCP and IP} In addition to transporting TLS data between Tor nodes, +the host TCP/IP stack is also responsible for transporting the SOCKS stream to +the Tor initiator (typically running on the same host as the application). + +\paragraph{Gateway} At the Initiator, Tor's \figref{Gateway} layer receives SOCKS +packets from the application SOCKS layer, extracts the payload data, and splits +it into cells. These are then encapsulated in the same way as control messages, +and passed to the \figref{Exit} node via any intermediaries. This layer is also +responsible for multiplexing multiple application streams over one circuit. + +At the Exit, the \figref{Gateway} layer receives payload data encapsulated in +cells, and sends it out to the appropriate host via the host TCP/IP stack. + +\paragraph{Cell Auth, Circuit, TLS} These layers are unchanged as intermediate +nodes cannot differentiate between control and data transport cells. + +\subsubsection{The data transport process} + +Based on the SOCKS handshake between \figref{SOCKS} on the \figref{Application}, +the Initiator may create and extend circuits as necessary until it has +established a circuit with the \figref{Exit}. + +The \figref{Gateway} layer at the Initiator then then instructs the +\figref{Gateway} layer at the exit to make a plain TCP connection to the host +requested by Initiator, and send the application stream data to it. + +\section{Alternative architecture proposals} + +This section discusses alternative architectures for Tor, involving the addition +of a datagram hop-by-hop transport. + +\subsection{Reardon} + +\begin{figure} +\includegraphics[scale=0.7]{reardon-data} +\caption{\label{fig:reardon-data}The main change in Reardon's proposal is to have 1:1 circuit per TCP connection mapping, rather than Tor's n:1, but TCP connections are still hop-by-hop in both schemes. +To stop the individual connections being apparent to a network observer, TCP frames are wrapped in DTLS encryption. +To allow this wrapping to be performed, a user-space TCP stack is employed, which has the added advantage of reducing usage of kernel-level sockets (a scarce resource on some platforms) and allowing greater customization of congestion control.} +\end{figure} + +Reardon and Goldberg~\cite{reardon-usenix} propose replacing the \figref{TLS} +layer with DTLS (a datagram variant of DTLS) and replacing \figref{TCP} with +UDP, as shown in \prettyref{fig:reardon-data}. +DTLS still provides confidentiality and authenticity, however UDP does not +provide reliability, in-order delivery, or congestion control. + +The authors therefore propose adding TCP back in, but with each pair of nodes +having a separate hop-by-hop user-space TCP connection for each circuit, rather than one +kernel-space TCP connection for all circuits. +For efficiency, the user-space TCP header is compressed by removing redundant +fields. + +Since the user-space TCP provides reliable in-order delivery of Tor cells, there +needs to be no change to the cell encryption or authentication. A user-space TCP stack +also allows more versatile congestion management; for example dropping cells before +they acknowledged when the corresponding exit circuit is congested. + +\subsection{Viecco: UDP-OR} + +Viecco~\cite{viecco}, as shown in \prettyref{fig:viecco-data} uses end-to-end TCP rather than the hop-by-hop approach of Reardon, and uses the +host TCP stack rather than a user-space one. +Also, control traffic is not sent within a TCP stream so is unreliable. +If messages are lost the initiator must detect a timeout and repeat the action. +TCP is end-to-end, thereby allowing middle nodes to drop and re-order packets, but leaving open the possibility of fingerprinting attacks. + +\begin{figure} +\includegraphics[scale=0.7]{viecco-data} +\caption{\label{fig:viecco-data}In the architecture proposed by Viecco, the initiator TCP stack is responsible for splitting SOCKS payload data into TCP frames. +Tor would then transport these frames directly (after compressing and sanitizing some fields), for it to be reassembled by the host TCP stack on the exit node, have any SOCKS header removed, and be emitted again via the host TCP stack. +Intermediate nodes use UDP, with reliability and congestion control managed by the initiator and exit. +A custom link encryption/authentication scheme is used, but DTLS could equally take its place. +The Circuit and Cell Auth cryptography schemes are updated to handle dropped or re-ordered cells.} +\end{figure} + +\subsection{Freedom 2.0} + +\begin{figure} +\includegraphics[scale=0.7]{freedom-data} +\caption{Like Viecco's proposal, TCP is end-to-end, however in Freedom this is initiator to server, rather than initiator to exit.} +\end{figure} + +Full details on Freedom~\cite{freedom2-arch} is not available but it appears that, while like Viecco's proposal, TCP is end-to-end, in Freedom the ends are the Initiator and destination Server, rather than Initiator and Exit. +Like Viecco's proposal, the initiator is responsible for reliability, through its host TCP stack. +However, SOCKS is not used (Freedom captures application data in the host network stack), and control traffic is sent over TCP rather than UDP, and thus may assume reliable in-order delivery. +Freedom also performs protocol filtering, before the data stream is split into TCP frames. + +\subsection{Cebolla and IPPriv} + +Other examples of the Freedom design are Cebolla~\cite{brown} and IPPriv~\cite{kiraly}. +Cebolla is notable for having a restricted topology, however in terms of +transport protocol it appears to be similar to Freedom. IP packets are captured +through a tun device on the initiator, encrypted, and then sent as UDP packets. +At the exit nodes, IP packets are emitted over the tun device. As such, the +characteristics of the initiator TCP stack are exposed to the destination. + +Kiraly~\cite{kiraly} proposes an anonymous communication system based on IPSec: IPPriv. +It operates in a similar way to Tor, with telescoping circuits and link encryption, but uses IPSec for both. +Unlike Tor circuit encryption, IPSec adds a header whether or not authentication is enabled. +Therefore cells must be padded to hide how many layers of encryption is needed, and there is a limit on path length. +Architecturally, IPPriv is similar to Freedom: IP packets are captured at the initiator and emitted at the exit nodes. + +\subsection{Liberatore: 100-tor-spec-udp} + +\begin{figure} +\includegraphics[scale=0.7]{liberatore-data} +\caption{\label{fig:liberatore-data}The Liberatore scheme is largely the same as Tor, except that data is received over UDP SOCKS rather than TCP SOCKS, transported over DTLS/UDP rather than TLS/TCP, and emitted as UDP rather than TCP. To handle the lack of in-order delivery, the Circuit cryptography is changed to have an explicit rather than implicit sequence number, and Cell Auth authenticates cells on the basis of the hash of a single cell rather than a running hash over all cells received in the circuit so far.} +\end{figure} + +Liberatore~\cite{liberatore} proposes a design (shown in \prettyref{fig:liberatore-data}) for the transport of UDP over Tor, but which does not offer in-order reliable delivery, so therefore cannot be used for TCP. +It is intended to work in parallel to the existing TCP variant of Tor, and all control traffic is sent over the existing TLS/TCP connections between nodes; only UDP payload cells are sent over the DTLS/UDP links. + +\section{Transport protocols} + +The transport protocol is used, at a minimum for meeting the in-order reliable transport properties expected by applications to be provided by TCP. + +\subsection{Kernel-mode TCP} + +One option for a transport protocol is to use the kernel TCP stack as a transport protocol. +When TCP sessions are end to end, this introduces a serious anonymity vulnerability as the host operating system could be fingerprinted (if TCP sessions are hop by hop, as in Reardon's proposal, this would not be an issue). +There are also other challenges of using the kernel-mode TCP stack. +Firstly, special operating system access would be needed to intercept packets from virtual network interfaces. +Secondly, Tor would be unable to have low level control over the TCP congestion control algorithms. + +\subsection{User-mode TCP} + +Reardon uses the Daytona TCP stack, which has the difficulty of not being publicly available and under a license incompatible with Tor's +There have been initial attempts to port the FreeBSD TCP stack to user-space, but these are not yet mature. +In any case, Tor will be the primary user of any user-mode TCP stack for the foreseeable future, which could come with significant maintenance costs. + +\subsection{User-mode SCTP} + +When reliability is initiator-to-exit, or hop-by-hop, there is no need to use TCP. +An alternative transport protocol is SCTP, which offers similar functionality to TCP, but with some extra features. +There have been proposals to port the FreeBSD SCTP stack to user-space, and this would be a potential candidate for use in Tor, but the same arguments for user-mode TCP apply to SCTP. + +\subsection{$\upmu$TP} + +$\upmu$TP is a reliable in-order transport protocol using the LEDBAT (Low Extra Delay Background Transport) congestion avoidance algorithm, so as the achieve the following goals: +\begin{itemize} +\item Use all available bandwidth on a link +\item Add little latency +\item Yield to TCP flows using the same bottleneck link +\end{itemize} + +Its major advantage over other user-space alternatives is that it is implemented in libutp\footnote{\url{https://github.com/bittorrent/libutp/}}, and this implementation has seen wide usage. +Therefore if Tor were to adopt this library, we would not be entirely responsible for maintenance, and we have reasonable expectation that there would not be blocking bugs. +However, $\upmu$TP is designed to yield to TCP, whereas Tor will likely aim to be TCP-friendly but not necessarily yield to it. +Also, $\upmu$TP does not have an explicit method to preserve fairness between flows sharing the same link -- one of the main goals of a transport protocol for Tor. +Nevertheless, it may be possible to tweak the parameters of libutp to be more suitable for Tor. + +\subsection{CurveCP} + +CurveCP is a transport protocol offering congestion management and reliable in-order delivery. +It also implements mandatory encryption and authentication. +While both of these are required, they are not suitable for use within datagram-Tor directly. +Firstly, hop-by-hop encryption and authentication may need to be performed without reliable in-order delivery. +Secondly, the circuit encryption must be done without increasing length but CurveCP increases message lengths to accommodate the authentication tag. + +Even so, it would be possible to use CurveCP as the transport protocol, and accept the inefficiency of encrypting data which is already encrypted. +End-to-end authentication is desirable, so this feature would be of use although it would be inefficient to use the CurveCP handshake protocol when the two ends already share a key. + +Alternatively, CurveCP could be refactored to separate out the congestion control and reliable in-order delivery and use this as an end-to-end transport protocol. +Also, the encryption and authentication could be used for hop-to-hop links, but with reliable in-order delivery disabled. + +A user-mode implementation for CurveCP is available\footnote{See \texttt{curvecp/} in \url{http://hyperelliptic.org/nacl/nacl-20110221.tar.bz2}}, but does not include an explicit copyright statement. +However related software from the author (Curve25519) was released into the public domain, so it is likely that CurveCP will also be. + +\section{Design decisions to be made} + +\subsection{Reliability and congestion control end-points and granularity} + +A variety of options are available for the end-points for reliability and congestion control protocols. +In Tor, TCP is used for both reliability and congestion control, on a hop-by-hop basis, with link level granularity. +In Reardon's proposal, TCP is still hop-by-hop, but at circuit level granularity. +With Viecco's proposal, TCP is initiator-to-exit, at stream level. +Finally, Freedom, IPPriv, and Cebolla all have TCP initiator-to-server. + +An advantage of initiator-to-exit/server reliability is that intermediate nodes may drop cells when load is high, and rely on congestion control to reduce the data rate. +In contrast, with hop-by-hop reliability, once a cell has been acknowledged, it may not be dropped. +However, circuit level cryptography is made easier and more efficient if it can assume reliability from the underlying transport. + +A risk of initiator-to-exit/server reliability is that the characteristics of the reliability protocol are exposed to nodes other than those which the initiator directly connects to. +This raises the possibility of fingerprinting, especially if the initiator's host networking stack is used. + +Link level granularity should in principle have lower overhead, but has the disadvantage that lost cells from one circuit will cause unnecessary delay on other circuits. +Circuit level granularity, as proposed by Reardon, removes this problem and thus decreases latency when there is packet loss. +Stream level granularity requires initiator-to-exit/server reliability as the stream level is only exposed to the exit node and server, but in principle should reduce unnecessary delay even more. + +Of course it is not necessary for reliability and congestion control to be linked, but existing transport protocols offer both. +Tor currently uses TCP for link level congestion control, but uses a custom algorithm for circuit and stream level. +Unless stream level granularity is used for the transport-protocol-provided congestion control, it is likely that some other congestion control algorithm will be needed to preserve fairness between different streams on a circuit. + +\subsection{First-hop protocol} + +The primary reason to use a datagram transport is to reduce congestion within the core network. +Therefore, it is not essential to use datagram transport for the connection from initiator to first-hop. +Bridge users, who desire censorship-resistance may therefore wish to continuing using TLS over TCP, rather than datagrams. +This will be relatively simple to accommodate with hop-to-hop reliability. +However, with initiator to exit/server reliability, either there would need to be TCP within TCP (and the consequential performance impact), or the bridge node would need to be the TCP end point, rather than initiator. + +It may however be desirable to use a datagram transport for the first-hop when used in conjunction with pluggable transports. +This is because the pluggable transport would not need to provide reliability and so could run over UDP with little difficulty (\eg disguising traffic as VoIP). +Even with TCP-based pluggable transports, switching to datagram transport for the first hop could be useful. +For example, while HTTP runs over TCP, it does not provide in-order reliable transport when multiple connections would be used (as is the case for any realistic implementation). + +\subsection{Migration path} + +Clearly it is essential that there be a smooth transition between the existing TCP transport and datagram transport. +It is also necessary that the initial users of datagram transports are sufficiently numerous so as not to be deanonymized. +It would also be desirable to make maximum usage of nodes which have been upgraded to support datagram transports. + +Therefore, Tor would have to support both TCP and datagram transports until a sufficient proportion of the network has upgraded. +If TCP is still used for first-hop connections, Tor nodes would have to support TCP for the foreseeable future. + +With hop-by-hop reliability, it would be possible to use datagram transports for segments of a circuit where a pair of nodes support datagram transports. +In contrast, with initiator-to-exit/server reliability, all hops for a circuit would need to support datagram transports for a circuit to use datagram transports. +This means that more circuits would able to, at least partially, use datagram transports for hop-by-hop reliability. + +So as to preserve the anonymity set of datagram transport users, clients should not use datagram transports until a sufficient number of other clients support them. +This could be achieved by having a flag in the consensus which states whether datagram transports should be used. +This flag would only be set once enough of the network supports datagram transports, on the assumption that clients upgrade roughly as frequently as nodes. + +The need for collective action is less severe for hop-by-hop reliability because the datagram transport is only visible on a hop-by-hop basis. +However, it should be assumed that whether a circuit is using hop-by-hop reliability will be visible to other hops on the circuit based on traffic characteristics. +For initiator-to-exit/server reliability whether the initiator supports datagram transport will be clearly visible to all hops on the circuit. + +\subsection{Transport protocol} + +A transport protocol will need to be selected, such as $\upmu$TP, CurveCP, TCP or SCTP (user-mode or kernel-mode). + +\subsection{Hop-to-hop encryption and authenticity} + +For all schemes considered, hop-by-hop encryption is required to hide which packet belongs to which circuit; authenticity is also highly desirable. +Currently Tor uses TLS, but this requires a reliable link layer, which is likely to be eliminated to reduce unnecessary delay in conditions of packet loss. +The ``natural'' choice would be to use DTLS, as adopted by Reardon, but a custom protocol, such as that adopted by Viecco, is another possibility. +CurveCP includes a suitable link layer encryption, but the implementation tightly couples the encryption/authentication layer with the reliability and congestion control. + +\subsection{Socket usage} + +One current limiting factor for Tor nodes running on Windows is limitations on number of sockets. +%TODO: Is this fixed by iocp? +All the proposed datagram schemes with user-space reliability protocols reduce socket usage on intermediate nodes, which may be beneficial if the IOCP functionality in libevent does not completely solve this issue. +However high socket usage is potentially still an issue on exit nodes, except for those proposals which use initiator-to-server reliability. + +\subsection{Circuit encryption and cell authentication} + +Tor's current circuit encryption scheme is AES CTR mode without explicit IVs. +This approach depends on a reliable in-order transport so where reliability is above circuit encryption in the protocol stack (as it is with initiator-to-exit/server reliability), a different approach would be needed. +The most obvious way of extending circuit encryption would be to include an IV in every cell, which would increase the protocol overhead but allow cells to be dropped or re-ordered without affecting the decryption of others. +For hop-by-hop reliability, circuit encryption is above reliability and so no change is needed. + +Tor's current cell authentication scheme is to include a running digest over all cells sent on this circuit. +The digest is only 32 bits, on the basis that a circuit is destroyed if the digest doesn't match and therefore in the event that a cell is not detected as corrupted immediately, it is very likely that the following cell will be rejected and the circuit destroyed. + +Calculating a running digest is possible with hop-by-hop reliability so there need be no change to cell authentication for this approach. +However with Liberatore's and Viecco's approach, cell authentication is performed at a lower layer in the protocol stack than any reliability protocol and so a running digest is no longer suitable. +Therefore a cell digest could be used, but to give similar security guarantees, the digest length would need to be extended. + +Tor does not guarantee authenticity of cells, mainly because this would require a non-length-preserving cell encryption and thus limit path lengths and require padding to hide how many layers of encryption are in place. +The path length limit is no longer an issue because there are other methods in place for Tor to limit path length, however padding may still be undesirable for efficiency reasons. +Tor's lack of cell authenticity permits tagging attacks, but this is explicitly permitted by the Tor threat model. +If this is considered a problem, an approach like Kiraly's, which includes hop-by-hop cell authentication, could be adopted. + +\subsection{Carrying UDP traffic} + +The primary motivation for Tor datagram transports is to improve the performance of TCP over Tor. +However, it may also be desirable to allow UDP to be sent over Tor, for example VoIP traffic. +All the schemes which use initiator-to-server reliability will naturally support UDP, as Tor would not need to even know the protocol type of packets. +Liberatore's proposal is explicitly designed to support UDP, although UDP packets will not be indistinguishable from TCP packets because they are inside different link-layer encapsulations. +Viecco's proposal could be easily extended to transport UDP, if the SOCKS server on the exit node were extended to support UDP. +Reardon's proposal is more challenging to support UDP because reliability is ensured at the circuit layer and so any dropped cells will be re-transmitted, which will defeat the purpose of the application using UDP in the first place. +Circuits could be marked as not needing reliability, but a different circuit encryption and cell authentication scheme would need to be used for these; also such circuits would be distinguishable from TCP circuits by intermediate nodes. + +\subsection{Carrying ACK messages} + +ACK messages needed for reliability and congestion control may need to be treated specially because they are much shorter than data packets. +It would be possible to pad them to the same size as data packets, but this may be inefficient. +With hop-by-hop reliability, ACK packets would be encrypted using DTLS which only adds a small amount of padding, so an external adversary would likely be able to tell which packets are ACK messages and thus learn something about the circuits being carried. +With initiator-to-server/exit reliability the situation is more problematic as now information on traffic characteristics would be more visible to middle nodes. + +\paragraph{Unreliable control messages} + +Viecco proposes that control messages should not be carried in a reliable transport. +A transport session is set up only between Initiator and Exit and only used for carrying data. +This is best option in terms of minimizing state on intermediate Tor nodes, and is the closest to the standard Internet router model. +It also reduces the overhead of setting up transport streams for carrying control messages. +However it is complex from a protocol-design perspective as all participants must assume that any control message may be dropped at any point and arbitrarily re-ordered. +In principle control messages may be corrupted too, but the hop-by-hop integrity protocol should prevent this from happening. + +\section{Recommendations and future study} + +This section proposes a set of provisional recommendations and raises questions which should be answered in further analysis. + +\subsection{Architecture} + +The most fundamental question to be resolved is the overall architecture: hop-by-hop reliability (\eg Reardon), initiator-to-exit reliability (\eg Viecco) or initiator-to-server reliability (\eg Freedom). +There are arguments for each approach, but in the absence of conclusive performance results, one approach is to guide the architecture by engineering and deployment difficulties. +Initiator-to-server reliability would require low-level access on exit nodes, so as to generate raw packets, which could put pressure on the already scarce resource of exit bandwidth. +Initiator-to-exit has the problem that the cryptographic protocols would need to be modified to handle the lack of reliable in-order delivery of cells. +In comparison, this makes hop-by-hop reliability (\eg Reardon) the most promising approach. + +\subsection{Transport protocol} + +No single candidate for transport protocol is the obvious choice. +The anonymity and engineering difficulties with using the kernel-mode TCP stack suggest that this approach is not suitable, except perhaps for experimentation. +User-mode TCP or SCTP stacks are possible, but are not yet available in a usable form. +$\upmu$TP and CurveCP are readily available, but $\upmu$TP would be the easiest to integrate and so is a good choice for testing. +Further study is needed as to whether investing engineering time in user-mode TCP or SCTP is a good choice, compared to analyzing and tuning $\upmu$TP so that it has the properties required. + +\subsection{Other trade offs} + +A consequence of adoption hop-by-hop reliability is that Tor would remain able only to carry TCP traffic. +This may be the prudent engineering choice, so as to avoid having to change many aspects of Tor at the same time. +Nevertheless, if VoIP and similar protocols are strongly desirable, it may be worth revisiting this decision. + +\bibliographystyle{alpha} +\bibliography{references} + +\end{document} diff --git a/2011/datagram-comparison/freedom-data.svg b/2011/datagram-comparison/freedom-data.svg new file mode 100644 index 0000000..4a032ff --- /dev/null +++ b/2011/datagram-comparison/freedom-data.svg @@ -0,0 +1,717 @@ +<?xml version="1.0" encoding="UTF-8" standalone="no"?> + + +<svg + xmlns:dc="http://purl.org/dc/elements/1.1/" + xmlns:cc="http://creativecommons.org/ns#" + xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" + xmlns:svg="http://www.w3.org/2000/svg" + xmlns="http://www.w3.org/2000/svg" + xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd" + xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape" + width="770.74414" + height="243.13622" + id="svg2" + version="1.1" + inkscape:version="0.48.2 r9819" + sodipodi:docname="freedom-data.svg"> + <defs + id="defs4" /> + <sodipodi:namedview + id="base" + pagecolor="#ffffff" + bordercolor="#666666" + borderopacity="1.0" + inkscape:pageopacity="0.0" + inkscape:pageshadow="2" + inkscape:zoom="2" + inkscape:cx="365.70855" + inkscape:cy="164.31269" + inkscape:document-units="px" + inkscape:current-layer="layer1" + showgrid="true" + inkscape:window-width="1676" + inkscape:window-height="1030" + inkscape:window-x="0" + inkscape:window-y="18" + inkscape:window-maximized="0" + showguides="true" + inkscape:guide-bbox="true" + fit-margin-top="5" + fit-margin-left="5" + fit-margin-right="5" + fit-margin-bottom="5"> + <inkscape:grid + type="xygrid" + id="grid4099" + empspacing="5" + visible="true" + enabled="true" + snapvisiblegridlinesonly="true" + dotted="false" + spacingx="5px" + spacingy="5px" /> + </sodipodi:namedview> + <metadata + id="metadata7"> + <rdf:RDF> + <cc:Work + rdf:about=""> + <dc:format>image/svg+xml</dc:format> + <dc:type + rdf:resource="http://purl.org/dc/dcmitype/StillImage" /> + <dc:title></dc:title> + </cc:Work> + </rdf:RDF> + </metadata> + <g + inkscape:label="Layer 1" + inkscape:groupmode="layer" + id="layer1" + transform="translate(-59.970703,-409.42775)"> + <rect + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3081-7" + width="60" + height="20" + x="533.96655" + y="572.36218" + rx="3" + ry="5" /> + <rect + ry="5" + rx="6.2514648" + y="467.56396" + x="534.94141" + height="20" + width="125.0293" + id="rect3069" + style="fill:#91cf60;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <rect + style="fill:#91cf60;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3063" + width="100" + height="20" + x="250" + y="467.76575" + rx="5" + ry="5" /> + <text + sodipodi:linespacing="125%" + id="text3167" + y="427.76575" + x="69.150642" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + xml:space="preserve"><tspan + y="427.76575" + x="69.150642" + id="tspan3169" + sodipodi:role="line">Application</tspan></text> + <rect + ry="5" + rx="5" + y="627.56396" + x="64.970703" + height="20" + width="100" + id="rect3131" + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3133" + y="642.10071" + x="108.71826" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="642.10071" + x="108.71826" + id="tspan3135" + sodipodi:role="line">IP</tspan></text> + <rect + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3137" + width="100" + height="20" + x="64.970703" + y="602.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="103.15454" + y="616.73035" + id="text3139" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3141" + x="103.15454" + y="616.73035" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">TCP</tspan></text> + <rect + ry="5" + rx="5" + y="492.76575" + x="250" + height="20" + width="100" + id="rect3155" + style="fill:#d9ef8b;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3157" + y="507.23938" + x="270.72778" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="507.23938" + x="270.72778" + id="tspan3159" + sodipodi:role="line">Cell Auth</tspan></text> + <rect + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3161" + width="125" + height="20" + x="225" + y="442.76575" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="260.82227" + y="455.97083" + id="text3163" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3165" + x="260.82227" + y="455.97083" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Gateway</tspan></text> + <rect + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3173" + width="60.029297" + height="20" + x="289.9707" + y="627.36218" + rx="3.0014648" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="314.9707" + y="642.10071" + id="text3175" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3177" + x="314.9707" + y="642.10071" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">IP</tspan></text> + <rect + style="fill:#fee08b;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3185" + width="100" + height="20" + x="250" + y="542.36218" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="259.9707" + y="557.56396" + id="text3187" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3189" + x="259.9707" + y="557.56396" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Link Crypto</tspan></text> + <rect + ry="5" + rx="5" + y="517.56396" + x="250" + height="20" + width="100" + id="rect3191" + style="fill:#fffebf;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + xml:space="preserve" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + x="254.87225" + y="427.56396" + id="text3209" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3211" + x="254.87225" + y="427.56396">Initiator</tspan></text> + <text + sodipodi:linespacing="125%" + id="text3231" + y="427.56396" + x="409.9707" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + xml:space="preserve"><tspan + y="427.56396" + x="409.9707" + id="tspan3233" + sodipodi:role="line">Intermediate</tspan></text> + <rect + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3237" + width="100" + height="20" + x="400" + y="627.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="443.74756" + y="642.10071" + id="text3239" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3241" + x="443.74756" + y="642.10071" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">IP</tspan></text> + <rect + ry="5" + rx="5" + y="572.56396" + x="400" + height="20" + width="100" + id="rect3243" + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3245" + y="587.09436" + x="438.18384" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="587.09436" + x="438.18384" + id="tspan3247" + sodipodi:role="line">UDP</tspan></text> + <rect + style="fill:#fee08b;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3249" + width="100" + height="20" + x="400" + y="542.56396" + rx="5" + ry="5" /> + <rect + ry="5" + rx="5" + y="517.91931" + x="401.12427" + height="20" + width="100" + id="rect3255" + style="fill:#ffffbf;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3257" + y="532.56396" + x="429.9707" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="532.56396" + x="429.9707" + id="tspan3259" + sodipodi:role="line">Circuit</tspan></text> + <rect + ry="5" + rx="7.75" + y="627.56396" + x="534.9707" + height="20" + width="155" + id="rect3275" + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3277" + y="642.30249" + x="591.21826" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="642.30249" + x="591.21826" + id="tspan3279" + sodipodi:role="line">IP</tspan></text> + <rect + ry="5" + rx="6.2501464" + y="542.83179" + x="534.96777" + height="20" + width="125.00293" + id="rect3287" + style="fill:#fee08b;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + xml:space="preserve" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + x="579.94141" + y="427.56396" + id="text3311" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3313" + x="579.94141" + y="427.56396">Exit</tspan></text> + <text + sodipodi:linespacing="125%" + id="text3193" + y="532.4104" + x="278.84644" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="532.4104" + x="278.84644" + id="tspan3195" + sodipodi:role="line">Circuit</tspan></text> + <rect + ry="5" + rx="5.9899106" + y="-245" + x="442.76575" + height="20" + width="204.7982" + id="rect3144" + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" + transform="matrix(0,1,-1,0,0,0)" /> + <rect + style="fill:#ffffbf;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3356" + width="100" + height="20" + x="64.970703" + y="518.1958" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="99.226562" + y="531.50635" + id="text3358" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3360" + x="99.226562" + y="531.50635" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">HTTP</tspan></text> + <path + sodipodi:nodetypes="cccc" + inkscape:connector-curvature="0" + id="path3075" + d="m 194.9707,637.56395 -35,0 c -10,0 -0.0293,-109.99998 -10.0293,-109.99998 l -14.9707,0" + style="fill:none;stroke:#980101;stroke-width:1.17260385px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" /> + <rect + style="fill:#d9ef8b;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3366" + width="125.00293" + height="20" + x="534.96777" + y="492.56396" + rx="6.2501464" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="566.97949" + y="507.0376" + id="text3368" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3370" + x="566.97949" + y="507.0376" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Cell Auth</tspan></text> + <rect + style="fill:#ffffbf;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3372" + width="125.00293" + height="20" + x="534.96777" + y="517.56396" + rx="6.2501464" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="572.84644" + y="532.4104" + id="text3374" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3376" + x="572.84644" + y="532.4104" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Circuit</tspan></text> + <rect + ry="5" + rx="5.5999999" + y="442.56396" + x="534.9707" + height="20" + width="140" + id="rect3378" + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <rect + transform="matrix(0,1,-1,0,0,0)" + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3380" + width="179.99997" + height="20" + x="442.56396" + y="-684.9707" + rx="8.999999" + ry="5" /> + <text + sodipodi:linespacing="125%" + id="text3382" + y="455.76904" + x="570.79297" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="455.76904" + x="570.79297" + id="tspan3384" + sodipodi:role="line">Gateway</tspan></text> + <path + style="fill:none;stroke:#980101;stroke-width:1.01379383px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" + d="m 624.9414,452.56397 45.0293,0 c 15,0 -5,185.20739 10,185 l 15,0 c 5,0 15,0 20,0" + id="path4156" + inkscape:connector-curvature="0" + sodipodi:nodetypes="csccc" /> + <path + style="fill:none;stroke:#000000;stroke-width:0.89805281;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:2.69415846, 2.69415846;stroke-dashoffset:0" + d="m 189.9707,567.56397 500.0293,0" + id="path3242" + inkscape:connector-curvature="0" /> + <text + sodipodi:linespacing="125%" + id="text4012" + y="560.56396" + x="194.9707" + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="560.56396" + x="194.9707" + id="tspan4014" + sodipodi:role="line">Tor</tspan></text> + <text + xml:space="preserve" + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="194.9707" + y="580.56396" + id="text4016" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan4018" + x="194.9707" + y="580.56396" + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Host</tspan></text> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="278.39062" + y="482.23938" + id="text3065" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3067" + x="278.39062" + y="482.23938" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Stream</tspan></text> + <text + sodipodi:linespacing="125%" + id="text3071" + y="482.0376" + x="572.36133" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="482.0376" + x="572.36133" + id="tspan3073" + sodipodi:role="line">Stream</tspan></text> + <text + xml:space="preserve" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + x="749.10986" + y="427.76575" + id="text3069" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3071" + x="749.10986" + y="427.76575">Server</tspan></text> + <rect + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3073" + width="100" + height="20" + x="725.71484" + y="627.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="769.4624" + y="642.10071" + id="text3075" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3077" + x="769.4624" + y="642.10071" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">IP</tspan></text> + <rect + ry="5" + rx="5" + y="602.56396" + x="725.71484" + height="20" + width="100" + id="rect3079" + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3081" + y="617.09436" + x="763.89868" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="617.09436" + x="763.89868" + id="tspan3083" + sodipodi:role="line">TCP</tspan></text> + <rect + ry="5" + rx="5" + y="542.56396" + x="725.71484" + height="20" + width="100" + id="rect3091" + style="fill:#ffffbf;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3093" + y="557.56396" + x="759.9707" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="557.56396" + x="759.9707" + id="tspan3095" + sodipodi:role="line">HTTP</tspan></text> + <path + sodipodi:nodetypes="ccccc" + inkscape:connector-curvature="0" + id="path3097" + d="m 679.9707,637.56397 c 5,0 20,0 25,0 l 30.0293,-1e-5 c 10,0 -0.0293,-84.99999 9.9707,-84.99999 l 10,0" + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" /> + <rect + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3081" + width="60" + height="20" + x="289.9707" + y="572.36218" + rx="3" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="305.94556" + y="587.09436" + id="text3083" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3085" + x="305.94556" + y="587.09436" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">UDP</tspan></text> + <path + style="fill:none;stroke:#980101;stroke-width:1.02353275px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" + d="m 360,637.56396 45,0 c 10,0 -0.0293,-109.99999 9.9707,-109.99999 l 10,0 m 50,0 10,0 c 10,0 0.0293,109.99999 10.0293,109.99999 l 20,0" + id="path3364" + inkscape:connector-curvature="0" + sodipodi:nodetypes="ccsccscc" /> + <path + sodipodi:nodetypes="cccc" + inkscape:connector-curvature="0" + id="path3080" + d="m 515,637.56396 24.9707,1e-5 c 15,0 0,-185 15,-185 l 10,0" + style="fill:none;stroke:#980101;stroke-width:1.01379383px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" /> + <path + sodipodi:nodetypes="cccccccc" + inkscape:connector-curvature="0" + id="path3362" + d="m 190,637.56396 40,0 c 15,0 -0.0293,-184.99999 14.9707,-184.99999 l 15,0 m 55,0 15,0 c 15,0 0.0293,185.20738 15.0293,184.99999 l 15,0" + style="fill:none;stroke:#980101;stroke-width:1.01379383px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="412.9707" + y="557.56396" + id="text3187-6" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3189-5" + x="412.9707" + y="557.56396" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Link Crypto</tspan></text> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="559.9707" + y="557.56396" + id="text3187-69" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3189-3" + x="559.9707" + y="557.56396" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Link Crypto</tspan></text> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="549.94141" + y="587.09436" + id="text3083-4" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3085-5" + x="549.94141" + y="587.09436" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">UDP</tspan></text> + </g> +</svg> diff --git a/2011/datagram-comparison/liberatore-data.svg b/2011/datagram-comparison/liberatore-data.svg new file mode 100644 index 0000000..523c72a --- /dev/null +++ b/2011/datagram-comparison/liberatore-data.svg @@ -0,0 +1,742 @@ +<?xml version="1.0" encoding="UTF-8" standalone="no"?> + + +<svg + xmlns:dc="http://purl.org/dc/elements/1.1/" + xmlns:cc="http://creativecommons.org/ns#" + xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" + xmlns:svg="http://www.w3.org/2000/svg" + xmlns="http://www.w3.org/2000/svg" + xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd" + xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape" + width="770.74414" + height="218.13622" + id="svg2" + version="1.1" + inkscape:version="0.48.2 r9819" + sodipodi:docname="liberatore-data.svg"> + <sodipodi:namedview + id="base" + pagecolor="#ffffff" + bordercolor="#666666" + borderopacity="1.0" + inkscape:pageopacity="0.0" + inkscape:pageshadow="2" + inkscape:zoom="1.4" + inkscape:cx="432.52595" + inkscape:cy="92.575241" + inkscape:document-units="px" + inkscape:current-layer="webslicer-layer" + showgrid="true" + inkscape:window-width="1676" + inkscape:window-height="1031" + inkscape:window-x="0" + inkscape:window-y="0" + inkscape:window-maximized="0" + showguides="true" + inkscape:guide-bbox="true" + fit-margin-top="5" + fit-margin-left="5" + fit-margin-right="5" + fit-margin-bottom="5"> + <inkscape:grid + spacingy="5px" + spacingx="5px" + dotted="false" + snapvisiblegridlinesonly="true" + enabled="true" + visible="true" + empspacing="5" + id="grid4099" + type="xygrid" /> + </sodipodi:namedview> + <defs + id="defs4" /> + <metadata + id="metadata7"> + <rdf:RDF> + <cc:Work + rdf:about=""> + <dc:format>image/svg+xml</dc:format> + <dc:type + rdf:resource="http://purl.org/dc/dcmitype/StillImage" /> + <dc:title /> + </cc:Work> + </rdf:RDF> + </metadata> + <g + transform="translate(-59.970703,-434.42775)" + id="layer1" + inkscape:groupmode="layer" + inkscape:label="Layer 1"> + <rect + style="fill:#91cf60;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3069" + width="100" + height="20" + x="549.9707" + y="497.56396" + rx="5" + ry="5" /> + <rect + ry="5" + rx="5" + y="497.56396" + x="250" + height="20" + width="100" + id="rect3063" + style="fill:#91cf60;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + xml:space="preserve" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + x="69.249092" + y="452.76575" + id="text3167" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3169" + x="69.249092" + y="452.76575">Application</tspan></text> + <rect + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3131" + width="100" + height="20" + x="64.970703" + y="627.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="108.71826" + y="642.10071" + id="text3133" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3135" + x="108.71826" + y="642.10071" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">IP</tspan></text> + <rect + ry="5" + rx="5" + y="602.56396" + x="64.970703" + height="20" + width="100" + id="rect3137" + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3139" + y="617.09436" + x="103.15454" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="617.09436" + x="103.15454" + id="tspan3141" + sodipodi:role="line">UDP</tspan></text> + <rect + style="fill:#d9ef8b;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3155" + width="100" + height="20" + x="250" + y="522.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="270.72778" + y="537.0376" + id="text3157" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3159" + x="270.72778" + y="537.0376" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Cell Auth</tspan></text> + <rect + ry="5" + rx="5" + y="472.56396" + x="225" + height="20" + width="125" + id="rect3161" + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3163" + y="485.76904" + x="260.82227" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="485.76904" + x="260.82227" + id="tspan3165" + sodipodi:role="line">Gateway</tspan></text> + <rect + ry="5" + rx="6.25" + y="627.36218" + x="225" + height="20" + width="125" + id="rect3173" + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3175" + y="642.10071" + x="281.24756" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="642.10071" + x="281.24756" + id="tspan3177" + sodipodi:role="line">IP</tspan></text> + <rect + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3179" + width="125" + height="20" + x="225" + y="602.36218" + rx="6.25" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="275.68384" + y="617.09436" + id="text3181" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3183" + x="275.68384" + y="617.09436" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">UDP</tspan></text> + <rect + ry="5" + rx="5" + y="572.36218" + x="250" + height="20" + width="100" + id="rect3185" + style="fill:#fee08b;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3187" + y="587.09436" + x="288.66309" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="587.09436" + x="288.66309" + id="tspan3189" + sodipodi:role="line">DTLS</tspan></text> + <rect + style="fill:#ffffbf;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3191" + width="100" + height="20" + x="250" + y="547.36218" + rx="5" + ry="5" /> + <text + sodipodi:linespacing="125%" + id="text3209" + y="452.56396" + x="254.9707" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + xml:space="preserve"><tspan + y="452.56396" + x="254.9707" + id="tspan3211" + sodipodi:role="line">Initiator</tspan></text> + <text + xml:space="preserve" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + x="410.06915" + y="452.56396" + id="text3231" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3233" + x="410.06915" + y="452.56396">Intermediate</tspan></text> + <rect + ry="5" + rx="5" + y="627.56396" + x="400" + height="20" + width="100" + id="rect3237" + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3239" + y="642.10071" + x="443.74756" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="642.10071" + x="443.74756" + id="tspan3241" + sodipodi:role="line">IP</tspan></text> + <rect + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3243" + width="100" + height="20" + x="400" + y="602.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="438.18384" + y="617.09436" + id="text3245" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3247" + x="438.18384" + y="617.09436" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">UDP</tspan></text> + <rect + ry="5" + rx="5" + y="572.56396" + x="400" + height="20" + width="100" + id="rect3249" + style="fill:#fee08b;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3251" + y="587.09436" + x="438.66309" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="587.09436" + x="438.66309" + id="tspan3253" + sodipodi:role="line">DTLS</tspan></text> + <rect + style="fill:#ffffbf;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3255" + width="100" + height="20" + x="400" + y="547.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="428.84644" + y="562.20862" + id="text3257" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3259" + x="428.84644" + y="562.20862" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Circuit</tspan></text> + <rect + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3275" + width="125" + height="20" + x="550" + y="627.56396" + rx="6.25" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="606.24756" + y="642.30249" + id="text3277" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3279" + x="606.24756" + y="642.30249" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">IP</tspan></text> + <rect + ry="5" + rx="6.25" + y="603.03125" + x="549.53125" + height="20" + width="125" + id="rect3281" + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3283" + y="617.29614" + x="600.68384" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="617.29614" + x="600.68384" + id="tspan3285" + sodipodi:role="line">UDP</tspan></text> + <rect + style="fill:#fee08b;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3287" + width="100" + height="20" + x="550" + y="572.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="588.66309" + y="587.29614" + id="text3289" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3291" + x="588.66309" + y="587.29614" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">DTLS</tspan></text> + <text + sodipodi:linespacing="125%" + id="text3311" + y="454.56067" + x="593.8512" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + xml:space="preserve"><tspan + y="454.56067" + x="593.8512" + id="tspan3313" + sodipodi:role="line">Exit</tspan></text> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="278.84644" + y="562.20862" + id="text3193" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3195" + x="278.84644" + y="562.20862" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Circuit</tspan></text> + <rect + transform="matrix(0,1,-1,0,0,0)" + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3144" + width="119.99999" + height="20" + x="472.56396" + y="-245" + rx="5.9999995" + ry="5" /> + <rect + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3350" + width="100" + height="20" + x="64.970703" + y="572.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="94.436523" + y="586.93213" + id="text3352" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3354" + x="94.436523" + y="586.93213" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">SOCKS</tspan></text> + <rect + ry="5" + rx="5" + y="547.56396" + x="64.970703" + height="20" + width="100" + id="rect3356" + style="fill:#ffffbf;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3358" + y="560.87451" + x="99.226562" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="560.87451" + x="99.226562" + id="tspan3360" + sodipodi:role="line">VoIP</tspan></text> + <path + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" + d="m 190,637.56396 40,0 c 15,0 -0.0293,-155.00001 14.9707,-155.00001 l 15,0 m 55,0 15,0 c 15,0 0.0293,155.20179 15.0293,155.00001 l 15,0" + id="path3362" + inkscape:connector-curvature="0" + sodipodi:nodetypes="cccccccc" /> + <path + sodipodi:nodetypes="cccccccc" + inkscape:connector-curvature="0" + id="path3364" + d="m 360,637.56396 45,0 c 10,0 -0.0293,-80 9.9707,-80 l 10,0 m 50,0 10,0 c 10,0 0.0293,80 10.0293,80 l 20,0" + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" /> + <path + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" + d="m 194.9707,637.56395 -35,0 c -10,0 -0.0293,-80 -10.0293,-80 l -14.9707,0" + id="path3075" + inkscape:connector-curvature="0" + sodipodi:nodetypes="cccc" /> + <rect + ry="5" + rx="5" + y="522.56396" + x="550" + height="20" + width="100" + id="rect3366" + style="fill:#d9ef8b;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3368" + y="537.0376" + x="572.97949" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="537.0376" + x="572.97949" + id="tspan3370" + sodipodi:role="line">Cell Auth</tspan></text> + <rect + ry="5" + rx="5" + y="547.56396" + x="550" + height="20" + width="100" + id="rect3372" + style="fill:#ffffbf;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3374" + y="562.4104" + x="578.84644" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="562.4104" + x="578.84644" + id="tspan3376" + sodipodi:role="line">Circuit</tspan></text> + <rect + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3378" + width="125" + height="20" + x="550" + y="472.56396" + rx="5" + ry="5" /> + <rect + ry="5" + rx="5.9999995" + y="-675" + x="472.56396" + height="20" + width="119.99999" + id="rect3380" + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" + transform="matrix(0,1,-1,0,0,0)" /> + <path + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" + d="m 515,637.56396 40,0 c 15,0 -0.0293,-155.00001 14.9707,-155.00001 l 15,0" + id="path3080" + inkscape:connector-curvature="0" + sodipodi:nodetypes="cccc" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="585.82227" + y="485.76904" + id="text3382" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3384" + x="585.82227" + y="485.76904" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Gateway</tspan></text> + <path + sodipodi:nodetypes="cscc" + inkscape:connector-curvature="0" + id="path4156" + d="m 639.9707,482.56395 15,0 c 15,0 0.0293,155.20179 15.0293,155.00001 l 20,0" + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" /> + <path + inkscape:connector-curvature="0" + id="path3242" + d="m 189.9707,597.56396 500.0293,0" + style="fill:none;stroke:#000000;stroke-width:0.89805281;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:2.69415846, 2.69415846;stroke-dashoffset:0" /> + <text + xml:space="preserve" + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="194.9707" + y="590.56396" + id="text4012" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan4014" + x="194.9707" + y="590.56396" + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Tor</tspan></text> + <text + sodipodi:linespacing="125%" + id="text4016" + y="610.56396" + x="194.9707" + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="610.56396" + x="194.9707" + id="tspan4018" + sodipodi:role="line">Host</tspan></text> + <text + sodipodi:linespacing="125%" + id="text3065" + y="512.0376" + x="278.39062" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="512.0376" + x="278.39062" + id="tspan3067" + sodipodi:role="line">Stream</tspan></text> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="578.36133" + y="512.0376" + id="text3071" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3073" + x="578.36133" + y="512.0376" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Stream</tspan></text> + <text + sodipodi:linespacing="125%" + id="text3069" + y="452.76575" + x="749.20831" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + xml:space="preserve"><tspan + y="452.76575" + x="749.20831" + id="tspan3071" + sodipodi:role="line">Server</tspan></text> + <rect + ry="5" + rx="5" + y="627.56396" + x="725.71484" + height="20" + width="100" + id="rect3073" + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3075" + y="642.10071" + x="769.4624" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="642.10071" + x="769.4624" + id="tspan3077" + sodipodi:role="line">IP</tspan></text> + <rect + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3079" + width="100" + height="20" + x="725.71484" + y="602.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="763.89868" + y="617.09436" + id="text3081" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3083" + x="763.89868" + y="617.09436" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">UDP</tspan></text> + <rect + style="fill:#ffffbf;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3091" + width="100" + height="20" + x="725.71484" + y="572.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="759.9707" + y="585.87451" + id="text3093" + sodipodi:linespacing="125%"><tspan + id="tspan3081" + sodipodi:role="line" + x="759.9707" + y="585.87451" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">VoIP</tspan></text> + <path + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" + d="m 690,637.56396 45,0 c 10,0 -0.0293,-55.00001 9.9707,-55.00001 l 10,0" + id="path3097" + inkscape:connector-curvature="0" + sodipodi:nodetypes="cccc" /> + </g> + <g + inkscape:groupmode="layer" + inkscape:label="Web Slicer" + id="webslicer-layer" /> +</svg> diff --git a/2011/datagram-comparison/prettyref.sty b/2011/datagram-comparison/prettyref.sty new file mode 100644 index 0000000..f3ce032 --- /dev/null +++ b/2011/datagram-comparison/prettyref.sty @@ -0,0 +1,41 @@ +%% +%% This is file `prettyref.sty', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% prettyref.dtx (with options: `style') +%% +%% Copyright (c) 1995 Kevin Ruland +%% +%% +%% prettyref v3.0 +%% +%% Copyright 1995,1998. by Kevin Ruland kevin(a)rodin.wustl.edu +%% +%% The following licence notice was added by Clea F. Rees on behalf of Kevin Ruland on 2008/11/05. +%% +%% prettyref consists of the files prettyref.dtx, prettyref.ins, prettyref.pdf, README and the derived file prettyref.sty. It is released to the public domain. +%% +\ProvidesPackage{prettyref}[1998/07/09 v3.0] +\def\newrefformat#1#2{% + \@namedef{pr@#1}##1{#2}} +\newrefformat{eq}{\textup{(\ref{#1})}} +\newrefformat{lem}{Lemma \ref{#1}} +\newrefformat{thm}{Theorem \ref{#1}} +\newrefformat{cha}{Chapter \ref{#1}} +\newrefformat{sec}{Section \ref{#1}} +\newrefformat{tab}{Table \ref{#1} on page \pageref{#1}} +\newrefformat{fig}{Figure \ref{#1} on page \pageref{#1}} +\def\prettyref#1{\@prettyref#1:} +\def\@prettyref#1:#2:{% + \expandafter\ifx\csname pr@#1\endcsname\relax% + \PackageWarning{prettyref}{Reference format #1\space undefined}% + \ref{#1:#2}% + \else% + \csname pr@#1\endcsname{#1:#2}% + \fi% +} +\endinput +%% +%% End of file `prettyref.sty'. diff --git a/2011/datagram-comparison/reardon-data.svg b/2011/datagram-comparison/reardon-data.svg new file mode 100644 index 0000000..37792d1 --- /dev/null +++ b/2011/datagram-comparison/reardon-data.svg @@ -0,0 +1,822 @@ +<?xml version="1.0" encoding="UTF-8" standalone="no"?> + + +<svg + xmlns:dc="http://purl.org/dc/elements/1.1/" + xmlns:cc="http://creativecommons.org/ns#" + xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" + xmlns:svg="http://www.w3.org/2000/svg" + xmlns="http://www.w3.org/2000/svg" + xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd" + xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape" + width="770.74414" + height="243.13622" + id="svg2" + version="1.1" + inkscape:version="0.48.2 r9819" + sodipodi:docname="reardon-data.svg"> + <defs + id="defs4" /> + <sodipodi:namedview + id="base" + pagecolor="#ffffff" + bordercolor="#666666" + borderopacity="1.0" + inkscape:pageopacity="0.0" + inkscape:pageshadow="2" + inkscape:zoom="1.979899" + inkscape:cx="376.17361" + inkscape:cy="44.639138" + inkscape:document-units="px" + inkscape:current-layer="layer1" + showgrid="true" + inkscape:window-width="1916" + inkscape:window-height="581" + inkscape:window-x="0" + inkscape:window-y="600" + inkscape:window-maximized="0" + showguides="true" + inkscape:guide-bbox="true" + fit-margin-top="5" + fit-margin-left="5" + fit-margin-right="5" + fit-margin-bottom="5"> + <inkscape:grid + type="xygrid" + id="grid4099" + empspacing="5" + visible="true" + enabled="true" + snapvisiblegridlinesonly="true" + dotted="false" + spacingx="5px" + spacingy="5px" /> + </sodipodi:namedview> + <metadata + id="metadata7"> + <rdf:RDF> + <cc:Work + rdf:about=""> + <dc:format>image/svg+xml</dc:format> + <dc:type + rdf:resource="http://purl.org/dc/dcmitype/StillImage" /> + <dc:title /> + </cc:Work> + </rdf:RDF> + </metadata> + <g + inkscape:label="Layer 1" + inkscape:groupmode="layer" + id="layer1" + transform="translate(-59.970703,-409.42775)"> + <rect + ry="5" + rx="5" + y="472.56396" + x="549.9707" + height="20" + width="100" + id="rect3069" + style="fill:#91cf60;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <rect + style="fill:#91cf60;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3063" + width="100" + height="20" + x="250" + y="472.56396" + rx="5" + ry="5" /> + <text + sodipodi:linespacing="125%" + id="text3167" + y="427.76575" + x="69.150642" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + xml:space="preserve"><tspan + y="427.76575" + x="69.150642" + id="tspan3169" + sodipodi:role="line">Application</tspan></text> + <rect + ry="5" + rx="5" + y="627.56396" + x="64.970703" + height="20" + width="100" + id="rect3131" + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3133" + y="642.10071" + x="108.71826" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="642.10071" + x="108.71826" + id="tspan3135" + sodipodi:role="line">IP</tspan></text> + <rect + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3137" + width="100" + height="20" + x="64.970703" + y="602.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="103.15454" + y="616.73035" + id="text3139" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3141" + x="103.15454" + y="616.73035" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">TCP</tspan></text> + <rect + ry="5" + rx="5" + y="497.56396" + x="250" + height="20" + width="100" + id="rect3155" + style="fill:#d9ef8b;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3157" + y="512.0376" + x="270.72778" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="512.0376" + x="270.72778" + id="tspan3159" + sodipodi:role="line">Cell Auth</tspan></text> + <rect + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3161" + width="125" + height="20" + x="225" + y="447.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="260.82227" + y="460.76904" + id="text3163" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3165" + x="260.82227" + y="460.76904" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Gateway</tspan></text> + <rect + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3173" + width="125" + height="20" + x="225" + y="627.36218" + rx="6.25" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="281.24756" + y="642.10071" + id="text3175" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3177" + x="281.24756" + y="642.10071" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">IP</tspan></text> + <rect + ry="5" + rx="2.9985352" + y="602.36218" + x="225" + height="20" + width="59.970703" + id="rect3179" + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3181" + y="617.09436" + x="243.16919" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="617.09436" + x="243.16919" + id="tspan3183" + sodipodi:role="line">TCP</tspan></text> + <rect + style="fill:#fee08b;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3185" + width="100" + height="20" + x="250" + y="572.36218" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="288.66309" + y="587.09436" + id="text3187" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3189" + x="288.66309" + y="587.09436" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">DTLS</tspan></text> + <rect + ry="5" + rx="5" + y="522.36218" + x="250" + height="20" + width="100" + id="rect3191" + style="fill:#fffebf;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + xml:space="preserve" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + x="254.87225" + y="427.56396" + id="text3209" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3211" + x="254.87225" + y="427.56396">Initiator</tspan></text> + <text + sodipodi:linespacing="125%" + id="text3231" + y="427.56396" + x="409.9707" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + xml:space="preserve"><tspan + y="427.56396" + x="409.9707" + id="tspan3233" + sodipodi:role="line">Intermediate</tspan></text> + <rect + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3237" + width="100" + height="20" + x="400" + y="627.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="443.74756" + y="642.10071" + id="text3239" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3241" + x="443.74756" + y="642.10071" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">IP</tspan></text> + <rect + ry="5" + rx="5" + y="602.56396" + x="400" + height="20" + width="100" + id="rect3243" + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3245" + y="617.09436" + x="438.18384" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="617.09436" + x="438.18384" + id="tspan3247" + sodipodi:role="line">UDP</tspan></text> + <rect + style="fill:#fee08b;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3249" + width="100" + height="20" + x="400" + y="572.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="438.66309" + y="587.09436" + id="text3251" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3253" + x="438.66309" + y="587.09436" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">DTLS</tspan></text> + <rect + ry="5" + rx="5" + y="522.56396" + x="400" + height="20" + width="100" + id="rect3255" + style="fill:#ffffbf;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3257" + y="537.20862" + x="428.84644" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="537.20862" + x="428.84644" + id="tspan3259" + sodipodi:role="line">Circuit</tspan></text> + <rect + ry="5" + rx="6.25" + y="627.56396" + x="550" + height="20" + width="125" + id="rect3275" + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3277" + y="642.30249" + x="606.24756" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="642.30249" + x="606.24756" + id="tspan3279" + sodipodi:role="line">IP</tspan></text> + <rect + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3281" + width="125" + height="20" + x="549.53125" + y="603.03125" + rx="6.25" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="600.68384" + y="617.29614" + id="text3283" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3285" + x="600.68384" + y="617.29614" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">UDP</tspan></text> + <rect + ry="5" + rx="5" + y="572.83179" + x="550" + height="20" + width="100" + id="rect3287" + style="fill:#fee08b;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3289" + y="587.56396" + x="588.66309" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="587.56396" + x="588.66309" + id="tspan3291" + sodipodi:role="line">DTLS</tspan></text> + <text + xml:space="preserve" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + x="594.9707" + y="427.56396" + id="text3311" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3313" + x="594.9707" + y="427.56396">Exit</tspan></text> + <text + sodipodi:linespacing="125%" + id="text3193" + y="537.20862" + x="278.84644" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="537.20862" + x="278.84644" + id="tspan3195" + sodipodi:role="line">Circuit</tspan></text> + <rect + ry="5" + rx="7.2499995" + y="-245" + x="447.56396" + height="20" + width="144.99998" + id="rect3144" + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" + transform="matrix(0,1,-1,0,0,0)" /> + <rect + ry="5" + rx="5" + y="572.56396" + x="64.970703" + height="20" + width="100" + id="rect3350" + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3352" + y="586.93213" + x="94.436523" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="586.93213" + x="94.436523" + id="tspan3354" + sodipodi:role="line">SOCKS</tspan></text> + <rect + style="fill:#ffffbf;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3356" + width="100" + height="20" + x="64.970703" + y="547.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="99.226562" + y="560.87451" + id="text3358" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3360" + x="99.226562" + y="560.87451" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">HTTP</tspan></text> + <path + sodipodi:nodetypes="cccc" + inkscape:connector-curvature="0" + id="path3075" + d="m 194.9707,637.56395 -35,0 c -10,0 -0.0293,-80 -10.0293,-80 l -14.9707,0" + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" /> + <rect + style="fill:#d9ef8b;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3366" + width="100" + height="20" + x="550" + y="497.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="572.97949" + y="512.0376" + id="text3368" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3370" + x="572.97949" + y="512.0376" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Cell Auth</tspan></text> + <rect + style="fill:#ffffbf;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3372" + width="100" + height="20" + x="550" + y="522.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="578.84644" + y="537.4104" + id="text3374" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3376" + x="578.84644" + y="537.4104" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Circuit</tspan></text> + <rect + ry="5" + rx="5" + y="447.56396" + x="550" + height="20" + width="125" + id="rect3378" + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <rect + transform="matrix(0,1,-1,0,0,0)" + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3380" + width="144.99998" + height="20" + x="447.56396" + y="-675" + rx="7.2499995" + ry="5" /> + <text + sodipodi:linespacing="125%" + id="text3382" + y="460.76904" + x="585.82227" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="460.76904" + x="585.82227" + id="tspan3384" + sodipodi:role="line">Gateway</tspan></text> + <path + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" + d="m 639.9707,457.56397 15,0 c 15,0 0.0293,180.20177 15.0293,179.99999 l 20,0" + id="path4156" + inkscape:connector-curvature="0" + sodipodi:nodetypes="cscc" /> + <path + style="fill:none;stroke:#000000;stroke-width:0.89805281;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:2.69415846, 2.69415846;stroke-dashoffset:0" + d="m 189.9707,597.56396 500.0293,0" + id="path3242" + inkscape:connector-curvature="0" /> + <text + sodipodi:linespacing="125%" + id="text4012" + y="590.56396" + x="194.9707" + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="590.56396" + x="194.9707" + id="tspan4014" + sodipodi:role="line">Tor</tspan></text> + <text + xml:space="preserve" + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="194.9707" + y="610.56396" + id="text4016" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan4018" + x="194.9707" + y="610.56396" + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Host</tspan></text> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="278.39062" + y="487.0376" + id="text3065" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3067" + x="278.39062" + y="487.0376" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Stream</tspan></text> + <text + sodipodi:linespacing="125%" + id="text3071" + y="487.0376" + x="578.36133" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="487.0376" + x="578.36133" + id="tspan3073" + sodipodi:role="line">Stream</tspan></text> + <text + xml:space="preserve" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + x="749.10986" + y="427.76575" + id="text3069" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3071" + x="749.10986" + y="427.76575">Server</tspan></text> + <rect + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3073" + width="100" + height="20" + x="725.71484" + y="627.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="769.4624" + y="642.10071" + id="text3075" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3077" + x="769.4624" + y="642.10071" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">IP</tspan></text> + <rect + ry="5" + rx="5" + y="602.56396" + x="725.71484" + height="20" + width="100" + id="rect3079" + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3081" + y="617.09436" + x="763.89868" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="617.09436" + x="763.89868" + id="tspan3083" + sodipodi:role="line">TCP</tspan></text> + <rect + ry="5" + rx="5" + y="572.56396" + x="725.71484" + height="20" + width="100" + id="rect3091" + style="fill:#ffffbf;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3093" + y="585.87451" + x="759.9707" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="585.87451" + x="759.9707" + id="tspan3095" + sodipodi:role="line">HTTP</tspan></text> + <path + sodipodi:nodetypes="cccc" + inkscape:connector-curvature="0" + id="path3097" + d="m 690,637.56396 45,0 c 10,0 -0.0293,-55.00001 9.9707,-55.00001 l 10,0" + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" /> + <rect + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3081" + width="60" + height="20" + x="289.9707" + y="602.36218" + rx="3" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="305.94556" + y="617.09436" + id="text3083" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3085" + x="305.94556" + y="617.09436" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">UDP</tspan></text> + <rect + ry="5" + rx="5" + y="547.56396" + x="250" + height="20" + width="100" + id="rect3087" + style="fill:#fff3a5;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <rect + ry="5" + rx="5" + y="547.76575" + x="400" + height="20" + width="100" + id="rect3089" + style="fill:#fff3a5;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <rect + style="fill:#fff3a5;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3092" + width="100" + height="20" + x="550" + y="548.03357" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="284.9707" + y="562.56396" + id="text3862" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3864" + x="284.9707" + y="562.56396" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">uTCP</tspan></text> + <text + sodipodi:linespacing="125%" + id="text3866" + y="562.56396" + x="584.9707" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="562.56396" + x="584.9707" + id="tspan3868" + sodipodi:role="line">uTCP</tspan></text> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="434.9707" + y="562.56396" + id="text3870" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3872" + x="434.9707" + y="562.56396" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">uTCP</tspan></text> + <path + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" + d="m 360,637.56396 45,0 c 10,0 -0.0293,-104.99999 9.9707,-104.99999 l 10,0 m 50,0 10,0 c 10,0 0.0293,104.99999 10.0293,104.99999 l 20,0" + id="path3364" + inkscape:connector-curvature="0" + sodipodi:nodetypes="ccsccscc" /> + <path + sodipodi:nodetypes="cccc" + inkscape:connector-curvature="0" + id="path3080" + d="m 515,637.56396 40,0 c 15,0 -0.0293,-179.99999 14.9707,-179.99999 l 15,0" + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" /> + <path + sodipodi:nodetypes="cccccccc" + inkscape:connector-curvature="0" + id="path3362" + d="m 190,637.56396 40,0 c 15,0 -0.0293,-179.99999 14.9707,-179.99999 l 15,0 m 55,0 15,0 c 15,0 0.0293,180.20177 15.0293,179.99999 l 15,0" + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" /> + </g> +</svg> diff --git a/2011/datagram-comparison/references.bib b/2011/datagram-comparison/references.bib new file mode 100644 index 0000000..bda7921 --- /dev/null +++ b/2011/datagram-comparison/references.bib @@ -0,0 +1,74 @@ +@inproceedings{reardon-usenix, + title = {Improving {T}or Using a {T}{C}{P}-over-{D}{T}{L}{S} Tunnel}, + author = {Joel Reardon and Ian Goldberg}, + booktitle = {Proceedings of the 18th USENIX Security Symposium}, + year = {2009}, + month = {August}, +} + +@inproceedings{viecco, + title = {{U}{D}{P}{-}{O}{R}: A Fair Onion Transport Design}, + author = {Camilo Viecco}, + booktitle = {HotPETS}, + year = {2008}, + note = {\url{http://www.petsymposium.org/2008/hotpets/udp-tor.pdf}}, +} + +@techreport{kiraly, + title = {Solving Performance Issues in Anonymization Overlays with a {L3} +approach}, + author = {Kiraly, C. and Bianchi, G. and Lo Cigno, R.}, + institution = {University of Trento}, + year = {2008}, + month = {September}, + number = {DISI-08-041}, + note = {\url{http://disi.unitn.it/locigno/preprints/TR-DISI-08-041.pdf}} +} + +@techreport{brown, + title = {Cebolla -- Pragmatic IP Anonymity}, + year = {2002}, + booktitle = {Ottowa Linux Symposium}, + month = {June}, + author = {Zach Brown}, + note = {\url{http://www.cypherspace.org/cebolla/cebolla.pdf}}, +} + +@mastersthesis{reardon-thesis, + title = {Improving {Tor} using a {TCP}-over-{DTLS} Tunnel}, + author = {Reardon, Joel}, + school = {University of Waterloo}, + year = {2008}, + month = {September}, + www_tags = {selected}, + www_abstract_url = {http://hdl.handle.net/10012/4011}, + www_section = {Anonymous communication}, + www_pdf_url = {http://uwspace.uwaterloo.ca/bitstream/10012/4011/1/thesis.pdf}, + note = {\url{http://hdl.handle.net/10012/4011}} +} + +@techreport{liberatore, + title = {Tor Unreliable Datagram Extension Proposal}, + author = {Marc Liberatore}, + year = {2006}, + month = {February}, + note = +{\url{https://gitweb.torproject.org/torspec.git/blob/HEAD:/proposals/100-tor-spec-udp.txt}}, + institution = {The {T}or {P}roject}, + number = {100}, + type = {Proposal}, +} + +@techreport{freedom2-arch, + title = {Freedom Systems 2.0 Architecture}, + author = {Philippe Boucher and Adam Shostack and Ian Goldberg}, + institution = {Zero Knowledge Systems, {Inc.}}, + year = {2000}, + month = {December}, + type = {White Paper}, + www_tags = {selected}, + www_section = {Anonymous communication}, + www_pdf_url = {http://osiris.978.org/~brianr/crypto-research/anon/www.freedom.net/products/whitepapers/Freedom_System_2_Architecture.pdf}, + day = {18}, +} + diff --git a/2011/datagram-comparison/tor-data.svg b/2011/datagram-comparison/tor-data.svg new file mode 100644 index 0000000..75db78e --- /dev/null +++ b/2011/datagram-comparison/tor-data.svg @@ -0,0 +1,738 @@ +<?xml version="1.0" encoding="UTF-8" standalone="no"?> + + +<svg + xmlns:dc="http://purl.org/dc/elements/1.1/" + xmlns:cc="http://creativecommons.org/ns#" + xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" + xmlns:svg="http://www.w3.org/2000/svg" + xmlns="http://www.w3.org/2000/svg" + xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd" + xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape" + width="770.74414" + height="218.13622" + id="svg2" + version="1.1" + inkscape:version="0.48.0 r9654" + sodipodi:docname="tor-data.svg.2011_05_06_11_21_03.0.svg"> + <defs + id="defs4" /> + <sodipodi:namedview + id="base" + pagecolor="#ffffff" + bordercolor="#666666" + borderopacity="1.0" + inkscape:pageopacity="0.0" + inkscape:pageshadow="2" + inkscape:zoom="1.979899" + inkscape:cx="402.88635" + inkscape:cy="53.477974" + inkscape:document-units="px" + inkscape:current-layer="layer1" + showgrid="true" + inkscape:window-width="1920" + inkscape:window-height="1126" + inkscape:window-x="0" + inkscape:window-y="26" + inkscape:window-maximized="1" + showguides="true" + inkscape:guide-bbox="true" + fit-margin-top="5" + fit-margin-left="5" + fit-margin-right="5" + fit-margin-bottom="5"> + <inkscape:grid + type="xygrid" + id="grid4099" + empspacing="5" + visible="true" + enabled="true" + snapvisiblegridlinesonly="true" + dotted="false" + spacingx="5px" + spacingy="5px" /> + </sodipodi:namedview> + <metadata + id="metadata7"> + <rdf:RDF> + <cc:Work + rdf:about=""> + <dc:format>image/svg+xml</dc:format> + <dc:type + rdf:resource="http://purl.org/dc/dcmitype/StillImage" /> + <dc:title></dc:title> + </cc:Work> + </rdf:RDF> + </metadata> + <g + inkscape:label="Layer 1" + inkscape:groupmode="layer" + id="layer1" + transform="translate(-59.970703,-434.42775)"> + <rect + ry="5" + rx="5" + y="497.56396" + x="549.9707" + height="20" + width="100" + id="rect3069" + style="fill:#91cf60;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <rect + style="fill:#91cf60;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3063" + width="100" + height="20" + x="250" + y="497.56396" + rx="5" + ry="5" /> + <text + sodipodi:linespacing="125%" + id="text3167" + y="452.76575" + x="69.249092" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + xml:space="preserve"><tspan + y="452.76575" + x="69.249092" + id="tspan3169" + sodipodi:role="line">Application</tspan></text> + <rect + ry="5" + rx="5" + y="627.56396" + x="64.970703" + height="20" + width="100" + id="rect3131" + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3133" + y="642.10071" + x="108.71826" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="642.10071" + x="108.71826" + id="tspan3135" + sodipodi:role="line">IP</tspan></text> + <rect + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3137" + width="100" + height="20" + x="64.970703" + y="602.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="103.15454" + y="617.09436" + id="text3139" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3141" + x="103.15454" + y="617.09436" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">TCP</tspan></text> + <rect + ry="5" + rx="5" + y="522.56396" + x="250" + height="20" + width="100" + id="rect3155" + style="fill:#d9ef8b;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3157" + y="537.0376" + x="270.72778" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="537.0376" + x="270.72778" + id="tspan3159" + sodipodi:role="line">Cell Auth</tspan></text> + <rect + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3161" + width="125" + height="20" + x="225" + y="472.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="260.82227" + y="485.76904" + id="text3163" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3165" + x="260.82227" + y="485.76904" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Gateway</tspan></text> + <rect + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3173" + width="125" + height="20" + x="225" + y="627.36218" + rx="6.25" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="281.24756" + y="642.10071" + id="text3175" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3177" + x="281.24756" + y="642.10071" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">IP</tspan></text> + <rect + ry="5" + rx="6.25" + y="602.36218" + x="225" + height="20" + width="125" + id="rect3179" + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3181" + y="617.09436" + x="275.68384" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="617.09436" + x="275.68384" + id="tspan3183" + sodipodi:role="line">TCP</tspan></text> + <rect + style="fill:#fee08b;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3185" + width="100" + height="20" + x="250" + y="572.36218" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="288.66309" + y="587.09436" + id="text3187" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3189" + x="288.66309" + y="587.09436" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">TLS</tspan></text> + <rect + ry="5" + rx="5" + y="547.36218" + x="250" + height="20" + width="100" + id="rect3191" + style="fill:#ffffbf;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + xml:space="preserve" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + x="254.9707" + y="452.56396" + id="text3209" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3211" + x="254.9707" + y="452.56396">Initiator</tspan></text> + <text + sodipodi:linespacing="125%" + id="text3231" + y="452.56396" + x="410.06915" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + xml:space="preserve"><tspan + y="452.56396" + x="410.06915" + id="tspan3233" + sodipodi:role="line">Intermediate</tspan></text> + <rect + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3237" + width="100" + height="20" + x="400" + y="627.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="443.74756" + y="642.10071" + id="text3239" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3241" + x="443.74756" + y="642.10071" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">IP</tspan></text> + <rect + ry="5" + rx="5" + y="602.56396" + x="400" + height="20" + width="100" + id="rect3243" + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3245" + y="617.09436" + x="438.18384" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="617.09436" + x="438.18384" + id="tspan3247" + sodipodi:role="line">TCP</tspan></text> + <rect + style="fill:#fee08b;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3249" + width="100" + height="20" + x="400" + y="572.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="438.66309" + y="587.09436" + id="text3251" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3253" + x="438.66309" + y="587.09436" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">TLS</tspan></text> + <rect + ry="5" + rx="5" + y="547.56396" + x="400" + height="20" + width="100" + id="rect3255" + style="fill:#ffffbf;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3257" + y="562.20862" + x="428.84644" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="562.20862" + x="428.84644" + id="tspan3259" + sodipodi:role="line">Circuit</tspan></text> + <rect + ry="5" + rx="6.25" + y="627.56396" + x="550" + height="20" + width="125" + id="rect3275" + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3277" + y="642.30249" + x="606.24756" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="642.30249" + x="606.24756" + id="tspan3279" + sodipodi:role="line">IP</tspan></text> + <rect + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3281" + width="125" + height="20" + x="549.53125" + y="603.03125" + rx="6.25" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="600.68384" + y="617.29614" + id="text3283" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3285" + x="600.68384" + y="617.29614" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">TCP</tspan></text> + <rect + ry="5" + rx="5" + y="572.56396" + x="550" + height="20" + width="100" + id="rect3287" + style="fill:#fee08b;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3289" + y="587.29614" + x="588.66309" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="587.29614" + x="588.66309" + id="tspan3291" + sodipodi:role="line">TLS</tspan></text> + <text + xml:space="preserve" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + x="593.8512" + y="454.56067" + id="text3311" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3313" + x="593.8512" + y="454.56067">Exit</tspan></text> + <text + sodipodi:linespacing="125%" + id="text3193" + y="562.20862" + x="278.84644" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="562.20862" + x="278.84644" + id="tspan3195" + sodipodi:role="line">Circuit</tspan></text> + <rect + ry="5" + rx="5.9999995" + y="-245" + x="472.56396" + height="20" + width="119.99999" + id="rect3144" + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" + transform="matrix(0,1,-1,0,0,0)" /> + <rect + ry="5" + rx="5" + y="572.56396" + x="64.970703" + height="20" + width="100" + id="rect3350" + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3352" + y="586.93213" + x="94.436523" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="586.93213" + x="94.436523" + id="tspan3354" + sodipodi:role="line">SOCKS</tspan></text> + <rect + style="fill:#ffffbf;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3356" + width="100" + height="20" + x="64.970703" + y="547.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="99.226562" + y="560.87451" + id="text3358" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3360" + x="99.226562" + y="560.87451" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">HTTP</tspan></text> + <path + sodipodi:nodetypes="cccccccc" + inkscape:connector-curvature="0" + id="path3362" + d="m 190,637.56396 40,0 c 15,0 -0.0293,-155.00001 14.9707,-155.00001 l 15,0 m 55,0 15,0 c 15,0 0.0293,155.20179 15.0293,155.00001 l 15,0" + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" /> + <path + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" + d="m 360,637.56396 45,0 c 10,0 -0.0293,-80 9.9707,-80 l 10,0 m 50,0 10,0 c 10,0 0.0293,80 10.0293,80 l 20,0" + id="path3364" + inkscape:connector-curvature="0" + sodipodi:nodetypes="cccccccc" /> + <path + sodipodi:nodetypes="cccc" + inkscape:connector-curvature="0" + id="path3075" + d="m 194.9707,637.56395 -35,0 c -10,0 -0.0293,-80 -10.0293,-80 l -14.9707,0" + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" /> + <rect + style="fill:#d9ef8b;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3366" + width="100" + height="20" + x="550" + y="522.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="572.97949" + y="537.0376" + id="text3368" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3370" + x="572.97949" + y="537.0376" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Cell Auth</tspan></text> + <rect + style="fill:#ffffbf;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3372" + width="100" + height="20" + x="550" + y="547.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="578.84644" + y="562.4104" + id="text3374" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3376" + x="578.84644" + y="562.4104" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Circuit</tspan></text> + <rect + ry="5" + rx="5" + y="472.56396" + x="550" + height="20" + width="125" + id="rect3378" + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <rect + transform="matrix(0,1,-1,0,0,0)" + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3380" + width="119.99999" + height="20" + x="472.56396" + y="-675" + rx="5.9999995" + ry="5" /> + <path + sodipodi:nodetypes="cccc" + inkscape:connector-curvature="0" + id="path3080" + d="m 515,637.56396 40,0 c 15,0 -0.0293,-155.00001 14.9707,-155.00001 l 15,0" + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" /> + <text + sodipodi:linespacing="125%" + id="text3382" + y="485.76904" + x="585.82227" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="485.76904" + x="585.82227" + id="tspan3384" + sodipodi:role="line">Gateway</tspan></text> + <path + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" + d="m 639.9707,482.56395 15,0 c 15,0 0.0293,155.20179 15.0293,155.00001 l 20,0" + id="path4156" + inkscape:connector-curvature="0" + sodipodi:nodetypes="cscc" /> + <path + style="fill:none;stroke:#000000;stroke-width:0.89805281;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:2.69415846, 2.69415846;stroke-dashoffset:0" + d="m 189.9707,597.56396 500.0293,0" + id="path3242" + inkscape:connector-curvature="0" /> + <text + sodipodi:linespacing="125%" + id="text4012" + y="590.56396" + x="194.9707" + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="590.56396" + x="194.9707" + id="tspan4014" + sodipodi:role="line">Tor</tspan></text> + <text + xml:space="preserve" + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="194.9707" + y="610.56396" + id="text4016" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan4018" + x="194.9707" + y="610.56396" + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Host</tspan></text> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="278.39062" + y="512.0376" + id="text3065" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3067" + x="278.39062" + y="512.0376" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Stream</tspan></text> + <text + sodipodi:linespacing="125%" + id="text3071" + y="512.0376" + x="578.36133" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="512.0376" + x="578.36133" + id="tspan3073" + sodipodi:role="line">Stream</tspan></text> + <text + xml:space="preserve" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + x="749.20831" + y="452.76575" + id="text3069" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3071" + x="749.20831" + y="452.76575">Server</tspan></text> + <rect + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3073" + width="100" + height="20" + x="725.71484" + y="627.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="769.4624" + y="642.10071" + id="text3075" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3077" + x="769.4624" + y="642.10071" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">IP</tspan></text> + <rect + ry="5" + rx="5" + y="602.56396" + x="725.71484" + height="20" + width="100" + id="rect3079" + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3081" + y="617.09436" + x="763.89868" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="617.09436" + x="763.89868" + id="tspan3083" + sodipodi:role="line">TCP</tspan></text> + <rect + ry="5" + rx="5" + y="572.56396" + x="725.71484" + height="20" + width="100" + id="rect3091" + style="fill:#ffffbf;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3093" + y="585.87451" + x="759.9707" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="585.87451" + x="759.9707" + id="tspan3095" + sodipodi:role="line">HTTP</tspan></text> + <path + sodipodi:nodetypes="cccc" + inkscape:connector-curvature="0" + id="path3097" + d="m 690,637.56396 45,0 c 10,0 -0.0293,-55.00001 9.9707,-55.00001 l 10,0" + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" /> + </g> +</svg> diff --git a/2011/datagram-comparison/tor-extension.svg b/2011/datagram-comparison/tor-extension.svg new file mode 100644 index 0000000..0b3fbc1 --- /dev/null +++ b/2011/datagram-comparison/tor-extension.svg @@ -0,0 +1,617 @@ +<?xml version="1.0" encoding="UTF-8" standalone="no"?> + + +<svg + xmlns:dc="http://purl.org/dc/elements/1.1/" + xmlns:cc="http://creativecommons.org/ns#" + xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" + xmlns:svg="http://www.w3.org/2000/svg" + xmlns="http://www.w3.org/2000/svg" + xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd" + xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape" + width="615.0293" + height="193.32378" + id="svg2" + version="1.1" + inkscape:version="0.48.0 r9654" + sodipodi:docname="tor-extension.svg"> + <defs + id="defs4" /> + <sodipodi:namedview + id="base" + pagecolor="#ffffff" + bordercolor="#666666" + borderopacity="1.0" + inkscape:pageopacity="0.0" + inkscape:pageshadow="2" + inkscape:zoom="1.979899" + inkscape:cx="431.52109" + inkscape:cy="40.004513" + inkscape:document-units="px" + inkscape:current-layer="layer1" + showgrid="true" + inkscape:window-width="1920" + inkscape:window-height="1126" + inkscape:window-x="0" + inkscape:window-y="26" + inkscape:window-maximized="1" + showguides="true" + inkscape:guide-bbox="true" + fit-margin-top="5" + fit-margin-left="5" + fit-margin-right="5" + fit-margin-bottom="5"> + <inkscape:grid + type="xygrid" + id="grid4099" + empspacing="5" + visible="true" + enabled="true" + snapvisiblegridlinesonly="true" + dotted="false" + spacingx="5px" + spacingy="5px" /> + </sodipodi:namedview> + <metadata + id="metadata7"> + <rdf:RDF> + <cc:Work + rdf:about=""> + <dc:format>image/svg+xml</dc:format> + <dc:type + rdf:resource="http://purl.org/dc/dcmitype/StillImage" /> + <dc:title /> + </cc:Work> + </rdf:RDF> + </metadata> + <g + inkscape:label="Layer 1" + inkscape:groupmode="layer" + id="layer1" + transform="translate(-39.970699,-454.44196)"> + <rect + transform="matrix(0,-1,1,0,0,0)" + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3065" + width="70" + height="20" + x="-562.76575" + y="549.9707" + rx="3.5" + ry="5" /> + <rect + ry="5" + rx="5" + y="492.76575" + x="550" + height="20" + width="100" + id="rect3375" + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <rect + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3305" + width="125" + height="20" + x="375" + y="492.96753" + rx="6.25" + ry="5" /> + <rect + ry="5" + rx="3.5" + y="480" + x="-562.96753" + height="20" + width="70" + id="rect3333" + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" + transform="matrix(0,-1,1,0,0,0)" /> + <text + sodipodi:linespacing="125%" + id="text3167" + y="472.56396" + x="93.053833" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + xml:space="preserve"><tspan + y="472.56396" + x="93.053833" + id="tspan3169" + sodipodi:role="line">Initiator</tspan></text> + <rect + ry="5" + rx="5" + y="622.56396" + x="75" + height="20" + width="100" + id="rect3131" + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3133" + y="637.30249" + x="118.74756" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="637.30249" + x="118.74756" + id="tspan3135" + sodipodi:role="line">IP</tspan></text> + <rect + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3137" + width="100" + height="20" + x="75" + y="597.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="113.18384" + y="612.29614" + id="text3139" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3141" + x="113.18384" + y="612.29614" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">TCP</tspan></text> + <rect + ry="5" + rx="5" + y="567.96753" + x="75" + height="20" + width="100" + id="rect3143" + style="fill:#fee08b;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3145" + y="582.49792" + x="113.6631" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="582.49792" + x="113.6631" + id="tspan3147" + sodipodi:role="line">TLS</tspan></text> + <rect + style="fill:#d9ef8b;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3149" + width="100" + height="20" + x="75" + y="542.96753" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="103.84645" + y="557.61218" + id="text3151" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3153" + x="103.84645" + y="557.61218" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Circuit</tspan></text> + <rect + ry="5" + rx="5" + y="517.96753" + x="75" + height="20" + width="100" + id="rect3155" + style="fill:#91cf60;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3157" + y="532.61218" + x="95.727783" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="532.61218" + x="95.727783" + id="tspan3159" + sodipodi:role="line">Cell Auth</tspan></text> + <rect + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3161" + width="100" + height="20" + x="75" + y="492.96753" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="107.45996" + y="505.97083" + id="text3163" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3165" + x="107.45996" + y="505.97083" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Setup</tspan></text> + <rect + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3173" + width="100" + height="20" + x="225" + y="622.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="268.74756" + y="637.30249" + id="text3175" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3177" + x="268.74756" + y="637.30249" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">IP</tspan></text> + <rect + ry="5" + rx="5" + y="597.56396" + x="225" + height="20" + width="100" + id="rect3179" + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3181" + y="612.29614" + x="263.18384" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="612.29614" + x="263.18384" + id="tspan3183" + sodipodi:role="line">TCP</tspan></text> + <rect + style="fill:#fee08b;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3185" + width="100" + height="20" + x="225" + y="567.76575" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="263.66309" + y="582.49792" + id="text3187" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3189" + x="263.66309" + y="582.49792" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">TLS</tspan></text> + <rect + ry="5" + rx="5" + y="542.76575" + x="225" + height="20" + width="100" + id="rect3191" + style="fill:#d9ef8b;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + xml:space="preserve" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + x="223.06216" + y="472.56396" + id="text3209" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3211" + x="223.06216" + y="472.56396">Intermediate</tspan></text> + <text + sodipodi:linespacing="125%" + id="text3231" + y="472.56396" + x="400" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + xml:space="preserve"><tspan + y="472.56396" + x="400" + id="tspan3233" + sodipodi:role="line">Previous</tspan></text> + <rect + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3237" + width="125" + height="20" + x="375" + y="622.76575" + rx="6.25" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="431.24756" + y="637.50427" + id="text3239" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3241" + x="431.24756" + y="637.50427" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">IP</tspan></text> + <rect + ry="5" + rx="6.25" + y="597.76575" + x="375" + height="20" + width="125" + id="rect3243" + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3245" + y="612.49792" + x="425.68384" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="612.49792" + x="425.68384" + id="tspan3247" + sodipodi:role="line">TCP</tspan></text> + <rect + style="fill:#fee08b;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3249" + width="125" + height="20" + x="375" + y="567.96753" + rx="6.25" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="426.16309" + y="582.69971" + id="text3251" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3253" + x="426.16309" + y="582.69971" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">TLS</tspan></text> + <rect + ry="5" + rx="5" + y="542.96753" + x="375" + height="20" + width="100" + id="rect3255" + style="fill:#d9ef8b;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3257" + y="557.81396" + x="403.84644" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="557.81396" + x="403.84644" + id="tspan3259" + sodipodi:role="line">Circuit</tspan></text> + <rect + style="fill:#91cf60;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3261" + width="100" + height="20" + x="375" + y="517.96753" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="395.72778" + y="532.81396" + id="text3263" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3265" + x="395.72778" + y="532.81396" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Cell Auth</tspan></text> + <text + sodipodi:linespacing="125%" + id="text3269" + y="506.354" + x="418.49829" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="506.354" + x="418.49829" + id="tspan3271" + sodipodi:role="line">Setup</tspan></text> + <rect + ry="5" + rx="5" + y="622.56396" + x="550" + height="20" + width="100" + id="rect3275" + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3277" + y="637.30249" + x="593.74756" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="637.30249" + x="593.74756" + id="tspan3279" + sodipodi:role="line">IP</tspan></text> + <rect + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3281" + width="100" + height="20" + x="550" + y="597.76575" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="588.18384" + y="612.29614" + id="text3283" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3285" + x="588.18384" + y="612.29614" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">TCP</tspan></text> + <rect + ry="5" + rx="5" + y="567.76575" + x="550" + height="20" + width="100" + id="rect3287" + style="fill:#fee08b;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3289" + y="582.49792" + x="588.66309" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="582.49792" + x="588.66309" + id="tspan3291" + sodipodi:role="line">TLS</tspan></text> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="580.99829" + y="506.23792" + id="text3307" + sodipodi:linespacing="125%" + inkscape:transform-center-x="5.6730957"><tspan + sodipodi:role="line" + id="tspan3309" + x="580.99829" + y="506.23792" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Setup</tspan></text> + <text + xml:space="preserve" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + x="579.29669" + y="472.56396" + id="text3311" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3313" + x="579.29669" + y="472.56396">Next</tspan></text> + <path + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" + d="m 190,632.96752 40,-0.20178 c 10,0 0,-80.20178 10,-80.20178 3.33333,0 10,0 10,0 m 50,0 10,0 c 10,0 0,80.20178 10,80.20178 l 35,0" + id="path3379" + inkscape:connector-curvature="0" + sodipodi:nodetypes="cccccccc" /> + <text + sodipodi:linespacing="125%" + id="text3193" + y="557.61218" + x="253.84644" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="557.61218" + x="253.84644" + id="tspan3195" + sodipodi:role="line">Circuit</tspan></text> + <path + sodipodi:nodetypes="cccc" + inkscape:connector-curvature="0" + id="path3075" + d="m 190,632.76574 -20,0 c -15,0 0,-130.20178 -15,-130.20178 l -10,0" + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" /> + <path + sodipodi:nodetypes="cccc" + inkscape:connector-curvature="0" + id="path3076" + d="m 355,632.76574 25,0 c 15,0 0,-130.20178 15,-130.20178 l 20,0" + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" /> + <path + sodipodi:nodetypes="cccc" + inkscape:connector-curvature="0" + id="path3078" + d="m 460,502.56396 20,0 c 15,0 0,130.20178 15,130.20178 l 20,0" + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" /> + <path + sodipodi:nodetypes="cccc" + inkscape:connector-curvature="0" + id="path3080" + d="m 515,632.76574 40,-0.20178 c 14.9707,0.20178 -0.0293,-129.79822 14.9707,-129.79822 l 5,0" + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" /> + <path + style="fill:none;stroke:#000000;stroke-width:0.98782915;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:2.96348749, 2.96348749;stroke-dashoffset:0" + d="m 45,592.76574 605,0" + id="path3242" + inkscape:connector-curvature="0" /> + <text + sodipodi:linespacing="125%" + id="text4012" + y="585.76575" + x="44.999996" + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="585.76575" + x="44.999996" + id="tspan4014" + sodipodi:role="line">Tor</tspan></text> + <text + xml:space="preserve" + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="44.999996" + y="605.76575" + id="text4016" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan4018" + x="44.999996" + y="605.76575" + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Host</tspan></text> + </g> +</svg> diff --git a/2011/datagram-comparison/vc b/2011/datagram-comparison/vc new file mode 100755 index 0000000..5c5a1b3 --- /dev/null +++ b/2011/datagram-comparison/vc @@ -0,0 +1,24 @@ +#!/bin/sh +# This is file 'vc' from the vc bundle for TeX. +# The original file can be found at CTAN:support/vc. +# This file is Public Domain. + +# Parse command line options. +full=0 +mod=0 +while [ -n "$(echo $1 | grep '-')" ]; do + case $1 in + -f ) full=1 ;; + -m ) mod=1 ;; + * ) echo 'usage: vc [-f] [-m]' + exit 1 + esac + shift +done +# English locale. +LC_ALL=C +git --no-pager log -1 HEAD --pretty=format:"Hash: %H%nAbr. Hash: %h%nParent Hashes: %P%nAbr. Parent Hashes: %p%nAuthor Name: %an%nAuthor Email: %ae%nAuthor Date: %ai%nCommitter Name: %cn%nCommitter Email: %ce%nCommitter Date: %ci%n" |gawk -v script=log -v full=$full -f vc-git.awk > vc.tex +if [ "$mod" = 1 ] +then + git status |gawk -v script=status -f vc-git.awk >> vc.tex +fi diff --git a/2011/datagram-comparison/vc-git.awk b/2011/datagram-comparison/vc-git.awk new file mode 100644 index 0000000..66b3526 --- /dev/null +++ b/2011/datagram-comparison/vc-git.awk @@ -0,0 +1,89 @@ +# This is file 'vc-git.awk' from the vc bundle for TeX. +# The original file can be found at CTAN:support/vc. +# This file is Public Domain. +BEGIN { + +### Process output of "git status". + if (script=="status") { + modified = 0 + } + +} + + + +### Process output of "git log". +script=="log" && /^Hash:/ { Hash = substr($0, 2+match($0, ":")) } +script=="log" && /^Abr. Hash:/ { AbrHash = substr($0, 2+match($0, ":")) } +script=="log" && /^Parent Hashes:/ { ParentHashes = substr($0, 2+match($0, ":")) } +script=="log" && /^Abr. Parent Hashes:/ { AbrParentHashes = substr($0, 2+match($0, ":")) } +script=="log" && /^Author Name:/ { AuthorName = substr($0, 2+match($0, ":")) } +script=="log" && /^Author Email:/ { AuthorEmail = substr($0, 2+match($0, ":")) } +script=="log" && /^Author Date:/ { AuthorDate = substr($0, 2+match($0, ":")) } +script=="log" && /^Committer Name:/ { CommitterName = substr($0, 2+match($0, ":")) } +script=="log" && /^Committer Email:/ { CommitterEmail = substr($0, 2+match($0, ":")) } +script=="log" && /^Committer Date:/ { CommitterDate = substr($0, 2+match($0, ":")) } + +### Process output of "git status". +### Changed index? +script=="status" && /^# Changes to be committed:/ { modified = 1 } +### Unstaged modifications? +script=="status" && /^# Changed but not updated:/ { modified = 2 } + + + +END { + +### Process output of "git log". + if (script=="log") { +### Standard encoding is UTF-8. + if (Encoding == "") Encoding = "UTF-8" +### Extract relevant information from variables. + LongDate = substr(AuthorDate, 1, 25) + DateRAW = substr(LongDate, 1, 10) + DateISO = DateRAW + DateTEX = DateISO + gsub("-", "/", DateTEX) + Time = substr(LongDate, 12, 14) +### Write file identification to vc.tex. + print "%%% This file has been generated by the vc bundle for TeX." + print "%%% Do not edit this file!" + print "%%%" +### Write Git specific macros. + print "%%% Define Git specific macros." + print "\\gdef\\GITHash{" Hash "}%" + print "\\gdef\\GITAbrHash{" AbrHash "}%" + print "\\gdef\\GITParentHashes{" ParentHashes "}%" + print "\\gdef\\GITAbrParentHashes{" AbrParentHashes "}%" + print "\\gdef\\GITAuthorName{" AuthorName "}%" + print "\\gdef\\GITAuthorEmail{" AuthorEmail "}%" + print "\\gdef\\GITAuthorDate{" AuthorDate "}%" + print "\\gdef\\GITCommitterName{" CommitterName "}%" + print "\\gdef\\GITCommitterEmail{" CommitterEmail "}%" + print "\\gdef\\GITCommitterDate{" CommitterDate "}%" +### Write generic version control macros. + print "%%% Define generic version control macros." + print "\\gdef\\VCRevision{\\GITAbrHash}%" + print "\\gdef\\VCAuthor{\\GITAuthorName}%" + print "\\gdef\\VCDateRAW{" DateRAW "}%" + print "\\gdef\\VCDateISO{" DateISO "}%" + print "\\gdef\\VCDateTEX{" DateTEX "}%" + print "\\gdef\\VCTime{" Time "}%" + print "\\gdef\\VCModifiedText{\\textcolor{red}{with local modifications!}}%" + print "%%% Assume clean working copy." + print "\\gdef\\VCModified{0}%" + print "\\gdef\\VCRevisionMod{\\VCRevision}%" + } + +### Process output of "git status". + if (script=="status") { + print "%%% Is working copy modified?" + print "\\gdef\\VCModified{" modified "}%" + if (modified==0) { + print "\\gdef\\VCRevisionMod{\\VCRevision}%" + } else { + print "\\gdef\\VCRevisionMod{\\VCRevision~\\VCModifiedText}%" + } + } + +} diff --git a/2011/datagram-comparison/viecco-data.svg b/2011/datagram-comparison/viecco-data.svg new file mode 100644 index 0000000..7e13fd8 --- /dev/null +++ b/2011/datagram-comparison/viecco-data.svg @@ -0,0 +1,780 @@ +<?xml version="1.0" encoding="UTF-8" standalone="no"?> + + +<svg + xmlns:dc="http://purl.org/dc/elements/1.1/" + xmlns:cc="http://creativecommons.org/ns#" + xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" + xmlns:svg="http://www.w3.org/2000/svg" + xmlns="http://www.w3.org/2000/svg" + xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd" + xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape" + width="770.74414" + height="243.13622" + id="svg2" + version="1.1" + inkscape:version="0.48.2 r9819" + sodipodi:docname="viecco-data.svg"> + <defs + id="defs4" /> + <sodipodi:namedview + id="base" + pagecolor="#ffffff" + bordercolor="#666666" + borderopacity="1.0" + inkscape:pageopacity="0.0" + inkscape:pageshadow="2" + inkscape:zoom="1.979899" + inkscape:cx="383.10285" + inkscape:cy="66.008237" + inkscape:document-units="px" + inkscape:current-layer="layer1" + showgrid="true" + inkscape:window-width="1676" + inkscape:window-height="1030" + inkscape:window-x="0" + inkscape:window-y="18" + inkscape:window-maximized="0" + showguides="true" + inkscape:guide-bbox="true" + fit-margin-top="5" + fit-margin-left="5" + fit-margin-right="5" + fit-margin-bottom="5"> + <inkscape:grid + type="xygrid" + id="grid4099" + empspacing="5" + visible="true" + enabled="true" + snapvisiblegridlinesonly="true" + dotted="false" + spacingx="5px" + spacingy="5px" /> + </sodipodi:namedview> + <metadata + id="metadata7"> + <rdf:RDF> + <cc:Work + rdf:about=""> + <dc:format>image/svg+xml</dc:format> + <dc:type + rdf:resource="http://purl.org/dc/dcmitype/StillImage" /> + <dc:title /> + </cc:Work> + </rdf:RDF> + </metadata> + <g + inkscape:label="Layer 1" + inkscape:groupmode="layer" + id="layer1" + transform="translate(-59.970703,-409.42775)"> + <rect + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3081-7" + width="60" + height="20" + x="533.96655" + y="572.36218" + rx="3" + ry="5" /> + <rect + ry="5" + rx="2.7012572" + y="602.83179" + x="654.9707" + height="20" + width="54.025146" + id="rect3147" + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <rect + ry="5" + rx="4.5001464" + y="467.56396" + x="534.94141" + height="20" + width="90.00293" + id="rect3069" + style="fill:#91cf60;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <rect + style="fill:#91cf60;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3063" + width="100" + height="20" + x="250" + y="467.76575" + rx="5" + ry="5" /> + <text + sodipodi:linespacing="125%" + id="text3167" + y="427.76575" + x="69.150642" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + xml:space="preserve"><tspan + y="427.76575" + x="69.150642" + id="tspan3169" + sodipodi:role="line">Application</tspan></text> + <rect + ry="5" + rx="5" + y="627.56396" + x="64.970703" + height="20" + width="100" + id="rect3131" + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3133" + y="642.10071" + x="108.71826" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="642.10071" + x="108.71826" + id="tspan3135" + sodipodi:role="line">IP</tspan></text> + <rect + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3137" + width="100" + height="20" + x="64.970703" + y="602.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="103.15454" + y="616.73035" + id="text3139" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3141" + x="103.15454" + y="616.73035" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">TCP</tspan></text> + <rect + ry="5" + rx="5" + y="492.76575" + x="250" + height="20" + width="100" + id="rect3155" + style="fill:#d9ef8b;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3157" + y="507.23938" + x="270.72778" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="507.23938" + x="270.72778" + id="tspan3159" + sodipodi:role="line">Cell Auth</tspan></text> + <rect + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3161" + width="125" + height="20" + x="225" + y="442.76575" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="260.82227" + y="455.97083" + id="text3163" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3165" + x="260.82227" + y="455.97083" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Gateway</tspan></text> + <rect + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3173" + width="125" + height="20" + x="225" + y="627.36218" + rx="6.25" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="281.24756" + y="642.10071" + id="text3175" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3177" + x="281.24756" + y="642.10071" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">IP</tspan></text> + <rect + style="fill:#fee08b;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3185" + width="100" + height="20" + x="250" + y="542.36218" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="259.9707" + y="557.56396" + id="text3187" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3189" + x="259.9707" + y="557.56396" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Link Crypto</tspan></text> + <rect + ry="5" + rx="5" + y="517.56396" + x="250" + height="20" + width="100" + id="rect3191" + style="fill:#fffebf;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + xml:space="preserve" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + x="254.87225" + y="427.56396" + id="text3209" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3211" + x="254.87225" + y="427.56396">Initiator</tspan></text> + <text + sodipodi:linespacing="125%" + id="text3231" + y="427.56396" + x="409.9707" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + xml:space="preserve"><tspan + y="427.56396" + x="409.9707" + id="tspan3233" + sodipodi:role="line">Intermediate</tspan></text> + <rect + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3237" + width="100" + height="20" + x="400" + y="627.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="443.74756" + y="642.10071" + id="text3239" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3241" + x="443.74756" + y="642.10071" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">IP</tspan></text> + <rect + ry="5" + rx="5" + y="572.56396" + x="400" + height="20" + width="100" + id="rect3243" + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3245" + y="587.09436" + x="438.18384" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="587.09436" + x="438.18384" + id="tspan3247" + sodipodi:role="line">UDP</tspan></text> + <rect + style="fill:#fee08b;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3249" + width="100" + height="20" + x="400" + y="542.56396" + rx="5" + ry="5" /> + <rect + ry="5" + rx="5" + y="517.91931" + x="401.12427" + height="20" + width="100" + id="rect3255" + style="fill:#ffffbf;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3257" + y="532.56396" + x="429.9707" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="532.56396" + x="429.9707" + id="tspan3259" + sodipodi:role="line">Circuit</tspan></text> + <rect + ry="5" + rx="8.75" + y="627.56396" + x="534.9707" + height="20" + width="175" + id="rect3275" + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3277" + y="642.30249" + x="591.21826" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="642.30249" + x="591.21826" + id="tspan3279" + sodipodi:role="line">IP</tspan></text> + <rect + ry="5" + rx="4.5001464" + y="542.83179" + x="534.96777" + height="20" + width="90.00293" + id="rect3287" + style="fill:#fee08b;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + xml:space="preserve" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + x="579.94141" + y="427.56396" + id="text3311" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3313" + x="579.94141" + y="427.56396">Exit</tspan></text> + <text + sodipodi:linespacing="125%" + id="text3193" + y="532.4104" + x="278.84644" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="532.4104" + x="278.84644" + id="tspan3195" + sodipodi:role="line">Circuit</tspan></text> + <rect + ry="5" + rx="8.9899101" + y="-245" + x="442.76575" + height="20" + width="179.7982" + id="rect3144" + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" + transform="matrix(0,1,-1,0,0,0)" /> + <rect + ry="5" + rx="5" + y="543.1958" + x="64.970703" + height="20" + width="100" + id="rect3350" + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3352" + y="557.56396" + x="94.436523" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="557.56396" + x="94.436523" + id="tspan3354" + sodipodi:role="line">SOCKS</tspan></text> + <rect + style="fill:#ffffbf;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3356" + width="100" + height="20" + x="64.970703" + y="518.1958" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="99.226562" + y="531.50635" + id="text3358" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3360" + x="99.226562" + y="531.50635" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">HTTP</tspan></text> + <path + sodipodi:nodetypes="cccc" + inkscape:connector-curvature="0" + id="path3075" + d="m 194.9707,637.56395 -35,0 c -10,0 -0.0293,-109.99998 -10.0293,-109.99998 l -14.9707,0" + style="fill:none;stroke:#980101;stroke-width:1.17260385px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" /> + <rect + style="fill:#d9ef8b;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3366" + width="90.00293" + height="20" + x="534.96777" + y="492.56396" + rx="4.5001464" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="557.9502" + y="507.0376" + id="text3368" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3370" + x="557.9502" + y="507.0376" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Cell Auth</tspan></text> + <rect + style="fill:#ffffbf;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3372" + width="90.00293" + height="20" + x="534.96777" + y="517.56396" + rx="4.5001464" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="563.81714" + y="532.4104" + id="text3374" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3376" + x="563.81714" + y="532.4104" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Circuit</tspan></text> + <rect + ry="5" + rx="4.5999999" + y="442.56396" + x="534.9707" + height="20" + width="115" + id="rect3378" + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <rect + transform="matrix(0,1,-1,0,0,0)" + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3380" + width="179.99997" + height="20" + x="442.56396" + y="-649.9707" + rx="8.999999" + ry="5" /> + <text + sodipodi:linespacing="125%" + id="text3382" + y="455.76904" + x="570.79297" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="455.76904" + x="570.79297" + id="tspan3384" + sodipodi:role="line">Gateway</tspan></text> + <path + style="fill:none;stroke:#980101;stroke-width:1.01379383px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" + d="m 624.9414,452.56397 10.0293,0 c 15,0 -5,185.20739 10,185 l 15,0 c 5,0 0,-85 5,-85" + id="path4156" + inkscape:connector-curvature="0" + sodipodi:nodetypes="csccc" /> + <path + style="fill:none;stroke:#000000;stroke-width:0.89805281;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:2.69415846, 2.69415846;stroke-dashoffset:0" + d="m 189.9707,567.56397 500.0293,0" + id="path3242" + inkscape:connector-curvature="0" /> + <text + sodipodi:linespacing="125%" + id="text4012" + y="560.56396" + x="194.9707" + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="560.56396" + x="194.9707" + id="tspan4014" + sodipodi:role="line">Tor</tspan></text> + <text + xml:space="preserve" + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="194.9707" + y="580.56396" + id="text4016" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan4018" + x="194.9707" + y="580.56396" + style="font-size:10px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Host</tspan></text> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="278.39062" + y="482.23938" + id="text3065" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3067" + x="278.39062" + y="482.23938" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Stream</tspan></text> + <text + sodipodi:linespacing="125%" + id="text3071" + y="482.0376" + x="563.33203" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="482.0376" + x="563.33203" + id="tspan3073" + sodipodi:role="line">Stream</tspan></text> + <text + xml:space="preserve" + style="font-size:18px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans" + x="749.10986" + y="427.76575" + id="text3069" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3071" + x="749.10986" + y="427.76575">Server</tspan></text> + <rect + style="fill:#d73027;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3073" + width="100" + height="20" + x="725.71484" + y="627.56396" + rx="5" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="769.4624" + y="642.10071" + id="text3075" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3077" + x="769.4624" + y="642.10071" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">IP</tspan></text> + <rect + ry="5" + rx="5" + y="602.56396" + x="725.71484" + height="20" + width="100" + id="rect3079" + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3081" + y="617.09436" + x="763.89868" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="617.09436" + x="763.89868" + id="tspan3083" + sodipodi:role="line">TCP</tspan></text> + <rect + ry="5" + rx="5" + y="572.56396" + x="725.71484" + height="20" + width="100" + id="rect3091" + style="fill:#ffffbf;fill-opacity:1;fill-rule:evenodd;stroke:none" /> + <text + sodipodi:linespacing="125%" + id="text3093" + y="585.87451" + x="759.9707" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="585.87451" + x="759.9707" + id="tspan3095" + sodipodi:role="line">HTTP</tspan></text> + <path + sodipodi:nodetypes="ccccc" + inkscape:connector-curvature="0" + id="path3097" + d="m 699.9707,552.56397 c 5,0 0,85 5,85 l 30.0293,-1e-5 c 10,0 -0.0293,-55.00001 9.9707,-55.00001 l 10,0" + style="fill:none;stroke:#980101;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" /> + <rect + style="fill:#fc8d59;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3081" + width="60" + height="20" + x="289.9707" + y="572.36218" + rx="3" + ry="5" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="305.94556" + y="587.09436" + id="text3083" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3085" + x="305.94556" + y="587.09436" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">UDP</tspan></text> + <path + style="fill:none;stroke:#980101;stroke-width:1.02353275px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" + d="m 360,637.56396 45,0 c 10,0 -0.0293,-109.99999 9.9707,-109.99999 l 10,0 m 50,0 10,0 c 10,0 0.0293,109.99999 10.0293,109.99999 l 20,0" + id="path3364" + inkscape:connector-curvature="0" + sodipodi:nodetypes="ccsccscc" /> + <path + sodipodi:nodetypes="cccc" + inkscape:connector-curvature="0" + id="path3080" + d="m 515,637.56396 24.9707,1e-5 c 15,0 0,-185 15,-185 l 10,0" + style="fill:none;stroke:#980101;stroke-width:1.01379383px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" /> + <path + sodipodi:nodetypes="cccccccc" + inkscape:connector-curvature="0" + id="path3362" + d="m 190,637.56396 40,0 c 15,0 -0.0293,-184.99999 14.9707,-184.99999 l 15,0 m 55,0 15,0 c 15,0 0.0293,185.20738 15.0293,184.99999 l 15,0" + style="fill:none;stroke:#980101;stroke-width:1.01379383px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" /> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="412.9707" + y="557.56396" + id="text3187-6" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3189-5" + x="412.9707" + y="557.56396" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Link Crypto</tspan></text> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="550.94141" + y="557.56396" + id="text3187-69" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3189-3" + x="550.94141" + y="557.56396" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">Link Crypto</tspan></text> + <text + xml:space="preserve" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="549.94141" + y="587.09436" + id="text3083-4" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3085-5" + x="549.94141" + y="587.09436" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">UDP</tspan></text> + <text + sodipodi:linespacing="125%" + id="text3149" + y="617.56396" + x="669.9707" + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + xml:space="preserve"><tspan + style="font-size:13px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + y="617.56396" + x="669.9707" + id="tspan3151" + sodipodi:role="line">TCP</tspan></text> + <rect + style="fill:#1a9850;fill-opacity:1;fill-rule:evenodd;stroke:none" + id="rect3342" + width="55" + height="20" + x="654.9707" + y="543.1958" + rx="2.75" + ry="5" /> + <text + xml:space="preserve" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans" + x="663.47577" + y="557.0589" + id="text3344" + sodipodi:linespacing="125%"><tspan + sodipodi:role="line" + id="tspan3346" + x="663.47577" + y="557.0589" + style="font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;font-family:DejaVu Sans;-inkscape-font-specification:DejaVu Sans">SOCKS</tspan></text> + </g> +</svg>

1 0

[tech-reports/master] Add raw pluggable-roadmap report from Steven's repo.
by karsten＠torproject.org 26 Aug '12

26 Aug '12

commit 1610f035b45ffa967082455738a2f18c460174b1 Author: Karsten Loesing <karsten.loesing(a)gmx.net> Date: Wed Aug 8 08:01:35 2012 +0200 Add raw pluggable-roadmap report from Steven's repo. https://gitweb.torproject.org/sjm217/torspec.git/tree/project4679:/proposal… --- 2012/pluggable-roadmap/.gitignore | 9 + 2012/pluggable-roadmap/Makefile | 3892 ++++++++++++++++++++++++++ 2012/pluggable-roadmap/Targets.ini | 4 + 2012/pluggable-roadmap/easychair.cls | 756 +++++ 2012/pluggable-roadmap/pluggable-roadmap.bib | 17 + 2012/pluggable-roadmap/pluggable-roadmap.tex | 274 ++ 2012/pluggable-roadmap/vc | 24 + 2012/pluggable-roadmap/vc-git.awk | 89 + 8 files changed, 5065 insertions(+), 0 deletions(-) diff --git a/2012/pluggable-roadmap/.gitignore b/2012/pluggable-roadmap/.gitignore new file mode 100644 index 0000000..70fe299 --- /dev/null +++ b/2012/pluggable-roadmap/.gitignore @@ -0,0 +1,9 @@ +pluggable-roadmap.aux.make +pluggable-roadmap.auxbbl.make +pluggable-roadmap.auxtarget.make +pluggable-roadmap.d +pluggable-roadmap.fls +pluggable-roadmap.out.make +pluggable-roadmap.pdf +vc._include_.tex + diff --git a/2012/pluggable-roadmap/Makefile b/2012/pluggable-roadmap/Makefile new file mode 100644 index 0000000..62951f3 --- /dev/null +++ b/2012/pluggable-roadmap/Makefile @@ -0,0 +1,3892 @@ +# Copyright 2004 Chris Monson (shiblon(a)gmail.com) +# Latest version available at http://www.bouncingchairs.net/oss +# +# This file is part of ``Chris Monson's Free Software''. +# +# ``Chris Monson's Free Software'' is free software; you can redistribute it +# and/or modify it under the terms of the GNU General Public License as +# published by the Free Software Foundation, Version 2. +# +# ``Chris Monson's Free Software'' is distributed in the hope that it will +# be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General +# Public License for more details. +# +# You should have received a copy of the GNU General Public License along +# with ``Chris Monson's Free Software''; if not, write to the Free Software +# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA +# +# It is also available on the web at http://www.gnu.org/copyleft/gpl.html +# +# Note that using this makefile to build your documents does NOT place them +# under the GPL unless you, the author, specifically do so. In other words, +# I, Chris Monson, the copyright holder and author of this makefile, +# consider it impossible to ``link'' to this makefile in any way covered by +# the GPL. +# +# +# TO OBTAIN INSTRUCTIONS FOR USING THIS FILE, RUN: +# make help +# +fileinfo := LaTeX Makefile +author := Chris Monson +version := 2.2.0 +# +.DEFAULT_GOAL := all +# Note that the user-global version is imported *after* the source directory, +# so that you can use stuff like ?= to get proper override behavior. +.PHONY: Makefile GNUmakefile Makefile.ini $(HOME)/.latex-makefile/Makefile.ini +-include Makefile.ini +-include $(HOME)/.latex-makefile/Makefile.ini +# Better names for these things +.PHONY: Variables.ini $(HOME)/.latex-makefile/Variables.ini +-include Variables.ini +-include $(HOME)/.latex-makefile/Variables.ini +# +# This can be pdflatex or latex - you can change this by adding the following line to your Makefile.ini: +# BUILD_STRATEGY := latex +BUILD_STRATEGY ?= pdflatex +# +# Sets LC_ALL=C, by default, so that the locale-aware tools, like sort, be +# # immune to changes to the locale in the user environment. +export LC_ALL ?= C +# +# +# If you specify sources here, all other files with the same suffix +# will be treated as if they were _include_ files. +#onlysources.tex ?= main.tex +#onlysources.tex.sh ?= +#onlysources.tex.pl ?= +#onlysources.tex.py ?= +#onlysources.rst ?= +#onlysources.fig ?= +#onlysources.gpi ?= +#onlysources.dot ?= +#onlysources.xvg ?= +#onlysources.svg ?= +#onlysources.eps.gz ?= +#onlysources.eps ?= +# +# If you list files here, they will be treated as _include_ files +#includes.tex ?= file1.tex file2.tex +#includes.tex.sh ?= +#includes.tex.pl ?= +#includes.tex.py ?= +#includes.rst ?= +#includes.fig ?= +#includes.gpi ?= +#includes.dot ?= +#includes.xvg ?= +#includes.svg ?= +#includes.eps.gz ?= +#includes.eps ?= +# +# If you list files or wildcards here, they will *not* be cleaned - default is +# to allow everything to be cleaned. +#neverclean ?= *.pdf +# +# Alternatively (recommended), you can add those lines to a Makefile.ini file +# and it will get picked up automatically without your having to edit this +# Makefile. +# +# KNOWN ISSUES: +# * The following occurs: +# file with: \usepackage{named}\bibliographystyle{named} +# Compile +# change to: \usepackage{apalike}\bibliographystyle{apalike} +# Compile again -- BARF! +# +# The workaround: make clean-nographics; make +# +# Note that we may not be able to fix this. LaTeX itself barfs +# on this, not the makefile. The very first invocation of LaTeX +# (when something like this has happened) reads the existing .aux +# file and discovers invalid commands like \citeauthoryear that +# are only valid in the package that was just removed. It then +# tries to parse them and explodes. It's not at all clear to me +# how to fix this. I tried removing the .aux files on the first +# run of LaTeX, but that necessarily requires more subsequent +# rebuilds on common edits. There does not appear to be a +# graceful solution to this issue. +# +# +# CHANGES: +# Chris Monson (2011-05-20): +# * Bumped version to 2.2.0 (release!) +# Chris Monson (2011-05-19): +# * Bumped version to 2.2.0-rc15 +# * Issue 125: infinite recursion with nomenclature files +# * Issue 125: removed .d as a target for .nls in get-log-index +# * Cleaned up invocation of run-makeindex to take an optional .ist instead of flags. +# Chris Monson (2011-04-06): +# * Bumped version to 2.2.0-rc14 +# * Issue 121: Added Targets.ini and corresponding help text for it. +# * Issue 121: Added Variables.ini (Makefile.ini still works, though). +# * Issue 121: Added .DEFAULT_GOAL optional setting. +# * Issue 120: xindy compatibility +# Chris Monson (2011-03-16): +# * Bumped version to 2.2.0-rc13 +# * Fixed a bug in kspewhich invocation - random characters and a missing pipe. +# * Added font embedding to gnuplot output. +# Chris Monson (2011-03-15): +# * Bumped version to 2.2.0-rc12 +# * Issue 119: Annoying warning from which if Gnuplot not installed. +# * Fixed catchall error output to show more info from the log. Cutting off the +# first line is too jarring. +# * Issue 118: Better glossary support +# Chris Monson (2011-03-03): +# * Bumped version to 2.2.0-rc11 +# * Issue 112: Fixed regression introduced by use of cygpath (ugly warnings) +# Chris Monson (2011-02-03): +# * Bumped version to 2.2.0-rc10 +# * Issue 112: Added path normalization for cygwin systems +# * Fixed a bug in get-missing-inputs where we weren't specifying target files +# Chris Monson (2011-01-24): +# * Issue 111: Added .jpeg as a possible image extension +# Chris Monson (2011-01-21): +# * Issue 110: Long filenames not produced correctly in .d file +# * Fixed problem with unknown control sequence error parsing +# * Fixed problem with \r in fatal output (was interpreted as LF by echo) +# * Removed a spurious "hi" +# Chris Monson (2011-01-14): +# * Bumped version to 2.2.0-rc8 +# * Issue 107: Removed comment with embedded newline, fixing MinGW on Windows 7. +# Chris Monson (2011-01-07): +# * Emit an error if .gpi.d files have dependencies with : in the name +# Chris Monson (2011-01-05): +# * Bumped version to 2.2.0-rc7 +# * Issue 106: existing graphic dependencies not generated correctly +# Chris Monson (2011-01-04): +# * Issue 106: not cleaning eps log files properly +# * Issue 106: not rebuilding after creating .pdf graphics from .eps +# * Issue 94: svg going unnecessarily through eps (can't reproduce) +# Chris Monson (2010-12-31): +# * Issue 100: make hanging because of faulty graphics detection (sed bug) +# * Issue 108: do not ignore fatal errors from pdftex +# Chris Monson (2010-12-23): +# * Added gpi_global to gnuplot dependencies so that changes are detected +# Chris Monson (2010-12-20): +# * Updated build file to be smarter about Python version detection +# * Created a bunch of test files and supporting scripts +# * Issue 72: added apacite capaability (thanks to matkarat) +# Chris Monson (2010-11-23): +# * Changed to multi-part makefile build (split out sed scripts) +# * Added build script and supporting infrastructure +# * Updated test directory format +# * Added notes about needed test cases +# * Changed to use -file-line-error and fixed multiple inclusion/error bugs +# * Added run_sed.py to allow easy testing of sed scripts outside of make +# Chris Monson (2010-11-11): +# * Bumped version to 2.2.0-rc7 +# * issue 92: broken hyperref driver detection fixed +# * issue 101: Broken inkscape conversion +# * issue 102: Broken specification of font size for gnuplot pdfcairo +# * Added KEEP_TEMP so that we can avoid deleting useful temporaries for debugging +# * Restructured gnuplot code to be easier to follow +# * Fixed a bug in convert-gpi where we were using $< instead of $1 +# Chris Monson (2010-11-03): +# * Bumped version to 2.2.0-rc6 +# * issue 96: Fix sed errors when using make variables in substitutions +# Chris Monson (2010-07-28): +# * Bumped version to 2.2.0-rc5 (rc4 is broken) +# * Bail out when we find the use of the import.sty package +# * Issue 90: Add -z to dvips invocation +# * Issue 67: Add xelatex support (thanks to Nikolai Prokoschenko for the patch!) +# * Issue 85: Add warning about make 3.80 +# Chris Monson (2010-06-20): +# * Bumped version to 2.2.0-rc3 +# * Attempt to fix bug with ! error detection (issue 88) +# * Added svg->pdf direct support (issue 89) +# Chris Monson (2010-04-28): +# * Bumped version to 2.2.0-rc2 +# * Fixed %._show target +# Chris Monson (2010-04-08): +# * Bumped version to 2.2.0-rc1 +# * Added back in the rst_style_file stuff that got broken when switching +# rst -> tex to use the script mechanism +# Chris Monson (2010-03-23): +# * Bumped version to 2.2.0-beta8 +# * Work on issue 76: bad backtick escape for some sed versions, failure +# to clear out the hold buffer when outputting MISSING comment. +# - Backed out 2>&1 to &> (doesn't work in sh) +# - Backed out using . to source variables +# Chris Monson (2010-03-22): +# * Bumped version to 2.2.0-beta7 +# * Issue 72: Fix latex/bibtex invocation order for annotated bib styles +# * Fixed informational output to reflect which LaTeX run we're on +# * Fixed graphic detection to include graphics that are already there in +# .d files +# * Tightened up the .d file output to only make .d depend on graphic +# *source* files. This means that building foo.d no longer +# builds all of the graphics files on which foo.tex depends. +# Had to use .SECONDEXPANSION trickery to make it work. +# * Changed get-graphics to only accept a stem. +# * Fixed build-once logic for scripted .tex to work better +# * Made get-inputs sed script more maintainable. +# * Moved Makefile.ini import up higher. +# * Changed bare stems to not recursively invoke make +# * Updated diff output to be more silent everywhere +# * Added a MISSING comment to the .d file if stuff isn't found - forces +# removal of .1st.make file, which often forces it to try again. +# * Fixed broken graphics-target function +# * Added sleep to .d file generation when stuff is missing - if it +# builds too fast, make doesn't realize it needs to be reloaded, +# and thus never discovers some deeper dependencies (especially +# evident when graphics are included from scripted include +# files). +# Chris Monson (2010-03-17): +# * Bumped version to 2.2.0-beta6 +# * Fixed bareword builds to actually work (requires static patterns) +# * Fixed colorization to work with new paragraph stuff +# Chris Monson (2010-03-17): +# * Bumped version to 2.2.0-beta5 +# * Fixed graphic detection to be much more focused - splits log file +# into paragraphs before doing pattern matching. +# * Fixed make foo to work properly (recursively calls make foo.pdf) +# * Fixed gpi -> pdf generation to not waste time building .eps *after* +# the pdf already exists. +# * Changed log copies to include MAKE_RESTARTS as part of the name. +# * Fixed missing include file detection (also makes use of the paragraph +# stuff) to detect missing scripted include files. +# Chris Monson (2010-03-16): +# * Bumped version to 2.2.0-beta4 +# * issue 70: .pdf not moved out of the way properly on first +# compilation, resulting in early error detection failure. +# * issue 74: fixed broken error on missing .aux files: the +# implementation was masking real errors. +# Chris Monson (2010-03-15): +# * Bumped version to 2.2.0-beta3 +# * issue 71: Made the tput dependency optional +# * issue 73: Made .tex targets not pull in .d files (building them from +# scripts should not require a .d) +# * issue 74: Output a much saner error when a .aux file is not produced +# (e.g., when you are typing "make" without arguments in a +# directory with included .tex files that are not named with +# ._include_.) +# Chris Monson (2010-03-11): +# * Bumped version to 2.2.0-beta2 +# * Fixed clean-graphics to get rid of intermediate .eps files that may +# be hanging around +# * Added an automatic setting to use eps terminals in pdflatex mode for +# gnuplot if it doesn't understand pdf. +# * issue 66: Removed grayscale generation via magic suffix. Grayscale +# generation is now only available via GRAY=1 +# * issue 68: Added explicit handling of LC_ALL for locale-aware tools +# like "sort" +# Chris Monson (2010-03-10): +# * Bumped version to 2.2.0-beta1 +# * Fixed success message to handle output message in different places +# * Added name of produced file to success message +# Chris Monson (2010-03-10): +# * Bumped version to 2.2.0-alpha3 +# * Added meaningful error message for wrong hyperref options +# * Added meaningful error message for incorrect graphics extensions +# Chris Monson (2010-03-09): +# * Bumped version to 2.2.0-alpha2 +# * Updated graphics handling (gnuplot and fig generate pdf natively) +# * Changed xmgrace to output monochrome natively +# Chris Monson (2010-03-09): +# * Bumped version to 2.2.0-alpha1 - major change! +# * Support pdflatex natively and by default (issue 6 - a long time coming) +# * Add ability to have a single $HOME/.latex-makefile/Makefile.ini for +# all invocations +# * Reworked graphic inclusion detection so that extensions need not be +# specified for either build strategy (e.g., +# \includegraphics{test1.eps} -> \includegrahpics{test1}) +# * Changed log format to include filenames and line numbers +# Chris Monson (2010-02-04): +# * Bumped version to 2.1.43 +# * All of the following are for issue 63 (thanks to mojoh81): +# * Added documentation about fixing Makefile.ini default target +# * Added perl and python script targets +# * Fixed run logic to allow included .tex files to be scripted (the +# run-again logic now detects missing .tex files, and the MV +# command has been switched out for a command that only invokes +# MV if the files exist) +# * Changed scripted generation to only run once per make invocation +# * Added dependency on expr +# Chris Monson (2010-01-19): +# * Bumped version to 2.1.42 +# * issue 62: Added .brf extension to cleanable files (backrefs) +# Chris Monson (2010-01-07): +# * Bumped version to 2.1.41 +# * issue 60: bad makeindex runs now error out on subsequent tries +# Chris Monson (2009-12-01): +# * Bumped version to 2.1.40 +# * issue 36: build all indices (for e.g., splitidx usage) +# * issue 59: clean up all generated files (including indices) +# Chris Monson (2009-11-23): +# * Bumped version to 2.1.39 +# * issue 57: change ps2pdf invocations to just use gs directly +# Chris Monson (2009-11-19): +# * Bumped version to 2.1.38 +# * issue 57: Added some limited support for Cygwin (spaces in filenames) +# Chris Monson (2009-11-15): +# * Bumped version to 2.1.37 +# * Removed svninfo, since this is now managed by mercurial +# * Fixed typo in changelist +# * Issue 52: added jpg->eps conversion (thanks to brubakee) +# * Issue 54: fix missing Overfull colorization due to lack of a blank +# line preceding the first error. +# * Issue 51: remove head.tmp and body.tmp in make clean invocation +# * Issue 56: maintain multiple versions of log files (for debugging) +# Chris Monson (2009-11-14): +# * Bumped version to 2.1.36 +# * Issues 53 and 49: added .brf, .mtc, and .maf to the cleanables +# Chris Monson (2009-11-05): +# * Bumped version to 2.1.35 +# * Added nomenclature support (see issue 48) +# Chris Monson (2009-10-29): +# * Bumped version to 2.1.34 +# * Fixed _out_ creation bug introduced in 2.1.33 (it was always created) +# * Fixed erroneous help output for $HOME in BINARY_TARGET_DIR +# * Changed contact email address - bring on the spam! +# Chris Monson (2009-10-21): +# * Bumped version to 2.1.33 +# * Fixed issue 46, adding support for dot2tex (thanks to fdemesmay) +# * Made all_files.* settable in Makefile.ini (using ?= instead of :=) +# * Fixed issue 47, thanks to fdemesmay: add binary copy directory, copy +# dvi, pdf, and ps if it exists +# Chris Monson (2009-09-25): +# * Bumped version to 2.1.32 +# * Fixed so that a changed lol file will cause a rebuild +# * Added .lol files to the cleanable list +# Chris Monson (2009-09-08): +# * Bumped version to 2.1.31 +# * Closed issue 43: evince doesn't notice pdf change w/out touch +# Chris Monson (2009-08-28): +# * Bumped version to 2.1.30 +# * Closed issue 39: Capture multi-line log warnings/errors to output +# Chris Monson (2009-08-26): +# * Bumped version to 2.1.29 +# * Closed issue 42: add svg support using inkscape +# Chris Monson (2009-08-17): +# * Bumped version to 2.1.28 +# * Patch from paul.biggar for issue 38: package warnings are overlooked +# Chris Monson (2009-08-07): +# * Bumped version to 2.1.27 +# * Included patch for issue 37 - removes pdf/ps files before copying, +# allowing some broken viewers to see changes properly. +# Chris Monson (2009-05-15): +# * Bumped version to 2.1.26 +# * Included patch for issue 9 from favonia - detects .fig changes for +# pstex files during regular compilation, so long as the pstex +# has been built at least once with make all-pstex. +# Chris Monson (2009-03-27): +# * Bumped version to 2.1.25 +# * Cleaned up a bunch of variable setting stuff - more stuff is now +# settable from Makefile.ini +# * Cleaned up documentation for various features, especially settable +# variables. +# * issue 28: support for png -> eps conversion (it even looks good!) +# * issue 29: support for "neverclean" files in Makefile.ini +# * issue 30: make ps2pdf14 the default - fall back when not there +# Chris Monson (2009-03-09): +# * Bumped version to 2.1.24 +# * issue 27: xmgrace support (thanks to rolandschulzhd) +# Chris Monson (2008-10-23): +# * Bumped version to 2.1.23 +# * issue 23: fixed _check_programs to not use bash string subs +# Chris Monson (2008-09-02): +# * Bumped version to 2.1.22 +# * Appled patch from Holger <yllohy(a)googlemail.com> to add include +# sources and some documentation updates. +# * Updated backup_patterns to be a bit more aggressive (also thanks to +# Holger) +# Chris Monson (2008-08-30): +# * Bumped version to 2.1.21 +# * Added ability to specify onlysources.* variables to indicate the only +# files that should *not* be considered includes. Thanks to Holger +# <yllohy(a)googlemail.com> for this patch. +# * Added an automatic include of Makefile.ini if it exists. Allows +# settings to be made outside of this makefile. +# Chris Monson (2008-05-21): +# * Bumped version to 2.1.20 +# * Added manual pstex compilation support (run make all-pstex first) +# * Removed all automatic pstex support. It was totally breaking +# everything and is very hard to incorporate into the makefile +# concept because it requires LaTeX to *fail* before it can +# determine that it needs the files. +# Chris Monson (2008-04-17): +# * Bumped version to 2.1.19 +# * Changed the pstex build hack to be on by default +# Chris Monson (2008-04-09): +# * Bumped version to 2.1.18 +# * issue 16: fixed pstex build problems, seems nondeterministic. Added +# gratuitious hack for testing: set PSTEX_BUILD_ALL_HACK=1. +# Chris Monson (2008-04-09): +# * Bumped version to 2.1.17 +# * issue 20: fixed accumulation of <pid>*.make files - wildcard was +# refusing to work on files that are very recently created. +# Chris Monson (2008-04-02): +# * Bumped version to 2.1.16 +# * issue 19: Removed the use of "type" to fix broken "echo" settings +# Chris Monson (2008-03-27): +# * Bumped version to 2.1.15 +# * issue 18: Favors binary echo over builtin, as binary understands -n +# * issue 16: Fixed handling of missing pstex_t files in the log +# * issue 9: Added .SECONDARY target for .pstex files +# Chris Monson (2008-03-21): +# * Bumped version to 2.1.14 +# * Fixed broken aux file flattening, which caused included bibs to be +# missed. +# Chris Monson (2008-03-20): +# * Bumped version to 2.1.13 +# * Changed error output colorization to show errors for missing files +# that are not graphics files. +# Chris Monson (2008-03-20): +# * Bumped version to 2.1.12 +# * Fixed a regression introduced in r28 that makes bibtex fail when +# there is no index file present +# Chris Monson (2008-03-03): +# * Bumped version to 2.1.11 +# * Fixed issue 11 (handle index files, reported by abachn) +# * Cleaned up some comments and help text +# Chris Monson (2008-01-24): +# * Bumped version to 2.1.10 +# * Fixed to work when 'sh' is a POSIX shell like 'dash' +# Chris Monson (2007-12-12): +# * Bumped version to 2.1.9 +# * Fixed documentation and dependency graph for pstex files +# Chris Monson (2007-12-12): +# * Bumped version to 2.1.8 +# * Added basic pstex_t support for fig files (Issue 9 by favonia) +# I still suggest that psfrag be used instead. +# Chris Monson (2007-10-16): +# * Bumped version to 2.1.7 +# * Removed todo item: allow other comment directives for rst conversion +# * Added ability to use global rst style file _rststyle_._include_.tex +# * Added help text to that effect +# Chris Monson (2007-05-20): +# * Bumped version to 2.1.6 +# * Changed default paper size for rst files +# * Added todo item: fix paper size for rst files +# * Added todo item: allow other comment directives for rst conversion +# Chris Monson (2007-04-02): +# * Bumped version to 2.1.5 +# * Addressed Issue 7, incorrect .gpi.d generation in subdirectories +# Chris Monson (2007-03-28): +# * Bumped version to 2.1.4 +# * Fixed syntax error in dot output +# Chris Monson (2007-03-01): +# * Bumped version to 2.1.3 +# * Added reST to the included documentation +# * Fixed graphics and script generation to be settable in the +# environment. +# Chris Monson (2007-02-23): +# * Bumped version to 2.1.2 +# * Added the ability to generate .tex files from .rst files +# Chris Monson (2006-10-17): +# * Bumped version to 2.1.1 +# * Fixed includes from subdirectories (sed-to-sed slash escape problem) +# Chris Monson (2006-10-05): +# * Bumped version to 2.1.0 (pretty serious new feature added) +# * New feature: bib files can now be anywhere on the BIBINPUTS path +# * New programs: kpsewhich (with tetex) and xargs (BSD) +# Chris Monson (2006-09-28): +# * Bumped version to 2.0.9 +# * Added ability to parse more than one bibliography +# Chris Monson (2006-06-01): +# * Bumped version to 2.0.8 +# * Added .vrb to the list of cleaned files +# Chris Monson (2006-04-26): +# * Bumped version to 2.0.7 +# * Fixed so that clean-nographics does not remove .gpi.d files +# * Removed jpg -> eps hack (not working properly -- just pre-convert) +# * Fixed so that postscript grayscale can be done with BSD sed +# Chris Monson (2006-04-25): +# * Bumped version to 2.0.6 +# * Fixed so that changed toc, lot, lof, or out causes a rebuild +# Chris Monson (2006-04-17): +# * Bumped version to 2.0.5 +# * Added jpg -> eps conversion target +# Chris Monson (2006-04-12): +# * Bumped version to 2.0.4 +# * Fixed BSD sed invocation to not use \| as a branch delimiter +# * Added a comment section on what is and is not allowed in BSD sed +# * Made paper size handling more robust while I was at it +# * Fixed postscript RGB grayscale to use a weighted average +# * Fixed postscript HSB grayscale to convert to RGB first +# * Fixed a problem with rebuilding .bbl files +# Chris Monson (2006-04-11): +# * Bumped version to 2.0.3 +# * Fixed some BSD sed problems: can't use \n in substitutions +# Chris Monson (2006-04-10): +# * Bumped version to 2.0.2 +# * Once again removed ability to create .tex files from scripts +# * \includeonly works again +# Chris Monson (2006-04-09): +# * Bumped version to 2.0.1 +# * Fixed grayscale postscript handling to be more robust +# * Added ability to generate ._gray_. files from eps and eps.gz +# * Added ability to clean ._gray_.eps files created from .eps files +# Chris Monson (2006-04-07): +# * Bumped version to 2.0.0 +# * Removed clunky ability to create included .tex files from scripts +# * Added note in the help about included tex scripting not working +# * Fixed the .eps generation to delete %.gpihead.make when finished +# * Abandoned designs to use shell variables to create sed scripts +# * Abandoned __default__.tex.sh idea: it causes recursion with %: . +# * Removed web page to-do. All items are now complete. +# * Added better grayscale conversion for dot figures (direct ps fixup). +# * Include files can now be scripted (at the expense of \includeonly). +# * Updated dependency graph to contain better node names. +# Chris Monson (2006-04-06): +# * Bumped version to 2.0b3 +# * Top level includes now fail if there is no rule to build them +# * A helpful message is printed when they do fail +# * Grayscale has been changed to be ._gray_, other phonies use _ now, too +# * Grayscale handling has been completed +# * Changed _include_stems target to _includes target. +# * Fixed _includes target to be useful by itself. +# * Removed the ability to specify clean and build targets at once +# * Verified that epsfig works fine with current code +# * Fixed included scripts so that they are added to the dep files +# * Fixed so that graphics includes don't happen if they aren't for gpi +# * Fixed dot output to allow grayscale. +# Chris Monson (2006-04-05): +# * Bumped version to 2.0b2 +# * Removed automatic -gray output. It needs fixing in a bad way. +# * Revamped dependency creation completely. +# * Fixed conditional inclusion to actually work (test.nobuild.d, test.d). +# * Fixed clean target to remove log targets +# * Added the 'monochrome' word for gray gpi output +# * Added a _check_gpi_files target that checks for common problems +# * Changed the _version target into the version target (no _) +# * Added better handling of grayscale files. Use the .gray.pdf target. +# * Fixed testing for rebuilds +# Chris Monson (2006-04-04): +# * Bumped version to 2.0b1 +# * Changed colorization of output +# * Made .auxbbl and .auxtex .make files secondary targets +# * Shortened and simplified the final latex invocation loop +# * Added version-specific output ($$i vs. $$$$i) in latex loop +# * Added a build message for the first .dvi run (Building .dvi (0)) +# * Removed some build messages that most people don't care about. +# * Simplified procedure for user-set colors -- simple text specification +# * Fixed diff output to...not output. +# * Fixed rerun bug -- detect not only when preceded with LaTeX Warning +# * Sped up gpi plotting +# * Added error handling and colorized output for gpi failure +# * Documented color changing stuff. +# * Now sort the flattened aux file to avoid false recompilation needs +# * Added clean-nographics target +# * Don't remove self.dvi file if self.aux is missing in the log +# * Clarified some code. Did some very minor adjusting. +# Chris Monson (2006-04-03): +# * Bumped version to 2.0a7 +# * Added .dvi and .ps files as secondary files. +# * Fixed handling of multiple run detection when includeonly is in use. +# * Added code to flatten .aux files. +# * Added more files as .SECONDARY prerequisites to avoid recompilation. +# * Fixed the inputs generation to be much simpler and to use pipes. +# * Added the dependency graph directly into the makefile. +# * Changed flatten-aux to remove \@writefile \relax \newlabel, etc. +# * Undid pipe changes with sed usage (BSD sed doesn't know -f-). +# * Added a _check_programs target that tells you what your system has. +# * Fixed an error in colorization that made unnecessary errors appear +# * Added view targets. +# * Updated help text. +# * Augmented cookies so that .aux can trigger .bbl and .dvi rebuilds +# * Added more informative error handling for dvips and ps2pdf +# Chris Monson (2006-04-02): +# * Bumped version to 2.0a6 +# * Added indirection to .bbl dependencies to avoid rebuilding .bbl files +# * Streamlined the diff invocation to eliminate an existence test +# * Removed special shell quote escape variables +# * Moved includes to a more prominent location +# * Fixed .inputs.make to not contain .aux files +# * Fixed embedding to use a file instead of always grepping. +# * Added *.make.temp to the list of cleanable files +# * Fixed Ruby. It should now be supported properly. +# * Now differentiate between all, default, and buildable files. +# * Fixed to bail out on serious errors. +# * Revised the handling of includable files. Still working on it. +# Chris Monson (2006-03-31): +# * Bumped version to 2.0a5 +# * Fixed a bug with LaTeX error detection (there can be spaces) +# * Added .bbl support, simplifying everything and making it more correct +# * Refactored some tests that muddy the code +# * Did a little cleanup of some shell loops that can safely be make loops +# * Added support for graphviz .dot files +# * Made _all_programs output easier to read +# * Added the ruby support that has long been advertised +# * Font embedding was screwed up for PostScript -- now implicit +# * Changed the generation of -gray.gpi files to a single command +# * Changed any make-generated file that is not included from .d to .make +# Chris Monson (2006-03-30): +# * Bumped version to 2.0a4 +# * Fixed a bug with very long graphics file names +# * Added a todo entry for epsfig support +# * Fixed a bug paper size bug: sometimes more than one entry appears +# * Fixed DVI build echoing to display the number instead of process ID +# * DVI files are now removed on first invocation if ANY file is missing +# * Added a simple grayscale approach: if a file ends with -gray.gpi, it +# is created from the corresponding .gpi file with a special +# comment ##GRAY in its header, which causes coloring to be +# turned off. +# * Fixed a bug in the handling of .tex.sh files. For some reason I had +# neglected to define file stems for scripted output. +# * Removed a trailing ; from the %.graphics dependencies +# * Added dvips embedding (I think it works, anyway) +# Chris Monson (2006-03-29): +# * Bumped version to 2.0a3 +# * Fixed error in make 3.79 with MAKEFILE_LIST usage +# * Added the presumed filename to the _version output +# * Added a vim macro for converting sed scripts to make commands +# * Added gpi dependency support (plotting external files and loading gpi) +# * Allow .gpi files to be ignored if called .include.gpi or .nobuild.gpi +# * Fixed sed invocations where \+ was used. BSD sed uses \{1,\}. +# Chris Monson (2006-03-28): +# * Bumped version to 2.0a2 +# * Added SHELL_DEBUG and VERBOSE options +# * Changed the default shell back to /bin/sh (unset, in other words) +# * Moved .PHONY declarations closer to their targets +# * Moved help text into its own define block to obtain better formatting +# * Removed need for double-entry when adding a new program invocation +# * Moved .SECONDARY declaration closer to its relevant occurrence +# * Commented things more heavily +# * Added help text about setting terminal and output in gnuplot +# * Created more fine-grained clean targets +# * Added a %.graphics target that generates all of %'s graphics +# * Killed backward-compatible graphics generation (e.g., eps.gpi=gpi.eps) +# * For now, we're just GPL 2, not 3. Maybe it will change later +# * Made the version and svninfo into variables +# Chris Monson (2006-03-27): +# * Bumped version to 2.0a1 +# * Huge, sweeping changes -- automatic dependencies +# + +# IMPORTANT! +# +# When adding to the following list, do not introduce any blank lines. The +# list is extracted for documentation using sed and is terminated by a blank +# line. +# +# EXTERNAL PROGRAMS: +# = ESSENTIAL PROGRAMS = +# == Basic Shell Utilities == +CAT ?= cat +CP ?= cp -f +DIFF ?= diff +ECHO ?= echo +EGREP ?= egrep +ENV ?= env +EXPR ?= expr +MV ?= mv -f +SED ?= sed +SORT ?= sort +TOUCH ?= touch +UNIQ ?= uniq +WHICH ?= which +XARGS ?= xargs +SLEEP ?= sleep +# == LaTeX (tetex-provided) == +BIBTEX ?= bibtex +DVIPS ?= dvips +LATEX ?= latex +PDFLATEX ?= pdflatex +XELATEX ?= xelatex +EPSTOPDF ?= epstopdf +MAKEINDEX ?= makeindex +XINDY ?= xindy +KPSEWHICH ?= kpsewhich +GS ?= gs +# = OPTIONAL PROGRAMS = +# == For MikTex under Cygwin, to get path names right +CYGPATH ?= cygpath +# == Makefile Color Output == +TPUT ?= tput +# == TeX Generation == +PERL ?= perl +PYTHON ?= python +RST2LATEX ?= rst2latex.py +# == EPS Generation == +CONVERT ?= convert # ImageMagick +DOT ?= dot # GraphViz +DOT2TEX ?= dot2tex # dot2tex - add options (not -o) as needed +FIG2DEV ?= fig2dev # XFig +GNUPLOT ?= gnuplot # GNUplot +INKSCAPE ?= inkscape # Inkscape (svg support) +XMGRACE ?= xmgrace # XMgrace +PNGTOPNM ?= pngtopnm # From NetPBM - step 1 for png -> eps +PPMTOPGM ?= ppmtopgm # From NetPBM - (gray) step 2 for png -> eps +PNMTOPS ?= pnmtops # From NetPBM - step 3 for png -> eps +GUNZIP ?= gunzip # GZipped EPS +# == Beamer Enlarged Output == +PSNUP ?= psnup +# == Viewing Stuff == +VIEW_POSTSCRIPT ?= gv +VIEW_PDF ?= xpdf +VIEW_GRAPHICS ?= display + +# Xindy glossaries +XINDYLANG ?= english +XINDYENC ?= utf8 + +# If cygpath is present, then we create a path-norm function that uses it, +# otherwise the function is just a no-op. Issue 112 has details. +USE_CYGPATH := $(if $(shell $(WHICH) $(CYGPATH) 2>/dev/null),yes,) + +# $(call get-cygpath,<path>) +define get-cygpath +$(shell $(CYGPATH) -u "$(shell $(CYGPATH) -s -w $1)") +endef + +define path-norm +$(if $(USE_CYGPATH),$(call get-cygpath,$1),$1) +endef + +# Command options for embedding fonts and postscript->pdf conversion +PS_EMBED_OPTIONS ?= -dPDFSETTINGS=/printer -dEmbedAllFonts=true -dSubsetFonts=true -dMaxSubsetPct=100 +PS_COMPATIBILITY ?= 1.4 + +# If set to something, will cause temporary files to not be deleted immediately +KEEP_TEMP ?= + +# Defaults for GPI +DEFAULT_GPI_EPS_FONTSIZE ?= 22 +DEFAULT_GPI_PDF_FONTSIZE ?= 12 + +# Style file for ReST +RST_STYLE_FILE ?= $(wildcard _rststyle_._include_.tex) + +# This ensures that even when echo is a shell builtin, we still use the binary +# (the builtin doesn't always understand -n) +FIXED_ECHO := $(if $(findstring -n,$(shell $(ECHO) -n)),$(shell which echo),$(ECHO)) +ECHO := $(if $(FIXED_ECHO),$(FIXED_ECHO),$(ECHO)) + +define determine-gnuplot-output-extension +$(if $(shell $(WHICH) $(GNUPLOT) 2>/dev/null), + $(if $(findstring unknown or ambiguous, $(shell $(GNUPLOT) -e "set terminal pdf" 2>&1)), + eps, pdf), + none) +endef + +GNUPLOT_OUTPUT_EXTENSION ?= $(strip $(call determine-gnuplot-output-extension)) + +# Internal code should use this because of :=. This means that the potentially +# expensive script invocation used to determine whether pdf is available will +# only be run once. +GPI_OUTPUT_EXTENSION := $(strip $(GNUPLOT_OUTPUT_EXTENSION)) + +# Note, if the terminal *does* understand fsize, then we expect this call to +# create a specific error here: "fsize: expecting font size". Otherwise, we +# assume that fsize is not understood. +GPI_FSIZE_SYNTAX := $(strip \ +$(if \ + $(filter pdf,$(GPI_OUTPUT_EXTENSION)),\ + $(if \ + $(findstring fsize: expecting font size,$(shell $(GNUPLOT) -e "set terminal pdf fsize" 2>&1)),\ + fsize FONTSIZE,\ + font ",FONTSIZE"),\ + FONTSIZE)) + +# Directory into which we place "binaries" if it exists. +# Note that this can be changed on the commandline or in Makefile.ini: +# +# Command line: +# make BINARY_TARGET_DIR=$HOME/pdfs myfile.pdf +# +# Also, you can specify a relative directory (relative to the Makefile): +# make BINARY_TARGET_DIR=pdfs myfile.pdf +# +# Or, you can use Makefile.ini: +# +# BINARY_TARGET_DIR := $(HOME)/bin_out +# +BINARY_TARGET_DIR ?= _out_ + +RESTARTS := $(if $(MAKE_RESTARTS),$(MAKE_RESTARTS),0) +# SH NOTES +# +# On some systems, /bin/sh, which is the default shell, is not linked to +# /bin/bash. While bash is supposed to be sh-compatible when invoked as sh, it +# just isn't. This section details some of the things you have to stay away +# from to remain sh-compatible. +# +# * File pattern expansion does not work for {} +# * [ "$x" = "$y" ] has to be [ x"$x" x"$y" ] +# * &> for stderr redirection doesn't work, use 2>&1 instead +# +# BSD SED NOTES +# +# BSD SED is not very nice compared to GNU sed, but it is the most +# commonly-invoked sed on Macs (being based on BSD), so we have to cater to +# it or require people to install GNU sed. It seems like the GNU +# requirement isn't too bad since this makefile is really a GNU makefile, +# but apparently GNU sed is much less common than GNU make in general, so +# I'm supporting it here. +# +# Sad experience has taught me the following about BSD sed: +# +# * \+ is not understood to mean \{1,\} +# * \| is meaningless (does not branch) +# * \n cannot be used as a substitution character +# * ? does not mean \{0,1\}, but is literal +# * a\ works, but only reliably for a single line if subsequent lines +# have forward slashes in them (as is the case in postscript) +# +# For more info (on the Mac) you can consult +# +# man -M /usr/share/man re_format +# +# And look for the word "Obsolete" near the bottom. + +# +# EXTERNAL PROGRAM DOCUMENTATION SCRIPT +# + +# $(call output-all-programs,[<output file>]) +define output-all-programs + [ -f '$(this_file)' ] && \ + $(SED) \ + -e '/^[[:space:]]*#[[:space:]]*EXTERNAL PROGRAMS:/,/^$$/!d' \ + -e '/EXTERNAL PROGRAMS/d' \ + -e '/^$$/d' \ + -e '/^[[:space:]]*#/i\ '\ + -e 's/^[[:space:]]*#[[:space:]][^=]*//' \ + $(this_file) $(if $1,> '$1',) || \ + $(ECHO) "Cannot determine the name of this makefile." +endef + +# If they misspell gray, it should still work. +GRAY ?= $(call get-default,$(GREY),) + +# +# Utility Functions and Definitions +# + +# Don't call this directly - it is here to avoid calling wildcard more than +# once in remove-files. +remove-files-helper = $(if $1,$(RM) $1,$(sh_true)) + +# $(call remove-files,file1 file2) +remove-files = $(call remove-files-helper,$(wildcard $1)) + +# Removes all cleanable files in the given list +# $(call clean-files,file1 file2 file3 ...) +# Works exactly like remove-files, but filters out files in $(neverclean) +clean-files = \ + $(call remove-files-helper,$(call cleanable-files,$(wildcard $1))) + +# Outputs all generated files to STDOUT, along with some others that are +# created by these (e.g., .idx files end up producing .ilg and .ind files). +# Discovered by reading *.fls OUTPUT lines and producing corresponding .ind +# filenames as needed. +# +# $(call get-generated-names,<source recorder file (*.fls)>) +define get-generated-names +[ -f '$1' ] && \ +$(SED) \ + -e '/^OUTPUT /{' \ + -e ' s///' \ + -e ' p' \ + -e ' s/\.idx/\.ind/p' \ + -e ' s/\.ind/\.ilg/p' \ + -e '}' \ + -e 'd' \ + '$1' \ +| $(SORT) | $(UNIQ) +endef + +# This removes files without checking whether they are there or not. This +# sometimes has to be used when the file is created by a series of shell +# commands, but there ends up being a race condition: make doesn't know about +# the file generation as quickly as the system does, so $(wildcard ...) doesn't +# work right. Blech. +# $(call remove-temporary-files,filenames) +remove-temporary-files = $(if $(KEEP_TEMP),:,$(if $1,$(RM) $1,:)) + +# Create an identifier from a file name +# $(call cleanse-filename,filename) +cleanse-filename = $(subst .,_,$(subst /,__,$1)) + +# Escape dots +# $(call escape-fname-regex,str) +escape-fname-regex = $(subst /,\\/,$(subst .,\\.,$1)) + +# Test that a file exists +# $(call test-exists,file) +test-exists = [ -e '$1' ] + +# $(call move-files,source,destination) +move-if-exists = $(call test-exists,$1) && $(MV) '$1' '$2' + +# Copy file1 to file2 only if file2 doesn't exist or they are different +# $(call copy-if-different,sfile,dfile) +copy-if-different = $(call test-different,$1,$2) && $(CP) '$1' '$2' +copy-if-exists = $(call test-exists,$1) && $(CP) '$1' '$2' +move-if-different = $(call test-different,$1,$2) && $(MV) '$1' '$2' +replace-if-different-and-remove = \ + $(call test-different,$1,$2) \ + && $(MV) '$1' '$2' \ + || $(call remove-files,'$1') + +# Note that $(DIFF) returns success when the files are the SAME.... +# $(call test-different,sfile,dfile) +test-different = ! $(DIFF) -q '$1' '$2' >/dev/null 2>&1 +test-exists-and-different = \ + $(call test-exists,$2) && $(call test-different,$1,$2) + +# Return value 1, or value 2 if value 1 is empty +# $(call get-default,<possibly empty arg>,<default value if empty>) +get-default = $(if $1,$1,$2) + +# Copy a file and log what's going on +# $(call copy-with-logging,<source>,<target>) +define copy-with-logging +if [ -d '$2/' ]; then \ + if $(CP) '$1' '$2/'; then \ + $(ECHO) "$(C_INFO)Copied '$1' to '$2/'$(C_RESET)"; \ + else \ + $(ECHO) "$(C_ERROR)Failed to copy '$1' to '$2/'$(C_RESET)"; \ + fi; \ +fi +endef + +# Gives a reassuring message about the failure to find include files +# $(call include-message,<list of include files>) +define include-message +$(strip \ +$(if $(filter-out $(wildcard $1),$1),\ + $(shell $(ECHO) \ + "$(C_INFO)NOTE: You may ignore warnings about the"\ + "following files:" >&2;\ + $(ECHO) >&2; \ + $(foreach s,$(filter-out $(wildcard $1),$1),$(ECHO) ' $s' >&2;)\ + $(ECHO) "$(C_RESET)" >&2) +)) +endef +# Characters that are hard to specify in certain places +space := $(empty) $(empty) +colon := \: +comma := , + +# Useful shell definitions +sh_true := : +sh_false := ! : + +# Clear out the standard interfering make suffixes +.SUFFIXES: + +# Turn off forceful rm (RM is usually mapped to rm -f) +ifdef SAFE_RM +RM := rm +endif + +# Turn command echoing back on with VERBOSE=1 +ifndef VERBOSE +QUIET := @ +endif + +# Turn on shell debugging with SHELL_DEBUG=1 +# (EVERYTHING is echoed, even $(shell ...) invocations) +ifdef SHELL_DEBUG +SHELL += -x +endif + +# Get the name of this makefile (always right in 3.80, often right in 3.79) +# This is only really used for documentation, so it isn't too serious. +ifdef MAKEFILE_LIST +this_file := $(word $(words $(MAKEFILE_LIST)),$(MAKEFILE_LIST)) +else +this_file := $(wildcard GNUmakefile makefile Makefile) +endif + +# Terminal color definitions + +REAL_TPUT := $(if $(NO_COLOR),,$(shell $(WHICH) $(TPUT))) + +# $(call get-term-code,codeinfo) +# e.g., +# $(call get-term-code,setaf 0) +get-term-code = $(if $(REAL_TPUT),$(shell $(REAL_TPUT) $1),) + +black := $(call get-term-code,setaf 0) +red := $(call get-term-code,setaf 1) +green := $(call get-term-code,setaf 2) +yellow := $(call get-term-code,setaf 3) +blue := $(call get-term-code,setaf 4) +magenta := $(call get-term-code,setaf 5) +cyan := $(call get-term-code,setaf 6) +white := $(call get-term-code,setaf 7) +bold := $(call get-term-code,bold) +uline := $(call get-term-code,smul) +reset := $(call get-term-code,sgr0) + +# +# User-settable definitions +# +LATEX_COLOR_WARNING ?= magenta +LATEX_COLOR_ERROR ?= red +LATEX_COLOR_INFO ?= green +LATEX_COLOR_UNDERFULL ?= magenta +LATEX_COLOR_OVERFULL ?= red bold +LATEX_COLOR_PAGES ?= bold +LATEX_COLOR_BUILD ?= cyan +LATEX_COLOR_GRAPHIC ?= yellow +LATEX_COLOR_DEP ?= green +LATEX_COLOR_SUCCESS ?= green bold +LATEX_COLOR_FAILURE ?= red bold + +# Gets the real color from a simple textual definition like those above +# $(call get-color,ALL_CAPS_COLOR_NAME) +# e.g., $(call get-color,WARNING) +get-color = $(subst $(space),,$(foreach c,$(LATEX_COLOR_$1),$($c))) + +# +# STANDARD COLORS +# +C_WARNING := $(call get-color,WARNING) +C_ERROR := $(call get-color,ERROR) +C_INFO := $(call get-color,INFO) +C_UNDERFULL := $(call get-color,UNDERFULL) +C_OVERFULL := $(call get-color,OVERFULL) +C_PAGES := $(call get-color,PAGES) +C_BUILD := $(call get-color,BUILD) +C_GRAPHIC := $(call get-color,GRAPHIC) +C_DEP := $(call get-color,DEP) +C_SUCCESS := $(call get-color,SUCCESS) +C_FAILURE := $(call get-color,FAILURE) +C_RESET := $(reset) + +# +# PRE-BUILD TESTS +# + +# Check that clean targets are not combined with other targets (weird things +# happen, and it's not easy to fix them) +hascleangoals := $(if $(sort $(filter clean clean-%,$(MAKECMDGOALS))),1) +hasbuildgoals := $(if $(sort $(filter-out clean clean-%,$(MAKECMDGOALS))),1) +ifneq "$(hasbuildgoals)" "" +ifneq "$(hascleangoals)" "" +$(error $(C_ERROR)Clean and build targets specified together$(C_RESET))) +endif +endif + +# +# VARIABLE DECLARATIONS +# + +# Names of sed scripts that morph gnuplot files -- only the first found is used +GNUPLOT_SED := global-gpi.sed gnuplot.sed +GNUPLOT_GLOBAL := global._include_.gpi gnuplot.global + +ifeq "$(strip $(BUILD_STRATEGY))" "latex" +default_graphic_extension ?= eps +latex_build_program ?= $(LATEX) +build_target_extension ?= dvi +hyperref_driver_pattern ?= hdvips +hyperref_driver_error ?= Using dvips: specify ps2pdf in the hyperref options. +endif + +ifeq "$(strip $(BUILD_STRATEGY))" "pdflatex" +default_graphic_extension ?= pdf +latex_build_program ?= $(PDFLATEX) +build_target_extension ?= pdf +hyperref_driver_pattern ?= hpdf.* +hyperref_driver_error ?= Using pdflatex: specify pdftex in the hyperref options (or leave it blank). +endif + +ifeq "$(strip $(BUILD_STRATEGY))" "xelatex" +default_graphic_extension ?= pdf +latex_build_program ?= $(XELATEX) +build_target_extension ?= pdf +hyperref_driver_pattern ?= hdvipdf.* +hyperref_driver_error ?= Using pdflatex: specify pdftex in the hyperref options (or leave it blank). +endif + +# Files of interest +all_files.tex ?= $(wildcard *.tex) +all_files.tex.sh ?= $(wildcard *.tex.sh) +all_files.tex.pl ?= $(wildcard *.tex.pl) +all_files.tex.py ?= $(wildcard *.tex.py) +all_files.rst ?= $(wildcard *.rst) +all_files.fig ?= $(wildcard *.fig) +all_files.gpi ?= $(wildcard *.gpi) +all_files.dot ?= $(wildcard *.dot) +all_files.xvg ?= $(wildcard *.xvg) +all_files.svg ?= $(wildcard *.svg) +all_files.png ?= $(wildcard *.png) +all_files.jpg ?= $(wildcard *.jpg) +all_files.jpeg ?= $(wildcard *.jpeg) +all_files.eps.gz ?= $(wildcard *.eps.gz) +all_files.eps ?= $(wildcard *.eps) + +# Utility function for obtaining all files not specified in $(neverclean) +# $(call cleanable-files,file1 file2 file3 ...) +# Returns the list of files that is not in $(wildcard $(neverclean)) +cleanable-files = $(filter-out $(wildcard $(neverclean)), $1) + +# Utility function for getting all .$1 files that are to be ignored +# * files listed in $(includes.$1) +# * files not listed in $(onlysources.$1) if it is defined +ignore_files = \ + $(includes.$1) \ + $(if $(onlysources.$1),$(filter-out $(onlysources.$1), $(all_files.$1))) + +# Patterns to never be allowed as source targets +ignore_patterns := %._include_ + +# Patterns allowed as source targets but not included in 'all' builds +nodefault_patterns := %._nobuild_ $(ignore_patterns) + +# Utility function for getting targets suitable building +# $(call filter-buildable,suffix) +filter-buildable = \ + $(filter-out $(call ignore_files,$1) \ + $(addsuffix .$1,$(ignore_patterns)),$(all_files.$1)) + +# Utility function for getting targets suitable for 'all' builds +# $(call filter-default,suffix) +filter-default = \ + $(filter-out $(call ignore_files,$1) \ + $(addsuffix .$1,$(nodefault_patterns)),$(all_files.$1)) + +# Top level sources that can be built even when they are not by default +files.tex := $(call filter-buildable,tex) +files.tex.sh := $(call filter-buildable,tex.sh) +files.tex.pl := $(call filter-buildable,tex.pl) +files.tex.py := $(call filter-buildable,tex.py) +files.rst := $(call filter-buildable,rst) +files.gpi := $(call filter-buildable,gpi) +files.dot := $(call filter-buildable,dot) +files.fig := $(call filter-buildable,fig) +files.xvg := $(call filter-buildable,xvg) +files.svg := $(call filter-buildable,svg) +files.png := $(call filter-buildable,png) +files.jpg := $(call filter-buildable,jpg) +files.jpeg := $(call filter-buildable,jpeg) +files.eps.gz := $(call filter-buildable,eps.gz) +files.eps := $(call filter-buildable,eps) + +# Make all pstex targets secondary. The pstex_t target requires the pstex +# target, and nothing else really depends on it, so it often gets deleted. +# This avoids that by allowing *all* fig files to be pstex targets, which is +# perfectly valid and causes no problems even if they're going to become eps +# files in the end. +.SECONDARY: $(patsubst %.fig,%.pstex,$(files.fig)) + +# Top level sources that are built by default targets +default_files.tex := $(call filter-default,tex) +default_files.tex.sh := $(call filter-default,tex.sh) +default_files.tex.pl := $(call filter-default,tex.pl) +default_files.tex.py := $(call filter-default,tex.py) +default_files.rst := $(call filter-default,rst) +default_files.gpi := $(call filter-default,gpi) +default_files.dot := $(call filter-default,dot) +default_files.fig := $(call filter-default,fig) +default_files.xvg := $(call filter-default,xvg) +default_files.svg := $(call filter-default,svg) +default_files.png := $(call filter-default,png) +default_files.jpg := $(call filter-default,jpg) +default_files.jpeg := $(call filter-default,jpeg) +default_files.eps.gz := $(call filter-default,eps.gz) +default_files.eps := $(call filter-default,eps) + +# Utility function for creating larger lists of files +# $(call concat-files,suffixes,[prefix]) +concat-files = $(foreach s,$1,$($(if $2,$2_,)files.$s)) + +# Useful file groupings +all_files_source := $(call concat-files,tex,all) +all_files_scripts := $(call concat-files,tex.sh tex.pl tex.py rst,all) + +.PHONY: $(all_files_scripts) + +default_files_source := $(call concat-files,tex,default) +default_files_scripts := $(call concat-files,tex.sh tex.pl tex.py rst,default) + +files_source := $(call concat-files,tex) +files_scripts := $(call concat-files,tex.sh tex.pl tex.py rst) + +# Utility function for obtaining stems +# $(call get-stems,suffix,[prefix]) +get-stems = $(sort $($(if $2,$2_,)files.$1:%.$1=%)) + +# List of all stems (including ._include_ and ._nobuild_ file stems) +all_stems.tex := $(call get-stems,tex,all) +all_stems.tex.sh := $(call get-stems,tex.sh,all) +all_stems.tex.pl := $(call get-stems,tex.pl,all) +all_stems.tex.py := $(call get-stems,tex.py,all) +all_stems.rst := $(call get-stems,rst,all) +all_stems.fig := $(call get-stems,fig,all) +all_stems.gpi := $(call get-stems,gpi,all) +all_stems.dot := $(call get-stems,dot,all) +all_stems.xvg := $(call get-stems,xvg,all) +all_stems.svg := $(call get-stems,svg,all) +all_stems.png := $(call get-stems,png,all) +all_stems.jpg := $(call get-stems,jpg,all) +all_stems.jpeg := $(call get-stems,jpeg,all) +all_stems.eps.gz := $(call get-stems,eps.gz,all) +all_stems.eps := $(call get-stems,eps,all) + +# List of all default stems (all default PDF targets): +default_stems.tex := $(call get-stems,tex,default) +default_stems.tex.sh := $(call get-stems,tex.sh,default) +default_stems.tex.pl := $(call get-stems,tex.pl,default) +default_stems.tex.py := $(call get-stems,tex.py,default) +default_stems.rst := $(call get-stems,rst,default) +default_stems.fig := $(call get-stems,fig,default) +default_stems.gpi := $(call get-stems,gpi,default) +default_stems.dot := $(call get-stems,dot,default) +default_stems.xvg := $(call get-stems,xvg,default) +default_stems.svg := $(call get-stems,svg,default) +default_stems.png := $(call get-stems,png,default) +default_stems.jpg := $(call get-stems,jpg,default) +default_stems.jpeg := $(call get-stems,jpeg,default) +default_stems.eps.gz := $(call get-stems,eps.gz,default) +default_stems.eps := $(call get-stems,eps,default) + +# List of all stems (all possible bare PDF targets created here): +stems.tex := $(call get-stems,tex) +stems.tex.sh := $(call get-stems,tex.sh) +stems.tex.pl := $(call get-stems,tex.pl) +stems.tex.py := $(call get-stems,tex.py) +stems.rst := $(call get-stems,rst) +stems.fig := $(call get-stems,fig) +stems.gpi := $(call get-stems,gpi) +stems.dot := $(call get-stems,dot) +stems.xvg := $(call get-stems,xvg) +stems.svg := $(call get-stems,svg) +stems.png := $(call get-stems,png) +stems.jpg := $(call get-stems,jpg) +stems.jpeg := $(call get-stems,jpeg) +stems.eps.gz := $(call get-stems,eps.gz) +stems.eps := $(call get-stems,eps) + +# Utility function for creating larger lists of stems +# $(call concat-stems,suffixes,[prefix]) +concat-stems = $(sort $(foreach s,$1,$($(if $2,$2_,)stems.$s))) + +# The most likely to be source but not finished product go first +graphic_source_extensions := fig \ + gpi \ + xvg \ + svg \ + dot \ + eps.gz + +ifeq "$(strip $(BUILD_STRATEGY))" "latex" +graphic_source_extensions += png jpg jpeg +graphic_target_extensions := eps ps +endif + +ifeq "$(strip $(BUILD_STRATEGY))" "pdflatex" +graphic_source_extensions += eps +graphic_target_extensions := pdf png jpg jpeg mps tif +endif + +ifeq "$(strip $(BUILD_STRATEGY))" "xelatex" +graphic_source_extensions += eps +graphic_target_extensions := pdf png jpg jpeg mps tif +endif + +all_stems_source := $(call concat-stems,tex,all) +all_stems_script := $(call concat-stems,tex.sh tex.pl tex.py rst,all) +all_stems_graphic := $(call concat-stems,$(graphic_source_extensions),all) +all_stems_ss := $(sort $(all_stems_source) $(all_stems_script)) +all_stems_sg := $(sort $(all_stems_script)) +all_stems_ssg := $(sort $(all_stems_ss)) + +default_stems_source := $(call concat-stems,tex,default) +default_stems_script := $(call concat-stems,tex.sh tex.pl tex.py rst,default) +default_stems_ss := $(sort $(default_stems_source) $(default_stems_script)) +default_stems_sg := $(sort $(default_stems_script)) +default_stems_ssg := $(sort $(default_stems_ss)) + +stems_source := $(call concat-stems,tex) +stems_script := $(call concat-stems,tex.sh tex.pl tex.py rst) +stems_graphic := $(call concat-stems,$(graphic_source_extensions)) +stems_gg := $(sort $(stems_graphic)) +stems_ss := $(sort $(stems_source) $(stems_script)) +stems_sg := $(sort $(stems_script)) +stems_ssg := $(sort $(stems_ss)) + +# Calculate names that can generate the need for an include file. We can't +# really do this with patterns because it's too easy to screw up, so we create +# an exhaustive list. +allowed_source_suffixes := \ + pdf \ + ps \ + dvi \ + ind \ + nls \ + bbl \ + aux \ + aux.make \ + d \ + auxbbl.make \ + _graphics \ + _show +allowed_source_patterns := $(addprefix %.,$(allowed_source_suffixes)) + +allowed_graphic_suffixes := \ + pdf \ + eps \ + gpihead.make \ + gpi.d +allowed_graphic_patterns := $(addprefix %.,$(allowed_graphic_suffixes)) + +# All targets allowed to build documents +allowed_source_targets := \ + $(foreach suff,$(allowed_source_suffixes),\ + $(addsuffix .$(suff),$(stems_ssg))) + +# All targets allowed to build graphics +allowed_graphic_targets := \ + $(foreach suff,$(allowed_graphic_suffixes),\ + $(addsuffix .$(suff),$(stems_gg))) + +# All targets that build multiple documents (like 'all') +allowed_batch_source_targets := \ + all \ + all-pdf \ + all-ps \ + all-dvi \ + all-bbl \ + all-ind \ + all-gls \ + all-nls \ + show + +# All targets that build multiple graphics (independent of document) +allowed_batch_graphic_targets := \ + all-graphics \ + all-pstex \ + all-dot2tex \ + show-graphics + +# Now we figure out which stuff is available as a make target for THIS RUN. +real_goals := $(call get-default,$(filter-out _includes,$(MAKECMDGOALS)),\ + all) + +specified_source_targets := $(strip \ + $(filter $(allowed_source_targets) $(stems_ssg),$(real_goals)) \ + ) + +specified_batch_source_targets := $(strip \ + $(filter $(allowed_batch_source_targets),$(real_goals)) \ + ) + +specified_graphic_targets := $(strip \ + $(filter $(allowed_graphic_targets),$(real_goals)) \ + ) + +specified_batch_graphic_targets := $(strip \ + $(filter $(allowed_batch_graphic_targets),$(real_goals)) \ + ) + +specified_gpi_targets := $(patsubst %.gpi,%.$(default_graphic_extension),\ + $(filter $(patsubst %.$(default_graphic_extension),%.gpi,$(specified_graphic_targets)),\ + $(all_files.gpi)) \ + ) + +# Determine which .d files need including from the information gained above. +# This is done by first checking whether a batch target exists. If it does, +# then all *default* stems are used to create possible includes (nobuild need +# not apply for batch status). If no batch targets exist, then the individual +# targets are considered and appropriate includes are taken from them. +source_stems_to_include := \ + $(sort\ + $(if $(specified_batch_source_targets),\ + $(default_stems_ss),\ + $(foreach t,$(specified_source_targets),\ + $(foreach p,$(allowed_source_patterns),\ + $(patsubst $p,%,$(filter $p $(stems_ssg),$t)) \ + )) \ + )) + +# Determine which .gpi.d files are needed using the above information. We +# first check whether a batch target is specified, then check individual +# graphics that may have been specified. +graphic_stems_to_include := \ + $(sort\ + $(if $(specified_batch_graphic_targets),\ + $(default_stems.gpi),\ + $(foreach t,$(specified_gpi_targets),\ + $(foreach p,$(allowed_graphic_patterns),\ + $(patsubst $p,%,$(filter $p,$t)) \ + )) \ + )) + +# All dependencies for the 'all' targets +all_pdf_targets := $(addsuffix .pdf,$(stems_ssg)) +all_ps_targets := $(addsuffix .ps,$(stems_ssg)) +all_dvi_targets := $(addsuffix .dvi,$(stems_ssg)) +all_tex_targets := $(addsuffix .tex,$(stems_sg)) +all_d_targets := $(addsuffix .d,$(stems_ssg)) +all_graphics_targets := $(addsuffix .$(default_graphic_extension),$(stems_gg)) +all_pstex_targets := $(addsuffix .pstex_t,$(stems.fig)) +all_dot2tex_targets := $(addsuffix .dot_t,$(stems.dot)) + +all_known_graphics := $(sort $(all_graphics_targets) $(wildcard *.$(default_graphic_extension))) + +default_pdf_targets := $(addsuffix .pdf,$(default_stems_ss)) + +ifeq "$(strip $(BUILD_STRATEGY))" "latex" +default_ps_targets := $(addsuffix .ps,$(default_stems_ss)) +default_dvi_targets := $(addsuffix .dvi,$(default_stems_ss)) +pre_pdf_extensions := dvi ps +endif + +# Extensions generated by LaTeX invocation that can be removed when complete +rm_ext := \ + log *.log aux $(pre_pdf_extensions) pdf blg bbl out nav snm toc lof lot lol pfg \ + fls vrb idx ind ilg glg glo gls lox nls nlo nlg brf mtc maf brf ist +backup_patterns := *~ *.bak *.backup body.tmp head.tmp + +graph_stem := _graph + +# All LaTeX-generated files that can be safely removed + +rm_tex := \ + $(foreach e,$(rm_ext),$(addsuffix .$e,$(all_stems_source))) \ + $(foreach e,$(rm_ext) tex,$(addsuffix .$e,$(all_stems_sg))) \ + $(addsuffix .log,$(all_ps_targets) $(all_pdf_targets)) \ + $(addsuffix .*.log,$(stems_graphic)) + +# These are the files that will affect .gpi transformation for all .gpi files. +# +# Use only the first one found. Backward compatible values are at the end. +# Note that we use foreach, even though wildcard also returns a list, to ensure +# that the order in the uppercase variables is preserved. Directory listings +# provide no such guarantee, so we avoid relying on them. +gpi_sed := $(strip \ + $(firstword $(foreach f,$(GNUPLOT_SED),$(wildcard $f)))) +gpi_global := $(strip \ + $(firstword $(foreach f,$(GNUPLOT_GLOBAL),$(wildcard $f)))) + +# +# Functions used in generating output +# + +# Outputs all source dependencies to stdout. The first argument is the file to +# be parsed, the second is a list of files that will show up as dependencies in +# the new .d file created here. +# +# $(call get-inputs,<parsed file>,<target files>) +define get-inputs +$(SED) \ +-e '/^INPUT/!d' \ +-e 's!^INPUT $\./$\{0,1\}!!' \ +-e 's/[[:space:]]/\\ /g' \ +-e 's/$.*$\.aux$$/\1.tex/' \ +-e '/\.tex$$/b addtargets' \ +-e '/\.cls$$/b addtargets' \ +-e '/\.sty$$/b addtargets' \ +-e '/\.pstex_t$$/b addtargets' \ +-e '/\.dot_t$$/b addtargets' \ +-e 'd' \ +-e ':addtargets' \ +-e 's!.*!$2: $$(call path-norm,&)!' \ +'$1' | $(SORT) | $(UNIQ) +endef + +# $(call get-missing-inputs,<log file>,<target files>) +define get-missing-inputs +$(SED) \ +-e '$${' \ +-e ' /^$$/!{' \ +-e ' H' \ +-e ' s/.*//' \ +-e ' }' \ +-e '}' \ +-e '/^$$/!{' \ +-e ' H' \ +-e ' d' \ +-e '}' \ +-e '/^$$/{' \ +-e ' x' \ +-e ' s/^$\n$$.*$/\2\1/' \ +-e '}' \ +-e '/^::P$P\{1,\}$::/{' \ +-e ' s//::\1::/' \ +-e ' G' \ +-e ' h' \ +-e ' d' \ +-e '}' \ +-e '/^::P::/{' \ +-e ' s//::0::/' \ +-e ' G' \ +-e '}' \ +-e 'b start' \ +-e ':needonemore' \ +-e 's/^/::P::/' \ +-e 'G' \ +-e 'h' \ +-e 'd' \ +-e ':needtwomore' \ +-e 's/^/::PP::/' \ +-e 'G' \ +-e 'h' \ +-e 'd' \ +-e ':needthreemore' \ +-e 's/^/::PPP::/' \ +-e 'G' \ +-e 'h' \ +-e 'd' \ +-e ':start' \ +-e '/^! LaTeX Error: File `/{' \ +-e ' b needtwomore' \ +-e '}' \ +-e '/^::0::$.*$/{' \ +-e ' s//\1/' \ +-e ' /Default extension: /!d' \ +-e ' s/.*File `$[^'"'"']*$'"'"' not found.*/\1/' \ +-e ' s/[[:cntrl:]]//' \ +-e ' /\.tex/!s/$$/.tex/' \ +-e ' s/[[:space:]]/\\ /g' \ +-e ' h' \ +-e ' s/.*/# MISSING input "&" - (presence of comment affects build)/' \ +-e ' p' \ +-e ' s/.*//' \ +-e ' x' \ +-e ' s!^.*!$2: $$(call path-norm,&)!' \ +-e ' p' \ +-e '}' \ +-e 'd' \ +'$1' | $(SORT) | $(UNIQ) +endef + +# Get source file for specified graphics stem. +# +# $(call graphics-source,<stem>) +define graphics-source +$(strip $(firstword \ + $(wildcard \ + $(addprefix $1.,\ + $(graphic_source_extensions))) \ + $1 \ +)) +endef + +# Get the target file for the specified graphics file/stem +# +# $(call graphics-target,<stem>) +define graphics-target +$(strip $(if $(filter $(addprefix %.,$(graphic_target_extensions)),$1), $1, + $(firstword $(patsubst $(addprefix %.,$(graphic_source_extensions) $(graphic_target_extensions)), %, $1).$(default_graphic_extension) $1.$(default_graphic_extension)))) +endef + +# Outputs all of the graphical dependencies to stdout. The first argument is +# the stem of the source file being built, the second is a list of suffixes +# that will show up as dependencies in the generated .d file. +# +# Note that we try to escape spaces in filenames where possible. We have to do +# it with three backslashes so that as the name percolates through the makefile +# it eventually ends up with the proper escaping when the build rule is found. +# Ugly, but it appears to work. Note that graphicx doesn't allow filenames +# with spaces, so this could in many ways be moot unless you're using something +# like grffile. +# +# For pdflatex, we really need the missing file to be specified without an +# extension, otherwise compilation barfs on the first missing file. Truly +# annoying, but there you have it. +# +# It turns out that the graphics errors, although they have lines with empty +# space, are only made of two paragraphs. So, we just use some sed magic to +# get everything into paragraphs, detect when it's a paragraph that interests +# us, and double it up. Then we get the filename only if we're missing +# extensions (a sign that it's graphicx complaining). +# +# $(call get-graphics,<target file stem>) +#.log,$(addprefix $*.,d $(build_target_extension) _graphics) +define get-graphics +$(SED) \ +-e '/^File: $.*$ Graphic file (type [^)]*)/{' \ +-e ' s//\1/' \ +-e ' b addtargets' \ +-e '}' \ +-e '$${' \ +-e ' /^$$/!{' \ +-e ' H' \ +-e ' s/.*//' \ +-e ' }' \ +-e '}' \ +-e '/^$$/!{' \ +-e ' H' \ +-e ' d' \ +-e '}' \ +-e '/^$$/{' \ +-e ' x' \ +-e ' s/^$\n$$.*$/\2\1/' \ +-e '}' \ +-e '/^::P$P\{1,\}$::/{' \ +-e ' s//::\1::/' \ +-e ' G' \ +-e ' h' \ +-e ' d' \ +-e '}' \ +-e '/^::P::/{' \ +-e ' s//::0::/' \ +-e ' G' \ +-e '}' \ +-e 'b start' \ +-e ':needonemore' \ +-e 's/^/::P::/' \ +-e 'G' \ +-e 'h' \ +-e 'd' \ +-e ':needtwomore' \ +-e 's/^/::PP::/' \ +-e 'G' \ +-e 'h' \ +-e 'd' \ +-e ':needthreemore' \ +-e 's/^/::PPP::/' \ +-e 'G' \ +-e 'h' \ +-e 'd' \ +-e ':start' \ +-e '/^[^[:cntrl:]:]*:[[:digit:]]\{1,\}: LaTeX Error: File `/{' \ +-e ' s/\n//g' \ +-e ' b needonemore' \ +-e '}' \ +-e '/^::0::.*: LaTeX Error: File `/{' \ +-e ' /\n\n$$/{' \ +-e ' s/^::0:://' \ +-e ' b needonemore' \ +-e ' }' \ +-e ' s/\n\{1,\}/ /g' \ +-e ' s/[[:space:]]\{1,\}/ /g' \ +-e ' s/^.*File `//' \ +-e ' s/'"'"' not found\..*extensions: $[^[:space:]]*$.*/::::\1/' \ +-e ' h' \ +-e ' s/$.*$::::$.*$/# MISSING stem "\1" - allowed extensions are "\2" - leave comment here - it affects the build/' \ +-e ' p' \ +-e ' g' \ +-e ' s/::::.*//' \ +-e ' b addtargets' \ +-e '}' \ +-e 'd' \ +-e ':addtargets' \ +-e 's/[[:space:]]/\\\\\\&/g' \ +-e 'h' \ +-e 's/.*/-include &.gpi.d/' \ +-e 'p' \ +-e 'g' \ +-e 's!.*!$1.d: $$$$(call graphics-source,&)!' \ +-e 'p' \ +-e 's/.*//' \ +-e 'x' \ +-e 's!.*!$1.$(build_target_extension) $1._graphics: $$$$(call graphics-target,&)!' \ +-e 'p' \ +-e 'd' \ +$1.log +endef + +# Checks for build failure due to pstex inclusion, and gives instructions. +# +# $(call die-on-pstexs,<parsed file>) +define die-on-pstexs +if $(EGREP) -q '^! LaTeX Error: File .*\.pstex.* not found' $1; then \ + $(ECHO) "$(C_ERROR)Missing pstex_t file(s)$(C_RESET)"; \ + $(ECHO) "$(C_ERROR)Please run$(C_RESET)"; \ + $(ECHO) "$(C_ERROR) make all-pstex$(C_RESET)"; \ + $(ECHO) "$(C_ERROR)before proceeding.$(C_RESET)"; \ + exit 1; \ +fi +endef + +# Checks for the use of import.sty and bails - we don't support subdirectories +# +# $(call die-on-import-sty,<log file>) +define die-on-import-sty +if $(EGREP) -s '/import.sty\)' '$1'; then \ + $(ECHO) "$(C_ERROR)import.sty is not supported - included files must"; \ + $(ECHO) "$(C_ERROR)be in the same directory as the primary document$(C_RESET)"; \ + exit 1; \ +fi +endef + +# Checks for build failure due to dot2tex, and gives instructions. +# +# $(call die-on-dot2tex,<parsed file>) +define die-on-dot2tex +if $(EGREP) -q ' LaTeX Error: File .*\.dot_t.* not found' $1; then \ + $(ECHO) "$(C_ERROR)Missing dot_t file(s)$(C_RESET)"; \ + $(ECHO) "$(C_ERROR)Please run$(C_RESET)"; \ + $(ECHO) "$(C_ERROR) make all-dot2tex$(C_RESET)"; \ + $(ECHO) "$(C_ERROR)before proceeding.$(C_RESET)"; \ + exit 1; \ +fi +endef + +# Checks for the existence of a .aux file, and dies with an error message if it +# isn't there. Note that we pass the file stem in, not the full filename, +# e.g., to check for foo.aux, we call it thus: $(call die-on-no-aux,foo) +# +# $(call die-on-no-aux,<aux stem>) +define die-on-no-aux +if [ ! -e '$1.aux' ]; then \ + $(call colorize-latex-errors,$1.log); \ + $(ECHO) "$(C_ERROR)Error: failed to create $1.aux$(C_RESET)"; \ + exit 1; \ +fi +endef + +# Outputs all index files to stdout. Arg 1 is the source file stem, arg 2 is +# the list of targets for the discovered dependency. +# +# $(call get-log-index,<log file stem>,<target files>) +define get-log-index +$(SED) \ +-e 's/^No file $.*\.ind$\.$$/TARGETS=\1/' \ +-e 's/^No file $.*\.[gn]ls$\.$$/TARGETS=\1/' \ +-e 's/[[:space:]]/\\&/g' \ +-e '/^TARGETS=/{' \ +-e ' h' \ +-e ' s!^TARGETS=!$2: !p' \ +-e ' g' \ +-e ' s!^TARGETS=$.*$!\1: $1.tex!p' \ +-e '}' \ +-e 'd' \ +'$1.log' | $(SORT) | $(UNIQ) +endef + + +# Outputs all bibliography files to stdout. Arg 1 is the source stem, arg 2 is +# a list of targets for each dependency found. +# +# The script kills all lines that do not contain bibdata. Remaining lines have +# the \bibdata macro and delimiters removed to create a dependency list. A +# trailing comma is added, then all adjacent commas are collapsed into a single +# comma. Then commas are replaced with the string .bib[space], and the +# trailing space is killed off. Finally, all filename spaces are escaped. +# This produces a list of space-delimited .bib filenames, which is what the +# make dep file expects to see. +# +# Note that we give kpsewhich a bogus argument so that a failure of sed to +# produce output will not cause an error. +# +# $(call get-bibs,<aux file>,<targets>) +define get-bibs +$(SED) \ +-e '/^\\bibdata/!d' \ +-e 's/\\bibdata{$[^}]*$}/\1,/' \ +-e 's/,\{2,\}/,/g' \ +-e 's/[[:space:]]/\\&/g' \ +-e 's/,/.bib /g' \ +-e 's/ \{1,\}$$//' \ +$1 | $(XARGS) $(KPSEWHICH) '#######' | \ +$(SED) \ +-e 's!^!$2: !' | \ +$(SORT) | $(UNIQ) +endef + +# Makes a an aux file that only has stuff relevant to the target in it +# $(call make-auxtarget-file,<flattened-aux>,<new-aux>) +define make-auxtarget-file +$(SED) \ +-e '/^\\newlabel/!d' \ +$1 > $2 +endef + +# Makes an aux file that only has stuff relevant to the bbl in it +# $(call make-auxbbl-file,<flattened-aux>,<new-aux>) +define make-auxbbl-file +$(SED) \ +-e '/^\\newlabel/d' \ +$1 > $2 +endef + +# Makes a .gpi.d file from a .gpi file +# $(call make-gpi-d,<.gpi>,<.gpi.d>) +define make-gpi-d +$(ECHO) '# vim: ft=make' > $2; \ +$(ECHO) 'ifndef INCLUDED_$(call cleanse-filename,$2)' >> $2; \ +$(ECHO) 'INCLUDED_$(call cleanse-filename,$2) := 1' >> $2; \ +$(call get-gpi-deps,$1,$(addprefix $(2:%.gpi.d=%).,$(GPI_OUTPUT_EXTENSION) gpi.d)) >> $2; \ +$(ECHO) 'endif' >> $2; +endef + +# Parse .gpi files for data and loaded dependencies, output to stdout +# +# The sed script here tries to be clever about obtaining valid +# filenames from the gpi file. It assumes that the plot command starts its own +# line, which is not too difficult a constraint to satisfy. +# +# This command script also generates 'include' directives for every 'load' +# command in the .gpi file. The load command must appear on a line by itself +# and the file it loads must have the suffix .gpi. If you don't want it to be +# compiled when running make graphics, then give it a suffix of ._include_.gpi. +# +# $(call get-gpi-deps,<gpi file>,<targets>) +define get-gpi-deps +$(SED) \ +-e '/^[[:space:]]*s\{0,1\}plot/,/[^\\]$$/{' \ +-e ' H' \ +-e ' /[^\\]$$/{' \ +-e ' s/.*//' \ +-e ' x' \ +-e ' s/\\\{0,1\}\n//g' \ +-e ' s/^[[:space:]]*s\{0,1\}plot[[:space:]]*$\[[^]]*\][[:space:]]*$*/,/' \ +-e ' s/[[:space:]]*$['"'"'\'"'"''"'"'"][^'"'"'\'"'"''"'"'"]*['"'"'\'"'"''"'"'"]$\{0,1\}[^,]*/\1/g' \ +-e ' s/,['"'"'\'"'"''"'"'"]-\{0,1\}['"'"'\'"'"''"'"'"]//g' \ +-e ' s/[,'"'"'\'"'"''"'"'"]\{1,\}/ /g' \ +-e ' s/.*:.*/$$(error Error: Filenames with colons are not allowed: &)/' \ +-e ' s!.*!$2: &!' \ +-e ' p' \ +-e ' }' \ +-e ' d' \ +-e '}' \ +-e 's/^[[:space:]]*load[[:space:]]*['"'"'\'"'"''"'"'"]$[^'"'"'\'"'"''"'"'"]*\.gpi$['"'"'\'"'"''"'"'"].*$$/-include \1.d/p' \ +-e 'd' \ +'$1' +endef + +# Colorizes real, honest-to-goodness LaTeX errors that can't be overcome with +# recompilation. +# +# Note that we only ignore file not found errors for things that we know how to +# build, like graphics files. +# +# Also note that the output of this is piped through sed again to escape any +# backslashes that might have made it through. This is to avoid sending things +# like "\right" to echo, which interprets \r as LF. In bash, we could just do +# ${var//\\/\\\\}, but in other popular sh variants (like dash), this doesn't +# work. +# +# $(call colorize-latex-errors,<log file>) +define colorize-latex-errors +$(SED) \ +-e '$${' \ +-e ' /^$$/!{' \ +-e ' H' \ +-e ' s/.*//' \ +-e ' }' \ +-e '}' \ +-e '/^$$/!{' \ +-e ' H' \ +-e ' d' \ +-e '}' \ +-e '/^$$/{' \ +-e ' x' \ +-e ' s/^$\n$$.*$/\2\1/' \ +-e '}' \ +-e '/^::P$P\{1,\}$::/{' \ +-e ' s//::\1::/' \ +-e ' G' \ +-e ' h' \ +-e ' d' \ +-e '}' \ +-e '/^::P::/{' \ +-e ' s//::0::/' \ +-e ' G' \ +-e '}' \ +-e 'b start' \ +-e ':needonemore' \ +-e 's/^/::P::/' \ +-e 'G' \ +-e 'h' \ +-e 'd' \ +-e ':needtwomore' \ +-e 's/^/::PP::/' \ +-e 'G' \ +-e 'h' \ +-e 'd' \ +-e ':needthreemore' \ +-e 's/^/::PPP::/' \ +-e 'G' \ +-e 'h' \ +-e 'd' \ +-e ':start' \ +-e '/^! LaTeX Error: File /{' \ +-e ' s/\n//g' \ +-e ' b needtwomore' \ +-e '}' \ +-e 's/^[^[:cntrl:]:]*:[[:digit:]]\{1,\}:/!!! &/' \ +-e 's/^$.*\n$$[^[:cntrl:]:]*:[[:digit:]]\{1,\}: .*$/\1!!! \2/' \ +-e '/^!!! .* LaTeX Error: File /{' \ +-e ' s/\n//g' \ +-e ' b needonemore' \ +-e '}' \ +-e '/^::0::! LaTeX Error: File .*/{' \ +-e ' /\n\n$$/{' \ +-e ' s/^::0:://' \ +-e ' b needonemore' \ +-e ' }' \ +-e ' s/^::0::! //' \ +-e ' s/^$.*not found.$.*Enter file name:.*\n$.*[[:digit:]]\{1,\}$: Emergency stop.*/\2: \1/' \ +-e ' b error' \ +-e '}' \ +-e '/^::0::!!! .*LaTeX Error: File .*/{' \ +-e ' /\n\n$$/{' \ +-e ' s/^::0:://' \ +-e ' b needonemore' \ +-e ' }' \ +-e ' s/::0::!!! //' \ +-e ' /could not locate.*any of these extensions:/{' \ +-e ' d' \ +-e ' }' \ +-e ' s/$not found\.$.*/\1/' \ +-e ' b error' \ +-e '}' \ +-e '/^$.* LaTeX Error: Missing .begin.document.\.$.*/{' \ +-e ' s//\1 --- Are you trying to build an include file?/' \ +-e ' b error' \ +-e '}' \ +-e '/.*$!!! .*Undefined control sequence$[^[:cntrl:]]*$.*$/{' \ +-e ' s//\1: \2/' \ +-e ' s/\nl\.[[:digit:]][^[:cntrl:]]*$\\[^\\[:cntrl:]]*$.*/\1/' \ +-e ' b error' \ +-e '}' \ +-e '/^$!pdfTeX error:.*$s*/{' \ +-e ' b error' \ +-e '}' \ +-e '/.*$!!! .*$/{' \ +-e ' s//\1/' \ +-e ' s/[[:cntrl:]]//' \ +-e ' s/[[:cntrl:]]$$//' \ +-e ' b error' \ +-e '}' \ +-e 'd' \ +-e ':error' \ +-e 's/^!$!! $\{0,1\}$.*$/$(C_ERROR)\2$(C_RESET)/' \ +-e 'p' \ +-e 'd' \ +'$1' | $(SED) -e 's/\\\\/\\\\\\\\/g' +endef + +# Colorize Makeindex errors +define colorize-makeindex-errors +$(SED) \ +-e '/^!! /{' \ +-e ' N' \ +-e ' s/^.*$$/$(C_ERROR)&$(C_RESET)/' \ +-e ' p' \ +-e '}' \ +-e 'd' \ +'$1' +endef + +# Colorize xindy errors +# $(call colorize-xindy-errors,<log file>) +define colorize-xindy-errors +$(SED) \ +-e 's/^xindy:.*/$(C_ERROR)&$(C_RESET)/p' \ +-e 'd' \ +'$1' +endef + +# Colorize epstopdf errors +# +# $(call colorize-epstopdf-errors,<log file>) +define colorize-epstopdf-errors +$(SED) \ +-e '/^Error:/,/^Execution stack:/{' \ +-e ' /^Execution stack:/d' \ +-e ' s/.*/$(C_ERROR)&$(C_RESET)/' \ +-e ' p' \ +-e '}' \ +-e 'd' \ +'$1' +endef + +# Colorize GNUplot errors +# +# $(call colorize-gnuplot-errors,<log file>) +define colorize-gnuplot-errors +$(SED) \ +-e '/, line [0-9]*:/!{' \ +-e ' H' \ +-e ' x' \ +-e ' s/.*\n$.*\n.*$$$/\1/' \ +-e ' x' \ +-e '}' \ +-e '/, line [0-9]*:/{' \ +-e ' H' \ +-e ' /unknown.*terminal type/{' \ +-e ' s/.*/--- Try changing the GNUPLOT_OUTPUT_EXTENSION variable to '"'"'eps'"'"'./' \ +-e ' H' \ +-e ' }' \ +-e ' /gpihead/{' \ +-e ' s/.*/--- This could be a Makefile bug - contact the maintainer./' \ +-e ' H' \ +-e ' }' \ +-e ' g' \ +-e ' s/.*/$(C_ERROR)&$(C_RESET)/' \ +-e ' p' \ +-e '}' \ +-e '/^gnuplot>/,/^$$/{' \ +-e ' s/^gnuplot.*/$(C_ERROR)&/' \ +-e ' s/^$$/$(C_RESET)/' \ +-e ' p' \ +-e '}' \ +-e 'd' \ +$1 +endef + +# Colorize GraphViz errors +# +# $(call colorize-dot-errors,<log file>) +define colorize-dot-errors +$(SED) \ +-e 's/.*not found.*/$(C_ERROR)&$(C_RESET)/p' \ +-e '/^Error:/,/context:/s/.*/$(C_ERROR)&$(C_RESET)/p' \ +-e 's/^Warning:.*/$(C_WARNING)&$(C_RESET)/p' \ +-e 'd' \ +'$1' +endef + +# Get all important .aux files from the top-level .aux file and merges them all +# into a single file, which it outputs to stdout. +# +# $(call flatten-aux,<toplevel aux>,<output file>) +define flatten-aux +$(SED) \ +-e '/\$a)input{\(.*$}/{' \ +-e 's//\1/' \ +-e 's![.:]!\\&!g' \ +-e 'h' \ +-e 's!.*!\\:\\\\@input{&}:{!' \ +-e 'p' \ +-e 'x' \ +-e 's/\\././g' \ +-e 's/.*/r &/p' \ +-e 's/.*/d/p' \ +-e 's/.*/}/p' \ +-e 'd' \ +-e '}' \ +-e 'd' \ +'$1' > "$1.$$$$.sed.make"; \ +$(SED) -f "$1.$$$$.sed.make" '$1' > "$1.$$$$.make"; \ +$(SED) \ +-e '/^\\relax/d' \ +-e '/^\\bibcite/d' \ +-e 's/^$\\newlabel{[^}]\{1,\}}$.*/\1/' \ +"$1.$$$$.make" | $(SORT) > '$2'; \ +$(call remove-temporary-files,$1.$$$$.make $1.$$$$.sed.make) +endef + +# Generate pdf from postscript +# +# Note that we don't just call ps2pdf, since there are so many versions of that +# script on various systems. Instead, we call the postscript interpreter +# directly. +# +# $(call ps2pdf,infile,outfile,[embed fonts]) +define ps2pdf + $(GS) \ + -dSAFER -dCompatibilityLevel=$(PS_COMPATIBILITY) \ + $(if $3,$(PS_EMBED_OPTIONS)) \ + -q -dNOPAUSE -dBATCH \ + -sDEVICE=pdfwrite -sstdout=%stderr \ + '-sOutputFile=$2' \ + -dSAFER -dCompatibilityLevel=$(PS_COMPATIBILITY) \ + $(if $3,$(PS_EMBED_OPTIONS)) \ + -c .setpdfwrite \ + -f '$1' +endef + +# Colorize LaTeX output. +color_tex := \ +$(SED) \ +-e '$${' \ +-e ' /^$$/!{' \ +-e ' H' \ +-e ' s/.*//' \ +-e ' }' \ +-e '}' \ +-e '/^$$/!{' \ +-e ' H' \ +-e ' d' \ +-e '}' \ +-e '/^$$/{' \ +-e ' x' \ +-e ' s/^\n//' \ +-e ' /Output written on /{' \ +-e ' s/.*Output written on $[^(]*$ ($[^)]\{1,\}$).*/Success! Wrote \2 to \1/' \ +-e ' s/[[:digit:]]\{1,\}/$(C_PAGES)&$(C_RESET)/g' \ +-e ' s/Success!/$(C_SUCCESS)&$(C_RESET)/g' \ +-e ' s/to $.*$$$/to $(C_SUCCESS)\1$(C_RESET)/' \ +-e ' b end' \ +-e ' }' \ +-e ' / *LaTeX Error:.*/{' \ +-e ' s/.*$ *LaTeX Error:.*$/$(C_ERROR)\1$(C_RESET)/' \ +-e ' b end' \ +-e ' }' \ +-e ' /.*Warning:.*/{' \ +-e ' s//$(C_WARNING)&$(C_RESET)/' \ +-e ' b end' \ +-e ' }' \ +-e ' /Underfull.*/{' \ +-e ' s/.*$Underfull.*$/$(C_UNDERFULL)\1$(C_RESET)/' \ +-e ' b end' \ +-e ' }' \ +-e ' /Overfull.*/{' \ +-e ' s/.*$Overfull.*$/$(C_OVERFULL)\1$(C_RESET)/' \ +-e ' b end' \ +-e ' }' \ +-e ' d' \ +-e ' :end' \ +-e ' G' \ +-e '}' + +# Colorize BibTeX output. +color_bib := \ +$(SED) \ +-e 's/^Warning--.*/$(C_WARNING)&$(C_RESET)/' \ +-e 't' \ +-e '/---/,/^.[^:]/{' \ +-e ' H' \ +-e ' /^.[^:]/{' \ +-e ' x' \ +-e ' s/\n$.*$/$(C_ERROR)\1$(C_RESET)/' \ +-e ' p' \ +-e ' s/.*//' \ +-e ' h' \ +-e ' d' \ +-e ' }' \ +-e ' d' \ +-e '}' \ +-e '/(.*error.*)/s//$(C_ERROR)&$(C_RESET)/' \ +-e 'd' + +# Make beamer output big enough to print on a full page. Landscape doesn't +# seem to work correctly. +enlarge_beamer = $(PSNUP) -l -1 -W128mm -H96mm -pletter + +# $(call test-run-again,<source stem>) +test-run-again = $(EGREP) -q '^(.*Rerun .*|No file $1\.[^.]+\.)$$' $1.log + +# This tests whether the build target commands should be run at all, from +# viewing the log file. +# $(call test-log-for-need-to-run,<source stem>) +define test-log-for-need-to-run +$(SED) \ +-e '/^No file $(call escape-fname-regex,$1)\.aux\./d' \ +$1.log \ +| $(EGREP) -q '^(.*Rerun .*|No file $1\.[^.]+\.|No file .+\.tex\.|LaTeX Warning: File.*)$$' +endef + +# LaTeX invocations +# +# $(call latex,<tex file>,[<extra LaTeX args>]) +run-latex = $(latex_build_program) -interaction=batchmode -file-line-error $(if $2,$2,) $1 > /dev/null + +# $(call latex-color-log,<LaTeX stem>) +latex-color-log = $(color_tex) $1.log + +# $(call run-makeindex,<input>,<output>,<log>,[.ist style file]) +define run-makeindex +success=1; \ +if ! $(MAKEINDEX) -q $1 -t $3 -o $2 $(if $4,-s $4,) > /dev/null || $(EGREP) -q '^!!' $3; \ +then \ + $(call colorize-makeindex-errors,$3); \ + $(RM) -f '$2'; \ + success=0; \ +fi; \ +[ "$$success" = "1" ] && $(sh_true) || $(sh_false); +endef + + +# $(call run-xindy,<input>,<output>,<module>,<log>) +define run-xindy +success=1; \ +if ! $(XINDY) -q -o $2 -L $(XINDYLANG) -C $(XINDYENC) -I xindy -M $3 -t $4 $1 > /dev/null || $(EGREP) -q '^xindy:' $4; then \ + $(call colorize-xindy-errors,$4); \ + $(RM) -f '$2'; \ + success=0; \ +fi; \ +[ "$$success" = "1" ] && $(sh_true) || $(sh_false); +endef + +# This runs the given script to generate output, and it uses MAKE_RESTARTS to +# ensure that it never runs it more than once for a particular root make +# invocation. +# +# $(call run-script,<interpreter>,<input>,<output>) +define run-script +[ ! -e '$2.cookie' ] && $(ECHO) "restarts=$(RESTARTS)" > $2.cookie && $(ECHO) "level=$(MAKELEVEL)" >> $2.cookie; \ +restarts=`$(SED) -n -e 's/^restarts=//p' $2.cookie`; \ +level=`$(SED) -n -e 's/^level=//p' $2.cookie`; \ +if $(EXPR) $(MAKELEVEL) '<=' $$level '&' $(RESTARTS) '<=' $$restarts >/dev/null; then \ + $(call echo-build,$2,$3,$(RESTARTS)-$(MAKELEVEL)); \ + $1 '$2' '$3'; \ + $(ECHO) "restarts=$(RESTARTS)" > '$2.cookie'; \ + $(ECHO) "level=$(MAKELEVEL)" >> '$2.cookie'; \ +fi +endef + +# BibTeX invocations +# +# $(call run-bibtex,<tex stem>) +run-bibtex = $(BIBTEX) $1 | $(color_bib) + + +# $(call convert-eps-to-pdf,<eps file>,<pdf file>,[gray]) +# Note that we don't use the --filter flag because it has trouble with bounding boxes that way. +define convert-eps-to-pdf +$(if $3,$(CAT) '$1' | $(call kill-ps-color) > '$1.cookie',$(CP) '$1' '$1.cookie'); \ +$(EPSTOPDF) '$1.cookie' --outfile='$2' > $1.log; \ +$(call colorize-epstopdf-errors,$1.log); +endef + +# $(call default-gpi-fontsize,<output file>) +# +# Find the default fontsize given the *output* file (it is based on the output extension) +# +default-gpi-fontsize = $(if $(filter %.pdf,$1),$(DEFAULT_GPI_PDF_FONTSIZE),$(DEFAULT_GPI_EPS_FONTSIZE)) + +# $(call gpi-fontsize,<gpi file>,<output file>) +# +# Find out what the gnuplot fontsize should be. Tries, in this order: +# - ##FONTSIZE comment in gpi file +# - ##FONTSIZE comment in global gpi file +# - default fontsize based on output type +define gpi-fontsize +$(strip $(firstword \ + $(shell $(SED) -e 's/^\#\#FONTSIZE=$[[:digit:]]\{1,\}$/\1/p' -e 'd' $1 $(strip $(gpi_global))) \ + $(call default-gpi-fontsize,$2))) +endef + +# $(call gpi-monochrome,<gpi file>,[gray]) +define gpi-monochrome +$(strip $(if $2,monochrome,$(if $(shell $(EGREP) '^\#\#[[:space:]]*GRAY[[:space:]]*$$' $1 $(gpi_global)),monochrome,color))) +endef + +# $(call gpi-font-entry,<output file>,<fontsize>) +# +# Get the font entry given the output file (type) and the font size. For PDF +# it uses fsize or font, for eps it just uses the bare number. +gpi-font-entry = $(if $(filter %.pdf,$1),$(subst FONTSIZE,$2,$(GPI_FSIZE_SYNTAX)),$2) + +# $(call gpi-terminal,<gpi file><output file>,[gray]) +# +# Get the terminal settings for a given gpi and its intended output file +define gpi-terminal +$(if $(filter %.pdf,$2),pdf enhanced,postscript enhanced eps) \ +$(call gpi-font-entry,$2,$(call gpi-fontsize,$1,$2)) \ +$(call gpi-monochrome,$1,$3) +endef + +# $(call gpi-embed-pdf-fonts,<input file>,<output file>) +# +define gpi-embed-pdf-fonts +$(GS) \ + -q \ + -dSAFER \ + -dNOPAUSE \ + -dBATCH \ + -sDEVICE=$(if $(filter pdf,$(GPI_OUTPUT_EXTENSION)),pdfwrite,pswrite) \ + -sOutputFile='$2' \ + -sstdout=%stderr \ + -dCompatibilityLevel=1.5 \ + -dPDFSETTINGS=/prepress \ + -c .setpdfwrite \ + -f '$1' +endef + +# $(call convert-gpi,<gpi file>,<output file>,[gray]) +# +define convert-gpi +$(ECHO) 'set terminal $(call gpi-terminal,$1,$2,$3)' > $1head.make; \ +$(ECHO) 'set output "$2"' >> $1head.make; \ +$(if $(gpi_global),$(CAT) $(gpi_global) >> $1head.make;,) \ +fnames='$1head.make $1';\ +$(if $(gpi_sed),\ + $(SED) -f '$(gpi_sed)' $$fnames > $1.temp.make; \ + fnames=$1.temp.make;,\ +) \ +success=1; \ +if ! $(GNUPLOT) $$fnames 2>$1.log; then \ + $(call colorize-gnuplot-errors,$1.log); \ + success=0; \ +else \ + if ! $(call gpi-embed-pdf-fonts,$2,$2.embed.make); then \ + success = 0; \ + else \ + $(call move-if-exists,$2.embed.make,$2); \ + fi; \ +fi; \ +$(if $(gpi_sed),$(call remove-temporary-files,$1.temp.make);,) \ +$(call remove-temporary-files,$1head.make); \ +[ "$$success" = "1" ] && $(sh_true) || $(sh_false); +endef + +# Creation of .eps files from .png files +# +# The intermediate step of PNM (using NetPBM) produces much nicer output than +# ImageMagick's "convert" binary. I couldn't get the right combination of +# flags to make it look nice, anyway. +# +# To handle gray scale conversion, we pipe things through ppmtopgm in the +# middle. +# +# $(call convert-png,<png file>,<eps file>) +define convert-png +$(PNGTOPNM) "$1" \ + $(if $3,| $(PPMTOPGM),) \ + | $(PNMTOPS) -noturn \ + > "$2" +endef + +# Creation of .eps files from .jpg/.jpeg files +# +# Thanks to brubakee for this solution. +# +# Uses Postscript level 2 to avoid file size bloat +# $(call convert-jpg,<jpg file>,<eps file>) +define convert-jpg +$(CONVERT) $(if $3,-type Grayscale,) '$1' eps2:'$2' +endef + +# Creation of .eps files from .fig files +# $(call convert-fig,<fig file>,<output file>,[gray]) +convert-fig = $(FIG2DEV) -L $(if $(filter %.pdf,$2),pdf,eps) $(if $3,-N,) $1 $2 + +# Creation of .pstex files from .fig files +# $(call convert-fig-pstex,<fig file>,<pstex file>) +convert-fig-pstex = $(FIG2DEV) -L pstex $1 $2 > /dev/null 2>&1 + +# Creation of .pstex_t files from .fig files +# $(call convert-fig-pstex-t,<fig file>,<pstex file>,<pstex_t file>) +convert-fig-pstex-t = $(FIG2DEV) -L pstex_t -p $3 $1 $2 > /dev/null 2>&1 + +# Creation of .dot_t files from .dot files +# #(call convert-dot-tex,<dot file>,<dot_t file>) +convert-dot-tex = $(DOT2TEX) '$1' > '$2' + +# Converts svg files into .eps files +# +# $(call convert-svg,<svg file>,<eps/pdf file>,[gray]) +convert-svg = $(INKSCAPE) --without-gui $(if $(filter %.pdf,$2),--export-pdf,--export-eps)='$2' '$1' + +# Converts xvg files into .eps files +# +# $(call convert-xvg,<xvg file>,<eps file>,[gray]) +convert-xvg = $(XMGRACE) '$1' -printfile - -hardcopy -hdevice $(if $3,-mono,) EPS > '$2' + +# Converts .eps.gz files into .eps files +# +# $(call convert-epsgz,<eps.gz file>,<eps file>,[gray]) +convert-epsgz = $(GUNZIP) -c '$1' $(if $3,| $(call kill-ps-color)) > '$2' + +# Converts .eps files into .eps files (usually a no-op, but can make grayscale) +# +# $(call convert-eps,<in file>,<out file>,[gray]) +convert-eps = $(if $3,$(call kill-ps-color) $1 > $2) + +# The name of the file containing special postscript commands for grayscale +gray_eps_file := gray.eps.make + +# Changes sethsbcolor and setrgbcolor calls in postscript to always produce +# grayscale. In general, this is accomplished by writing new versions of those +# functions into the user dictionary space, which is looked up before the +# global or system dictionaries (userdict is one of the permanent dictionaries +# in postscript and is not read-only like systemdict). +# +# For setrgbcolor, the weighted average of the triple is computed and the +# triple is replaced with three copies of that average before the original +# procedure is called: .299R + .587G + .114B +# +# For sethsbcolor, the color is first converted to RGB, then to grayscale by +# the new setrgbcolor operator as described above. Why is this done? +# Because simply using the value component will tend to make pure colors +# white, a very undesirable thing. Pure blue should not translate to white, +# but to some level of gray. Conversion to RGB does the right thing. It's +# messy, but it works. +# +# From +# http://en.wikipedia.org/wiki/HSV_color_space#Transformation_from_HSV_to_RGB, +# HSB = HSV (Value = Brightness), and the formula used to convert to RGB is +# as follows: +# +# Hi = int(floor(6 * H)) mod 6 +# f = 6 * H - Hi +# p = V(1-S) +# q = V(1-fS) +# t = V(1-(1-f)S) +# if Hi = 0: R G B <-- V t p +# if Hi = 1: R G B <-- q V p +# if Hi = 2: R G B <-- p V t +# if Hi = 3: R G B <-- p q V +# if Hi = 4: R G B <-- t p V +# if Hi = 5: R G B <-- V p q +# +# The messy stack-based implementation is below +# $(call create-gray-eps-file,filename) +define create-gray-eps-file +$(ECHO) -n -e '\ +/OLDRGB /setrgbcolor load def\n\ +/setrgbcolor {\n\ + .114 mul exch\n\ + .587 mul add exch\n\ + .299 mul add\n\ + dup dup\n\ + OLDRGB\n\ +} bind def\n\ +/OLDHSB /sethsbcolor load def\n\ +/sethsbcolor {\n\ + 2 index % H V S H\n\ + 6 mul floor cvi 6 mod % Hi V S H\n\ + 3 index % H Hi V S H\n\ + 6 mul % 6H Hi V S H\n\ + 1 index % Hi 6H Hi V S H\n\ + sub % f Hi V S H\n\ + 2 index 1 % 1 V f Hi V S H\n\ + 4 index % S 1 V f Hi V S H\n\ + sub mul % p f Hi V S H\n\ + 3 index 1 % 1 V p f Hi V S H\n\ + 6 index % S 1 V p f Hi V S H\n\ + 4 index % f S 1 V p f Hi V S H\n\ + mul sub mul % q p f Hi V S H\n\ + 4 index 1 1 % 1 1 V q p f Hi V S H\n\ + 5 index % f 1 1 V q p f Hi V S H\n\ + sub % (1-f) 1 V q p f Hi V S H\n\ + 8 index % S (1-f) 1 V q p f Hi V S H\n\ + mul sub mul % t q p f Hi V S H\n\ + 4 -1 roll pop % t q p Hi V S H\n\ + 7 -2 roll pop pop % t q p Hi V\n\ + 5 -2 roll % Hi V t q p\n\ + dup 0 eq\n\ + {1 index 3 index 6 index}\n\ + {\n\ + dup 1 eq\n\ + {3 index 2 index 6 index}\n\ + {\n\ + dup 2 eq\n\ + {4 index 2 index 4 index}\n\ + {\n\ + dup 3 eq\n\ + {4 index 4 index 3 index}\n\ + {\n\ + dup 4 eq\n\ + {2 index 5 index 3 index}\n\ + {\n\ + dup 5 eq\n\ + {1 index 5 index 5 index}\n\ + {0 0 0}\n\ + ifelse\n\ + }\n\ + ifelse\n\ + }\n\ + ifelse\n\ + }\n\ + ifelse\n\ + }\n\ + ifelse\n\ + }\n\ + ifelse % B G R Hi V t q p\n\ + setrgbcolor\n\ + 5 {pop} repeat\n\ +} bind def\n'\ +> $1 +endef + +# This actually inserts the color-killing code into a postscript file +# $(call kill-ps-color) +define kill-ps-color +$(SED) -e '/%%EndComments/r $(gray_eps_file)' +endef + +# Converts graphviz .dot files into .eps files +# Grayscale is not directly supported by dot, so we pipe it through fig2dev in +# that case. +# $(call convert-dot,<dot file>,<eps file>,<log file>,[gray]) +define convert-dot +$(DOT) -Tps '$1' 2>'$3' $(if $4,| $(call kill-ps-color)) > $2; \ +$(call colorize-dot-errors,$3) +endef + +# Convert DVI to Postscript +# $(call make-ps,<dvi file>,<ps file>,<log file>,[<paper size>]) +make-ps = \ + $(DVIPS) -z -o '$2' $(if $(filter-out BEAMER,$4),-t$(firstword $4),) '$1' \ + $(if $(filter BEAMER,$4),| $(enlarge_beamer)) > $3 2>&1 + +# Convert Postscript to PDF +# $(call make-pdf,<ps file>,<pdf file>,<log file>,<embed file>) +make-pdf = \ + $(call ps2pdf,$1,$2,$(filter 1,$(shell $(CAT) '$4'))) > '$3' 2>&1 + +# Display information about what is being done +# $(call echo-build,<input file>,<output file>,[<run number>]) +echo-build = $(ECHO) "$(C_BUILD)= $1 --> $2$(if $3, ($3),) =$(C_RESET)" +echo-graphic = $(ECHO) "$(C_GRAPHIC)= $1 --> $2 =$(C_RESET)" +echo-dep = $(ECHO) "$(C_DEP)= $1 --> $2 =$(C_RESET)" + +# Display a list of something +# $(call echo-list,<values>) +echo-list = for x in $1; do $(ECHO) "$$x"; done + +# +# DEFAULT TARGET +# + +.PHONY: all +all: $(default_pdf_targets) ; + +.PHONY: all-pdf +all-pdf: $(default_pdf_targets) ; + +ifeq "$(strip $(BUILD_STRATEGY))" "latex" +.PHONY: all-ps +all-ps: $(default_ps_targets) ; + +.PHONY: all-dvi +all-dvi: $(default_dvi_targets) ; +endif + +# +# VIEWING TARGET +# +.PHONY: show +show: all + $(QUIET)for x in $(default_pdf_targets); do \ + [ -e "$$x" ] && $(VIEW_PDF) $$x & \ + done + +# +# INCLUDES +# +source_includes := $(addsuffix .d,$(source_stems_to_include)) +graphic_includes := $(addsuffix .gpi.d,$(graphic_stems_to_include)) + +# Check the version of the makefile +ifneq "" "$(filter 3.79 3.80,$(MAKE_VERSION))" +$(warning $(C_WARNING)Your version of make is too old. Please upgrade.$(C_RESET)) +endif + +# Include only the dependencies used +ifneq "" "$(source_includes)" +include $(source_includes)$(call include-message,$(source_includes)) +endif +ifneq "" "$(graphic_includes)" +include $(graphic_includes)$(call include-message,$(graphic_includes)) +endif + +# +# MAIN TARGETS +# + +# Note that we don't just say %: %.pdf here - this can tend to mess up our +# includes, which detect what kind of file we are asking for. For example, +# asking to build foo.pdf is much different than asking to build foo when +# foo.gpi exists, because we look through all of the goals for *.pdf that +# matches *.gpi, then use that to determine which include files we need to +# build. +# +# Thus, we invoke make recursively with better arugments instead, restarting +# all of the appropriate machinery. +.PHONY: $(default_stems_ss) +$(default_stems_ss): %: %.pdf ; + +# This builds and displays the wanted file. +.PHONY: $(addsuffix ._show,$(stems_ssg)) +$(addsuffix ._show,$(stems_ssg)): %._show: %.pdf + $(QUIET)$(VIEW_PDF) $< & + +ifeq "$(strip $(BUILD_STRATEGY))" "latex" +.SECONDARY: $(all_pdf_targets) +%.pdf: %.ps %.embed.make + $(QUIET)$(call echo-build,$<,$@) + $(QUIET)$(call make-pdf,$<,$@.temp,$@.log,$*.embed.make); \ + if [ x"$$?" = x"0" ]; then \ + $(if $(VERBOSE),$(CAT) $@.log,:); \ + $(RM) -f '$@'; \ + $(MV) '$@.temp' '$@'; \ + $(TOUCH) '$@'; \ + $(call copy-with-logging,$@,$(BINARY_TARGET_DIR)); \ + else \ + $(CAT) $@.log; \ + $(call remove-temporary-files,'$@.temp'); \ + $(sh_false); \ + fi + +.SECONDARY: $(all_ps_targets) +%.ps: %.dvi %.paper.make + $(QUIET)$(call echo-build,$<,$@) + $(QUIET)$(call make-ps,$<,$@.temp,$@.log,\ + $(firstword $(shell $(CAT) $*.paper.make))); \ + if [ x"$$?" = x"0" ]; then \ + $(if $(VERBOSE),$(CAT) $@.log,:); \ + $(RM) -f '$@'; \ + $(MV) '$@.temp' '$@'; \ + $(TOUCH) '$@'; \ + $(call copy-with-logging,$@,$(BINARY_TARGET_DIR)); \ + else \ + $(CAT) $@.log; \ + $(call remove-temporary-files,'$@.temp'); \ + $(sh_false); \ + fi +endif + +# Build the final target (dvi or pdf) file. This is a very tricky rule because +# of the way that latex runs multiple times, needs graphics after the first run +# (or maybe already has them), and relies on bibliographies or indices that may +# not exist. +# +# Check the log for fatal errors. If they exist, colorize and bail. +# +# Create the .auxtarget.cookie file. (Needed for next time if not present) +# +# If any of the following are true, we must rebuild at least one time: +# +# * the .bbl was recently rebuilt +# +# check a cookie, then delete it +# +# * any of several output files was created or changed: +# +# check $*.run.cookie, then delete it +# +# * the .aux file changed in a way that necessitates attention +# +# Note that if the .auxtarget.make file doesn't exist, this means +# that we are doing a clean build, so it doesn't figure into the +# test for running again. +# +# compare against .auxtarget.make +# +# move if different, remove if not +# +# * the .log file has errors or warnings requiring at least one more run +# +# We use a loop over a single item to simplify the process of breaking +# out when we find one of the conditions to be true. +# +# If we do NOT need to run latex here, then we move the $@.1st.make file +# over to $@ because the target file has already been built by the first +# dependency run and is valid. +# +# If we do, we delete that cookie file and do the normal multiple-runs +# routine. +# +ifeq "$(strip $(BUILD_STRATEGY))" "latex" +.SECONDARY: $(all_dvi_targets) +endif +%.$(build_target_extension): %.bbl %.aux %.$(build_target_extension).1st.make + $(QUIET)\ + fatal=`$(call colorize-latex-errors,$*.log)`; \ + if [ x"$$fatal" != x"" ]; then \ + $(ECHO) "$$fatal"; \ + exit 1; \ + fi; \ + $(call make-auxtarget-file,$*.aux.make,$*.auxtarget.cookie); \ + run=0; \ + for i in 1; do \ + if $(call test-exists,$*.bbl.cookie); then \ + run=1; \ + break; \ + fi; \ + if $(call test-exists,$*.run.cookie); then \ + run=1; \ + break; \ + fi; \ + if $(call \ + test-exists-and-different,$*.auxtarget.cookie,$*.auxtarget.make);\ + then \ + run=1; \ + break; \ + fi; \ + if $(call test-log-for-need-to-run,$*); then \ + run=1; \ + break; \ + fi; \ + if [ ! -e $*.1st.*.make ]; then \ + run=1; \ + break; \ + fi; \ + done; \ + $(call remove-temporary-files,$*.bbl.cookie $*.run.cookie); \ + $(MV) $*.auxtarget.cookie $*.auxtarget.make; \ + if [ x"$$run" = x"1" ]; then \ + $(call remove-files,$@.1st.make); \ + for i in 2 3 4 5; do \ + $(if $(findstring 3.79,$(MAKE_VERSION)),\ + $(call echo-build,$*.tex,$@,$(RESTARTS)-$$$$i),\ + $(call echo-build,$*.tex,$@,$(RESTARTS)-$$i)\ + ); \ + $(call run-latex,$*); \ + $(CP) '$*.log' '$*.'$(RESTARTS)-$$i'.log'; \ + $(call test-run-again,$*) || break; \ + done; \ + else \ + $(MV) '$@.1st.make' '$@'; \ + fi; \ + $(call copy-with-logging,$@,$(BINARY_TARGET_DIR)); \ + $(call latex-color-log,$*) + +# Build the .bbl file. When dependencies are included, this will (or will +# not!) depend on something.bib, which we detect, acting accordingly. The +# dependency creation also produces the %.auxbbl.make file. BibTeX is a bit +# finicky about what you call the actual files, but we can rest assured that if +# a .auxbbl.make file exists, then the .aux file does, as well. The +# .auxbbl.make file is a cookie indicating whether the .bbl needs to be +# rewritten. It only changes if the .aux file changes in ways relevant to .bbl +# creation. +# +# Note that we do NOT touch the .bbl file if there is no need to +# create/recreate it. We would like to leave existing files alone if they +# don't need to be changed, thus possibly avoiding a rebuild trigger. +%.bbl: %.auxbbl.make + $(QUIET)\ + $(if $(filter %.bib,$^),\ + $(call echo-build,$(filter %.bib,$?) $*.aux,$@); \ + $(call run-bibtex,$*); \ + $(TOUCH) $@.cookie; \ + ) \ + if $(EGREP) -q 'bibstyle.(apacite|apacann|chcagoa|[^}]*annot)' '$*.aux'; then \ + $(call echo-build,** annotated extra latex **,output ignored,$(RESTARTS)-1); \ + $(call run-latex,$*); \ + $(CP) '$*.log' '$*.$(RESTARTS)-annotated.log'; \ + $(if $(filter %.bib,$^),\ + $(call echo-build,** annotated extra bibtex ** $(filter %.bib,$?) $*.aux,$@); \ + $(call run-bibtex,$*); \ + $(TOUCH) $@.cookie; \ + ) \ + $(call echo-build,** annotated extra latex **,output ignored,$(RESTARTS)-2); \ + $(call run-latex,$*); \ + fi + +# Create the index file - note that we do *not* depend on %.tex here, since +# that unnecessarily restricts the kinds of indices that we can build to those +# with exactly the same stem as the source file. Things like splitidx create +# idx files with other names. +# +# Therefore, we add the .tex dependency in the sourcestem.d file in the call to +# get index file dependencies from the logs. +%.ind: %.idx + $(QUIET)$(call echo-build,$<,$@) + $(QUIET)$(call run-makeindex,$<,$(a),$*.ilg) + +# Create a glossary file from a .ist file +%.gls: %.glo %.tex %.ist + $(QUIET)$(call echo-build,$<,$@) + $(QUIET)$(call run-makeindex,$<,$(a),$*.glg,$*.ist) + +# Create a glossary file from a glossary input formatted for xindy +%.gls: %.glo %.tex %.xdy + $(QUIET)$(call echo-build,$<,$@) + $(QUIET)$(call run-xindy,$<,$(a),$*,$*.glg) + +# Create the glossary file from a nomenclature file +%.gls: %.glo %.tex nomencl.ist + $(QUIET)$(call echo-build,$<,$@) + $(QUIET)$(call run-makeindex,$<,$(a),$*.glg,nomencl.ist) + +# Create the nomenclature file +%.nls: %.nlo %.tex nomencl.ist + $(QUIET)$(call echo-build,$<,$@) + $(QUIET)$(call run-makeindex,$<,$(a),$*.nlg,nomencl.ist) + +# SCRIPTED LaTeX TARGETS +# +# Keep the generated .tex files around for debugging if needed. +.SECONDARY: $(all_tex_targets) + +%.tex:: %.tex.sh + $(QUIET)$(call run-script,$(SHELL),$<,$@) + +%.tex:: %.tex.py + $(QUIET)$(call run-script,$(PYTHON),$<,$@) + +%.tex:: %.tex.pl + $(QUIET)$(call run-script,$(PERL),$<,$@) + +%.tex:: %.rst $(RST_STYLE_FILE) + $(QUIET)\ + $(call run-script,$(RST2LATEX)\ + --documentoptions=letterpaper\ + $(if $(RST_STYLE_FILE),--stylesheet=$(RST_STYLE_FILE),),$<,$@) + +# +# GRAPHICS TARGETS +# +.PHONY: all-graphics +all-graphics: $(all_graphics_targets); + +ifeq "$(strip $(BUILD_STRATEGY))" "latex" +.PHONY: all-pstex +all-pstex: $(all_pstex_targets); +endif + +.PHONY: all-dot2tex +all-dot2tex: $(all_dot2tex_targets); + +.PHONY: show-graphics +show-graphics: all-graphics + $(VIEW_GRAPHICS) $(all_known_graphics) + +$(gray_eps_file): + $(QUIET)$(call echo-build,$^,$@) + $(QUIET)$(call create-gray-eps-file,$@) + +ifeq "$(strip $(BUILD_STRATEGY))" "pdflatex" +%.pdf: %.eps $(if $(GRAY),$(gray_eps_file)) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-eps-to-pdf,$<,$@,$(GRAY)) + +ifeq "$(strip $(GPI_OUTPUT_EXTENSION))" "pdf" +%.pdf: %.gpi %.gpi.d $(gpi_sed) $(gpi_global) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-gpi,$<,$@,$(GRAY)) +endif + +%.pdf: %.fig + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-fig,$<,$@,$(GRAY)) + +%.pdf: %.svg + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-svg,$<,$@,$(GRAY)) +endif + +ifeq "$(strip $(BUILD_STRATEGY))" "xelatex" +%.pdf: %.eps $(if $(GRAY),$(gray_eps_file)) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-eps-to-pdf,$<,$@,$(GRAY)) + +ifeq "$(strip $(GPI_OUTPUT_EXTENSION))" "pdf" +%.pdf: %.gpi %.gpi.d $(gpi_sed) $(gpi_global) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-gpi,$<,$@,$(GRAY)) +endif + +%.pdf: %.fig + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-fig,$<,$@,$(GRAY)) + +endif + + +%.eps: %.gpi %.gpi.d $(gpi_sed) $(gpi_global) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-gpi,$<,$@,$(GRAY)) + +%.eps: %.fig + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-fig,$<,$@,$(GRAY)) + +%.eps: %.dot $(if $(GRAY),$(gray_eps_file)) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-dot,$<,$@,$<.log,$(GRAY)) + +%.eps: %.xvg $(if $(GRAY),$(gray_eps_file)) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-xvg,$<,$@,$(GRAY)) + +ifneq "$(default_graphic_extension)" "pdf" +# We have a perfectly good build rule for svg to pdf, so we eliminate this to +# avoid confusing make (it sometimes chooses to go svg -> eps -> pdf). +%.eps: %.svg $(if $(GRAY),$(gray_eps_file)) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-svg,$<,$@,$(GRAY)) + +# Similarly for these, we don't need eps if we have supported extensions +# already. +%.eps: %.jpg $(if $(GRAY),$(gray_eps_file)) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-jpg,$<,$@,$(GRAY)) + +%.eps: %.jpeg $(if $(GRAY),$(gray_eps_file)) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-jpg,$<,$@,$(GRAY)) + +%.eps: %.png $(if $(GRAY),$(gray_eps_file)) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-png,$<,$@,$(GRAY)) +endif + +%.eps: %.eps.gz $(if $(GRAY),$(gray_eps_file)) + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-epsgz,$<,$@,$(GRAY)) + +%.pstex: %.fig + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-fig-pstex,$<,$@,$(GRAY)) + +%.pstex_t: %.fig %.pstex + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-fig-pstex-t,$<,$(a),$*.pstex,$(GRAY)) + +%.dot_t: %.dot + $(QUIET)$(call echo-graphic,$^,$@) + $(QUIET)$(call convert-dot-tex,$<,$@) + +# +# DEPENDENCY-RELATED TARGETS. +# + +# Generate all of the information needed to get dependencies +# As a side effect, this creates a .dvi or .pdf file (depending on the build +# strategy). We need to be sure to remove it if there are errors. Errors can +# take several forms and all of them are found within the log file: +# * There was a LaTeX error +# * A needed file was not found +# * Cross references need adjustment +# +# Behavior: +# This rule is responsible for generating the following: +# %.aux +# %.d +# %.aux.make +# %.(pdf|dvi).1st.make (the .pdf or .dvi output file, moved) +# +# Steps: +# +# Run latex +# Move .pdf or .dvi somewhere else (make no judgements about success) +# Flatten the .aux file into another file +# Add source dependencies +# Add graphic dependencies +# Add bib dependencies +# +# Create cookies for various suffixes that may represent files that +# need to be read by LaTeX in order for it to function properly. +# +# Note that if some of the dependencies are discovered because they turn +# up missing in the log file, we really need the .d file to be reloaded. +# Adding a sleep command helps with this. Otherwise make is extremely +# nondeterministic, sometimes working, sometimes not. +# +# Usually we can force this by simply removing the generated pdf file and +# not creating a .1st.make file.. +# +%.$(build_target_extension).1st.make %.d %.aux %.aux.make %.fls: %.tex + $(QUIET)$(call echo-build,$<,$*.d $*.$(build_target_extension).1st.make,$(RESTARTS)-1) + $(QUIET)\ + $(call run-latex,$<,-recorder) || $(sh_true); \ + $(CP) '$*.log' '$*.$(RESTARTS)-1.log'; \ + $(call die-on-import-sty,$*.log); \ + $(call die-on-dot2tex,$*.log); \ + $(call die-on-no-aux,$*); \ + $(call flatten-aux,$*.aux,$*.aux.make); \ + $(ECHO) "# vim: ft=make" > $*.d; \ + $(ECHO) ".PHONY: $*._graphics" >> $*.d; \ + $(call get-inputs,$*.fls,$(addprefix $*.,aux aux.make d $(build_target_extension))) >> $*.d; \ + $(call get-missing-inputs,$*.log,$(addprefix $*.,aux aux.make d $(build_target_extension))) >> $*.d; \ + $(ECHO) ".SECONDEXPANSION:" >> $*.d; \ + $(call get-graphics,$*) >> $*.d; \ + $(call get-log-index,$*,$(addprefix $*.,aux aux.make)) >> $*.d; \ + $(call get-bibs,$*.aux.make,$(addprefix $*.,bbl aux aux.make)) >> $*.d; \ + $(EGREP) -q "# MISSING" $*.d && $(SLEEP) 1 && $(RM) $*.pdf; \ + $(call move-if-exists,$*.$(build_target_extension),$*.$(build_target_extension).1st.make); \ + for s in toc out lot lof lol nav; do \ + if [ -e "$*.$$s" ]; then \ + if ! $(DIFF) -q $*.$$s $*.$$s.make >/dev/null 2>&1; then \ + $(TOUCH) $*.run.cookie; \ + fi; \ + $(CP) $*.$$s $*.$$s.make; \ + fi; \ + done + +# This is a cookie that is updated if the flattened aux file has changed in a +# way that affects the bibliography generation. +.SECONDARY: $(addsuffix .auxbbl.make,$(stems_ssg)) +%.auxbbl.make: %.aux.make + $(QUIET)\ + $(call make-auxbbl-file,$<,$@.temp); \ + $(call replace-if-different-and-remove,$@.temp,$@) + +# Build a dependency file for .gpi files. These often plot data files that +# also reside in the directory, so if a data file changes, it's nice to know +# about it. This also handles loaded .gpi files, whose filename should have +# _include_. in it. +%.gpi.d: %.gpi + $(QUIET)$(call echo-build,$<,$@) + $(QUIET)$(call make-gpi-d,$<,$@) + +# Store the paper size for this document -- note that if beamer is used we set +# it to the special BEAMER paper size. We only do this, however, if the +# special comment exists, in which case we enlarge the output with psnup. +# +# The paper size is extracted from a documentclass attribute. +%.paper.make: %.tex + $(QUIET)$(SED) \ + -e '/\\documentclass/,/}/{' \ + -e ' s/%.*//' \ + -e ' H' \ + -e ' /}/{' \ + -e ' s/.*//' \ + -e ' x' \ + -e ' /\\documentclass/!d' \ + -e ' s/[\n[:space:]]*//g' \ + -e ' s/$[,{[]$$[[:alnum:]]\{1,\}$paper$[],}]$/\1%-\2-%\3/g' \ + -e ' s/$[,{[]$$landscape$$[],}]$/\1%-\2-%\3/g' \ + -e ' s/^[^%]*%-//' \ + -e ' s/-%[^%]*$$//' \ + -e ' s/-%[^%]%-/ /g' \ + -e ' p' \ + -e ' }' \ + -e ' d' \ + -e '}' \ + -e 'd' \ + $< > $@; \ + $(EGREP) -q '^[^%]*\\documentclass[^{]*{beamer}' $< && \ + (\ + $(EGREP) -q '^%%[[:space:]]*BEAMER[[:space:]]*LARGE$$' $< && \ + $(ECHO) "BEAMER" > $@ || \ + : > $@ \ + ) || $(sh_true) + +# Store embedding instructions for this document using a special comment +%.embed.make: %.tex + $(QUIET)$(EGREP) '^%%[[:space:]]*NO[[:space:]]*EMBED[[:space:]]*$$' $< \ + && $(ECHO) '' > $@ \ + || $(ECHO) '1' > $@; + +# +# HELPFUL PHONY TARGETS +# + +.PHONY: _all_programs +_all_programs: + $(QUIET)$(ECHO) "== All External Programs Used ==" + $(QUIET)$(call output-all-programs) + +.PHONY: _check_programs +_check_programs: + $(QUIET)$(ECHO) "== Checking Makefile Dependencies =="; $(ECHO) + $(QUIET) \ + allprogs=`\ + ($(call output-all-programs)) | \ + $(SED) \ + -e 's/^[[:space:]]*//' \ + -e '/^#/d' \ + -e 's/[[:space:]]*#.*//' \ + -e '/^=/s/[[:space:]]/_/g' \ + -e '/^[[:space:]]*$$/d' \ + -e 's/^[^=].*=[[:space:]]*$[^[:space:]]\{1,\}$.*$$/\\1/' \ + `; \ + spaces=' '; \ + for p in $${allprogs}; do \ + case $$p in \ + =*) $(ECHO); $(ECHO) "$$p";; \ + *) \ + $(ECHO) -n "$$p:$$spaces" | $(SED) -e 's/^$.\{0,20\}$.*$$/\1/'; \ + loc=`$(WHICH) $$p`; \ + if [ x"$$?" = x"0" ]; then \ + $(ECHO) "$(C_SUCCESS)Found:$(C_RESET) $$loc"; \ + else \ + $(ECHO) "$(C_FAILURE)Not Found$(C_RESET)"; \ + fi; \ + ;; \ + esac; \ + done + +.PHONY: _check_gpi_files +_check_gpi_files: + $(QUIET)$(ECHO) "== Checking all .gpi files for common errors =="; \ + $(ECHO); \ + for f in $(files.gpi); do \ + result=`$(EGREP) '^([^#]*set terminal |set output )' $$f`; \ + $(ECHO) -n "$$f: "; \ + if [ x"$$result" = x"" ]; then \ + $(ECHO) "$(C_SUCCESS)Okay$(C_RESET)"; \ + else \ + $(ECHO) "$(C_FAILURE)Warning: Problematic commands:$(C_RESET)";\ + $(ECHO) "$(C_ERROR)$$result$(C_RESET)"; \ + fi; \ + done; \ + $(ECHO) + +.PHONY: _all_stems +_all_stems: + $(QUIET)$(ECHO) "== All Stems ==" + $(QUIET)$(call echo-list,$(sort $(default_stems_ss))) + +.PHONY: _includes +_includes: + $(QUIET)$(ECHO) "== Include Stems ==" + $(QUIET)$(ECHO) "=== Sources ===" + $(QUIET)$(call echo-list,$(sort $(source_includes))) + $(QUIET)$(ECHO) "=== Graphics ===" + $(QUIET)$(call echo-list,$(sort $(graphic_includes))) + +.PHONY: _all_sources +_all_sources: + $(QUIET)$(ECHO) "== All Sources ==" + $(QUIET)$(call echo-list,$(sort $(all_files.tex))) + +.PHONY: _dependency_graph +_dependency_graph: + $(QUIET)$(ECHO) "/* LaTeX Dependency Graph */" + $(QUIET)$(call output-dependency-graph) + +.PHONY: _show_dependency_graph +_show_dependency_graph: + $(QUIET)$(call output-dependency-graph,$(graph_stem).dot) + $(QUIET)$(DOT) -Tps -o $(graph_stem).eps $(graph_stem).dot + $(QUIET)$(VIEW_POSTSCRIPT) $(graph_stem).eps + $(QUIET)$(call remove-temporary-files,$(graph_stem).*) + +.PHONY: _sources +_sources: + $(QUIET)$(ECHO) "== Sources ==" + $(QUIET)$(call echo-list,$(sort $(files.tex))) + +.PHONY: _scripts +_scripts: + $(QUIET)$(ECHO) "== Scripts ==" + $(QUIET)$(call echo-list,$(sort $(files_scripts))) + +.PHONY: _graphic_outputs +_graphic_outputs: + $(QUIET)$(ECHO) "== Graphic Outputs ==" + $(QUIET)$(call echo-list,$(sort $(all_graphics_targets))) + +.PHONY: _env +_env: +ifdef .VARIABLES + $(QUIET)$(ECHO) "== MAKE VARIABLES ==" + $(QUIET)$(call echo-list,$(foreach var,$(sort $(.VARIABLES)),'$(var)')) +endif + $(QUIET)$(ECHO) "== ENVIRONMENT ==" + $(QUIET)$(ENV) + +# +# CLEAN TARGETS +# +# clean-generated is somewhat unique - it relies on the .fls file being +# properly built so that it can determine which of the files was generated, and +# which was not. Expect it to silently fail if the .fls file is missing. +# +# This is used to, e.g., clean up index files that are generated by the LaTeX. +.PHONY: clean-generated +clean-generated: + $(QUIET)$(call clean-files,$(foreach e,$(addsuffix .fls,$(all_stems_source)),\ + $(shell $(call get-generated-names,$e)))) + +.PHONY: clean-deps +clean-deps: + $(QUIET)$(call clean-files,$(all_d_targets) *.make *.make.temp *.cookie) + +.PHONY: clean-tex +clean-tex: clean-deps + $(QUIET)$(call clean-files,$(rm_tex)) + +.PHONY: clean-graphics +# TODO: This *always* deletes pstex files, even if they were not generated by +# anything.... In other words, if you create a pstex and pstex_t pair by hand +# an drop them in here without the generating fig file, they will be deleted +# and you won't get them back. It's a hack put in here because I'm not sure we +# even want to keep pstex functionality, so my motivation is not terribly high +# for doing it right. +clean-graphics: + $(QUIET)$(call clean-files,$(all_graphics_targets) *.gpi.d *.pstex *.pstex_t *.dot_t) + +.PHONY: clean-backups +clean-backups: + $(QUIET)$(call clean-files,$(backup_patterns) *.temp) + +.PHONY: clean-auxiliary +clean-auxiliary: + $(QUIET)$(call clean-files,$(graph_stem).*) + +.PHONY: clean-nographics +clean-nographics: clean-tex clean-deps clean-backups clean-auxiliary ; + +.PHONY: clean +clean: clean-generated clean-tex clean-graphics clean-deps clean-backups clean-auxiliary ; + +# +# HELP TARGETS +# + +.PHONY: help +help: + $(help_text) + +.PHONY: version +version: + $(QUIET)\ + $(ECHO) "$(fileinfo) Version $(version)"; \ + $(ECHO) "by $(author)"; \ + +# +# HELP TEXT +# + +define help_text +# $(fileinfo) Version $(version) +# +# by $(author) +# +# Generates a number of possible output files from a LaTeX document and its +# various dependencies. Handles .bib files, \include and \input, and .eps +# graphics. All dependencies are handled automatically by running LaTeX over +# the source. +# +# USAGE: +# +# make [GRAY=1] [VERBOSE=1] [SHELL_DEBUG=1] <target(s)> +# +# STANDARD OPTIONS: +# GRAY: +# Setting this variable forces all recompiled graphics to be grayscale. +# It is useful when creating a document for printing. The default is +# to allow colors. Note that it only changes graphics that need to be +# rebuilt! It is usually a good idea to do a 'make clean' first. +# +# VERBOSE: +# This turns off all @ prefixes for commands invoked by make. Thus, +# you get to see all of the gory details of what is going on. +# +# SHELL_DEBUG: +# This enables the -x option for sh, meaning that everything it does is +# echoed to stderr. This is particularly useful for debugging +# what is going on in $$(shell ...) invocations. One of my favorite +# debugging tricks is to do this: +# +# make -d SHELL_DEBUG=1 VERBOSE=1 2>&1 | less +# +# KEEP_TEMP: +# When set, this allows .make and other temporary files to stick around +# long enough to do some debugging. This can be useful when trying to +# figure out why gnuplot is not doing the right things, for example +# (e.g., look for *head.make). +# +# STANDARD AUXILIARY FILES: +# +# Variables.ini (formerly Makefile.ini, which still works) +# +# This file can contain variable declarations that override various +# aspects of the makefile. For example, one might specify +# +# neverclean := *.pdf *.ps +# onlysources.tex := main.tex +# LATEX_COLOR_WARNING := 'bold red uline' +# +# And this would override the neverclean setting to ensure that pdf +# and ps files always remain behind, set the makefile to treat all +# .tex files that are not "main.tex" as includes (and therefore not +# default targets). It also changes the LaTeX warning output to be +# red, bold, and underlined. +# +# There are numerous variables in this file that can be overridden in +# this way. Search for '?=' to find them all. +# +# The Variables.ini is imported before *anything else* is done, so go +# wild with your ideas for changes to this makefile in there. It +# makes it easy to test them before submitting patches. +# +# If you're adding rules or targets, however, see Targets.ini below. +# +# Targets.ini +# +# This is included much later in the makefile, after all variables and +# targets are defined. This is where you would put new make rules, +# e.g., +# +# generated.tex: generating_script.weird_lang depA depB +# ./generating_script.weird_lang > $$@ +# +# In this file, you have access to all of the variables that the +# makefile creates, like $(onlysources.tex). While accessing those can +# be somewhat brittle (they are implementation details and may change), +# it is a great way to test your ideas when submitting feature requests. +# +# STANDARD ENVIRONMENT VARIABLES: +# +# LATEX_COLOR_WARNING '$(LATEX_COLOR_WARNING)' +# LATEX_COLOR_ERROR '$(LATEX_COLOR_ERROR)' +# LATEX_COLOR_UNDERFULL '$(LATEX_COLOR_UNDERFULL)' +# LATEX_COLOR_OVERFULL '$(LATEX_COLOR_OVERFULL)' +# LATEX_COLOR_PAGES '$(LATEX_COLOR_PAGES)' +# LATEX_COLOR_BUILD '$(LATEX_COLOR_BUILD)' +# LATEX_COLOR_GRAPHIC '$(LATEX_COLOR_GRAPHIC)' +# LATEX_COLOR_DEP '$(LATEX_COLOR_DEP)' +# LATEX_COLOR_SUCCESS '$(LATEX_COLOR_SUCCESS)' +# LATEX_COLOR_FAILURE '$(LATEX_COLOR_FAILURE)' +# +# These may be redefined in your environment to be any of the following: +# +# black +# red +# green +# yellow +# blue +# magenta +# cyan +# white +# +# Bold or underline may be used, as well, either alone or in combination +# with colors: +# +# bold +# uline +# +# Order is not important. You may want, for example, to specify: +# +# export LATEX_COLOR_SUCCESS='bold blue uline' +# +# in your .bashrc file. I don't know why, but you may want to. +# +# STANDARD TARGETS: +# +# all: +# Make all possible documents in this directory. The documents are +# determined by scanning for .tex and .tex.sh (described in more detail +# later) and omitting any file that ends in ._include_.tex or +# ._nobuild_.tex. The output is a set of .pdf files. +# +# If you wish to omit files without naming them with the special +# underscore names, set the following near the top of the Makefile, +# or (this is recommended) within a Makefile.ini in the same directory: +# +# includes.tex := file1.tex file2.tex +# +# This will cause the files listed to be considered as include files. +# +# If you have only few source files, you can set +# +# onlysources.tex := main.tex +# +# This will cause only the source files listed to be considered in +# dependency detection. All other .tex files will be considered as +# include files. Note that these options work for *any* source type, +# so you could do something similar with includes.gpi, for example. +# Note that this works for *any valid source* target. All of the +# onlysources.* variables are commented out in the shipping version of +# this file, so it does the right thing when they simply don't exist. +# The comments are purely documentation. If you know, for example, that +# file.mycoolformat is supported by this Makefile, but don't see the +# "onlysources.mycoolformat" declared in the comments, that doesn't mean +# you can't use it. Go ahead and set "onlysources.mycoolformat" and it +# should do the right thing. +# +# show: +# Builds and displays all documents in this directory. It uses the +# environment-overridable value of VIEW_PDF (currently $(VIEW_PDF)) to +# do its work. +# +# all-graphics: +# Make all of the graphics in this directory. +# +# all-pstex (only for BUILD_STRATEGY=latex): +# Build all fig files into pstex and pstex_t files. Gray DOES NOT WORK. +# +# all-gray-pstex (only for BUILD_STRATEGY=latex): +# Build all fig files into grayscale pstex and pstex_t files. +# +# all-dot2tex: +# Build all dot files into tex files. +# +# show-graphics: +# Builds and displays all graphics in this directory. Uses the +# environment-overridable value of VIEW_GRAPHICS (currently +# $(VIEW_GRAPHICS)) to do its work. +# +# clean: +# Remove ALL generated files, leaving only source intact. +# This will *always* skip files mentioned in the "neverclean" variable, +# either in this file or specified in Makefile.ini: +# +# neverclean := *.pdf *.ps +# +# The neverclean variable works on all "clean" targets below, as well. +# +# clean-graphics: +# Remove all generated graphics files. +# +# clean-backups: +# Remove all backup files: $(backup_patterns) +# (XFig and other editors have a nasty habit of leaving them around) +# Also removes Makefile-generated .temp files +# +# clean-tex: +# Remove all files generated from LaTeX invocations except dependency +# information. Leaves graphics alone. +# +# clean-deps: +# Removes all auto-generated dependency information. +# +# clean-auxiliary: +# Removes extra files created by various targets (like the dependency +# graph output). +# +# clean-nographics: +# Cleans everything *except* the graphics files. +# +# help: +# This help text. +# +# version: +# Version information about this LaTeX makefile. +# +# DEBUG TARGETS: +# +# _all_programs: +# A list of the programs used by this makefile. +# +# _check_programs: +# Checks your system for the needed software and reports what it finds. +# +# _check_gpi_files: +# Checks the .gpi files in the current directory for common errors, such +# as specification of the terminal or output file inside of the gpi file +# itself. +# +# _dependency_graph: +# Outputs a .dot file to stdout that represents a graph of LaTeX +# dependencies. To see it, use the _show_dependency_graph target or +# direct the output to a file, run dot on it, and view the output, e.g.: +# +# make _dependency_graph > graph.dot +# dot -T ps -o graph.eps graph.dot +# gv graph.eps +# +# _show_dependency_graph: +# Makes viewing the graph simple: extracts, builds and displays the +# dependency graph given in the _dependency_graph target using the value +# of the environment-overridable VIEW_POSTSCRIPT variable (currently set +# to $(VIEW_POSTSCRIPT)). The postscript viewer is used because it +# makes it easier to zoom in on the graph, a critical ability for +# something so dense and mysterious. +# +# _all_sources: +# List all .tex files in this directory. +# +# _sources: +# Print out a list of all compilable sources in this directory. This is +# useful for determining what make thinks it will be using as the +# primary source for 'make all'. +# +# _scripts: +# Print out a list of scripts that make knows can be used to generate +# .tex files (described later). +# +# _all_stems: +# Print a list of stems. These represent bare targets that can be +# executed. Listing <stem> as a bare target will produce <stem>.pdf. +# +# _includes: +# A list of .d files that would be included in this run if _includes +# weren't specified. This target may be used alone or in conjunction +# with other targets. +# +# _graphic_outputs: +# A list of all generated .eps files +# +# _env: +# A list of environment variables and their values. If supported by +# your version of make, also a list of variables known to make. +# +# FILE TARGETS: +# +# %, %.pdf: +# Build a PDF file from the corresponding %.tex file. +# +# If BUILD_STRATEGY=pdflatex, then this builds the pdf directly. +# Otherwise, it uses this old-school but effective approach: +# +# latex -> dvips -> ps2pdf +# +# The BUILD_STRATEGY can be overridden in Makefile.ini in the same +# directory. The default is pdflatex. +# +# Reasons for using latex -> dvips include the "psfrag" package, and the +# generation of postscript instead of PDF. Arguments for using pdflatex +# include "new and shiny" and "better supported." I can't argue with +# either of those, and supporting them both didn't turn out to be that +# difficult, so there you have it. Choices. +# +# %._show: +# A phony target that builds the pdf file and then displays it using the +# environment-overridable value of VIEW_PDF ($(VIEW_PDF)). +# +# %._graphics: +# A phony target that generates all graphics on which %.pdf (or %.dvi) +# depends. +# +# %.ps (only for BUILD_STRATEGY=latex): +# Build a Postscript file from the corresponding %.tex file. +# This is done using dvips. Paper size is automatically +# extracted from the declaration +# +# \documentclass[<something>paper] +# +# or it is the system default. +# +# If using beamer (an excellent presentation class), the paper +# size is ignored. More on this later. +# +# %.dvi (only for BUILD_STRATEGY=latex): +# Build the DVI file from the corresponding %.tex file. +# +# %.ind: +# Build the index for this %.tex file. +# +# %.gls: +# Build the nomenclature glossary for this %.tex file. +# +# %.nls: +# Build the (newer) nomenclature file for this %.tex file. +# +# %.eps: +# Build an eps file from one of the following file types: +# +# .dot : graphviz +# .gpi : gnuplot +# .fig : xfig +# .xvg : xmgrace +# .svg : scalable vector graphics (goes through inkscape) +# .png : png (goes through NetPBM) +# .jpg : jpeg (goes through ImageMagick) +# .eps.gz : gzipped eps +# +# The behavior of this makefile with each type is described in +# its own section below. +# +# %.pstex{,_t} (only for BUILD_STRATEGY=latex): +# Build a .pstex_t file from a .fig file. +# +# FEATURES: +# +# Optional Binary Directory: +# If you create the _out_ directory in the same place as the makefile, +# it will automatically be used as a dumping ground for .pdf (or .dvi, +# .ps, and .pdf) output files. +# +# Alternatively, you can set the BINARY_TARGET_DIR variable, either as a +# make argument or in Makefile.ini, to point to your directory of +# choice. Note that no pathname wildcard expansion is done in the +# makefile, so make sure that the path is complete before going in +# there. E.g., if you want to specify something in your home directory, +# use $$HOME/ instead of ~/ so that the shell expands it before it gets +# to the makefile. +# +# External Program Dependencies: +# Every external program used by the makefile is represented by an +# ALLCAPS variable at the top of this file. This should allow you to +# make judgments about whether your system supports the use of this +# makefile. The list is available in the ALL_PROGRAMS variable and, +# provided that you are using GNU make 3.80 or later (or you haven't +# renamed this file to something weird like "mylatexmakefile" and like +# invoking it with make -f) can be viewed using +# +# make _all_programs +# +# Additionally, the availability of these programs can be checked +# automatically for you by running +# +# make _check_programs +# +# The programs are categorized according to how important they are and +# what function they perform to help you decide which ones you really +# need. +# +# Colorized Output: +# The output of commands is colorized to highlight things that are often +# important to developers. This includes {underfull,overfull} +# {h,v}boxes, general LaTeX Errors, each stage of document building, and +# the number of pages in the final document. The colors are obtained +# using 'tput', so colorization should work pretty well on any terminal. +# +# The colors can be customized very simply by setting any of the +# LATEX_COLOR_<CONTEXT> variables in your environment (see above). +# +# Predecessors to TeX Files: +# Given a target <target>, if no <target>.tex file exists but a +# corresponding script or predecessor file exists, then appropriate +# action will be taken to generate the tex file. +# +# Currently supported script or predecessor languages are: +# +# sh: %.tex.sh +# perl: %.tex.pl +# python: %.tex.py +# +# Calls the script using the appropriate interpreter, assuming that +# its output is a .tex file. +# +# The script is called thus: +# +# <interpreter> <script file name> <target tex file> +# +# and therefore sees exactly one parameter: the name of the .tex +# file that it is to create. +# +# Why does this feature exist? I ran into this while working on +# my paper dissertation. I wrote a huge bash script that used a +# lot of sed to bring together existing papers in LaTeX. It +# would have been nice had I had something like this to make my +# life easier, since as it stands I have to run the script and +# then build the document with make. This feature provides hooks +# for complicated stuff that you may want to do, but that I have +# not considered. It should work fine with included dependencies, +# too. +# +# Scripts are run every time make is invoked. Some trickery is +# employed to make sure that multiple restarts of make don't cause +# them to be run again. +# +# reST: %.rst +# +# Runs the reST to LaTeX converter to generate a .tex file +# If it finds a file names _rststyle_._include_.tex, uses it as +# the "stylesheet" option to rst2latex. +# +# Note that this does not track sub-dependencies in rst files. It +# assumes that the top-level rst file will change if you want a +# rebuild. +# +# Dependencies: +# +# In general, dependencies are extracted directly from LaTeX output on +# your document. This includes +# +# * Bibliography information +# * \include or \input files (honoring \includeonly, too) +# * Graphics files inserted by the graphicx package +# +# Where possible, all of these are built correctly and automatically. +# In the case of graphics files, these are generated from the following +# file types: +# +# GraphViz: .dot +# GNUPlot: .gpi +# XFig: .fig +# XMgrace: .xvg +# SVG: .svg +# PNG: .png +# JPEG: .jpg +# GZipped EPS: .eps.gz +# +# If the file exists as a .eps already, it is merely used (and will not +# be deleted by 'clean'!). +# +# LaTeX and BibTeX are invoked correctly and the "Rerun to get +# cross-references right" warning is heeded a reasonable number of +# times. In my experience this is enough for even the most troublesome +# documents, but it can be easily changed (if LaTeX has to be run after +# BibTeX more than three times, it is likely that something is moving +# back and forth between pages, and no amount of LaTeXing will fix +# that). +# +# \includeonly is honored by this system, so files that are not +# specified there will not trigger a rebuild when changed. +# +# Beamer: +# A special TeX source comment is recognized by this makefile (only when +# BUILD_STRATEGY=latex, since this invokes psnup): +# +# %%[[:space:]]*BEAMER[[:space:]]*LARGE +# +# The presence of this comment forces the output of dvips through psnup +# to enlarge beamer slides to take up an entire letter-sized page. This +# is particularly useful when printing transparencies or paper versions +# of the slides. For some reason landscape orientation doesn't appear +# to work, though. +# +# If you want to put multiple slides on a page, use this option and then +# print using mpage, a2ps, or psnup to consolidate slides. My personal +# favorite is a2ps, but your mileage may vary. +# +# When beamer is the document class, dvips does NOT receive a paper size +# command line attribute, since beamer does special things with sizes. +# +# GNUPlot Graphics: +# When creating a .gpi file, DO NOT INCLUDE the "set terminal" or "set +# output" commands! The makefile will include terminal information for +# you. Besides being unnecessary and potentially harmful, including the +# terminal definition in the .gpi file makes it harder for you, the one +# writing the document, to preview your graphics, e.g., with +# +# gnuplot -persist myfile.gpi +# +# so don't do specify a terminal or an output file in your .gpi files. +# +# When building a gpi file into an eps file, there are several features +# available to the document designer: +# +# Global Header: +# The makefile searches for the files in the variable GNUPLOT_GLOBAL +# in order: +# +# ($(GNUPLOT_GLOBAL)) +# +# Only the first found is used. All .gpi files in the directory are +# treated as though the contents of GNUPLOT_GLOBAL were directly +# included at the top of the file. +# +# NOTE: This includes special comments! (see below) +# +# Font Size: +# A special comment in a .gpi file (or a globally included file) of +# the form +# +# ## FONTSIZE=<number> +# +# will change the font size of the GPI output. If font size is +# specified in both the global file and the GPI file, the +# specification in the individual GPI file is used. +# +# Grayscale Output: +# GNUplot files also support a special comment to force them to be +# output in grayscale *no matter what*: +# +# ## GRAY +# +# This is not generally advisable, since you can always create a +# grayscale document using the forms mentioned above. But, if your +# plot simply must be grayscale even in a document that allows +# colors, this is how you do it. +# +# XFig Graphics: +# No special handling is done with XFig, except when a global +# grayscale method is used, e.g. +# +# make GRAY=1 document +# +# In these cases the .eps files is created using the -N switch to +# fig2dev to turn off color output. (Only works with eps, not pstex +# output) +# +# GraphVis Graphics: +# Color settings are simply ignored here. The 'dot' program is used +# to transform a .dot file into a .eps file. +# +# If you want, you can use the dot2tex program to convert dot files +# to tex graphics. The default is to just call dot2tex with no +# arguments, but you can change the DOT2TEX definition to include +# options as needed (in your Makefile.ini). +# +# Note that, as with pstex, the makefile cannot use latex's own +# output to discover all missing dot_t (output) files, since anytime +# TeX includes TeX, it has to bail when it can't find the include +# file. It can therefore only stop on the first missing file it +# discovers, and we can't get a large list of them out easily. +# +# So, the makefile errors out if it's missing an included dot_t +# file, then prompts the user to run this command manually: +# +# make all-dot2tex +# +# GZipped EPS Graphics: +# +# A .eps.gz file is sometimes a nice thing to have. EPS files can get +# very large, especially when created from bitmaps (don't do this if you +# don't have to). This makefile will unzip them (not in place) to +# create the appropriate EPS file. +# +# +endef + +# +# DEPENDENCY CHART: +# +# digraph "g" { +# rankdir=TB +# size="9,9" +# edge [fontsize=12 weight=10] +# node [shape=box fontsize=14 style=rounded] +# +# eps [ +# shape=Mrecord +# label="{{<gpi> GNUplot|<epsgz> GZip|<dot> Dot|<fig> XFig}|<eps> eps}" +# ] +# pstex [label="%.pstex"] +# pstex_t [label="%.pstex_t"] +# tex_outputs [shape=point] +# extra_tex_files [shape=point] +# gpi_data [label="<data>"] +# gpi_includes [label="_include_.gpi"] +# aux [label="%.aux"] +# fls [label="%.fls"] +# idx [label="%.idx"] +# glo [label="%.glo"] +# ind [label="%.ind"] +# log [label="%.log"] +# tex_sh [label="%.tex.sh"] +# rst [label="%.rst"] +# tex [ +# shape=record +# label="<tex> %.tex|<include> _include_.tex" +# ] +# include_aux [label="_include_.aux"] +# file_bib [label=".bib"] +# bbl [label="%.bbl"] +# dvi [label="%.dvi"] +# ps [label="%.ps"] +# pdf [label="%.pdf"] +# fig [label=".fig"] +# dot [label=".dot"] +# gpi [label=".gpi"] +# eps_gz [label=".eps.gz"] +# +# gpi_files [shape=point] +# +# rst -> tex:tex [label="reST"] +# tex_sh -> tex:tex [label="sh"] +# tex_pl -> tex:tex [label="perl"] +# tex_py -> tex:tex [label="python"] +# tex -> tex_outputs [label="latex"] +# tex_outputs -> dvi +# tex_outputs -> aux +# tex_outputs -> log +# tex_outputs -> fls +# tex_outputs -> idx +# tex_outputs -> include_aux +# aux -> bbl [label="bibtex"] +# file_bib -> bbl [label="bibtex"] +# idx -> ind [label="makeindex"] +# glo -> gls [label="makeindex"] +# nlo -> nls [label="makeindex"] +# gls -> extra_tex_files +# nls -> extra_tex_files +# ind -> extra_tex_files +# bbl -> extra_tex_files +# eps -> extra_tex_files +# extra_tex_files -> dvi [label="latex"] +# gpi_files -> eps:gpi [label="gnuplot"] +# gpi -> gpi_files +# gpi_data -> gpi_files +# gpi_includes -> gpi_files +# eps_gz -> eps:epsgz [label="gunzip"] +# fig -> eps:fig [label="fig2dev"] +# fig -> pstex [label="fig2dev"] +# fig -> pstex_t [label="fig2dev"] +# pstex -> pstex_t [label="fig2dev"] +# dot -> eps:dot [label="dot"] +# dvi -> ps [label="dvips"] +# include_aux -> bbl [label="bibtex"] +# ps -> pdf [label="ps2pdf"] +# +# edge [ color=blue label="" style=dotted weight=1 fontcolor=blue] +# fls -> tex:include [label="INPUT: *.tex"] +# fls -> file_bib [label="INPUT: *.aux"] +# aux -> file_bib [label="\\bibdata{...}"] +# include_aux -> file_bib [label="\\bibdata{...}"] +# log -> gpi [label="Graphic file"] +# log -> fig [label="Graphic file"] +# log -> eps_gz [label="Graphic file"] +# log -> dot [label="Graphic file"] +# log -> idx [label="No file *.ind"] +# log -> glo [label="No file *.gls"] +# log -> nlo [label="No file *.nls"] +# gpi -> gpi_data [label="plot '...'"] +# gpi -> gpi_includes [label="load '...'"] +# tex:tex -> ps [label="paper"] +# tex:tex -> pdf [label="embedding"] +# } +# + +# +# DEPENDENCY CHART SCRIPT +# +# $(call output_dependency_graph,[<output file>]) +define output-dependency-graph + if [ -f '$(this_file)' ]; then \ + $(SED) \ + -e '/^[[:space:]]*#[[:space:]]*DEPENDENCY CHART:/,/^$$/!d' \ + -e '/DEPENDENCY CHART/d' \ + -e '/^$$/d' \ + -e 's/^[[:space:]]*#//' \ + $(this_file) $(if $1,> '$1',); \ + else \ + $(ECHO) "Cannot determine the name of this makefile."; \ + fi +endef +# +.PHONY: Targets.ini $(HOME)/.latex-makefile/Targets.ini +-include Targets.ini +-include $(HOME)/.latex-makefile/Targets.ini +# +# vim: noet sts=0 sw=8 ts=8 + diff --git a/2012/pluggable-roadmap/Targets.ini b/2012/pluggable-roadmap/Targets.ini new file mode 100644 index 0000000..1466882 --- /dev/null +++ b/2012/pluggable-roadmap/Targets.ini @@ -0,0 +1,4 @@ +pluggable-roadmap.d: vc._include_.tex + +vc._include_.tex: vc pluggable-roadmap.tex pluggable-roadmap.bib + ./vc -m && mv vc.tex $@ diff --git a/2012/pluggable-roadmap/easychair.cls b/2012/pluggable-roadmap/easychair.cls new file mode 100755 index 0000000..47e0ee3 --- /dev/null +++ b/2012/pluggable-roadmap/easychair.cls @@ -0,0 +1,756 @@ +% +% Some credits +% + +\def\easychairstyleauthor{easychair class style, by Serguei A. Mokhov, with changes by Andrei Voronkov <24 October 2011>} +\def\easychairstylerevision{CVS Revision: $Id: easychair.cls,v 3.0 2011/10/24 20:26:32 voronkov Exp $} +\def\easychairstylepurpose{Designed for EasyChair.org, under guidelines and suggestions of} +\def\easychairstylevoronkov{\space\space\space\space\space\space\space\space\space\space\space\space\space Andrei Voronkov <www.voronkov.com>, and} +\def\easychairstylesutcliffe{\space\space\space\space\space\space\space\space\space\space\space\space\space Geoff Sutcliffe <www.cs.miami.edu/^geoff>} +\def\easychairstylecopyright{Copyright terms are that of EasyChair.org} +\def\easychairstylebugs{For bug reports, please contact <andrei(a)voronkov.com>} + +\everyjob{\typeout{\easychairstyleauthor}} +\everyjob{\typeout{\easychairstylerevision}} +\everyjob{\typeout{\easychairstylepurpose}} +\everyjob{\typeout{\easychairstylevoronkov}} +\everyjob{\typeout{\easychairstylesutcliffe}} +\everyjob{\typeout{\easychairstylecopyright}} +\everyjob{\typeout{\easychairstylebugs}} + +\immediate\write10{\easychairstyleauthor} +\immediate\write10{\easychairstylerevision} +\immediate\write10{\easychairstylepurpose} +\immediate\write10{\easychairstylevoronkov} +\immediate\write10{\easychairstylesutcliffe} +\immediate\write10{\easychairstylecopyright} +\immediate\write10{\easychairstylebugs} + +% +% Require LaTeX 2.09 or later +% + +\NeedsTeXFormat{LaTeX2e}[1995/12/01] +\ProvidesClass{easychair}[2011/05/02 v3.0] +\def\@tempa#1#2\@nil{\edef\@classname{#1}} +\expandafter\@tempa\@currnamestack{}{}{}\@nil +\ifx\@classname\@empty \edef\@classname{\@currname}\fi + + +% +% Debug +% + +\def\easychairdebug#1{\gdef\@EasyDebug{#1}} +\def\@EasyDebug{} + +\newif\ifdebug +\debugfalse + +\DeclareOption{debug}{\debugtrue} + +\def\easychairframe#1{\gdef\@EasyFrame{#1}} +\def\@EasyFrame{} + +\newif\ifframe +\framefalse + +\DeclareOption{frame}{\frametrue} + +\def\easychairverbose#1{\gdef\@EasyVerbose{#1}} +\def\@EasyVerbose{} + +\newif\ifverbose +\verbosefalse + +\DeclareOption{verbose}{\verbosetrue} + + +% +% Thesis +% Perh Geoff, February 23, 2010 with support from Andrei +% + +\def\easythesis#1{\gdef\@EasyThesis{#1}} +\def\@EasyThesis{} + +\newif\ifthesis +\thesisfalse + +\DeclareOption{thesis}{\thesistrue} + + +% +% Times New Roman or not +% + +\def\easytimes#1{\gdef\@EasyTimes{#1}} +\def\@EasyTimes{} + +\newif\ifnotimes +\notimesfalse + +\DeclareOption{notimes}{\notimestrue} + +\newif\ifwithtimes +\withtimesfalse + +\DeclareOption{withtimes}{\withtimestrue} + + +\newif\ifauthorundefined +\authorundefinedtrue + +\let\oldauthor=\author +\renewcommand + {\author} + [1] + {% + \ifauthorundefined + \oldauthor{#1} + \authorundefinedfalse + \else + \PackageWarning{easychair}{Another use of author ignored} + \fi + } + +\newif\iftitleundefined +\titleundefinedtrue + +\let\oldtitle=\title +\renewcommand + {\title} + [1] + { + \iftitleundefined + \oldtitle{#1} + \titleundefinedfalse + \else + \PackageWarning{easychair}{Another use of title ignored} + \fi + } + + +% +% Running heads definitions +% + +%\def\titlerunning#1{\gdef\@titleRunning{#1}} +%\def\authorrunning#1{\gdef\@authorRunning{#1}} +%\titlerunning{easychair: Running title head is undefined.} +%\authorrunning{easychair: Running author head is undefined.} + +\newif\iftitlerunningundefined +\titlerunningundefinedtrue + +\newif\ifauthorrunningundefined +\authorrunningundefinedtrue + +\gdef\@titleRunning{easychair: Running title head is undefined.} +\gdef\@authorRunning{easychair: Running author head is undefined.} + +\def\titlerunning#1 +{ + \iftitlerunningundefined + \gdef\@titleRunning{#1} + \titlerunningundefinedfalse + \else + \PackageWarning{easychair}{Another use of titlerunning ignored} + \fi +} + +\def\authorrunning#1 +{ + \ifauthorrunningundefined + \gdef\@authorRunning{#1} + \authorrunningundefinedfalse + \else + \PackageWarning{easychair}{Another use of authorrunning ignored} + \fi +} + +% +% Affiliations +% + +\newcommand{\affiliation}[1]{\small{#1}\vspace{-3pt}} + + +% +% Decide between letter and A4 paper formats +% as well as orientation +% + +% Default is 'letterpaper' +\def\paperformat#1{\gdef\@PaperFormat{#1}} +\def\@PaperFormat{letterpaper} + +\newif\ifletterpaper +\newif\ifafourpaper +\newif\ifcustompaper + +\letterpapertrue + +\DeclareOption{letterpaper}{\paperformat{letterpaper}\afourpaperfalse\custompaperfalse} +\DeclareOption{a4paper}{\paperformat{a4paper}\afourpapertrue\letterpaperfalse\custompaperfalse} +\DeclareOption{custompaper}{\paperformat{letterpaper}\afourpaperfalse\letterpaperfalse\custompapertrue} + + +\newlength{\@LMarginSize} +\newlength{\@RMarginSize} +\newlength{\@TMarginSize} +\newlength{\@BMarginSize} + +\DeclareOption{lmargin}{} +\DeclareOption{rmargin}{} +\DeclareOption{tmargin}{} +\DeclareOption{bmargin}{} + + +% Default is portrait {} +\def\paperorientation#1{\gdef\@PaperOrientation{#1}} +\def\@PaperOrientation{} + +\DeclareOption{portrait}{\paperorientation{}} +\DeclareOption{landscape}{\paperorientation{landscape}} + +% Two sided running heads for titlerunning and author running +% twosided is the default +\newif\iftwosided +\twosidedfalse + +\DeclareOption{onesided}{} +\DeclareOption{twosided}{\twosidedtrue} + + +% +% Decide between 1- or 2-column formats +% + +\def\columnCount#1{\gdef\@ColumnCount{#1}} +\def\@ColumnCount{onecolumn} + +\DeclareOption{onecolumn}{} +\DeclareOption{twocolumn}{\columnCount{twocolumn}} + + +% +% Decide on line spacing +% + +\def\lineSpacing#1{\gdef\@LineSpacing{#1}} +\def\(a)LineSpacing{1.0} + +\DeclareOption{zerospacing}{\lineSpacing{0.0}} +\DeclareOption{singlespacing}{\lineSpacing{1.0}} +\DeclareOption{lineandhalfspacing}{\lineSpacing{1.5}} +\DeclareOption{doublespacing}{\lineSpacing{2.0}} + +\DeclareOption{0.0}{\lineSpacing{0.0}} +\DeclareOption{1.0}{\lineSpacing{1.0}} +\DeclareOption{1.5}{\lineSpacing{1.5}} +\DeclareOption{2.0}{\lineSpacing{2.0}} + +\DeclareOption{0.0pt}{\lineSpacing{0.0}} +\DeclareOption{1.0pt}{\lineSpacing{1.0}} +\DeclareOption{1.5pt}{\lineSpacing{1.5}} +\DeclareOption{2.0pt}{\lineSpacing{2.0}} + + +% +% Font point size; default is 10pt +% +% The \headheight will have to be changed later accordingly +% such that fancyhdr does not complain it is too small. +% + +\def\baseFontSize#1{\gdef\@BaseFontSize{#1}} +\def\headHeightSize#1{\gdef\@HeadHeightSize{#1}} +\def\headSepSize#1{\gdef\@HeadSepSize{#1}} +\def\footSkipSize#1{\gdef\@FootSkipSize{#1}} + +\def\@BaseFontSize{10pt} +\def\(a)HeadHeightSize{12.0pt} +\def\(a)HeadSepSize{16.0pt} % instead of the default 25pt +\def\(a)FootSkipSize{26.0pt} % instead of the default 30pt + +\DeclareOption{8pt}{\PackageWarning{easychair}{Option '\CurrentOption' is not supported.}} +\DeclareOption{9pt}{\PackageWarning{easychair}{Option '\CurrentOption' is not supported.}} +\DeclareOption{10pt}{\baseFontSize{10pt}\headHeightSize{12.0pt}\headSepSize{16.0pt}\footSkipSize{26pt}} +\DeclareOption{11pt}{\baseFontSize{11pt}\headHeightSize{13.6pt}\headSepSize{23.0pt}\footSkipSize{28pt}} +\DeclareOption{12pt}{\baseFontSize{12pt}\headHeightSize{14.5pt}\headSepSize{25.0pt}\footSkipSize{30pt}} +\ExecuteOptions{10pt} + +% +% Page sizing +% + +%\newif\iffullpage +%\newif\ifsavetrees +% +%\DeclareOption{fullpage}{\fullpagetrue} +%\DeclareOption{savetrees}{\savetreestrue} + + +% Bark at any unknown package option +\DeclareOption*{\PackageWarning{easychair}{Unknown option '\CurrentOption'}} +\DeclareOption*{\PassOptionsToPackage{\CurrentOption}{geometry}} +%\DeclareOption*{\PassOptionsToClass{\CurrentOption}{article}} + +%\ExecuteOptions{centertags,portrait,10pt,twoside,onecolumn,final} +%\ExecuteOptions{} +\ProcessOptions\relax + + +% +% Required packages and classes. +% +% All must be standard as per most common LaTeX +% distributions. +% + +\ifthesis + \LoadClass[\@PaperFormat,\@PaperOrientation,\@ColumnCount,\@BaseFontSize,twoside]{report} + \RequirePackage{makeidx} +\else + % We are an article (more customized later) + \LoadClass[\@PaperFormat,\@PaperOrientation,\@ColumnCount,\@BaseFontSize,twoside]{article} + %\LoadClass[\@PaperFormat,\@PaperOrientation,\@ColumnCount,\@BaseFontSize]{article} +\fi + +% Require UTF8 encoding, per Andrei Voronkov, to accomodate +% all sorts of author names. +\RequirePackage[utf8]{inputenc} + +% All \urls will be hyperlinked and will deal properly with special characters +% XXX: url is included by hyperref +%\RequirePackage{url} + +% To ensure the footnotes are always at the bottom. +% IMPORTANT: footmisc should precede hyperref for the footnotes to hyperlink +% correctly to their pages where they are at instead of always at +% page 1. Per bug reports from a couple of users and a suggestion by +% Uwe Pfeiffer. +\RequirePackage[bottom]{footmisc} + +%% TOC/thumbnail LHS preview in the PDFs as well as active URLs and other cross-refs +%% Newer versions of hyperref declare a4paper or letterpaper as obsolete and issue warnings +%%\RequirePackage[\(a)PaperFormat,pdfcreator=easychair.cls-2.0]{hyperref} +%\RequirePackage[linktocpage,pdfcreator=easychair.cls-2.0-Beta-3]{hyperref} + +% Traditional graphics processing +\RequirePackage{graphicx} +%\RequirePackage{pdflscape} +%\RequirePackage{lscape} + + +%% Fonts, generally more compact but preserving point size + +% Pick "Times Roman" as a base font unless explicitly told not to +\ifnotimes + \ifwithtimes + \PackageWarning{easychair}{Cannot really use 'notimes' and 'withtimes' together} + \PackageWarning{easychair}{Defaulting to 'notimes'...} + \else + \PackageWarning{easychair}{'notimes' has been deprecated as it is the default in 2.0} + \fi +\else + \ifwithtimes + \RequirePackage{mathptmx} + \fi +\fi + +% Pick "Helvetica" as a "Sans-Serif" font +\RequirePackage[scaled=.85]{helvet} + +% For algorithm and source code listings +\RequirePackage{listings} + +%% Different Math and non-Math symbols and definitions + +\RequirePackage{latexsym} +\RequirePackage{amsthm} +\RequirePackage{empheq} + + +%% Line spacing to be applied AFTER the above space saving packages + +\renewcommand{\baselinestretch}{\@LineSpacing} + +%% Final text printing area, per Geoff Sutcliffe + +\RequirePackage{keyval} + +\define@key{Ec}{lmargin}{\Ec@defbylen{lmargin}{#1}} + +\newlength{\@MarginSize} +\setlength{\@MarginSize}{1in} + +\setlength{\@LMarginSize}{\@MarginSize} +%\setlength{\@LMarginSize}{\Ec@lmargin} +\setlength{\@RMarginSize}{\@MarginSize} +\setlength{\@TMarginSize}{\@MarginSize} +\setlength{\@BMarginSize}{\@MarginSize} + + +% Head height is dependent on the font point size +\setlength{\headheight}{\@HeadHeightSize} +\setlength{\headsep}{\@HeadSepSize} +\setlength{\footskip}{\@FootSkipSize} + +\ifletterpaper + \immediate\write10{easychair: Selecting letter paper margin sizes.} + \RequirePackage[% + papersize={8.5in,11in}, + total={145mm,224mm}, + centering, + twoside, + includeheadfoot]{geometry} +\fi +\ifafourpaper + \immediate\write10{easychair: Selecting A4 paper margin sizes.} + \RequirePackage[% + papersize={210mm,297mm}, + total={145mm,224mm}, + centering, + twoside, + includeheadfoot]{geometry} +\fi + +\ifcustompaper + \immediate\write10{easychair: Selecting custom paper margin sizes.} + \RequirePackage[% + papersize={189mm,246mm}, + total={145mm,224mm}, + top=9mm, + left=24mm, + twoside, + includeheadfoot]{geometry} + \headHeightSize{12.0pt} + \headSepSize{16.0pt} + \footSkipSize{26pt} +\fi + +%\setlength{\textwidth}{16cm} +%\setlength{\textheight}{9in} + + +% +% Volume +% + +\RequirePackage{lastpage} + +\newif\ifvolumeundefined +\volumeundefinedtrue + +% e.g. +% \volumeinfo +% {J. Bloe} % editor(s) #1 +% {1} % No. of editors #2 +% {LICS 2008} % event title #3 +% {1} % volume number #4 +% {4} % issue #5 +% {134} % start page #6 + +\def\@EasyFontStyle{\footnotesize} +\newcommand{\headfootstyle}[1]{\def\@EasyFontStyle{#1}} + +\def\@EasyVolumeInfo{} + +\ifthesis + \newcommand{\volumeinfo}[6] + {\PackageWarning{easychair}{Cannot use volumeinfo with 'thesis' option. Ignoring...}} +\else + \newcommand{\volumeinfo}[6]{% + \ifvolumeundefined + % \def\@makefntext##1{\noindent ##1}% + \def\@EasyEdsNames{#1}% + \def\(a)EasyEds{ed.}% + \def\@EasyEvent{#3}% + \def\@EasyVolume{}% + \def\@EasyIssue{}% + \def\@EasyFirstPage{#6}% + \ifnum #2>1 \gdef\(a)EasyEds{eds.}\fi% + \ifnum #4>0 \gdef\@EasyVolume{; Volume #4}\fi% + \ifnum #5>0 \gdef\@EasyIssue{, issue: #5} \fi% + % \footnotetext[0]{\sf \@EasyEdsNames (\@EasyEds); \@EasyEvent\@EasyVolume\@EasyIssue, pp. #6-\pageref{LastPage}}% + % \def\@EasyVolumeInfo{\footnotesize{\sf\@EasyEdsNames~(\@EasyEds); \@EasyEvent\@EasyVolume\@EasyIssue, pp. \@EasyFirstPage--\pageref{LastPage}}}% + \def\@EasyVolumeInfo{\@EasyFontStyle\@EasyEdsNames~(\@EasyEds); \@EasyEvent\@EasyVolume\@EasyIssue, pp. \@EasyFirstPage--\pageref{LastPage}}% + %\def\@makefntext##1{\noindent\@makefnmark##1}% + \setcounter{page}{\@EasyFirstPage} + \volumeundefinedfalse + \else + {\PackageWarning{easychair}{May not redefine volumeinfo}} + \fi + } +\fi + +\def\@EventInfo{} +\def\@VolumeInfo{} + +\newif\ifvolumeecpsundefined +\volumeecpsundefinedtrue + +\newcommand{\volumeinfoECPS}[2]{% + \ifvolumeecpsundefined + \def\@EventInfo{#1}% + \def\@VolumeInfo{#2}% + \volumeecpsundefinedfalse + \else + {\PackageWarning{easychair}{Ignoring another definition of volumeinfoECPS}} + \fi +} + + +% +% Allow for more space to place floats. +% + +\renewcommand{\topfraction}{0.95} +\renewcommand{\bottomfraction}{0.95} +\renewcommand{\textfraction}{0.05} +\renewcommand{\floatpagefraction}{0.8} + + +% +% Running heads and ``foots'' +% + +\RequirePackage{fancyhdr} +\pagestyle{fancy} + +\fancyhead{} +%\ifdebug +% \iftwosided +% \fancyhead[RE]{\overline{\@titleRunning}} +% \fancyhead[RO]{\overline{\@authorRunning}} +% \else +% \fancyhead[LO,LE]{\begin{math}\overline{\mbox{\@titleRunning}}\end{math}} +% \fancyhead[RO,RE]{\begin{math}\overline{\mbox{\@authorRunning}}\end{math}} +% \fi +%\else + \iftwosided + \fancyhead[RE]{{\@EasyFontStyle\@titleRunning}} + \fancyhead[RO]{{\@EasyFontStyle\@authorRunning}} + \else + \fancyhead[LO,LE]{{\@EasyFontStyle\@titleRunning}} + \fancyhead[RO,RE]{{\@EasyFontStyle\@authorRunning}} + \fi +%\fi + +\fancyfoot{} +%\ifdebug +% \fancyfoot[CO,CE]{\underline{\thepage}} +% \renewcommand{\headrulewidth}{1pt} +% \renewcommand{\footrulewidth}{1pt} +%\else +% \fancyfoot[CO,CE]{\thepage} +% \fancyfoot[LO]{{\footnotesize{\sf\@EventInfo}}} +% \fancyfoot[LE]{{\footnotesize{\sf\@VolumeInfo}}} +% \fancyfoot[LO]{{\@EasyFontStyle\@EventInfo}} +% \fancyfoot[LE]{{\@EasyFontStyle\@VolumeInfo}} +\ifodd\c@page + \fancyfoot[LO]{{\@EasyFontStyle\@VolumeInfo}} + \fancyfoot[RE]{{\@EasyFontStyle\@EventInfo}} +\else + \fancyfoot[RE]{{\@EasyFontStyle\@VolumeInfo}} + \fancyfoot[LO]{{\@EasyFontStyle\@EventInfo}} +\fi +% \fancyfoot[LO,LE] +% { +%\volumeinfoECPS +% {A. Editor, B. Editor} % editors +% {2} % number of editors +% {EVENT, Month YEAR} % event +% {1} % volume +% } +% \fancyfoot[RO,RE]{{\@EasyFontStyle\thepage}} +% \fancyfoot[RO]{{\@EasyFontStyle\thepage}} +% \fancyfoot[LE]{{\@EasyFontStyle\thepage}} +\ifodd\c@page + \fancyfoot[RO]{{\normalsize\thepage}} + \fancyfoot[LE]{{\normalsize\thepage}} +\else + \fancyfoot[LE]{{\normalsize\thepage}} + \fancyfoot[RO]{{\normalsize\thepage}} +\fi + \renewcommand{\headrulewidth}{0pt} + \renewcommand{\footrulewidth}{0pt} +%\fi + +% Suppress the default date, per Geoff +\date{} + +% For the first page +\fancypagestyle{plain}{% +\fancyhf{} % clear all header and footer fields +\ifodd\c@page + \fancyfoot[L]{\@EasyVolumeInfo}% + \fancyfoot[R]{{\normalsize\thepage}} % except the center +\else + \fancyfoot[R]{\@EasyVolumeInfo}% + \fancyfoot[L]{{\normalsize\thepage}} % except the center +\fi +\renewcommand{\headrulewidth}{0pt} +\renewcommand{\footrulewidth}{0pt}} + + +\let\oldmaketitle=\maketitle +\def\@maketitle{% + \newpage + \null + % Facelift a bit the title and make it bold, per Geoff + \vspace{-1cm} + \begin{center}% + \let\footnote\thanks% + % Do not bold Times title, per Geoff + \ifwithtimes + {\LARGE{\@title}\par} + \else + {\LARGE{\bf \@title}\par} + \fi + \vskip 0.5\baselineskip + \begin{tabular}[t]{c}% + \@author + \end{tabular}\par + \@date + \end{center}% + %\volumeinfoECPS{\@EventInfo}{\@VolumeInfo} + %\titlerunning{EMPTY}% + %\authorrunning{EMPTY}% + %\authorrunning{\@authorRunning}% + %\renewcommand{\titlerunning}[1]{} + %\renewcommand{\authorrunning}[1]{} + %%\renewcommand{\volumeinfoECPS}[2]{}% + %%\renewcommand{\volumeinfo}[6]{} + %\gdef\@authorRunning{Gooo\@authorRunning}% + %\gdef\@EasyVolumeInfo{Foo\@authorRunning}% + %\gdef\@EventInfo{} + %\gdef\@VolumeInfo{} +%\volumeinfo + %{NNNNOT A. Voronkov} % editors + %{1} % number of editors + %{NYO-YO} % event + %{44} % volume + %{1} % issue + %{45} % starting page number +%\volumeinfoECPS + %{NNNNOT Super EasyChair Workshop Proceedings} + %{NNNNOT ECPS vol. 43} + \par + %\relax +} + + +% TOC/thumbnail LHS preview in the PDFs as well as active URLs and other cross-refs +% Newer versions of hyperref declare a4paper or letterpaper as obsolete and issue warnings +\RequirePackage[linktocpage,pdfcreator=easychair.cls-3.0]{hyperref} + + +% Tighten up bibliography +\let\oldthebibliography=\thebibliography +\let\endoldthebibliography=\endthebibliography +\renewenvironment{thebibliography}[1] +{ + \small + \begin{oldthebibliography}{#1} + \setlength{\parskip}{2pt} + \setlength{\itemsep}{0pt} +} +{ + \end{oldthebibliography} +} + +\ifdebug + \ifverbose + \RequirePackage[colorgrid,pscoord]{eso-pic}% + \else + \RequirePackage[pscoord]{eso-pic} + \newcommand\ShowFramePicture{% + \begingroup + \color{red} + \AtTextLowerLeft{\framebox(\LenToUnit{\textwidth},\LenToUnit{\textheight}){}}% + \AtTextUpperLeft{\put(0,\LenToUnit{\headsep}){\framebox(\LenToUnit{\textwidth},\LenToUnit{\headheight}){}}}% + \AtTextLowerLeft{\put(0,\LenToUnit{-\footskip}){\framebox(\LenToUnit{\textwidth},\LenToUnit{\headheight}){}}}% + \endgroup + } + \AddToShipoutPicture{\ShowFramePicture} + \fi + %\RequirePackage[a4,cam,center]{crop}% + %\RequirePackage[cam,center]{crop}% +\fi + +\ifframe + \ifverbose + \RequirePackage[colorgrid,pscoord]{eso-pic}% + \else + \RequirePackage[pscoord]{eso-pic} + \newcommand\ShowBlueFrame{% + \begingroup + \color{blue} + % odd page +% \AtTextLowerLeft{\put(\LenToUnit{-23.6mm},\LenToUnit{-21.8mm}){\framebox(\LenToUnit{188.3mm},\LenToUnit{245.4mm}){}}}% + % even page +% \AtTextLowerLeft{\put(\LenToUnit{-19.6mm},\LenToUnit{-21.8mm}){\framebox(\LenToUnit{188.3mm},\LenToUnit{245.4mm}){}}}% + \endgroup + } + \AddToShipoutPicture{\ShowBlueFrame} + \fi +\fi + +% \geometry{papersize={170mm,240mm},total={124mm,185mm}} + +%% Indexing options for proceedings to link up people's names to their +%% various participation and affiliation options. + +\newcommand + {\indexedperson} + [3] + {\index{#2!#1}\index{#1}\index{#1!#3}} + +\newcommand + {\indexedauthor} + [1] + {\indexedperson{#1}{Authors}{Author}} + +\newcommand + {\indexededitor} + [1] + {\indexedperson{#1}{Editors}{Editor}} + +\newcommand + {\indexedpcmember} + [1] + {\indexedperson{#1}{PC Members}{PC Member}} + +\newcommand + {\indexedreviewer} + [1] + {\indexedperson{#1}{Reviewers}{Reviewer}} + +\newcommand + {\indexedorganizer} + [1] + {\indexedperson{#1}{Organizers}{Organizer}} + +\newcommand + {\indexedwebmaster} + [1] + {\indexedperson{#1}{Webmasters}{Webmaster}} + +\newcommand + {\indexedaffiliation} + [2] + {\indexedperson{#1}{#2}{#2}} + +\newcommand + {\indexedsupervisor} + [2] + {\indexedperson{#1}{}{Supervisor: #2}\indexedperson{#2}{Supervisors}{Supervisor}} + +\endinput + +% \crop[font=\upshape\mdseries\small\textsf] + +% EOF diff --git a/2012/pluggable-roadmap/pluggable-roadmap.bib b/2012/pluggable-roadmap/pluggable-roadmap.bib new file mode 100644 index 0000000..d1f4916 --- /dev/null +++ b/2012/pluggable-roadmap/pluggable-roadmap.bib @@ -0,0 +1,17 @@ +@techreport{obfs2, + title={obfs2 (The Twobfuscator)}, + note={\url{https://gitweb.torproject.org/obfsproxy.git/blob/HEAD:/doc/obfs2…, + author={George Kadianakis and Nick Mathewson} +} + +@techreport{dust, + title={Dust: A Blocking-Resistant Internet Transport Protocol}, + note={\url{http://blanu.net/Dust.pdf}}, + author={Brandon Wiley}, +} + +@techreport{bananaphone, + title={bananaphone: Reverse Hash Encoding}, + note={\url{https://github.com/leif/bananaphone}}, + author={Leif Ryge}, +} diff --git a/2012/pluggable-roadmap/pluggable-roadmap.tex b/2012/pluggable-roadmap/pluggable-roadmap.tex new file mode 100644 index 0000000..f1a3474 --- /dev/null +++ b/2012/pluggable-roadmap/pluggable-roadmap.tex @@ -0,0 +1,274 @@ +\documentclass[a4paper,withtimes]{easychair} + +\usepackage{doc} +\usepackage{xspace} +\usepackage{fancyhdr} +\usepackage{color} +\usepackage{graphicx} +\input{vc._include_.tex} + +\usepackage{prettyref} +%% Non-breaking space should really be used +\newrefformat{sec}{Section~\ref{#1}} +%% Page numbers seem a bit redundant in a short paper +\newrefformat{tab}{Table~\ref{#1}} +\newrefformat{fig}{Figure~\ref{#1}} +\newrefformat{cha}{Chapter~\ref{#1}} +\newrefformat{app}{Appendix~\ref{#1}} + +\makeatletter +\newcommand{\ie}{i.e.\@\xspace} +\newcommand{\eg}{e.g.\@\xspace} +\newcommand{\etc}{etc.\@\xspace} +\newcommand{\cf}{cf.\@\xspace} +\newcommand{\vs}{vs.\@\xspace} +\newcommand{\wrt}{w.r.t.\@\xspace} +\newcommand{\etal}{\textit{et al.\@\xspace}} +\newcommand{\detal}{\textit{et al.}} +\newcommand{\ia}{inter alia\xspace} +\makeatother + +\pagestyle{fancy} +\fancyhf{} + +\fancyhead[C]{\sc revision \VCRevisionMod~(\VCDateISO~\VCTime)} +\fancyfoot[C]{\thepage} + +\begin{document} + +\title{Pluggable Transports Roadmap} + +\author{Steven J. Murdoch \and George Kadianakis} + +\date{\VCDateISO} + +% \authorrunning{} has to be set for the shorter version of the authors' names; +% otherwise a warning will be rendered in the running heads. +% +\authorrunning{Murdoch and Kadianakis} +\titlerunning{Pluggable Transports Roadmap} + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\maketitle +\thispagestyle{empty} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%------------------------------------------------------------------------------ +% Abstract +% +\begin{abstract} +Of the currently available pluggable transports, obfs2 is a good default due to its efficiency and resistance to blocking. +StegoTorus offers alternative pluggable transports which are significantly harder to block, but come with a much higher overhead. +Suggestions for future development include: efficiency improvements, splitting and joining Tor cells to disguise Tor's distinctive packet-size probability distribution, efficient ways to hide ciphertext in compressed data, hardening obfs2 against a passive adversary, and designing a HTTP transport capable of traversing a proxy server. +\end{abstract} + +%------------------------------------------------------------------------------ +\section{Introduction} +\label{sec:introduction} + +This paper discusses the currently available pluggable transports for Tor, and their various advantages and disadvantages. It concludes with suggestions for further development. + +\subsection{Dust} + +Dust~\cite{dust} defines a packet format in which there are no identifiable patterns in the payload. +Therefore, it is hoped, Deep Packet Inspection (DPI) equipment should be unable to reliably block Dust packets, or identify Dust hosts. +In addition to the packet format, Dust defines a public-key key-exchange protocol which is resistant to a passive or active adversary, but does not provide perfect-forward-secrecy. +Part of the key exchange is performed offline, and the remainder is online. + +\subsubsection{Strengths} + +Dust assumes a reasonably strong threat model, in that the adversary may be active. +Dust also goes to some lengths to ensure that there are no static fingerprints in the payload packets, and permits padding to be added so as to disguise packet length. +Dust is versatile, and can be carried both by TCP and UDP. + +\subsubsection{Weaknesses} + +Currently Dust does not provide reliable in-order delivery, so cannot be directly used as a Tor pluggable transport. +Deployment is also made more difficult by having key-exchange partially offline. +Packets which are entirely random do stand out, but it is not clear that DPI equipment can perform such entropy tests. + +\subsection{obfs2} + +obfs2~\cite{obfs2} is currently the only protocol supported by the obsfproxy framework. +In a similar way to Dust, it aims to have no static protocol fingerprint, but it is simpler. +obfs2 depends on a reliable in-order transport (typically TCP) and offers a reliable in-order transport to layers above (\ie Tor). + +\subsubsection{Strengths} + +obfs2 is relatively simple and has no static protocol signature to block. +It is already implemented as a pluggable transport and has been tested in the field. +obfs2 has a low overhead (just a key-exchange) and uses only symmetric cryptography so is fast. + +\subsubsection{Weaknesses} + +obfs2 is not resistant to either an active or passive adversary, as someone who has recorded the initial key exchange can recover the session key and decode the traffic. +obfs2 also makes no attempt to hide packet lengths. +Like Dust, obfs2's high-entropy output format does make it possible to distinguish from most other protocols. + +\subsection{StegoTorus: Packet Chopping} + +StegoTorus defines a series of transports, all based on the packet chopper, but the packet chopper can be used by itself. +Like Dust and obfs2, packets are indistinguishable from random. +By using public key cryptography, StegoTorus is resistant to a passive adversary, but the lack of key-exchange authentication means that it is vulnerable to a man-in-the-middle attack. +The key exchange also does not provide perfect-forward-secrecy. + +The chopper provides a reliable in-order transport, and so is suitable to be used as a Tor pluggable transport. +The chopper depends on an underlying reliable transport, but it does not have to be in-order. +The packet format permits padding to be added. + +\subsubsection{Strengths} + +The packet chopper has been implemented and tested as a pluggable transport, and is more resilient than obfs2 to passive attacks. +The packet chopper is also more versatile in that it does not need an in-order transport. + +\subsubsection{Weaknesses} + +The packet chopper is more complex than obfs2 and has more overhead. +Like obfs2 and Dust, the high entropy packets could conceivably be detected. + +\subsection{StegoTorus: Embed Module} + +The embed module is built on the packet chopper. +It takes a network trace and substitutes the output of the chopper into the payload of the trace. +Since traces are to be collected from encrypted communication, an adversary should not be able to tell that the encrypted payload has been replaced with another encrypted payload. + +\subsubsection{Strengths} + +Unlike the previous transports, the embed module does not have an unusually high entropy of payload. +Provided the packet traces are selected appropriately it should be very hard to distinguish this transport's use. + +\subsubsection{Weaknesses} + +Before this transport can be used, a sufficiently large number packet traces have to be distributed to clients that they cannot all simply be blocked. +If the operator of the DPI system has a better understanding of the protocol being impersonated than the designer of the embedder, it might be possible to develop blocking mechanisms. +The embed module can only impersonate encrypted protocols, and has a moderately high overhead due to padding. + +\subsection{StegoTorus: HTTP Module} + +An alternative to the embed module is HTTP. +This also requires network traces, but is no longer restricted to only encrypted protocols. +Instead, Javascript, PDF and SWF files are used for server to client communication (client to server communication uses the cookie header). + +\subsubsection{Strengths} + +Here, even blocking all encrypted protocols will not be sufficient to block the HTTP transport. +As such, it is one of the most blocking-resistant protocols developed. + +\subsubsection{Weaknesses} + +Unfortunately, the overhead of the HTTP module is very high and as a result performance is low. +Currently, HTTP protocol compliance is not sufficiently complete to permit traffic being processed through a HTTP proxy. + +\subsection{bananaphone} + +bananaphone~\cite{bananaphone} is an encoding scheme which transforms +a stream of binary data into a stream of tokens (eg, something +resembling natural language text) such that the stream can be decoded +by concatenating the hashes of the tokens. + +\subsubsection{Strengths} + +The strength of bananaphone is that its output resembles arbitrarily +formatted data. For example, its output can look like a natural +language, or the chunks of an MP3 file. + +Furthermore, bananaphone can also be used to generate payloads for +other pluggable transports (e.g. HTTP or IRC transports). + +\subsubsection{Weaknesses} + +bananphone is not able to produce truly realistic looking output. That +is, bananaphone output emulating a natural language will look wrong +upon human inspection. + +Standalone bnanaphone is not able to withstand adversaries willing to +whitelist specific network protocols. + +\subsection{Easy-Come-Easy-Go Transports (ECEGT)} + +Another deployment idea is to create a number of easy-to-implement but +easy-to-block pluggable transports. Pluggable transport proxies are +designed to be modular and to allow fast development of pluggable +transports, while most DPI systems are not currently designed with the +same modular mindset. + +\subsubsection{Strengths} + +The main strength of this idea is that by carefully selecting the +strengths of each ECEGT, censors might be forced to build +distinguishers for each one of them. + +For example, a simple obfs2-over-base64 transport would reduce the +entropy of obfs2 and also obfuscate the packet sizes a bit. This will +probably force censors to add more rules to their DPI systems, which +not only takes time but also increases their false-positive rates. + +\subsubsection{Weaknesses} + +The obvious weakness of ECEGT is that censors can easily find ways to +block them. + +\section{Protocol trade-offs} + +The discussion above has shown some trade-offs which must be made when designing a protocol. + +\subsubsection{Perfect forward secrecy} + +To achieve perfect forward secrecy, a Diffie-Hellman key exchange needs to be performed. +This requires public key cryptography, and also one more round-trip than otherwise necessary. +While desirable, Tor already provides perfect forward secrecy, so it is not essential that the pluggable transport does so. + +\subsubsection{Resistance to passive and active attacks} + +A goal of any blocking resistance scheme is resistance to being reliably fingerprinted by a passive attack. +However, some (such as obfs2) only try to avoid identification by string matching rather than an arbitrary passive attack. +To reliably resist passive attacks, public key cryptography can be used. + +Resisting active attacks is harder. Unless there is out-of-band exchange of an authentication key, a man-in-the-middle can always impersonate both sides of the communication. +However, while resisting active attacks is desirable, the underlying Tor protocol already provides resistance. + +\subsubsection{Entropy fingerprinting} + +Tor traffic is encrypted and therefore inevitably is high-entropy. +Any transport which attempts to reduce the entropy of data must therefore significantly increase the payload size. +This restricts efficient blocking resistant protocols to impersonating encrypted protocols, or perhaps compressed data (on the assumption that DPI equipment will not decode the compressed data). + +\subsubsection{Padding and splitting} + +Even if traffic payload is disguised, directly encoding Tor packets will lead to a characteristic set of packet sizes. +By basing network traffic on observed network traces, StegoTorus resists blocking based on packet sizes but at the cost of a high padding overhead. + +\section{Potential censorship techniques} + +It is difficult to predict the approach which will be taken by censors, especially as some are willing to block all encrypted traffic, at least temporarily. +Some potential techniques (e.g. entropy detection, protocol whitelisting, \etc) are implicit in the development of fingerprinting resistant transports. + +However one approach which could work, even against the StegoTorus HTTP module, is to require all data be sent via a HTTP proxy (which itself blocks encrypted traffic). +This is done in some high-security corporate environments so it is likely that commercially available filtering equipment is capable of enforcing this policy. + +\section{Further avenues of research} + +In case HTTP proxy filtering is deployed, it would be useful to have a pluggable transport which was compatible enough with HTTP to make it through unscathed. + +Further efficiency improvements could be made to all protocols. +Some possibilities are simple (\eg compression of Tor data, taking advantage of the predictable TLS headers), but more sophisticated approaches could lead to better results. + +obfs2 could be extended to resist passive attack by performing a public-key handshake. + +A better understanding of how to reliably embed encrypted data in compressed fields would make it more difficult to develop filtering equipment capable for distinguishing common compression algorithms from ciphertext. + +Padding to disguise packet size is expensive, but simply joining or splitting packets would disguise Tor's protocol signature at little or no cost. +This approach is not capable of matching an arbitrary packet-size probability distribution, but it would defeat simple packet-size fingerprinting attacks. + +\section{Changes to Tor} + +There is no transport protocol proposed which is both efficient and very likely to remain unblocked, so the decision to move obfuscation out of Tor still seems appropriate. + +\label{sec:bib} +\bibliographystyle{plain} +%\bibliographystyle{alpha} +%\bibliographystyle{unsrt} +%\bibliographystyle{abbrv} +\bibliography{pluggable-roadmap} +\end{document} + +% EOF diff --git a/2012/pluggable-roadmap/vc b/2012/pluggable-roadmap/vc new file mode 100755 index 0000000..5c5a1b3 --- /dev/null +++ b/2012/pluggable-roadmap/vc @@ -0,0 +1,24 @@ +#!/bin/sh +# This is file 'vc' from the vc bundle for TeX. +# The original file can be found at CTAN:support/vc. +# This file is Public Domain. + +# Parse command line options. +full=0 +mod=0 +while [ -n "$(echo $1 | grep '-')" ]; do + case $1 in + -f ) full=1 ;; + -m ) mod=1 ;; + * ) echo 'usage: vc [-f] [-m]' + exit 1 + esac + shift +done +# English locale. +LC_ALL=C +git --no-pager log -1 HEAD --pretty=format:"Hash: %H%nAbr. Hash: %h%nParent Hashes: %P%nAbr. Parent Hashes: %p%nAuthor Name: %an%nAuthor Email: %ae%nAuthor Date: %ai%nCommitter Name: %cn%nCommitter Email: %ce%nCommitter Date: %ci%n" |gawk -v script=log -v full=$full -f vc-git.awk > vc.tex +if [ "$mod" = 1 ] +then + git status |gawk -v script=status -f vc-git.awk >> vc.tex +fi diff --git a/2012/pluggable-roadmap/vc-git.awk b/2012/pluggable-roadmap/vc-git.awk new file mode 100644 index 0000000..66b3526 --- /dev/null +++ b/2012/pluggable-roadmap/vc-git.awk @@ -0,0 +1,89 @@ +# This is file 'vc-git.awk' from the vc bundle for TeX. +# The original file can be found at CTAN:support/vc. +# This file is Public Domain. +BEGIN { + +### Process output of "git status". + if (script=="status") { + modified = 0 + } + +} + + + +### Process output of "git log". +script=="log" && /^Hash:/ { Hash = substr($0, 2+match($0, ":")) } +script=="log" && /^Abr. Hash:/ { AbrHash = substr($0, 2+match($0, ":")) } +script=="log" && /^Parent Hashes:/ { ParentHashes = substr($0, 2+match($0, ":")) } +script=="log" && /^Abr. Parent Hashes:/ { AbrParentHashes = substr($0, 2+match($0, ":")) } +script=="log" && /^Author Name:/ { AuthorName = substr($0, 2+match($0, ":")) } +script=="log" && /^Author Email:/ { AuthorEmail = substr($0, 2+match($0, ":")) } +script=="log" && /^Author Date:/ { AuthorDate = substr($0, 2+match($0, ":")) } +script=="log" && /^Committer Name:/ { CommitterName = substr($0, 2+match($0, ":")) } +script=="log" && /^Committer Email:/ { CommitterEmail = substr($0, 2+match($0, ":")) } +script=="log" && /^Committer Date:/ { CommitterDate = substr($0, 2+match($0, ":")) } + +### Process output of "git status". +### Changed index? +script=="status" && /^# Changes to be committed:/ { modified = 1 } +### Unstaged modifications? +script=="status" && /^# Changed but not updated:/ { modified = 2 } + + + +END { + +### Process output of "git log". + if (script=="log") { +### Standard encoding is UTF-8. + if (Encoding == "") Encoding = "UTF-8" +### Extract relevant information from variables. + LongDate = substr(AuthorDate, 1, 25) + DateRAW = substr(LongDate, 1, 10) + DateISO = DateRAW + DateTEX = DateISO + gsub("-", "/", DateTEX) + Time = substr(LongDate, 12, 14) +### Write file identification to vc.tex. + print "%%% This file has been generated by the vc bundle for TeX." + print "%%% Do not edit this file!" + print "%%%" +### Write Git specific macros. + print "%%% Define Git specific macros." + print "\\gdef\\GITHash{" Hash "}%" + print "\\gdef\\GITAbrHash{" AbrHash "}%" + print "\\gdef\\GITParentHashes{" ParentHashes "}%" + print "\\gdef\\GITAbrParentHashes{" AbrParentHashes "}%" + print "\\gdef\\GITAuthorName{" AuthorName "}%" + print "\\gdef\\GITAuthorEmail{" AuthorEmail "}%" + print "\\gdef\\GITAuthorDate{" AuthorDate "}%" + print "\\gdef\\GITCommitterName{" CommitterName "}%" + print "\\gdef\\GITCommitterEmail{" CommitterEmail "}%" + print "\\gdef\\GITCommitterDate{" CommitterDate "}%" +### Write generic version control macros. + print "%%% Define generic version control macros." + print "\\gdef\\VCRevision{\\GITAbrHash}%" + print "\\gdef\\VCAuthor{\\GITAuthorName}%" + print "\\gdef\\VCDateRAW{" DateRAW "}%" + print "\\gdef\\VCDateISO{" DateISO "}%" + print "\\gdef\\VCDateTEX{" DateTEX "}%" + print "\\gdef\\VCTime{" Time "}%" + print "\\gdef\\VCModifiedText{\\textcolor{red}{with local modifications!}}%" + print "%%% Assume clean working copy." + print "\\gdef\\VCModified{0}%" + print "\\gdef\\VCRevisionMod{\\VCRevision}%" + } + +### Process output of "git status". + if (script=="status") { + print "%%% Is working copy modified?" + print "\\gdef\\VCModified{" modified "}%" + if (modified==0) { + print "\\gdef\\VCRevisionMod{\\VCRevision}%" + } else { + print "\\gdef\\VCRevisionMod{\\VCRevision~\\VCModifiedText}%" + } + } + +}

1 0

[tech-reports/master] Update datagram-testing-plan report to new style.
by karsten＠torproject.org 26 Aug '12

26 Aug '12

commit 656e8b0c298ff878354f49f99254191348a7b26d Author: Karsten Loesing <karsten.loesing(a)gmx.net> Date: Wed Aug 8 08:26:11 2012 +0200 Update datagram-testing-plan report to new style. --- 2012/datagram-testing-plan/.gitignore | 8 +- 2012/datagram-testing-plan/Makefile | 3892 -------------------- 2012/datagram-testing-plan/Targets.ini | 4 - .../datagram-testing-plan.bib | 3 +- .../datagram-testing-plan.tex | 21 +- 2012/datagram-testing-plan/easychair.cls | 756 ---- 2012/datagram-testing-plan/tortechrep.cls | 1 + 2012/datagram-testing-plan/vc | 24 - 2012/datagram-testing-plan/vc-git.awk | 89 - 9 files changed, 8 insertions(+), 4790 deletions(-) diff --git a/2012/datagram-testing-plan/.gitignore b/2012/datagram-testing-plan/.gitignore index e696f73..6412471 100644 --- a/2012/datagram-testing-plan/.gitignore +++ b/2012/datagram-testing-plan/.gitignore @@ -1,9 +1,3 @@ -datagram-testing-plan.aux.make -datagram-testing-plan.auxbbl.make -datagram-testing-plan.auxtarget.make -datagram-testing-plan.d -datagram-testing-plan.fls -datagram-testing-plan.out.make datagram-testing-plan.pdf -vc._include_.tex +datagram-testing-plan-2012-03-16.pdf diff --git a/2012/datagram-testing-plan/Makefile b/2012/datagram-testing-plan/Makefile deleted file mode 100644 index 62951f3..0000000 --- a/2012/datagram-testing-plan/Makefile +++ /dev/null @@ -1,3892 +0,0 @@ -# Copyright 2004 Chris Monson (shiblon(a)gmail.com) -# Latest version available at http://www.bouncingchairs.net/oss -# -# This file is part of ``Chris Monson's Free Software''. -# -# ``Chris Monson's Free Software'' is free software; you can redistribute it -# and/or modify it under the terms of the GNU General Public License as -# published by the Free Software Foundation, Version 2. -# -# ``Chris Monson's Free Software'' is distributed in the hope that it will -# be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of -# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General -# Public License for more details. -# -# You should have received a copy of the GNU General Public License along -# with ``Chris Monson's Free Software''; if not, write to the Free Software -# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA -# -# It is also available on the web at http://www.gnu.org/copyleft/gpl.html -# -# Note that using this makefile to build your documents does NOT place them -# under the GPL unless you, the author, specifically do so. In other words, -# I, Chris Monson, the copyright holder and author of this makefile, -# consider it impossible to ``link'' to this makefile in any way covered by -# the GPL. -# -# -# TO OBTAIN INSTRUCTIONS FOR USING THIS FILE, RUN: -# make help -# -fileinfo := LaTeX Makefile -author := Chris Monson -version := 2.2.0 -# -.DEFAULT_GOAL := all -# Note that the user-global version is imported *after* the source directory, -# so that you can use stuff like ?= to get proper override behavior. -.PHONY: Makefile GNUmakefile Makefile.ini $(HOME)/.latex-makefile/Makefile.ini --include Makefile.ini --include $(HOME)/.latex-makefile/Makefile.ini -# Better names for these things -.PHONY: Variables.ini $(HOME)/.latex-makefile/Variables.ini --include Variables.ini --include $(HOME)/.latex-makefile/Variables.ini -# -# This can be pdflatex or latex - you can change this by adding the following line to your Makefile.ini: -# BUILD_STRATEGY := latex -BUILD_STRATEGY ?= pdflatex -# -# Sets LC_ALL=C, by default, so that the locale-aware tools, like sort, be -# # immune to changes to the locale in the user environment. -export LC_ALL ?= C -# -# -# If you specify sources here, all other files with the same suffix -# will be treated as if they were _include_ files. -#onlysources.tex ?= main.tex -#onlysources.tex.sh ?= -#onlysources.tex.pl ?= -#onlysources.tex.py ?= -#onlysources.rst ?= -#onlysources.fig ?= -#onlysources.gpi ?= -#onlysources.dot ?= -#onlysources.xvg ?= -#onlysources.svg ?= -#onlysources.eps.gz ?= -#onlysources.eps ?= -# -# If you list files here, they will be treated as _include_ files -#includes.tex ?= file1.tex file2.tex -#includes.tex.sh ?= -#includes.tex.pl ?= -#includes.tex.py ?= -#includes.rst ?= -#includes.fig ?= -#includes.gpi ?= -#includes.dot ?= -#includes.xvg ?= -#includes.svg ?= -#includes.eps.gz ?= -#includes.eps ?= -# -# If you list files or wildcards here, they will *not* be cleaned - default is -# to allow everything to be cleaned. -#neverclean ?= *.pdf -# -# Alternatively (recommended), you can add those lines to a Makefile.ini file -# and it will get picked up automatically without your having to edit this -# Makefile. -# -# KNOWN ISSUES: -# * The following occurs: -# file with: \usepackage{named}\bibliographystyle{named} -# Compile -# change to: \usepackage{apalike}\bibliographystyle{apalike} -# Compile again -- BARF! -# -# The workaround: make clean-nographics; make -# -# Note that we may not be able to fix this. LaTeX itself barfs -# on this, not the makefile. The very first invocation of LaTeX -# (when something like this has happened) reads the existing .aux -# file and discovers invalid commands like \citeauthoryear that -# are only valid in the package that was just removed. It then -# tries to parse them and explodes. It's not at all clear to me -# how to fix this. I tried removing the .aux files on the first -# run of LaTeX, but that necessarily requires more subsequent -# rebuilds on common edits. There does not appear to be a -# graceful solution to this issue. -# -# -# CHANGES: -# Chris Monson (2011-05-20): -# * Bumped version to 2.2.0 (release!) -# Chris Monson (2011-05-19): -# * Bumped version to 2.2.0-rc15 -# * Issue 125: infinite recursion with nomenclature files -# * Issue 125: removed .d as a target for .nls in get-log-index -# * Cleaned up invocation of run-makeindex to take an optional .ist instead of flags. -# Chris Monson (2011-04-06): -# * Bumped version to 2.2.0-rc14 -# * Issue 121: Added Targets.ini and corresponding help text for it. -# * Issue 121: Added Variables.ini (Makefile.ini still works, though). -# * Issue 121: Added .DEFAULT_GOAL optional setting. -# * Issue 120: xindy compatibility -# Chris Monson (2011-03-16): -# * Bumped version to 2.2.0-rc13 -# * Fixed a bug in kspewhich invocation - random characters and a missing pipe. -# * Added font embedding to gnuplot output. -# Chris Monson (2011-03-15): -# * Bumped version to 2.2.0-rc12 -# * Issue 119: Annoying warning from which if Gnuplot not installed. -# * Fixed catchall error output to show more info from the log. Cutting off the -# first line is too jarring. -# * Issue 118: Better glossary support -# Chris Monson (2011-03-03): -# * Bumped version to 2.2.0-rc11 -# * Issue 112: Fixed regression introduced by use of cygpath (ugly warnings) -# Chris Monson (2011-02-03): -# * Bumped version to 2.2.0-rc10 -# * Issue 112: Added path normalization for cygwin systems -# * Fixed a bug in get-missing-inputs where we weren't specifying target files -# Chris Monson (2011-01-24): -# * Issue 111: Added .jpeg as a possible image extension -# Chris Monson (2011-01-21): -# * Issue 110: Long filenames not produced correctly in .d file -# * Fixed problem with unknown control sequence error parsing -# * Fixed problem with \r in fatal output (was interpreted as LF by echo) -# * Removed a spurious "hi" -# Chris Monson (2011-01-14): -# * Bumped version to 2.2.0-rc8 -# * Issue 107: Removed comment with embedded newline, fixing MinGW on Windows 7. -# Chris Monson (2011-01-07): -# * Emit an error if .gpi.d files have dependencies with : in the name -# Chris Monson (2011-01-05): -# * Bumped version to 2.2.0-rc7 -# * Issue 106: existing graphic dependencies not generated correctly -# Chris Monson (2011-01-04): -# * Issue 106: not cleaning eps log files properly -# * Issue 106: not rebuilding after creating .pdf graphics from .eps -# * Issue 94: svg going unnecessarily through eps (can't reproduce) -# Chris Monson (2010-12-31): -# * Issue 100: make hanging because of faulty graphics detection (sed bug) -# * Issue 108: do not ignore fatal errors from pdftex -# Chris Monson (2010-12-23): -# * Added gpi_global to gnuplot dependencies so that changes are detected -# Chris Monson (2010-12-20): -# * Updated build file to be smarter about Python version detection -# * Created a bunch of test files and supporting scripts -# * Issue 72: added apacite capaability (thanks to matkarat) -# Chris Monson (2010-11-23): -# * Changed to multi-part makefile build (split out sed scripts) -# * Added build script and supporting infrastructure -# * Updated test directory format -# * Added notes about needed test cases -# * Changed to use -file-line-error and fixed multiple inclusion/error bugs -# * Added run_sed.py to allow easy testing of sed scripts outside of make -# Chris Monson (2010-11-11): -# * Bumped version to 2.2.0-rc7 -# * issue 92: broken hyperref driver detection fixed -# * issue 101: Broken inkscape conversion -# * issue 102: Broken specification of font size for gnuplot pdfcairo -# * Added KEEP_TEMP so that we can avoid deleting useful temporaries for debugging -# * Restructured gnuplot code to be easier to follow -# * Fixed a bug in convert-gpi where we were using $< instead of $1 -# Chris Monson (2010-11-03): -# * Bumped version to 2.2.0-rc6 -# * issue 96: Fix sed errors when using make variables in substitutions -# Chris Monson (2010-07-28): -# * Bumped version to 2.2.0-rc5 (rc4 is broken) -# * Bail out when we find the use of the import.sty package -# * Issue 90: Add -z to dvips invocation -# * Issue 67: Add xelatex support (thanks to Nikolai Prokoschenko for the patch!) -# * Issue 85: Add warning about make 3.80 -# Chris Monson (2010-06-20): -# * Bumped version to 2.2.0-rc3 -# * Attempt to fix bug with ! error detection (issue 88) -# * Added svg->pdf direct support (issue 89) -# Chris Monson (2010-04-28): -# * Bumped version to 2.2.0-rc2 -# * Fixed %._show target -# Chris Monson (2010-04-08): -# * Bumped version to 2.2.0-rc1 -# * Added back in the rst_style_file stuff that got broken when switching -# rst -> tex to use the script mechanism -# Chris Monson (2010-03-23): -# * Bumped version to 2.2.0-beta8 -# * Work on issue 76: bad backtick escape for some sed versions, failure -# to clear out the hold buffer when outputting MISSING comment. -# - Backed out 2>&1 to &> (doesn't work in sh) -# - Backed out using . to source variables -# Chris Monson (2010-03-22): -# * Bumped version to 2.2.0-beta7 -# * Issue 72: Fix latex/bibtex invocation order for annotated bib styles -# * Fixed informational output to reflect which LaTeX run we're on -# * Fixed graphic detection to include graphics that are already there in -# .d files -# * Tightened up the .d file output to only make .d depend on graphic -# *source* files. This means that building foo.d no longer -# builds all of the graphics files on which foo.tex depends. -# Had to use .SECONDEXPANSION trickery to make it work. -# * Changed get-graphics to only accept a stem. -# * Fixed build-once logic for scripted .tex to work better -# * Made get-inputs sed script more maintainable. -# * Moved Makefile.ini import up higher. -# * Changed bare stems to not recursively invoke make -# * Updated diff output to be more silent everywhere -# * Added a MISSING comment to the .d file if stuff isn't found - forces -# removal of .1st.make file, which often forces it to try again. -# * Fixed broken graphics-target function -# * Added sleep to .d file generation when stuff is missing - if it -# builds too fast, make doesn't realize it needs to be reloaded, -# and thus never discovers some deeper dependencies (especially -# evident when graphics are included from scripted include -# files). -# Chris Monson (2010-03-17): -# * Bumped version to 2.2.0-beta6 -# * Fixed bareword builds to actually work (requires static patterns) -# * Fixed colorization to work with new paragraph stuff -# Chris Monson (2010-03-17): -# * Bumped version to 2.2.0-beta5 -# * Fixed graphic detection to be much more focused - splits log file -# into paragraphs before doing pattern matching. -# * Fixed make foo to work properly (recursively calls make foo.pdf) -# * Fixed gpi -> pdf generation to not waste time building .eps *after* -# the pdf already exists. -# * Changed log copies to include MAKE_RESTARTS as part of the name. -# * Fixed missing include file detection (also makes use of the paragraph -# stuff) to detect missing scripted include files. -# Chris Monson (2010-03-16): -# * Bumped version to 2.2.0-beta4 -# * issue 70: .pdf not moved out of the way properly on first -# compilation, resulting in early error detection failure. -# * issue 74: fixed broken error on missing .aux files: the -# implementation was masking real errors. -# Chris Monson (2010-03-15): -# * Bumped version to 2.2.0-beta3 -# * issue 71: Made the tput dependency optional -# * issue 73: Made .tex targets not pull in .d files (building them from -# scripts should not require a .d) -# * issue 74: Output a much saner error when a .aux file is not produced -# (e.g., when you are typing "make" without arguments in a -# directory with included .tex files that are not named with -# ._include_.) -# Chris Monson (2010-03-11): -# * Bumped version to 2.2.0-beta2 -# * Fixed clean-graphics to get rid of intermediate .eps files that may -# be hanging around -# * Added an automatic setting to use eps terminals in pdflatex mode for -# gnuplot if it doesn't understand pdf. -# * issue 66: Removed grayscale generation via magic suffix. Grayscale -# generation is now only available via GRAY=1 -# * issue 68: Added explicit handling of LC_ALL for locale-aware tools -# like "sort" -# Chris Monson (2010-03-10): -# * Bumped version to 2.2.0-beta1 -# * Fixed success message to handle output message in different places -# * Added name of produced file to success message -# Chris Monson (2010-03-10): -# * Bumped version to 2.2.0-alpha3 -# * Added meaningful error message for wrong hyperref options -# * Added meaningful error message for incorrect graphics extensions -# Chris Monson (2010-03-09): -# * Bumped version to 2.2.0-alpha2 -# * Updated graphics handling (gnuplot and fig generate pdf natively) -# * Changed xmgrace to output monochrome natively -# Chris Monson (2010-03-09): -# * Bumped version to 2.2.0-alpha1 - major change! -# * Support pdflatex natively and by default (issue 6 - a long time coming) -# * Add ability to have a single $HOME/.latex-makefile/Makefile.ini for -# all invocations -# * Reworked graphic inclusion detection so that extensions need not be -# specified for either build strategy (e.g., -# \includegraphics{test1.eps} -> \includegrahpics{test1}) -# * Changed log format to include filenames and line numbers -# Chris Monson (2010-02-04): -# * Bumped version to 2.1.43 -# * All of the following are for issue 63 (thanks to mojoh81): -# * Added documentation about fixing Makefile.ini default target -# * Added perl and python script targets -# * Fixed run logic to allow included .tex files to be scripted (the -# run-again logic now detects missing .tex files, and the MV -# command has been switched out for a command that only invokes -# MV if the files exist) -# * Changed scripted generation to only run once per make invocation -# * Added dependency on expr -# Chris Monson (2010-01-19): -# * Bumped version to 2.1.42 -# * issue 62: Added .brf extension to cleanable files (backrefs) -# Chris Monson (2010-01-07): -# * Bumped version to 2.1.41 -# * issue 60: bad makeindex runs now error out on subsequent tries -# Chris Monson (2009-12-01): -# * Bumped version to 2.1.40 -# * issue 36: build all indices (for e.g., splitidx usage) -# * issue 59: clean up all generated files (including indices) -# Chris Monson (2009-11-23): -# * Bumped version to 2.1.39 -# * issue 57: change ps2pdf invocations to just use gs directly -# Chris Monson (2009-11-19): -# * Bumped version to 2.1.38 -# * issue 57: Added some limited support for Cygwin (spaces in filenames) -# Chris Monson (2009-11-15): -# * Bumped version to 2.1.37 -# * Removed svninfo, since this is now managed by mercurial -# * Fixed typo in changelist -# * Issue 52: added jpg->eps conversion (thanks to brubakee) -# * Issue 54: fix missing Overfull colorization due to lack of a blank -# line preceding the first error. -# * Issue 51: remove head.tmp and body.tmp in make clean invocation -# * Issue 56: maintain multiple versions of log files (for debugging) -# Chris Monson (2009-11-14): -# * Bumped version to 2.1.36 -# * Issues 53 and 49: added .brf, .mtc, and .maf to the cleanables -# Chris Monson (2009-11-05): -# * Bumped version to 2.1.35 -# * Added nomenclature support (see issue 48) -# Chris Monson (2009-10-29): -# * Bumped version to 2.1.34 -# * Fixed _out_ creation bug introduced in 2.1.33 (it was always created) -# * Fixed erroneous help output for $HOME in BINARY_TARGET_DIR -# * Changed contact email address - bring on the spam! -# Chris Monson (2009-10-21): -# * Bumped version to 2.1.33 -# * Fixed issue 46, adding support for dot2tex (thanks to fdemesmay) -# * Made all_files.* settable in Makefile.ini (using ?= instead of :=) -# * Fixed issue 47, thanks to fdemesmay: add binary copy directory, copy -# dvi, pdf, and ps if it exists -# Chris Monson (2009-09-25): -# * Bumped version to 2.1.32 -# * Fixed so that a changed lol file will cause a rebuild -# * Added .lol files to the cleanable list -# Chris Monson (2009-09-08): -# * Bumped version to 2.1.31 -# * Closed issue 43: evince doesn't notice pdf change w/out touch -# Chris Monson (2009-08-28): -# * Bumped version to 2.1.30 -# * Closed issue 39: Capture multi-line log warnings/errors to output -# Chris Monson (2009-08-26): -# * Bumped version to 2.1.29 -# * Closed issue 42: add svg support using inkscape -# Chris Monson (2009-08-17): -# * Bumped version to 2.1.28 -# * Patch from paul.biggar for issue 38: package warnings are overlooked -# Chris Monson (2009-08-07): -# * Bumped version to 2.1.27 -# * Included patch for issue 37 - removes pdf/ps files before copying, -# allowing some broken viewers to see changes properly. -# Chris Monson (2009-05-15): -# * Bumped version to 2.1.26 -# * Included patch for issue 9 from favonia - detects .fig changes for -# pstex files during regular compilation, so long as the pstex -# has been built at least once with make all-pstex. -# Chris Monson (2009-03-27): -# * Bumped version to 2.1.25 -# * Cleaned up a bunch of variable setting stuff - more stuff is now -# settable from Makefile.ini -# * Cleaned up documentation for various features, especially settable -# variables. -# * issue 28: support for png -> eps conversion (it even looks good!) -# * issue 29: support for "neverclean" files in Makefile.ini -# * issue 30: make ps2pdf14 the default - fall back when not there -# Chris Monson (2009-03-09): -# * Bumped version to 2.1.24 -# * issue 27: xmgrace support (thanks to rolandschulzhd) -# Chris Monson (2008-10-23): -# * Bumped version to 2.1.23 -# * issue 23: fixed _check_programs to not use bash string subs -# Chris Monson (2008-09-02): -# * Bumped version to 2.1.22 -# * Appled patch from Holger <yllohy(a)googlemail.com> to add include -# sources and some documentation updates. -# * Updated backup_patterns to be a bit more aggressive (also thanks to -# Holger) -# Chris Monson (2008-08-30): -# * Bumped version to 2.1.21 -# * Added ability to specify onlysources.* variables to indicate the only -# files that should *not* be considered includes. Thanks to Holger -# <yllohy(a)googlemail.com> for this patch. -# * Added an automatic include of Makefile.ini if it exists. Allows -# settings to be made outside of this makefile. -# Chris Monson (2008-05-21): -# * Bumped version to 2.1.20 -# * Added manual pstex compilation support (run make all-pstex first) -# * Removed all automatic pstex support. It was totally breaking -# everything and is very hard to incorporate into the makefile -# concept because it requires LaTeX to *fail* before it can -# determine that it needs the files. -# Chris Monson (2008-04-17): -# * Bumped version to 2.1.19 -# * Changed the pstex build hack to be on by default -# Chris Monson (2008-04-09): -# * Bumped version to 2.1.18 -# * issue 16: fixed pstex build problems, seems nondeterministic. Added -# gratuitious hack for testing: set PSTEX_BUILD_ALL_HACK=1. -# Chris Monson (2008-04-09): -# * Bumped version to 2.1.17 -# * issue 20: fixed accumulation of <pid>*.make files - wildcard was -# refusing to work on files that are very recently created. -# Chris Monson (2008-04-02): -# * Bumped version to 2.1.16 -# * issue 19: Removed the use of "type" to fix broken "echo" settings -# Chris Monson (2008-03-27): -# * Bumped version to 2.1.15 -# * issue 18: Favors binary echo over builtin, as binary understands -n -# * issue 16: Fixed handling of missing pstex_t files in the log -# * issue 9: Added .SECONDARY target for .pstex files -# Chris Monson (2008-03-21): -# * Bumped version to 2.1.14 -# * Fixed broken aux file flattening, which caused included bibs to be -# missed. -# Chris Monson (2008-03-20): -# * Bumped version to 2.1.13 -# * Changed error output colorization to show errors for missing files -# that are not graphics files. -# Chris Monson (2008-03-20): -# * Bumped version to 2.1.12 -# * Fixed a regression introduced in r28 that makes bibtex fail when -# there is no index file present -# Chris Monson (2008-03-03): -# * Bumped version to 2.1.11 -# * Fixed issue 11 (handle index files, reported by abachn) -# * Cleaned up some comments and help text -# Chris Monson (2008-01-24): -# * Bumped version to 2.1.10 -# * Fixed to work when 'sh' is a POSIX shell like 'dash' -# Chris Monson (2007-12-12): -# * Bumped version to 2.1.9 -# * Fixed documentation and dependency graph for pstex files -# Chris Monson (2007-12-12): -# * Bumped version to 2.1.8 -# * Added basic pstex_t support for fig files (Issue 9 by favonia) -# I still suggest that psfrag be used instead. -# Chris Monson (2007-10-16): -# * Bumped version to 2.1.7 -# * Removed todo item: allow other comment directives for rst conversion -# * Added ability to use global rst style file _rststyle_._include_.tex -# * Added help text to that effect -# Chris Monson (2007-05-20): -# * Bumped version to 2.1.6 -# * Changed default paper size for rst files -# * Added todo item: fix paper size for rst files -# * Added todo item: allow other comment directives for rst conversion -# Chris Monson (2007-04-02): -# * Bumped version to 2.1.5 -# * Addressed Issue 7, incorrect .gpi.d generation in subdirectories -# Chris Monson (2007-03-28): -# * Bumped version to 2.1.4 -# * Fixed syntax error in dot output -# Chris Monson (2007-03-01): -# * Bumped version to 2.1.3 -# * Added reST to the included documentation -# * Fixed graphics and script generation to be settable in the -# environment. -# Chris Monson (2007-02-23): -# * Bumped version to 2.1.2 -# * Added the ability to generate .tex files from .rst files -# Chris Monson (2006-10-17): -# * Bumped version to 2.1.1 -# * Fixed includes from subdirectories (sed-to-sed slash escape problem) -# Chris Monson (2006-10-05): -# * Bumped version to 2.1.0 (pretty serious new feature added) -# * New feature: bib files can now be anywhere on the BIBINPUTS path -# * New programs: kpsewhich (with tetex) and xargs (BSD) -# Chris Monson (2006-09-28): -# * Bumped version to 2.0.9 -# * Added ability to parse more than one bibliography -# Chris Monson (2006-06-01): -# * Bumped version to 2.0.8 -# * Added .vrb to the list of cleaned files -# Chris Monson (2006-04-26): -# * Bumped version to 2.0.7 -# * Fixed so that clean-nographics does not remove .gpi.d files -# * Removed jpg -> eps hack (not working properly -- just pre-convert) -# * Fixed so that postscript grayscale can be done with BSD sed -# Chris Monson (2006-04-25): -# * Bumped version to 2.0.6 -# * Fixed so that changed toc, lot, lof, or out causes a rebuild -# Chris Monson (2006-04-17): -# * Bumped version to 2.0.5 -# * Added jpg -> eps conversion target -# Chris Monson (2006-04-12): -# * Bumped version to 2.0.4 -# * Fixed BSD sed invocation to not use \| as a branch delimiter -# * Added a comment section on what is and is not allowed in BSD sed -# * Made paper size handling more robust while I was at it -# * Fixed postscript RGB grayscale to use a weighted average -# * Fixed postscript HSB grayscale to convert to RGB first -# * Fixed a problem with rebuilding .bbl files -# Chris Monson (2006-04-11): -# * Bumped version to 2.0.3 -# * Fixed some BSD sed problems: can't use \n in substitutions -# Chris Monson (2006-04-10): -# * Bumped version to 2.0.2 -# * Once again removed ability to create .tex files from scripts -# * \includeonly works again -# Chris Monson (2006-04-09): -# * Bumped version to 2.0.1 -# * Fixed grayscale postscript handling to be more robust -# * Added ability to generate ._gray_. files from eps and eps.gz -# * Added ability to clean ._gray_.eps files created from .eps files -# Chris Monson (2006-04-07): -# * Bumped version to 2.0.0 -# * Removed clunky ability to create included .tex files from scripts -# * Added note in the help about included tex scripting not working -# * Fixed the .eps generation to delete %.gpihead.make when finished -# * Abandoned designs to use shell variables to create sed scripts -# * Abandoned __default__.tex.sh idea: it causes recursion with %: . -# * Removed web page to-do. All items are now complete. -# * Added better grayscale conversion for dot figures (direct ps fixup). -# * Include files can now be scripted (at the expense of \includeonly). -# * Updated dependency graph to contain better node names. -# Chris Monson (2006-04-06): -# * Bumped version to 2.0b3 -# * Top level includes now fail if there is no rule to build them -# * A helpful message is printed when they do fail -# * Grayscale has been changed to be ._gray_, other phonies use _ now, too -# * Grayscale handling has been completed -# * Changed _include_stems target to _includes target. -# * Fixed _includes target to be useful by itself. -# * Removed the ability to specify clean and build targets at once -# * Verified that epsfig works fine with current code -# * Fixed included scripts so that they are added to the dep files -# * Fixed so that graphics includes don't happen if they aren't for gpi -# * Fixed dot output to allow grayscale. -# Chris Monson (2006-04-05): -# * Bumped version to 2.0b2 -# * Removed automatic -gray output. It needs fixing in a bad way. -# * Revamped dependency creation completely. -# * Fixed conditional inclusion to actually work (test.nobuild.d, test.d). -# * Fixed clean target to remove log targets -# * Added the 'monochrome' word for gray gpi output -# * Added a _check_gpi_files target that checks for common problems -# * Changed the _version target into the version target (no _) -# * Added better handling of grayscale files. Use the .gray.pdf target. -# * Fixed testing for rebuilds -# Chris Monson (2006-04-04): -# * Bumped version to 2.0b1 -# * Changed colorization of output -# * Made .auxbbl and .auxtex .make files secondary targets -# * Shortened and simplified the final latex invocation loop -# * Added version-specific output ($$i vs. $$$$i) in latex loop -# * Added a build message for the first .dvi run (Building .dvi (0)) -# * Removed some build messages that most people don't care about. -# * Simplified procedure for user-set colors -- simple text specification -# * Fixed diff output to...not output. -# * Fixed rerun bug -- detect not only when preceded with LaTeX Warning -# * Sped up gpi plotting -# * Added error handling and colorized output for gpi failure -# * Documented color changing stuff. -# * Now sort the flattened aux file to avoid false recompilation needs -# * Added clean-nographics target -# * Don't remove self.dvi file if self.aux is missing in the log -# * Clarified some code. Did some very minor adjusting. -# Chris Monson (2006-04-03): -# * Bumped version to 2.0a7 -# * Added .dvi and .ps files as secondary files. -# * Fixed handling of multiple run detection when includeonly is in use. -# * Added code to flatten .aux files. -# * Added more files as .SECONDARY prerequisites to avoid recompilation. -# * Fixed the inputs generation to be much simpler and to use pipes. -# * Added the dependency graph directly into the makefile. -# * Changed flatten-aux to remove \@writefile \relax \newlabel, etc. -# * Undid pipe changes with sed usage (BSD sed doesn't know -f-). -# * Added a _check_programs target that tells you what your system has. -# * Fixed an error in colorization that made unnecessary errors appear -# * Added view targets. -# * Updated help text. -# * Augmented cookies so that .aux can trigger .bbl and .dvi rebuilds -# * Added more informative error handling for dvips and ps2pdf -# Chris Monson (2006-04-02): -# * Bumped version to 2.0a6 -# * Added indirection to .bbl dependencies to avoid rebuilding .bbl files -# * Streamlined the diff invocation to eliminate an existence test -# * Removed special shell quote escape variables -# * Moved includes to a more prominent location -# * Fixed .inputs.make to not contain .aux files -# * Fixed embedding to use a file instead of always grepping. -# * Added *.make.temp to the list of cleanable files -# * Fixed Ruby. It should now be supported properly. -# * Now differentiate between all, default, and buildable files. -# * Fixed to bail out on serious errors. -# * Revised the handling of includable files. Still working on it. -# Chris Monson (2006-03-31): -# * Bumped version to 2.0a5 -# * Fixed a bug with LaTeX error detection (there can be spaces) -# * Added .bbl support, simplifying everything and making it more correct -# * Refactored some tests that muddy the code -# * Did a little cleanup of some shell loops that can safely be make loops -# * Added support for graphviz .dot files -# * Made _all_programs output easier to read -# * Added the ruby support that has long been advertised -# * Font embedding was screwed up for PostScript -- now implicit -# * Changed the generation of -gray.gpi files to a single command -# * Changed any make-generated file that is not included from .d to .make -# Chris Monson (2006-03-30): -# * Bumped version to 2.0a4 -# * Fixed a bug with very long graphics file names -# * Added a todo entry for epsfig support -# * Fixed a bug paper size bug: sometimes more than one entry appears -# * Fixed DVI build echoing to display the number instead of process ID -# * DVI files are now removed on first invocation if ANY file is missing -# * Added a simple grayscale approach: if a file ends with -gray.gpi, it -# is created from the corresponding .gpi file with a special -# comment ##GRAY in its header, which causes coloring to be -# turned off. -# * Fixed a bug in the handling of .tex.sh files. For some reason I had -# neglected to define file stems for scripted output. -# * Removed a trailing ; from the %.graphics dependencies -# * Added dvips embedding (I think it works, anyway) -# Chris Monson (2006-03-29): -# * Bumped version to 2.0a3 -# * Fixed error in make 3.79 with MAKEFILE_LIST usage -# * Added the presumed filename to the _version output -# * Added a vim macro for converting sed scripts to make commands -# * Added gpi dependency support (plotting external files and loading gpi) -# * Allow .gpi files to be ignored if called .include.gpi or .nobuild.gpi -# * Fixed sed invocations where \+ was used. BSD sed uses \{1,\}. -# Chris Monson (2006-03-28): -# * Bumped version to 2.0a2 -# * Added SHELL_DEBUG and VERBOSE options -# * Changed the default shell back to /bin/sh (unset, in other words) -# * Moved .PHONY declarations closer to their targets -# * Moved help text into its own define block to obtain better formatting -# * Removed need for double-entry when adding a new program invocation -# * Moved .SECONDARY declaration closer to its relevant occurrence -# * Commented things more heavily -# * Added help text about setting terminal and output in gnuplot -# * Created more fine-grained clean targets -# * Added a %.graphics target that generates all of %'s graphics -# * Killed backward-compatible graphics generation (e.g., eps.gpi=gpi.eps) -# * For now, we're just GPL 2, not 3. Maybe it will change later -# * Made the version and svninfo into variables -# Chris Monson (2006-03-27): -# * Bumped version to 2.0a1 -# * Huge, sweeping changes -- automatic dependencies -# - -# IMPORTANT! -# -# When adding to the following list, do not introduce any blank lines. The -# list is extracted for documentation using sed and is terminated by a blank -# line. -# -# EXTERNAL PROGRAMS: -# = ESSENTIAL PROGRAMS = -# == Basic Shell Utilities == -CAT ?= cat -CP ?= cp -f -DIFF ?= diff -ECHO ?= echo -EGREP ?= egrep -ENV ?= env -EXPR ?= expr -MV ?= mv -f -SED ?= sed -SORT ?= sort -TOUCH ?= touch -UNIQ ?= uniq -WHICH ?= which -XARGS ?= xargs -SLEEP ?= sleep -# == LaTeX (tetex-provided) == -BIBTEX ?= bibtex -DVIPS ?= dvips -LATEX ?= latex -PDFLATEX ?= pdflatex -XELATEX ?= xelatex -EPSTOPDF ?= epstopdf -MAKEINDEX ?= makeindex -XINDY ?= xindy -KPSEWHICH ?= kpsewhich -GS ?= gs -# = OPTIONAL PROGRAMS = -# == For MikTex under Cygwin, to get path names right -CYGPATH ?= cygpath -# == Makefile Color Output == -TPUT ?= tput -# == TeX Generation == -PERL ?= perl -PYTHON ?= python -RST2LATEX ?= rst2latex.py -# == EPS Generation == -CONVERT ?= convert # ImageMagick -DOT ?= dot # GraphViz -DOT2TEX ?= dot2tex # dot2tex - add options (not -o) as needed -FIG2DEV ?= fig2dev # XFig -GNUPLOT ?= gnuplot # GNUplot -INKSCAPE ?= inkscape # Inkscape (svg support) -XMGRACE ?= xmgrace # XMgrace -PNGTOPNM ?= pngtopnm # From NetPBM - step 1 for png -> eps -PPMTOPGM ?= ppmtopgm # From NetPBM - (gray) step 2 for png -> eps -PNMTOPS ?= pnmtops # From NetPBM - step 3 for png -> eps -GUNZIP ?= gunzip # GZipped EPS -# == Beamer Enlarged Output == -PSNUP ?= psnup -# == Viewing Stuff == -VIEW_POSTSCRIPT ?= gv -VIEW_PDF ?= xpdf -VIEW_GRAPHICS ?= display - -# Xindy glossaries -XINDYLANG ?= english -XINDYENC ?= utf8 - -# If cygpath is present, then we create a path-norm function that uses it, -# otherwise the function is just a no-op. Issue 112 has details. -USE_CYGPATH := $(if $(shell $(WHICH) $(CYGPATH) 2>/dev/null),yes,) - -# $(call get-cygpath,<path>) -define get-cygpath -$(shell $(CYGPATH) -u "$(shell $(CYGPATH) -s -w $1)") -endef - -define path-norm -$(if $(USE_CYGPATH),$(call get-cygpath,$1),$1) -endef - -# Command options for embedding fonts and postscript->pdf conversion -PS_EMBED_OPTIONS ?= -dPDFSETTINGS=/printer -dEmbedAllFonts=true -dSubsetFonts=true -dMaxSubsetPct=100 -PS_COMPATIBILITY ?= 1.4 - -# If set to something, will cause temporary files to not be deleted immediately -KEEP_TEMP ?= - -# Defaults for GPI -DEFAULT_GPI_EPS_FONTSIZE ?= 22 -DEFAULT_GPI_PDF_FONTSIZE ?= 12 - -# Style file for ReST -RST_STYLE_FILE ?= $(wildcard _rststyle_._include_.tex) - -# This ensures that even when echo is a shell builtin, we still use the binary -# (the builtin doesn't always understand -n) -FIXED_ECHO := $(if $(findstring -n,$(shell $(ECHO) -n)),$(shell which echo),$(ECHO)) -ECHO := $(if $(FIXED_ECHO),$(FIXED_ECHO),$(ECHO)) - -define determine-gnuplot-output-extension -$(if $(shell $(WHICH) $(GNUPLOT) 2>/dev/null), - $(if $(findstring unknown or ambiguous, $(shell $(GNUPLOT) -e "set terminal pdf" 2>&1)), - eps, pdf), - none) -endef - -GNUPLOT_OUTPUT_EXTENSION ?= $(strip $(call determine-gnuplot-output-extension)) - -# Internal code should use this because of :=. This means that the potentially -# expensive script invocation used to determine whether pdf is available will -# only be run once. -GPI_OUTPUT_EXTENSION := $(strip $(GNUPLOT_OUTPUT_EXTENSION)) - -# Note, if the terminal *does* understand fsize, then we expect this call to -# create a specific error here: "fsize: expecting font size". Otherwise, we -# assume that fsize is not understood. -GPI_FSIZE_SYNTAX := $(strip \ -$(if \ - $(filter pdf,$(GPI_OUTPUT_EXTENSION)),\ - $(if \ - $(findstring fsize: expecting font size,$(shell $(GNUPLOT) -e "set terminal pdf fsize" 2>&1)),\ - fsize FONTSIZE,\ - font ",FONTSIZE"),\ - FONTSIZE)) - -# Directory into which we place "binaries" if it exists. -# Note that this can be changed on the commandline or in Makefile.ini: -# -# Command line: -# make BINARY_TARGET_DIR=$HOME/pdfs myfile.pdf -# -# Also, you can specify a relative directory (relative to the Makefile): -# make BINARY_TARGET_DIR=pdfs myfile.pdf -# -# Or, you can use Makefile.ini: -# -# BINARY_TARGET_DIR := $(HOME)/bin_out -# -BINARY_TARGET_DIR ?= _out_ - -RESTARTS := $(if $(MAKE_RESTARTS),$(MAKE_RESTARTS),0) -# SH NOTES -# -# On some systems, /bin/sh, which is the default shell, is not linked to -# /bin/bash. While bash is supposed to be sh-compatible when invoked as sh, it -# just isn't. This section details some of the things you have to stay away -# from to remain sh-compatible. -# -# * File pattern expansion does not work for {} -# * [ "$x" = "$y" ] has to be [ x"$x" x"$y" ] -# * &> for stderr redirection doesn't work, use 2>&1 instead -# -# BSD SED NOTES -# -# BSD SED is not very nice compared to GNU sed, but it is the most -# commonly-invoked sed on Macs (being based on BSD), so we have to cater to -# it or require people to install GNU sed. It seems like the GNU -# requirement isn't too bad since this makefile is really a GNU makefile, -# but apparently GNU sed is much less common than GNU make in general, so -# I'm supporting it here. -# -# Sad experience has taught me the following about BSD sed: -# -# * \+ is not understood to mean \{1,\} -# * \| is meaningless (does not branch) -# * \n cannot be used as a substitution character -# * ? does not mean \{0,1\}, but is literal -# * a\ works, but only reliably for a single line if subsequent lines -# have forward slashes in them (as is the case in postscript) -# -# For more info (on the Mac) you can consult -# -# man -M /usr/share/man re_format -# -# And look for the word "Obsolete" near the bottom. - -# -# EXTERNAL PROGRAM DOCUMENTATION SCRIPT -# - -# $(call output-all-programs,[<output file>]) -define output-all-programs - [ -f '$(this_file)' ] && \ - $(SED) \ - -e '/^[[:space:]]*#[[:space:]]*EXTERNAL PROGRAMS:/,/^$$/!d' \ - -e '/EXTERNAL PROGRAMS/d' \ - -e '/^$$/d' \ - -e '/^[[:space:]]*#/i\ '\ - -e 's/^[[:space:]]*#[[:space:]][^=]*//' \ - $(this_file) $(if $1,> '$1',) || \ - $(ECHO) "Cannot determine the name of this makefile." -endef - -# If they misspell gray, it should still work. -GRAY ?= $(call get-default,$(GREY),) - -# -# Utility Functions and Definitions -# - -# Don't call this directly - it is here to avoid calling wildcard more than -# once in remove-files. -remove-files-helper = $(if $1,$(RM) $1,$(sh_true)) - -# $(call remove-files,file1 file2) -remove-files = $(call remove-files-helper,$(wildcard $1)) - -# Removes all cleanable files in the given list -# $(call clean-files,file1 file2 file3 ...) -# Works exactly like remove-files, but filters out files in $(neverclean) -clean-files = \ - $(call remove-files-helper,$(call cleanable-files,$(wildcard $1))) - -# Outputs all generated files to STDOUT, along with some others that are -# created by these (e.g., .idx files end up producing .ilg and .ind files). -# Discovered by reading *.fls OUTPUT lines and producing corresponding .ind -# filenames as needed. -# -# $(call get-generated-names,<source recorder file (*.fls)>) -define get-generated-names -[ -f '$1' ] && \ -$(SED) \ - -e '/^OUTPUT /{' \ - -e ' s///' \ - -e ' p' \ - -e ' s/\.idx/\.ind/p' \ - -e ' s/\.ind/\.ilg/p' \ - -e '}' \ - -e 'd' \ - '$1' \ -| $(SORT) | $(UNIQ) -endef - -# This removes files without checking whether they are there or not. This -# sometimes has to be used when the file is created by a series of shell -# commands, but there ends up being a race condition: make doesn't know about -# the file generation as quickly as the system does, so $(wildcard ...) doesn't -# work right. Blech. -# $(call remove-temporary-files,filenames) -remove-temporary-files = $(if $(KEEP_TEMP),:,$(if $1,$(RM) $1,:)) - -# Create an identifier from a file name -# $(call cleanse-filename,filename) -cleanse-filename = $(subst .,_,$(subst /,__,$1)) - -# Escape dots -# $(call escape-fname-regex,str) -escape-fname-regex = $(subst /,\\/,$(subst .,\\.,$1)) - -# Test that a file exists -# $(call test-exists,file) -test-exists = [ -e '$1' ] - -# $(call move-files,source,destination) -move-if-exists = $(call test-exists,$1) && $(MV) '$1' '$2' - -# Copy file1 to file2 only if file2 doesn't exist or they are different -# $(call copy-if-different,sfile,dfile) -copy-if-different = $(call test-different,$1,$2) && $(CP) '$1' '$2' -copy-if-exists = $(call test-exists,$1) && $(CP) '$1' '$2' -move-if-different = $(call test-different,$1,$2) && $(MV) '$1' '$2' -replace-if-different-and-remove = \ - $(call test-different,$1,$2) \ - && $(MV) '$1' '$2' \ - || $(call remove-files,'$1') - -# Note that $(DIFF) returns success when the files are the SAME.... -# $(call test-different,sfile,dfile) -test-different = ! $(DIFF) -q '$1' '$2' >/dev/null 2>&1 -test-exists-and-different = \ - $(call test-exists,$2) && $(call test-different,$1,$2) - -# Return value 1, or value 2 if value 1 is empty -# $(call get-default,<possibly empty arg>,<default value if empty>) -get-default = $(if $1,$1,$2) - -# Copy a file and log what's going on -# $(call copy-with-logging,<source>,<target>) -define copy-with-logging -if [ -d '$2/' ]; then \ - if $(CP) '$1' '$2/'; then \ - $(ECHO) "$(C_INFO)Copied '$1' to '$2/'$(C_RESET)"; \ - else \ - $(ECHO) "$(C_ERROR)Failed to copy '$1' to '$2/'$(C_RESET)"; \ - fi; \ -fi -endef - -# Gives a reassuring message about the failure to find include files -# $(call include-message,<list of include files>) -define include-message -$(strip \ -$(if $(filter-out $(wildcard $1),$1),\ - $(shell $(ECHO) \ - "$(C_INFO)NOTE: You may ignore warnings about the"\ - "following files:" >&2;\ - $(ECHO) >&2; \ - $(foreach s,$(filter-out $(wildcard $1),$1),$(ECHO) ' $s' >&2;)\ - $(ECHO) "$(C_RESET)" >&2) -)) -endef -# Characters that are hard to specify in certain places -space := $(empty) $(empty) -colon := \: -comma := , - -# Useful shell definitions -sh_true := : -sh_false := ! : - -# Clear out the standard interfering make suffixes -.SUFFIXES: - -# Turn off forceful rm (RM is usually mapped to rm -f) -ifdef SAFE_RM -RM := rm -endif - -# Turn command echoing back on with VERBOSE=1 -ifndef VERBOSE -QUIET := @ -endif - -# Turn on shell debugging with SHELL_DEBUG=1 -# (EVERYTHING is echoed, even $(shell ...) invocations) -ifdef SHELL_DEBUG -SHELL += -x -endif - -# Get the name of this makefile (always right in 3.80, often right in 3.79) -# This is only really used for documentation, so it isn't too serious. -ifdef MAKEFILE_LIST -this_file := $(word $(words $(MAKEFILE_LIST)),$(MAKEFILE_LIST)) -else -this_file := $(wildcard GNUmakefile makefile Makefile) -endif - -# Terminal color definitions - -REAL_TPUT := $(if $(NO_COLOR),,$(shell $(WHICH) $(TPUT))) - -# $(call get-term-code,codeinfo) -# e.g., -# $(call get-term-code,setaf 0) -get-term-code = $(if $(REAL_TPUT),$(shell $(REAL_TPUT) $1),) - -black := $(call get-term-code,setaf 0) -red := $(call get-term-code,setaf 1) -green := $(call get-term-code,setaf 2) -yellow := $(call get-term-code,setaf 3) -blue := $(call get-term-code,setaf 4) -magenta := $(call get-term-code,setaf 5) -cyan := $(call get-term-code,setaf 6) -white := $(call get-term-code,setaf 7) -bold := $(call get-term-code,bold) -uline := $(call get-term-code,smul) -reset := $(call get-term-code,sgr0) - -# -# User-settable definitions -# -LATEX_COLOR_WARNING ?= magenta -LATEX_COLOR_ERROR ?= red -LATEX_COLOR_INFO ?= green -LATEX_COLOR_UNDERFULL ?= magenta -LATEX_COLOR_OVERFULL ?= red bold -LATEX_COLOR_PAGES ?= bold -LATEX_COLOR_BUILD ?= cyan -LATEX_COLOR_GRAPHIC ?= yellow -LATEX_COLOR_DEP ?= green -LATEX_COLOR_SUCCESS ?= green bold -LATEX_COLOR_FAILURE ?= red bold - -# Gets the real color from a simple textual definition like those above -# $(call get-color,ALL_CAPS_COLOR_NAME) -# e.g., $(call get-color,WARNING) -get-color = $(subst $(space),,$(foreach c,$(LATEX_COLOR_$1),$($c))) - -# -# STANDARD COLORS -# -C_WARNING := $(call get-color,WARNING) -C_ERROR := $(call get-color,ERROR) -C_INFO := $(call get-color,INFO) -C_UNDERFULL := $(call get-color,UNDERFULL) -C_OVERFULL := $(call get-color,OVERFULL) -C_PAGES := $(call get-color,PAGES) -C_BUILD := $(call get-color,BUILD) -C_GRAPHIC := $(call get-color,GRAPHIC) -C_DEP := $(call get-color,DEP) -C_SUCCESS := $(call get-color,SUCCESS) -C_FAILURE := $(call get-color,FAILURE) -C_RESET := $(reset) - -# -# PRE-BUILD TESTS -# - -# Check that clean targets are not combined with other targets (weird things -# happen, and it's not easy to fix them) -hascleangoals := $(if $(sort $(filter clean clean-%,$(MAKECMDGOALS))),1) -hasbuildgoals := $(if $(sort $(filter-out clean clean-%,$(MAKECMDGOALS))),1) -ifneq "$(hasbuildgoals)" "" -ifneq "$(hascleangoals)" "" -$(error $(C_ERROR)Clean and build targets specified together$(C_RESET))) -endif -endif - -# -# VARIABLE DECLARATIONS -# - -# Names of sed scripts that morph gnuplot files -- only the first found is used -GNUPLOT_SED := global-gpi.sed gnuplot.sed -GNUPLOT_GLOBAL := global._include_.gpi gnuplot.global - -ifeq "$(strip $(BUILD_STRATEGY))" "latex" -default_graphic_extension ?= eps -latex_build_program ?= $(LATEX) -build_target_extension ?= dvi -hyperref_driver_pattern ?= hdvips -hyperref_driver_error ?= Using dvips: specify ps2pdf in the hyperref options. -endif - -ifeq "$(strip $(BUILD_STRATEGY))" "pdflatex" -default_graphic_extension ?= pdf -latex_build_program ?= $(PDFLATEX) -build_target_extension ?= pdf -hyperref_driver_pattern ?= hpdf.* -hyperref_driver_error ?= Using pdflatex: specify pdftex in the hyperref options (or leave it blank). -endif - -ifeq "$(strip $(BUILD_STRATEGY))" "xelatex" -default_graphic_extension ?= pdf -latex_build_program ?= $(XELATEX) -build_target_extension ?= pdf -hyperref_driver_pattern ?= hdvipdf.* -hyperref_driver_error ?= Using pdflatex: specify pdftex in the hyperref options (or leave it blank). -endif - -# Files of interest -all_files.tex ?= $(wildcard *.tex) -all_files.tex.sh ?= $(wildcard *.tex.sh) -all_files.tex.pl ?= $(wildcard *.tex.pl) -all_files.tex.py ?= $(wildcard *.tex.py) -all_files.rst ?= $(wildcard *.rst) -all_files.fig ?= $(wildcard *.fig) -all_files.gpi ?= $(wildcard *.gpi) -all_files.dot ?= $(wildcard *.dot) -all_files.xvg ?= $(wildcard *.xvg) -all_files.svg ?= $(wildcard *.svg) -all_files.png ?= $(wildcard *.png) -all_files.jpg ?= $(wildcard *.jpg) -all_files.jpeg ?= $(wildcard *.jpeg) -all_files.eps.gz ?= $(wildcard *.eps.gz) -all_files.eps ?= $(wildcard *.eps) - -# Utility function for obtaining all files not specified in $(neverclean) -# $(call cleanable-files,file1 file2 file3 ...) -# Returns the list of files that is not in $(wildcard $(neverclean)) -cleanable-files = $(filter-out $(wildcard $(neverclean)), $1) - -# Utility function for getting all .$1 files that are to be ignored -# * files listed in $(includes.$1) -# * files not listed in $(onlysources.$1) if it is defined -ignore_files = \ - $(includes.$1) \ - $(if $(onlysources.$1),$(filter-out $(onlysources.$1), $(all_files.$1))) - -# Patterns to never be allowed as source targets -ignore_patterns := %._include_ - -# Patterns allowed as source targets but not included in 'all' builds -nodefault_patterns := %._nobuild_ $(ignore_patterns) - -# Utility function for getting targets suitable building -# $(call filter-buildable,suffix) -filter-buildable = \ - $(filter-out $(call ignore_files,$1) \ - $(addsuffix .$1,$(ignore_patterns)),$(all_files.$1)) - -# Utility function for getting targets suitable for 'all' builds -# $(call filter-default,suffix) -filter-default = \ - $(filter-out $(call ignore_files,$1) \ - $(addsuffix .$1,$(nodefault_patterns)),$(all_files.$1)) - -# Top level sources that can be built even when they are not by default -files.tex := $(call filter-buildable,tex) -files.tex.sh := $(call filter-buildable,tex.sh) -files.tex.pl := $(call filter-buildable,tex.pl) -files.tex.py := $(call filter-buildable,tex.py) -files.rst := $(call filter-buildable,rst) -files.gpi := $(call filter-buildable,gpi) -files.dot := $(call filter-buildable,dot) -files.fig := $(call filter-buildable,fig) -files.xvg := $(call filter-buildable,xvg) -files.svg := $(call filter-buildable,svg) -files.png := $(call filter-buildable,png) -files.jpg := $(call filter-buildable,jpg) -files.jpeg := $(call filter-buildable,jpeg) -files.eps.gz := $(call filter-buildable,eps.gz) -files.eps := $(call filter-buildable,eps) - -# Make all pstex targets secondary. The pstex_t target requires the pstex -# target, and nothing else really depends on it, so it often gets deleted. -# This avoids that by allowing *all* fig files to be pstex targets, which is -# perfectly valid and causes no problems even if they're going to become eps -# files in the end. -.SECONDARY: $(patsubst %.fig,%.pstex,$(files.fig)) - -# Top level sources that are built by default targets -default_files.tex := $(call filter-default,tex) -default_files.tex.sh := $(call filter-default,tex.sh) -default_files.tex.pl := $(call filter-default,tex.pl) -default_files.tex.py := $(call filter-default,tex.py) -default_files.rst := $(call filter-default,rst) -default_files.gpi := $(call filter-default,gpi) -default_files.dot := $(call filter-default,dot) -default_files.fig := $(call filter-default,fig) -default_files.xvg := $(call filter-default,xvg) -default_files.svg := $(call filter-default,svg) -default_files.png := $(call filter-default,png) -default_files.jpg := $(call filter-default,jpg) -default_files.jpeg := $(call filter-default,jpeg) -default_files.eps.gz := $(call filter-default,eps.gz) -default_files.eps := $(call filter-default,eps) - -# Utility function for creating larger lists of files -# $(call concat-files,suffixes,[prefix]) -concat-files = $(foreach s,$1,$($(if $2,$2_,)files.$s)) - -# Useful file groupings -all_files_source := $(call concat-files,tex,all) -all_files_scripts := $(call concat-files,tex.sh tex.pl tex.py rst,all) - -.PHONY: $(all_files_scripts) - -default_files_source := $(call concat-files,tex,default) -default_files_scripts := $(call concat-files,tex.sh tex.pl tex.py rst,default) - -files_source := $(call concat-files,tex) -files_scripts := $(call concat-files,tex.sh tex.pl tex.py rst) - -# Utility function for obtaining stems -# $(call get-stems,suffix,[prefix]) -get-stems = $(sort $($(if $2,$2_,)files.$1:%.$1=%)) - -# List of all stems (including ._include_ and ._nobuild_ file stems) -all_stems.tex := $(call get-stems,tex,all) -all_stems.tex.sh := $(call get-stems,tex.sh,all) -all_stems.tex.pl := $(call get-stems,tex.pl,all) -all_stems.tex.py := $(call get-stems,tex.py,all) -all_stems.rst := $(call get-stems,rst,all) -all_stems.fig := $(call get-stems,fig,all) -all_stems.gpi := $(call get-stems,gpi,all) -all_stems.dot := $(call get-stems,dot,all) -all_stems.xvg := $(call get-stems,xvg,all) -all_stems.svg := $(call get-stems,svg,all) -all_stems.png := $(call get-stems,png,all) -all_stems.jpg := $(call get-stems,jpg,all) -all_stems.jpeg := $(call get-stems,jpeg,all) -all_stems.eps.gz := $(call get-stems,eps.gz,all) -all_stems.eps := $(call get-stems,eps,all) - -# List of all default stems (all default PDF targets): -default_stems.tex := $(call get-stems,tex,default) -default_stems.tex.sh := $(call get-stems,tex.sh,default) -default_stems.tex.pl := $(call get-stems,tex.pl,default) -default_stems.tex.py := $(call get-stems,tex.py,default) -default_stems.rst := $(call get-stems,rst,default) -default_stems.fig := $(call get-stems,fig,default) -default_stems.gpi := $(call get-stems,gpi,default) -default_stems.dot := $(call get-stems,dot,default) -default_stems.xvg := $(call get-stems,xvg,default) -default_stems.svg := $(call get-stems,svg,default) -default_stems.png := $(call get-stems,png,default) -default_stems.jpg := $(call get-stems,jpg,default) -default_stems.jpeg := $(call get-stems,jpeg,default) -default_stems.eps.gz := $(call get-stems,eps.gz,default) -default_stems.eps := $(call get-stems,eps,default) - -# List of all stems (all possible bare PDF targets created here): -stems.tex := $(call get-stems,tex) -stems.tex.sh := $(call get-stems,tex.sh) -stems.tex.pl := $(call get-stems,tex.pl) -stems.tex.py := $(call get-stems,tex.py) -stems.rst := $(call get-stems,rst) -stems.fig := $(call get-stems,fig) -stems.gpi := $(call get-stems,gpi) -stems.dot := $(call get-stems,dot) -stems.xvg := $(call get-stems,xvg) -stems.svg := $(call get-stems,svg) -stems.png := $(call get-stems,png) -stems.jpg := $(call get-stems,jpg) -stems.jpeg := $(call get-stems,jpeg) -stems.eps.gz := $(call get-stems,eps.gz) -stems.eps := $(call get-stems,eps) - -# Utility function for creating larger lists of stems -# $(call concat-stems,suffixes,[prefix]) -concat-stems = $(sort $(foreach s,$1,$($(if $2,$2_,)stems.$s))) - -# The most likely to be source but not finished product go first -graphic_source_extensions := fig \ - gpi \ - xvg \ - svg \ - dot \ - eps.gz - -ifeq "$(strip $(BUILD_STRATEGY))" "latex" -graphic_source_extensions += png jpg jpeg -graphic_target_extensions := eps ps -endif - -ifeq "$(strip $(BUILD_STRATEGY))" "pdflatex" -graphic_source_extensions += eps -graphic_target_extensions := pdf png jpg jpeg mps tif -endif - -ifeq "$(strip $(BUILD_STRATEGY))" "xelatex" -graphic_source_extensions += eps -graphic_target_extensions := pdf png jpg jpeg mps tif -endif - -all_stems_source := $(call concat-stems,tex,all) -all_stems_script := $(call concat-stems,tex.sh tex.pl tex.py rst,all) -all_stems_graphic := $(call concat-stems,$(graphic_source_extensions),all) -all_stems_ss := $(sort $(all_stems_source) $(all_stems_script)) -all_stems_sg := $(sort $(all_stems_script)) -all_stems_ssg := $(sort $(all_stems_ss)) - -default_stems_source := $(call concat-stems,tex,default) -default_stems_script := $(call concat-stems,tex.sh tex.pl tex.py rst,default) -default_stems_ss := $(sort $(default_stems_source) $(default_stems_script)) -default_stems_sg := $(sort $(default_stems_script)) -default_stems_ssg := $(sort $(default_stems_ss)) - -stems_source := $(call concat-stems,tex) -stems_script := $(call concat-stems,tex.sh tex.pl tex.py rst) -stems_graphic := $(call concat-stems,$(graphic_source_extensions)) -stems_gg := $(sort $(stems_graphic)) -stems_ss := $(sort $(stems_source) $(stems_script)) -stems_sg := $(sort $(stems_script)) -stems_ssg := $(sort $(stems_ss)) - -# Calculate names that can generate the need for an include file. We can't -# really do this with patterns because it's too easy to screw up, so we create -# an exhaustive list. -allowed_source_suffixes := \ - pdf \ - ps \ - dvi \ - ind \ - nls \ - bbl \ - aux \ - aux.make \ - d \ - auxbbl.make \ - _graphics \ - _show -allowed_source_patterns := $(addprefix %.,$(allowed_source_suffixes)) - -allowed_graphic_suffixes := \ - pdf \ - eps \ - gpihead.make \ - gpi.d -allowed_graphic_patterns := $(addprefix %.,$(allowed_graphic_suffixes)) - -# All targets allowed to build documents -allowed_source_targets := \ - $(foreach suff,$(allowed_source_suffixes),\ - $(addsuffix .$(suff),$(stems_ssg))) - -# All targets allowed to build graphics -allowed_graphic_targets := \ - $(foreach suff,$(allowed_graphic_suffixes),\ - $(addsuffix .$(suff),$(stems_gg))) - -# All targets that build multiple documents (like 'all') -allowed_batch_source_targets := \ - all \ - all-pdf \ - all-ps \ - all-dvi \ - all-bbl \ - all-ind \ - all-gls \ - all-nls \ - show - -# All targets that build multiple graphics (independent of document) -allowed_batch_graphic_targets := \ - all-graphics \ - all-pstex \ - all-dot2tex \ - show-graphics - -# Now we figure out which stuff is available as a make target for THIS RUN. -real_goals := $(call get-default,$(filter-out _includes,$(MAKECMDGOALS)),\ - all) - -specified_source_targets := $(strip \ - $(filter $(allowed_source_targets) $(stems_ssg),$(real_goals)) \ - ) - -specified_batch_source_targets := $(strip \ - $(filter $(allowed_batch_source_targets),$(real_goals)) \ - ) - -specified_graphic_targets := $(strip \ - $(filter $(allowed_graphic_targets),$(real_goals)) \ - ) - -specified_batch_graphic_targets := $(strip \ - $(filter $(allowed_batch_graphic_targets),$(real_goals)) \ - ) - -specified_gpi_targets := $(patsubst %.gpi,%.$(default_graphic_extension),\ - $(filter $(patsubst %.$(default_graphic_extension),%.gpi,$(specified_graphic_targets)),\ - $(all_files.gpi)) \ - ) - -# Determine which .d files need including from the information gained above. -# This is done by first checking whether a batch target exists. If it does, -# then all *default* stems are used to create possible includes (nobuild need -# not apply for batch status). If no batch targets exist, then the individual -# targets are considered and appropriate includes are taken from them. -source_stems_to_include := \ - $(sort\ - $(if $(specified_batch_source_targets),\ - $(default_stems_ss),\ - $(foreach t,$(specified_source_targets),\ - $(foreach p,$(allowed_source_patterns),\ - $(patsubst $p,%,$(filter $p $(stems_ssg),$t)) \ - )) \ - )) - -# Determine which .gpi.d files are needed using the above information. We -# first check whether a batch target is specified, then check individual -# graphics that may have been specified. -graphic_stems_to_include := \ - $(sort\ - $(if $(specified_batch_graphic_targets),\ - $(default_stems.gpi),\ - $(foreach t,$(specified_gpi_targets),\ - $(foreach p,$(allowed_graphic_patterns),\ - $(patsubst $p,%,$(filter $p,$t)) \ - )) \ - )) - -# All dependencies for the 'all' targets -all_pdf_targets := $(addsuffix .pdf,$(stems_ssg)) -all_ps_targets := $(addsuffix .ps,$(stems_ssg)) -all_dvi_targets := $(addsuffix .dvi,$(stems_ssg)) -all_tex_targets := $(addsuffix .tex,$(stems_sg)) -all_d_targets := $(addsuffix .d,$(stems_ssg)) -all_graphics_targets := $(addsuffix .$(default_graphic_extension),$(stems_gg)) -all_pstex_targets := $(addsuffix .pstex_t,$(stems.fig)) -all_dot2tex_targets := $(addsuffix .dot_t,$(stems.dot)) - -all_known_graphics := $(sort $(all_graphics_targets) $(wildcard *.$(default_graphic_extension))) - -default_pdf_targets := $(addsuffix .pdf,$(default_stems_ss)) - -ifeq "$(strip $(BUILD_STRATEGY))" "latex" -default_ps_targets := $(addsuffix .ps,$(default_stems_ss)) -default_dvi_targets := $(addsuffix .dvi,$(default_stems_ss)) -pre_pdf_extensions := dvi ps -endif - -# Extensions generated by LaTeX invocation that can be removed when complete -rm_ext := \ - log *.log aux $(pre_pdf_extensions) pdf blg bbl out nav snm toc lof lot lol pfg \ - fls vrb idx ind ilg glg glo gls lox nls nlo nlg brf mtc maf brf ist -backup_patterns := *~ *.bak *.backup body.tmp head.tmp - -graph_stem := _graph - -# All LaTeX-generated files that can be safely removed - -rm_tex := \ - $(foreach e,$(rm_ext),$(addsuffix .$e,$(all_stems_source))) \ - $(foreach e,$(rm_ext) tex,$(addsuffix .$e,$(all_stems_sg))) \ - $(addsuffix .log,$(all_ps_targets) $(all_pdf_targets)) \ - $(addsuffix .*.log,$(stems_graphic)) - -# These are the files that will affect .gpi transformation for all .gpi files. -# -# Use only the first one found. Backward compatible values are at the end. -# Note that we use foreach, even though wildcard also returns a list, to ensure -# that the order in the uppercase variables is preserved. Directory listings -# provide no such guarantee, so we avoid relying on them. -gpi_sed := $(strip \ - $(firstword $(foreach f,$(GNUPLOT_SED),$(wildcard $f)))) -gpi_global := $(strip \ - $(firstword $(foreach f,$(GNUPLOT_GLOBAL),$(wildcard $f)))) - -# -# Functions used in generating output -# - -# Outputs all source dependencies to stdout. The first argument is the file to -# be parsed, the second is a list of files that will show up as dependencies in -# the new .d file created here. -# -# $(call get-inputs,<parsed file>,<target files>) -define get-inputs -$(SED) \ --e '/^INPUT/!d' \ --e 's!^INPUT $\./$\{0,1\}!!' \ --e 's/[[:space:]]/\\ /g' \ --e 's/$.*$\.aux$$/\1.tex/' \ --e '/\.tex$$/b addtargets' \ --e '/\.cls$$/b addtargets' \ --e '/\.sty$$/b addtargets' \ --e '/\.pstex_t$$/b addtargets' \ --e '/\.dot_t$$/b addtargets' \ --e 'd' \ --e ':addtargets' \ --e 's!.*!$2: $$(call path-norm,&)!' \ -'$1' | $(SORT) | $(UNIQ) -endef - -# $(call get-missing-inputs,<log file>,<target files>) -define get-missing-inputs -$(SED) \ --e '$${' \ --e ' /^$$/!{' \ --e ' H' \ --e ' s/.*//' \ --e ' }' \ --e '}' \ --e '/^$$/!{' \ --e ' H' \ --e ' d' \ --e '}' \ --e '/^$$/{' \ --e ' x' \ --e ' s/^$\n$$.*$/\2\1/' \ --e '}' \ --e '/^::P$P\{1,\}$::/{' \ --e ' s//::\1::/' \ --e ' G' \ --e ' h' \ --e ' d' \ --e '}' \ --e '/^::P::/{' \ --e ' s//::0::/' \ --e ' G' \ --e '}' \ --e 'b start' \ --e ':needonemore' \ --e 's/^/::P::/' \ --e 'G' \ --e 'h' \ --e 'd' \ --e ':needtwomore' \ --e 's/^/::PP::/' \ --e 'G' \ --e 'h' \ --e 'd' \ --e ':needthreemore' \ --e 's/^/::PPP::/' \ --e 'G' \ --e 'h' \ --e 'd' \ --e ':start' \ --e '/^! LaTeX Error: File `/{' \ --e ' b needtwomore' \ --e '}' \ --e '/^::0::$.*$/{' \ --e ' s//\1/' \ --e ' /Default extension: /!d' \ --e ' s/.*File `$[^'"'"']*$'"'"' not found.*/\1/' \ --e ' s/[[:cntrl:]]//' \ --e ' /\.tex/!s/$$/.tex/' \ --e ' s/[[:space:]]/\\ /g' \ --e ' h' \ --e ' s/.*/# MISSING input "&" - (presence of comment affects build)/' \ --e ' p' \ --e ' s/.*//' \ --e ' x' \ --e ' s!^.*!$2: $$(call path-norm,&)!' \ --e ' p' \ --e '}' \ --e 'd' \ -'$1' | $(SORT) | $(UNIQ) -endef - -# Get source file for specified graphics stem. -# -# $(call graphics-source,<stem>) -define graphics-source -$(strip $(firstword \ - $(wildcard \ - $(addprefix $1.,\ - $(graphic_source_extensions))) \ - $1 \ -)) -endef - -# Get the target file for the specified graphics file/stem -# -# $(call graphics-target,<stem>) -define graphics-target -$(strip $(if $(filter $(addprefix %.,$(graphic_target_extensions)),$1), $1, - $(firstword $(patsubst $(addprefix %.,$(graphic_source_extensions) $(graphic_target_extensions)), %, $1).$(default_graphic_extension) $1.$(default_graphic_extension)))) -endef - -# Outputs all of the graphical dependencies to stdout. The first argument is -# the stem of the source file being built, the second is a list of suffixes -# that will show up as dependencies in the generated .d file. -# -# Note that we try to escape spaces in filenames where possible. We have to do -# it with three backslashes so that as the name percolates through the makefile -# it eventually ends up with the proper escaping when the build rule is found. -# Ugly, but it appears to work. Note that graphicx doesn't allow filenames -# with spaces, so this could in many ways be moot unless you're using something -# like grffile. -# -# For pdflatex, we really need the missing file to be specified without an -# extension, otherwise compilation barfs on the first missing file. Truly -# annoying, but there you have it. -# -# It turns out that the graphics errors, although they have lines with empty -# space, are only made of two paragraphs. So, we just use some sed magic to -# get everything into paragraphs, detect when it's a paragraph that interests -# us, and double it up. Then we get the filename only if we're missing -# extensions (a sign that it's graphicx complaining). -# -# $(call get-graphics,<target file stem>) -#.log,$(addprefix $*.,d $(build_target_extension) _graphics) -define get-graphics -$(SED) \ --e '/^File: $.*$ Graphic file (type [^)]*)/{' \ --e ' s//\1/' \ --e ' b addtargets' \ --e '}' \ --e '$${' \ --e ' /^$$/!{' \ --e ' H' \ --e ' s/.*//' \ --e ' }' \ --e '}' \ --e '/^$$/!{' \ --e ' H' \ --e ' d' \ --e '}' \ --e '/^$$/{' \ --e ' x' \ --e ' s/^$\n$$.*$/\2\1/' \ --e '}' \ --e '/^::P$P\{1,\}$::/{' \ --e ' s//::\1::/' \ --e ' G' \ --e ' h' \ --e ' d' \ --e '}' \ --e '/^::P::/{' \ --e ' s//::0::/' \ --e ' G' \ --e '}' \ --e 'b start' \ --e ':needonemore' \ --e 's/^/::P::/' \ --e 'G' \ --e 'h' \ --e 'd' \ --e ':needtwomore' \ --e 's/^/::PP::/' \ --e 'G' \ --e 'h' \ --e 'd' \ --e ':needthreemore' \ --e 's/^/::PPP::/' \ --e 'G' \ --e 'h' \ --e 'd' \ --e ':start' \ --e '/^[^[:cntrl:]:]*:[[:digit:]]\{1,\}: LaTeX Error: File `/{' \ --e ' s/\n//g' \ --e ' b needonemore' \ --e '}' \ --e '/^::0::.*: LaTeX Error: File `/{' \ --e ' /\n\n$$/{' \ --e ' s/^::0:://' \ --e ' b needonemore' \ --e ' }' \ --e ' s/\n\{1,\}/ /g' \ --e ' s/[[:space:]]\{1,\}/ /g' \ --e ' s/^.*File `//' \ --e ' s/'"'"' not found\..*extensions: $[^[:space:]]*$.*/::::\1/' \ --e ' h' \ --e ' s/$.*$::::$.*$/# MISSING stem "\1" - allowed extensions are "\2" - leave comment here - it affects the build/' \ --e ' p' \ --e ' g' \ --e ' s/::::.*//' \ --e ' b addtargets' \ --e '}' \ --e 'd' \ --e ':addtargets' \ --e 's/[[:space:]]/\\\\\\&/g' \ --e 'h' \ --e 's/.*/-include &.gpi.d/' \ --e 'p' \ --e 'g' \ --e 's!.*!$1.d: $$$$(call graphics-source,&)!' \ --e 'p' \ --e 's/.*//' \ --e 'x' \ --e 's!.*!$1.$(build_target_extension) $1._graphics: $$$$(call graphics-target,&)!' \ --e 'p' \ --e 'd' \ -$1.log -endef - -# Checks for build failure due to pstex inclusion, and gives instructions. -# -# $(call die-on-pstexs,<parsed file>) -define die-on-pstexs -if $(EGREP) -q '^! LaTeX Error: File .*\.pstex.* not found' $1; then \ - $(ECHO) "$(C_ERROR)Missing pstex_t file(s)$(C_RESET)"; \ - $(ECHO) "$(C_ERROR)Please run$(C_RESET)"; \ - $(ECHO) "$(C_ERROR) make all-pstex$(C_RESET)"; \ - $(ECHO) "$(C_ERROR)before proceeding.$(C_RESET)"; \ - exit 1; \ -fi -endef - -# Checks for the use of import.sty and bails - we don't support subdirectories -# -# $(call die-on-import-sty,<log file>) -define die-on-import-sty -if $(EGREP) -s '/import.sty\)' '$1'; then \ - $(ECHO) "$(C_ERROR)import.sty is not supported - included files must"; \ - $(ECHO) "$(C_ERROR)be in the same directory as the primary document$(C_RESET)"; \ - exit 1; \ -fi -endef - -# Checks for build failure due to dot2tex, and gives instructions. -# -# $(call die-on-dot2tex,<parsed file>) -define die-on-dot2tex -if $(EGREP) -q ' LaTeX Error: File .*\.dot_t.* not found' $1; then \ - $(ECHO) "$(C_ERROR)Missing dot_t file(s)$(C_RESET)"; \ - $(ECHO) "$(C_ERROR)Please run$(C_RESET)"; \ - $(ECHO) "$(C_ERROR) make all-dot2tex$(C_RESET)"; \ - $(ECHO) "$(C_ERROR)before proceeding.$(C_RESET)"; \ - exit 1; \ -fi -endef - -# Checks for the existence of a .aux file, and dies with an error message if it -# isn't there. Note that we pass the file stem in, not the full filename, -# e.g., to check for foo.aux, we call it thus: $(call die-on-no-aux,foo) -# -# $(call die-on-no-aux,<aux stem>) -define die-on-no-aux -if [ ! -e '$1.aux' ]; then \ - $(call colorize-latex-errors,$1.log); \ - $(ECHO) "$(C_ERROR)Error: failed to create $1.aux$(C_RESET)"; \ - exit 1; \ -fi -endef - -# Outputs all index files to stdout. Arg 1 is the source file stem, arg 2 is -# the list of targets for the discovered dependency. -# -# $(call get-log-index,<log file stem>,<target files>) -define get-log-index -$(SED) \ --e 's/^No file $.*\.ind$\.$$/TARGETS=\1/' \ --e 's/^No file $.*\.[gn]ls$\.$$/TARGETS=\1/' \ --e 's/[[:space:]]/\\&/g' \ --e '/^TARGETS=/{' \ --e ' h' \ --e ' s!^TARGETS=!$2: !p' \ --e ' g' \ --e ' s!^TARGETS=$.*$!\1: $1.tex!p' \ --e '}' \ --e 'd' \ -'$1.log' | $(SORT) | $(UNIQ) -endef - - -# Outputs all bibliography files to stdout. Arg 1 is the source stem, arg 2 is -# a list of targets for each dependency found. -# -# The script kills all lines that do not contain bibdata. Remaining lines have -# the \bibdata macro and delimiters removed to create a dependency list. A -# trailing comma is added, then all adjacent commas are collapsed into a single -# comma. Then commas are replaced with the string .bib[space], and the -# trailing space is killed off. Finally, all filename spaces are escaped. -# This produces a list of space-delimited .bib filenames, which is what the -# make dep file expects to see. -# -# Note that we give kpsewhich a bogus argument so that a failure of sed to -# produce output will not cause an error. -# -# $(call get-bibs,<aux file>,<targets>) -define get-bibs -$(SED) \ --e '/^\\bibdata/!d' \ --e 's/\\bibdata{$[^}]*$}/\1,/' \ --e 's/,\{2,\}/,/g' \ --e 's/[[:space:]]/\\&/g' \ --e 's/,/.bib /g' \ --e 's/ \{1,\}$$//' \ -$1 | $(XARGS) $(KPSEWHICH) '#######' | \ -$(SED) \ --e 's!^!$2: !' | \ -$(SORT) | $(UNIQ) -endef - -# Makes a an aux file that only has stuff relevant to the target in it -# $(call make-auxtarget-file,<flattened-aux>,<new-aux>) -define make-auxtarget-file -$(SED) \ --e '/^\\newlabel/!d' \ -$1 > $2 -endef - -# Makes an aux file that only has stuff relevant to the bbl in it -# $(call make-auxbbl-file,<flattened-aux>,<new-aux>) -define make-auxbbl-file -$(SED) \ --e '/^\\newlabel/d' \ -$1 > $2 -endef - -# Makes a .gpi.d file from a .gpi file -# $(call make-gpi-d,<.gpi>,<.gpi.d>) -define make-gpi-d -$(ECHO) '# vim: ft=make' > $2; \ -$(ECHO) 'ifndef INCLUDED_$(call cleanse-filename,$2)' >> $2; \ -$(ECHO) 'INCLUDED_$(call cleanse-filename,$2) := 1' >> $2; \ -$(call get-gpi-deps,$1,$(addprefix $(2:%.gpi.d=%).,$(GPI_OUTPUT_EXTENSION) gpi.d)) >> $2; \ -$(ECHO) 'endif' >> $2; -endef - -# Parse .gpi files for data and loaded dependencies, output to stdout -# -# The sed script here tries to be clever about obtaining valid -# filenames from the gpi file. It assumes that the plot command starts its own -# line, which is not too difficult a constraint to satisfy. -# -# This command script also generates 'include' directives for every 'load' -# command in the .gpi file. The load command must appear on a line by itself -# and the file it loads must have the suffix .gpi. If you don't want it to be -# compiled when running make graphics, then give it a suffix of ._include_.gpi. -# -# $(call get-gpi-deps,<gpi file>,<targets>) -define get-gpi-deps -$(SED) \ --e '/^[[:space:]]*s\{0,1\}plot/,/[^\\]$$/{' \ --e ' H' \ --e ' /[^\\]$$/{' \ --e ' s/.*//' \ --e ' x' \ --e ' s/\\\{0,1\}\n//g' \ --e ' s/^[[:space:]]*s\{0,1\}plot[[:space:]]*$\[[^]]*\][[:space:]]*$*/,/' \ --e ' s/[[:space:]]*$['"'"'\'"'"''"'"'"][^'"'"'\'"'"''"'"'"]*['"'"'\'"'"''"'"'"]$\{0,1\}[^,]*/\1/g' \ --e ' s/,['"'"'\'"'"''"'"'"]-\{0,1\}['"'"'\'"'"''"'"'"]//g' \ --e ' s/[,'"'"'\'"'"''"'"'"]\{1,\}/ /g' \ --e ' s/.*:.*/$$(error Error: Filenames with colons are not allowed: &)/' \ --e ' s!.*!$2: &!' \ --e ' p' \ --e ' }' \ --e ' d' \ --e '}' \ --e 's/^[[:space:]]*load[[:space:]]*['"'"'\'"'"''"'"'"]$[^'"'"'\'"'"''"'"'"]*\.gpi$['"'"'\'"'"''"'"'"].*$$/-include \1.d/p' \ --e 'd' \ -'$1' -endef - -# Colorizes real, honest-to-goodness LaTeX errors that can't be overcome with -# recompilation. -# -# Note that we only ignore file not found errors for things that we know how to -# build, like graphics files. -# -# Also note that the output of this is piped through sed again to escape any -# backslashes that might have made it through. This is to avoid sending things -# like "\right" to echo, which interprets \r as LF. In bash, we could just do -# ${var//\\/\\\\}, but in other popular sh variants (like dash), this doesn't -# work. -# -# $(call colorize-latex-errors,<log file>) -define colorize-latex-errors -$(SED) \ --e '$${' \ --e ' /^$$/!{' \ --e ' H' \ --e ' s/.*//' \ --e ' }' \ --e '}' \ --e '/^$$/!{' \ --e ' H' \ --e ' d' \ --e '}' \ --e '/^$$/{' \ --e ' x' \ --e ' s/^$\n$$.*$/\2\1/' \ --e '}' \ --e '/^::P$P\{1,\}$::/{' \ --e ' s//::\1::/' \ --e ' G' \ --e ' h' \ --e ' d' \ --e '}' \ --e '/^::P::/{' \ --e ' s//::0::/' \ --e ' G' \ --e '}' \ --e 'b start' \ --e ':needonemore' \ --e 's/^/::P::/' \ --e 'G' \ --e 'h' \ --e 'd' \ --e ':needtwomore' \ --e 's/^/::PP::/' \ --e 'G' \ --e 'h' \ --e 'd' \ --e ':needthreemore' \ --e 's/^/::PPP::/' \ --e 'G' \ --e 'h' \ --e 'd' \ --e ':start' \ --e '/^! LaTeX Error: File /{' \ --e ' s/\n//g' \ --e ' b needtwomore' \ --e '}' \ --e 's/^[^[:cntrl:]:]*:[[:digit:]]\{1,\}:/!!! &/' \ --e 's/^$.*\n$$[^[:cntrl:]:]*:[[:digit:]]\{1,\}: .*$/\1!!! \2/' \ --e '/^!!! .* LaTeX Error: File /{' \ --e ' s/\n//g' \ --e ' b needonemore' \ --e '}' \ --e '/^::0::! LaTeX Error: File .*/{' \ --e ' /\n\n$$/{' \ --e ' s/^::0:://' \ --e ' b needonemore' \ --e ' }' \ --e ' s/^::0::! //' \ --e ' s/^$.*not found.$.*Enter file name:.*\n$.*[[:digit:]]\{1,\}$: Emergency stop.*/\2: \1/' \ --e ' b error' \ --e '}' \ --e '/^::0::!!! .*LaTeX Error: File .*/{' \ --e ' /\n\n$$/{' \ --e ' s/^::0:://' \ --e ' b needonemore' \ --e ' }' \ --e ' s/::0::!!! //' \ --e ' /could not locate.*any of these extensions:/{' \ --e ' d' \ --e ' }' \ --e ' s/$not found\.$.*/\1/' \ --e ' b error' \ --e '}' \ --e '/^$.* LaTeX Error: Missing .begin.document.\.$.*/{' \ --e ' s//\1 --- Are you trying to build an include file?/' \ --e ' b error' \ --e '}' \ --e '/.*$!!! .*Undefined control sequence$[^[:cntrl:]]*$.*$/{' \ --e ' s//\1: \2/' \ --e ' s/\nl\.[[:digit:]][^[:cntrl:]]*$\\[^\\[:cntrl:]]*$.*/\1/' \ --e ' b error' \ --e '}' \ --e '/^$!pdfTeX error:.*$s*/{' \ --e ' b error' \ --e '}' \ --e '/.*$!!! .*$/{' \ --e ' s//\1/' \ --e ' s/[[:cntrl:]]//' \ --e ' s/[[:cntrl:]]$$//' \ --e ' b error' \ --e '}' \ --e 'd' \ --e ':error' \ --e 's/^!$!! $\{0,1\}$.*$/$(C_ERROR)\2$(C_RESET)/' \ --e 'p' \ --e 'd' \ -'$1' | $(SED) -e 's/\\\\/\\\\\\\\/g' -endef - -# Colorize Makeindex errors -define colorize-makeindex-errors -$(SED) \ --e '/^!! /{' \ --e ' N' \ --e ' s/^.*$$/$(C_ERROR)&$(C_RESET)/' \ --e ' p' \ --e '}' \ --e 'd' \ -'$1' -endef - -# Colorize xindy errors -# $(call colorize-xindy-errors,<log file>) -define colorize-xindy-errors -$(SED) \ --e 's/^xindy:.*/$(C_ERROR)&$(C_RESET)/p' \ --e 'd' \ -'$1' -endef - -# Colorize epstopdf errors -# -# $(call colorize-epstopdf-errors,<log file>) -define colorize-epstopdf-errors -$(SED) \ --e '/^Error:/,/^Execution stack:/{' \ --e ' /^Execution stack:/d' \ --e ' s/.*/$(C_ERROR)&$(C_RESET)/' \ --e ' p' \ --e '}' \ --e 'd' \ -'$1' -endef - -# Colorize GNUplot errors -# -# $(call colorize-gnuplot-errors,<log file>) -define colorize-gnuplot-errors -$(SED) \ --e '/, line [0-9]*:/!{' \ --e ' H' \ --e ' x' \ --e ' s/.*\n$.*\n.*$$$/\1/' \ --e ' x' \ --e '}' \ --e '/, line [0-9]*:/{' \ --e ' H' \ --e ' /unknown.*terminal type/{' \ --e ' s/.*/--- Try changing the GNUPLOT_OUTPUT_EXTENSION variable to '"'"'eps'"'"'./' \ --e ' H' \ --e ' }' \ --e ' /gpihead/{' \ --e ' s/.*/--- This could be a Makefile bug - contact the maintainer./' \ --e ' H' \ --e ' }' \ --e ' g' \ --e ' s/.*/$(C_ERROR)&$(C_RESET)/' \ --e ' p' \ --e '}' \ --e '/^gnuplot>/,/^$$/{' \ --e ' s/^gnuplot.*/$(C_ERROR)&/' \ --e ' s/^$$/$(C_RESET)/' \ --e ' p' \ --e '}' \ --e 'd' \ -$1 -endef - -# Colorize GraphViz errors -# -# $(call colorize-dot-errors,<log file>) -define colorize-dot-errors -$(SED) \ --e 's/.*not found.*/$(C_ERROR)&$(C_RESET)/p' \ --e '/^Error:/,/context:/s/.*/$(C_ERROR)&$(C_RESET)/p' \ --e 's/^Warning:.*/$(C_WARNING)&$(C_RESET)/p' \ --e 'd' \ -'$1' -endef - -# Get all important .aux files from the top-level .aux file and merges them all -# into a single file, which it outputs to stdout. -# -# $(call flatten-aux,<toplevel aux>,<output file>) -define flatten-aux -$(SED) \ --e '/\$a)input{\(.*$}/{' \ --e 's//\1/' \ --e 's![.:]!\\&!g' \ --e 'h' \ --e 's!.*!\\:\\\\@input{&}:{!' \ --e 'p' \ --e 'x' \ --e 's/\\././g' \ --e 's/.*/r &/p' \ --e 's/.*/d/p' \ --e 's/.*/}/p' \ --e 'd' \ --e '}' \ --e 'd' \ -'$1' > "$1.$$$$.sed.make"; \ -$(SED) -f "$1.$$$$.sed.make" '$1' > "$1.$$$$.make"; \ -$(SED) \ --e '/^\\relax/d' \ --e '/^\\bibcite/d' \ --e 's/^$\\newlabel{[^}]\{1,\}}$.*/\1/' \ -"$1.$$$$.make" | $(SORT) > '$2'; \ -$(call remove-temporary-files,$1.$$$$.make $1.$$$$.sed.make) -endef - -# Generate pdf from postscript -# -# Note that we don't just call ps2pdf, since there are so many versions of that -# script on various systems. Instead, we call the postscript interpreter -# directly. -# -# $(call ps2pdf,infile,outfile,[embed fonts]) -define ps2pdf - $(GS) \ - -dSAFER -dCompatibilityLevel=$(PS_COMPATIBILITY) \ - $(if $3,$(PS_EMBED_OPTIONS)) \ - -q -dNOPAUSE -dBATCH \ - -sDEVICE=pdfwrite -sstdout=%stderr \ - '-sOutputFile=$2' \ - -dSAFER -dCompatibilityLevel=$(PS_COMPATIBILITY) \ - $(if $3,$(PS_EMBED_OPTIONS)) \ - -c .setpdfwrite \ - -f '$1' -endef - -# Colorize LaTeX output. -color_tex := \ -$(SED) \ --e '$${' \ --e ' /^$$/!{' \ --e ' H' \ --e ' s/.*//' \ --e ' }' \ --e '}' \ --e '/^$$/!{' \ --e ' H' \ --e ' d' \ --e '}' \ --e '/^$$/{' \ --e ' x' \ --e ' s/^\n//' \ --e ' /Output written on /{' \ --e ' s/.*Output written on $[^(]*$ ($[^)]\{1,\}$).*/Success! Wrote \2 to \1/' \ --e ' s/[[:digit:]]\{1,\}/$(C_PAGES)&$(C_RESET)/g' \ --e ' s/Success!/$(C_SUCCESS)&$(C_RESET)/g' \ --e ' s/to $.*$$$/to $(C_SUCCESS)\1$(C_RESET)/' \ --e ' b end' \ --e ' }' \ --e ' / *LaTeX Error:.*/{' \ --e ' s/.*$ *LaTeX Error:.*$/$(C_ERROR)\1$(C_RESET)/' \ --e ' b end' \ --e ' }' \ --e ' /.*Warning:.*/{' \ --e ' s//$(C_WARNING)&$(C_RESET)/' \ --e ' b end' \ --e ' }' \ --e ' /Underfull.*/{' \ --e ' s/.*$Underfull.*$/$(C_UNDERFULL)\1$(C_RESET)/' \ --e ' b end' \ --e ' }' \ --e ' /Overfull.*/{' \ --e ' s/.*$Overfull.*$/$(C_OVERFULL)\1$(C_RESET)/' \ --e ' b end' \ --e ' }' \ --e ' d' \ --e ' :end' \ --e ' G' \ --e '}' - -# Colorize BibTeX output. -color_bib := \ -$(SED) \ --e 's/^Warning--.*/$(C_WARNING)&$(C_RESET)/' \ --e 't' \ --e '/---/,/^.[^:]/{' \ --e ' H' \ --e ' /^.[^:]/{' \ --e ' x' \ --e ' s/\n$.*$/$(C_ERROR)\1$(C_RESET)/' \ --e ' p' \ --e ' s/.*//' \ --e ' h' \ --e ' d' \ --e ' }' \ --e ' d' \ --e '}' \ --e '/(.*error.*)/s//$(C_ERROR)&$(C_RESET)/' \ --e 'd' - -# Make beamer output big enough to print on a full page. Landscape doesn't -# seem to work correctly. -enlarge_beamer = $(PSNUP) -l -1 -W128mm -H96mm -pletter - -# $(call test-run-again,<source stem>) -test-run-again = $(EGREP) -q '^(.*Rerun .*|No file $1\.[^.]+\.)$$' $1.log - -# This tests whether the build target commands should be run at all, from -# viewing the log file. -# $(call test-log-for-need-to-run,<source stem>) -define test-log-for-need-to-run -$(SED) \ --e '/^No file $(call escape-fname-regex,$1)\.aux\./d' \ -$1.log \ -| $(EGREP) -q '^(.*Rerun .*|No file $1\.[^.]+\.|No file .+\.tex\.|LaTeX Warning: File.*)$$' -endef - -# LaTeX invocations -# -# $(call latex,<tex file>,[<extra LaTeX args>]) -run-latex = $(latex_build_program) -interaction=batchmode -file-line-error $(if $2,$2,) $1 > /dev/null - -# $(call latex-color-log,<LaTeX stem>) -latex-color-log = $(color_tex) $1.log - -# $(call run-makeindex,<input>,<output>,<log>,[.ist style file]) -define run-makeindex -success=1; \ -if ! $(MAKEINDEX) -q $1 -t $3 -o $2 $(if $4,-s $4,) > /dev/null || $(EGREP) -q '^!!' $3; \ -then \ - $(call colorize-makeindex-errors,$3); \ - $(RM) -f '$2'; \ - success=0; \ -fi; \ -[ "$$success" = "1" ] && $(sh_true) || $(sh_false); -endef - - -# $(call run-xindy,<input>,<output>,<module>,<log>) -define run-xindy -success=1; \ -if ! $(XINDY) -q -o $2 -L $(XINDYLANG) -C $(XINDYENC) -I xindy -M $3 -t $4 $1 > /dev/null || $(EGREP) -q '^xindy:' $4; then \ - $(call colorize-xindy-errors,$4); \ - $(RM) -f '$2'; \ - success=0; \ -fi; \ -[ "$$success" = "1" ] && $(sh_true) || $(sh_false); -endef - -# This runs the given script to generate output, and it uses MAKE_RESTARTS to -# ensure that it never runs it more than once for a particular root make -# invocation. -# -# $(call run-script,<interpreter>,<input>,<output>) -define run-script -[ ! -e '$2.cookie' ] && $(ECHO) "restarts=$(RESTARTS)" > $2.cookie && $(ECHO) "level=$(MAKELEVEL)" >> $2.cookie; \ -restarts=`$(SED) -n -e 's/^restarts=//p' $2.cookie`; \ -level=`$(SED) -n -e 's/^level=//p' $2.cookie`; \ -if $(EXPR) $(MAKELEVEL) '<=' $$level '&' $(RESTARTS) '<=' $$restarts >/dev/null; then \ - $(call echo-build,$2,$3,$(RESTARTS)-$(MAKELEVEL)); \ - $1 '$2' '$3'; \ - $(ECHO) "restarts=$(RESTARTS)" > '$2.cookie'; \ - $(ECHO) "level=$(MAKELEVEL)" >> '$2.cookie'; \ -fi -endef - -# BibTeX invocations -# -# $(call run-bibtex,<tex stem>) -run-bibtex = $(BIBTEX) $1 | $(color_bib) - - -# $(call convert-eps-to-pdf,<eps file>,<pdf file>,[gray]) -# Note that we don't use the --filter flag because it has trouble with bounding boxes that way. -define convert-eps-to-pdf -$(if $3,$(CAT) '$1' | $(call kill-ps-color) > '$1.cookie',$(CP) '$1' '$1.cookie'); \ -$(EPSTOPDF) '$1.cookie' --outfile='$2' > $1.log; \ -$(call colorize-epstopdf-errors,$1.log); -endef - -# $(call default-gpi-fontsize,<output file>) -# -# Find the default fontsize given the *output* file (it is based on the output extension) -# -default-gpi-fontsize = $(if $(filter %.pdf,$1),$(DEFAULT_GPI_PDF_FONTSIZE),$(DEFAULT_GPI_EPS_FONTSIZE)) - -# $(call gpi-fontsize,<gpi file>,<output file>) -# -# Find out what the gnuplot fontsize should be. Tries, in this order: -# - ##FONTSIZE comment in gpi file -# - ##FONTSIZE comment in global gpi file -# - default fontsize based on output type -define gpi-fontsize -$(strip $(firstword \ - $(shell $(SED) -e 's/^\#\#FONTSIZE=$[[:digit:]]\{1,\}$/\1/p' -e 'd' $1 $(strip $(gpi_global))) \ - $(call default-gpi-fontsize,$2))) -endef - -# $(call gpi-monochrome,<gpi file>,[gray]) -define gpi-monochrome -$(strip $(if $2,monochrome,$(if $(shell $(EGREP) '^\#\#[[:space:]]*GRAY[[:space:]]*$$' $1 $(gpi_global)),monochrome,color))) -endef - -# $(call gpi-font-entry,<output file>,<fontsize>) -# -# Get the font entry given the output file (type) and the font size. For PDF -# it uses fsize or font, for eps it just uses the bare number. -gpi-font-entry = $(if $(filter %.pdf,$1),$(subst FONTSIZE,$2,$(GPI_FSIZE_SYNTAX)),$2) - -# $(call gpi-terminal,<gpi file><output file>,[gray]) -# -# Get the terminal settings for a given gpi and its intended output file -define gpi-terminal -$(if $(filter %.pdf,$2),pdf enhanced,postscript enhanced eps) \ -$(call gpi-font-entry,$2,$(call gpi-fontsize,$1,$2)) \ -$(call gpi-monochrome,$1,$3) -endef - -# $(call gpi-embed-pdf-fonts,<input file>,<output file>) -# -define gpi-embed-pdf-fonts -$(GS) \ - -q \ - -dSAFER \ - -dNOPAUSE \ - -dBATCH \ - -sDEVICE=$(if $(filter pdf,$(GPI_OUTPUT_EXTENSION)),pdfwrite,pswrite) \ - -sOutputFile='$2' \ - -sstdout=%stderr \ - -dCompatibilityLevel=1.5 \ - -dPDFSETTINGS=/prepress \ - -c .setpdfwrite \ - -f '$1' -endef - -# $(call convert-gpi,<gpi file>,<output file>,[gray]) -# -define convert-gpi -$(ECHO) 'set terminal $(call gpi-terminal,$1,$2,$3)' > $1head.make; \ -$(ECHO) 'set output "$2"' >> $1head.make; \ -$(if $(gpi_global),$(CAT) $(gpi_global) >> $1head.make;,) \ -fnames='$1head.make $1';\ -$(if $(gpi_sed),\ - $(SED) -f '$(gpi_sed)' $$fnames > $1.temp.make; \ - fnames=$1.temp.make;,\ -) \ -success=1; \ -if ! $(GNUPLOT) $$fnames 2>$1.log; then \ - $(call colorize-gnuplot-errors,$1.log); \ - success=0; \ -else \ - if ! $(call gpi-embed-pdf-fonts,$2,$2.embed.make); then \ - success = 0; \ - else \ - $(call move-if-exists,$2.embed.make,$2); \ - fi; \ -fi; \ -$(if $(gpi_sed),$(call remove-temporary-files,$1.temp.make);,) \ -$(call remove-temporary-files,$1head.make); \ -[ "$$success" = "1" ] && $(sh_true) || $(sh_false); -endef - -# Creation of .eps files from .png files -# -# The intermediate step of PNM (using NetPBM) produces much nicer output than -# ImageMagick's "convert" binary. I couldn't get the right combination of -# flags to make it look nice, anyway. -# -# To handle gray scale conversion, we pipe things through ppmtopgm in the -# middle. -# -# $(call convert-png,<png file>,<eps file>) -define convert-png -$(PNGTOPNM) "$1" \ - $(if $3,| $(PPMTOPGM),) \ - | $(PNMTOPS) -noturn \ - > "$2" -endef - -# Creation of .eps files from .jpg/.jpeg files -# -# Thanks to brubakee for this solution. -# -# Uses Postscript level 2 to avoid file size bloat -# $(call convert-jpg,<jpg file>,<eps file>) -define convert-jpg -$(CONVERT) $(if $3,-type Grayscale,) '$1' eps2:'$2' -endef - -# Creation of .eps files from .fig files -# $(call convert-fig,<fig file>,<output file>,[gray]) -convert-fig = $(FIG2DEV) -L $(if $(filter %.pdf,$2),pdf,eps) $(if $3,-N,) $1 $2 - -# Creation of .pstex files from .fig files -# $(call convert-fig-pstex,<fig file>,<pstex file>) -convert-fig-pstex = $(FIG2DEV) -L pstex $1 $2 > /dev/null 2>&1 - -# Creation of .pstex_t files from .fig files -# $(call convert-fig-pstex-t,<fig file>,<pstex file>,<pstex_t file>) -convert-fig-pstex-t = $(FIG2DEV) -L pstex_t -p $3 $1 $2 > /dev/null 2>&1 - -# Creation of .dot_t files from .dot files -# #(call convert-dot-tex,<dot file>,<dot_t file>) -convert-dot-tex = $(DOT2TEX) '$1' > '$2' - -# Converts svg files into .eps files -# -# $(call convert-svg,<svg file>,<eps/pdf file>,[gray]) -convert-svg = $(INKSCAPE) --without-gui $(if $(filter %.pdf,$2),--export-pdf,--export-eps)='$2' '$1' - -# Converts xvg files into .eps files -# -# $(call convert-xvg,<xvg file>,<eps file>,[gray]) -convert-xvg = $(XMGRACE) '$1' -printfile - -hardcopy -hdevice $(if $3,-mono,) EPS > '$2' - -# Converts .eps.gz files into .eps files -# -# $(call convert-epsgz,<eps.gz file>,<eps file>,[gray]) -convert-epsgz = $(GUNZIP) -c '$1' $(if $3,| $(call kill-ps-color)) > '$2' - -# Converts .eps files into .eps files (usually a no-op, but can make grayscale) -# -# $(call convert-eps,<in file>,<out file>,[gray]) -convert-eps = $(if $3,$(call kill-ps-color) $1 > $2) - -# The name of the file containing special postscript commands for grayscale -gray_eps_file := gray.eps.make - -# Changes sethsbcolor and setrgbcolor calls in postscript to always produce -# grayscale. In general, this is accomplished by writing new versions of those -# functions into the user dictionary space, which is looked up before the -# global or system dictionaries (userdict is one of the permanent dictionaries -# in postscript and is not read-only like systemdict). -# -# For setrgbcolor, the weighted average of the triple is computed and the -# triple is replaced with three copies of that average before the original -# procedure is called: .299R + .587G + .114B -# -# For sethsbcolor, the color is first converted to RGB, then to grayscale by -# the new setrgbcolor operator as described above. Why is this done? -# Because simply using the value component will tend to make pure colors -# white, a very undesirable thing. Pure blue should not translate to white, -# but to some level of gray. Conversion to RGB does the right thing. It's -# messy, but it works. -# -# From -# http://en.wikipedia.org/wiki/HSV_color_space#Transformation_from_HSV_to_RGB, -# HSB = HSV (Value = Brightness), and the formula used to convert to RGB is -# as follows: -# -# Hi = int(floor(6 * H)) mod 6 -# f = 6 * H - Hi -# p = V(1-S) -# q = V(1-fS) -# t = V(1-(1-f)S) -# if Hi = 0: R G B <-- V t p -# if Hi = 1: R G B <-- q V p -# if Hi = 2: R G B <-- p V t -# if Hi = 3: R G B <-- p q V -# if Hi = 4: R G B <-- t p V -# if Hi = 5: R G B <-- V p q -# -# The messy stack-based implementation is below -# $(call create-gray-eps-file,filename) -define create-gray-eps-file -$(ECHO) -n -e '\ -/OLDRGB /setrgbcolor load def\n\ -/setrgbcolor {\n\ - .114 mul exch\n\ - .587 mul add exch\n\ - .299 mul add\n\ - dup dup\n\ - OLDRGB\n\ -} bind def\n\ -/OLDHSB /sethsbcolor load def\n\ -/sethsbcolor {\n\ - 2 index % H V S H\n\ - 6 mul floor cvi 6 mod % Hi V S H\n\ - 3 index % H Hi V S H\n\ - 6 mul % 6H Hi V S H\n\ - 1 index % Hi 6H Hi V S H\n\ - sub % f Hi V S H\n\ - 2 index 1 % 1 V f Hi V S H\n\ - 4 index % S 1 V f Hi V S H\n\ - sub mul % p f Hi V S H\n\ - 3 index 1 % 1 V p f Hi V S H\n\ - 6 index % S 1 V p f Hi V S H\n\ - 4 index % f S 1 V p f Hi V S H\n\ - mul sub mul % q p f Hi V S H\n\ - 4 index 1 1 % 1 1 V q p f Hi V S H\n\ - 5 index % f 1 1 V q p f Hi V S H\n\ - sub % (1-f) 1 V q p f Hi V S H\n\ - 8 index % S (1-f) 1 V q p f Hi V S H\n\ - mul sub mul % t q p f Hi V S H\n\ - 4 -1 roll pop % t q p Hi V S H\n\ - 7 -2 roll pop pop % t q p Hi V\n\ - 5 -2 roll % Hi V t q p\n\ - dup 0 eq\n\ - {1 index 3 index 6 index}\n\ - {\n\ - dup 1 eq\n\ - {3 index 2 index 6 index}\n\ - {\n\ - dup 2 eq\n\ - {4 index 2 index 4 index}\n\ - {\n\ - dup 3 eq\n\ - {4 index 4 index 3 index}\n\ - {\n\ - dup 4 eq\n\ - {2 index 5 index 3 index}\n\ - {\n\ - dup 5 eq\n\ - {1 index 5 index 5 index}\n\ - {0 0 0}\n\ - ifelse\n\ - }\n\ - ifelse\n\ - }\n\ - ifelse\n\ - }\n\ - ifelse\n\ - }\n\ - ifelse\n\ - }\n\ - ifelse % B G R Hi V t q p\n\ - setrgbcolor\n\ - 5 {pop} repeat\n\ -} bind def\n'\ -> $1 -endef - -# This actually inserts the color-killing code into a postscript file -# $(call kill-ps-color) -define kill-ps-color -$(SED) -e '/%%EndComments/r $(gray_eps_file)' -endef - -# Converts graphviz .dot files into .eps files -# Grayscale is not directly supported by dot, so we pipe it through fig2dev in -# that case. -# $(call convert-dot,<dot file>,<eps file>,<log file>,[gray]) -define convert-dot -$(DOT) -Tps '$1' 2>'$3' $(if $4,| $(call kill-ps-color)) > $2; \ -$(call colorize-dot-errors,$3) -endef - -# Convert DVI to Postscript -# $(call make-ps,<dvi file>,<ps file>,<log file>,[<paper size>]) -make-ps = \ - $(DVIPS) -z -o '$2' $(if $(filter-out BEAMER,$4),-t$(firstword $4),) '$1' \ - $(if $(filter BEAMER,$4),| $(enlarge_beamer)) > $3 2>&1 - -# Convert Postscript to PDF -# $(call make-pdf,<ps file>,<pdf file>,<log file>,<embed file>) -make-pdf = \ - $(call ps2pdf,$1,$2,$(filter 1,$(shell $(CAT) '$4'))) > '$3' 2>&1 - -# Display information about what is being done -# $(call echo-build,<input file>,<output file>,[<run number>]) -echo-build = $(ECHO) "$(C_BUILD)= $1 --> $2$(if $3, ($3),) =$(C_RESET)" -echo-graphic = $(ECHO) "$(C_GRAPHIC)= $1 --> $2 =$(C_RESET)" -echo-dep = $(ECHO) "$(C_DEP)= $1 --> $2 =$(C_RESET)" - -# Display a list of something -# $(call echo-list,<values>) -echo-list = for x in $1; do $(ECHO) "$$x"; done - -# -# DEFAULT TARGET -# - -.PHONY: all -all: $(default_pdf_targets) ; - -.PHONY: all-pdf -all-pdf: $(default_pdf_targets) ; - -ifeq "$(strip $(BUILD_STRATEGY))" "latex" -.PHONY: all-ps -all-ps: $(default_ps_targets) ; - -.PHONY: all-dvi -all-dvi: $(default_dvi_targets) ; -endif - -# -# VIEWING TARGET -# -.PHONY: show -show: all - $(QUIET)for x in $(default_pdf_targets); do \ - [ -e "$$x" ] && $(VIEW_PDF) $$x & \ - done - -# -# INCLUDES -# -source_includes := $(addsuffix .d,$(source_stems_to_include)) -graphic_includes := $(addsuffix .gpi.d,$(graphic_stems_to_include)) - -# Check the version of the makefile -ifneq "" "$(filter 3.79 3.80,$(MAKE_VERSION))" -$(warning $(C_WARNING)Your version of make is too old. Please upgrade.$(C_RESET)) -endif - -# Include only the dependencies used -ifneq "" "$(source_includes)" -include $(source_includes)$(call include-message,$(source_includes)) -endif -ifneq "" "$(graphic_includes)" -include $(graphic_includes)$(call include-message,$(graphic_includes)) -endif - -# -# MAIN TARGETS -# - -# Note that we don't just say %: %.pdf here - this can tend to mess up our -# includes, which detect what kind of file we are asking for. For example, -# asking to build foo.pdf is much different than asking to build foo when -# foo.gpi exists, because we look through all of the goals for *.pdf that -# matches *.gpi, then use that to determine which include files we need to -# build. -# -# Thus, we invoke make recursively with better arugments instead, restarting -# all of the appropriate machinery. -.PHONY: $(default_stems_ss) -$(default_stems_ss): %: %.pdf ; - -# This builds and displays the wanted file. -.PHONY: $(addsuffix ._show,$(stems_ssg)) -$(addsuffix ._show,$(stems_ssg)): %._show: %.pdf - $(QUIET)$(VIEW_PDF) $< & - -ifeq "$(strip $(BUILD_STRATEGY))" "latex" -.SECONDARY: $(all_pdf_targets) -%.pdf: %.ps %.embed.make - $(QUIET)$(call echo-build,$<,$@) - $(QUIET)$(call make-pdf,$<,$@.temp,$@.log,$*.embed.make); \ - if [ x"$$?" = x"0" ]; then \ - $(if $(VERBOSE),$(CAT) $@.log,:); \ - $(RM) -f '$@'; \ - $(MV) '$@.temp' '$@'; \ - $(TOUCH) '$@'; \ - $(call copy-with-logging,$@,$(BINARY_TARGET_DIR)); \ - else \ - $(CAT) $@.log; \ - $(call remove-temporary-files,'$@.temp'); \ - $(sh_false); \ - fi - -.SECONDARY: $(all_ps_targets) -%.ps: %.dvi %.paper.make - $(QUIET)$(call echo-build,$<,$@) - $(QUIET)$(call make-ps,$<,$@.temp,$@.log,\ - $(firstword $(shell $(CAT) $*.paper.make))); \ - if [ x"$$?" = x"0" ]; then \ - $(if $(VERBOSE),$(CAT) $@.log,:); \ - $(RM) -f '$@'; \ - $(MV) '$@.temp' '$@'; \ - $(TOUCH) '$@'; \ - $(call copy-with-logging,$@,$(BINARY_TARGET_DIR)); \ - else \ - $(CAT) $@.log; \ - $(call remove-temporary-files,'$@.temp'); \ - $(sh_false); \ - fi -endif - -# Build the final target (dvi or pdf) file. This is a very tricky rule because -# of the way that latex runs multiple times, needs graphics after the first run -# (or maybe already has them), and relies on bibliographies or indices that may -# not exist. -# -# Check the log for fatal errors. If they exist, colorize and bail. -# -# Create the .auxtarget.cookie file. (Needed for next time if not present) -# -# If any of the following are true, we must rebuild at least one time: -# -# * the .bbl was recently rebuilt -# -# check a cookie, then delete it -# -# * any of several output files was created or changed: -# -# check $*.run.cookie, then delete it -# -# * the .aux file changed in a way that necessitates attention -# -# Note that if the .auxtarget.make file doesn't exist, this means -# that we are doing a clean build, so it doesn't figure into the -# test for running again. -# -# compare against .auxtarget.make -# -# move if different, remove if not -# -# * the .log file has errors or warnings requiring at least one more run -# -# We use a loop over a single item to simplify the process of breaking -# out when we find one of the conditions to be true. -# -# If we do NOT need to run latex here, then we move the $@.1st.make file -# over to $@ because the target file has already been built by the first -# dependency run and is valid. -# -# If we do, we delete that cookie file and do the normal multiple-runs -# routine. -# -ifeq "$(strip $(BUILD_STRATEGY))" "latex" -.SECONDARY: $(all_dvi_targets) -endif -%.$(build_target_extension): %.bbl %.aux %.$(build_target_extension).1st.make - $(QUIET)\ - fatal=`$(call colorize-latex-errors,$*.log)`; \ - if [ x"$$fatal" != x"" ]; then \ - $(ECHO) "$$fatal"; \ - exit 1; \ - fi; \ - $(call make-auxtarget-file,$*.aux.make,$*.auxtarget.cookie); \ - run=0; \ - for i in 1; do \ - if $(call test-exists,$*.bbl.cookie); then \ - run=1; \ - break; \ - fi; \ - if $(call test-exists,$*.run.cookie); then \ - run=1; \ - break; \ - fi; \ - if $(call \ - test-exists-and-different,$*.auxtarget.cookie,$*.auxtarget.make);\ - then \ - run=1; \ - break; \ - fi; \ - if $(call test-log-for-need-to-run,$*); then \ - run=1; \ - break; \ - fi; \ - if [ ! -e $*.1st.*.make ]; then \ - run=1; \ - break; \ - fi; \ - done; \ - $(call remove-temporary-files,$*.bbl.cookie $*.run.cookie); \ - $(MV) $*.auxtarget.cookie $*.auxtarget.make; \ - if [ x"$$run" = x"1" ]; then \ - $(call remove-files,$@.1st.make); \ - for i in 2 3 4 5; do \ - $(if $(findstring 3.79,$(MAKE_VERSION)),\ - $(call echo-build,$*.tex,$@,$(RESTARTS)-$$$$i),\ - $(call echo-build,$*.tex,$@,$(RESTARTS)-$$i)\ - ); \ - $(call run-latex,$*); \ - $(CP) '$*.log' '$*.'$(RESTARTS)-$$i'.log'; \ - $(call test-run-again,$*) || break; \ - done; \ - else \ - $(MV) '$@.1st.make' '$@'; \ - fi; \ - $(call copy-with-logging,$@,$(BINARY_TARGET_DIR)); \ - $(call latex-color-log,$*) - -# Build the .bbl file. When dependencies are included, this will (or will -# not!) depend on something.bib, which we detect, acting accordingly. The -# dependency creation also produces the %.auxbbl.make file. BibTeX is a bit -# finicky about what you call the actual files, but we can rest assured that if -# a .auxbbl.make file exists, then the .aux file does, as well. The -# .auxbbl.make file is a cookie indicating whether the .bbl needs to be -# rewritten. It only changes if the .aux file changes in ways relevant to .bbl -# creation. -# -# Note that we do NOT touch the .bbl file if there is no need to -# create/recreate it. We would like to leave existing files alone if they -# don't need to be changed, thus possibly avoiding a rebuild trigger. -%.bbl: %.auxbbl.make - $(QUIET)\ - $(if $(filter %.bib,$^),\ - $(call echo-build,$(filter %.bib,$?) $*.aux,$@); \ - $(call run-bibtex,$*); \ - $(TOUCH) $@.cookie; \ - ) \ - if $(EGREP) -q 'bibstyle.(apacite|apacann|chcagoa|[^}]*annot)' '$*.aux'; then \ - $(call echo-build,** annotated extra latex **,output ignored,$(RESTARTS)-1); \ - $(call run-latex,$*); \ - $(CP) '$*.log' '$*.$(RESTARTS)-annotated.log'; \ - $(if $(filter %.bib,$^),\ - $(call echo-build,** annotated extra bibtex ** $(filter %.bib,$?) $*.aux,$@); \ - $(call run-bibtex,$*); \ - $(TOUCH) $@.cookie; \ - ) \ - $(call echo-build,** annotated extra latex **,output ignored,$(RESTARTS)-2); \ - $(call run-latex,$*); \ - fi - -# Create the index file - note that we do *not* depend on %.tex here, since -# that unnecessarily restricts the kinds of indices that we can build to those -# with exactly the same stem as the source file. Things like splitidx create -# idx files with other names. -# -# Therefore, we add the .tex dependency in the sourcestem.d file in the call to -# get index file dependencies from the logs. -%.ind: %.idx - $(QUIET)$(call echo-build,$<,$@) - $(QUIET)$(call run-makeindex,$<,$(a),$*.ilg) - -# Create a glossary file from a .ist file -%.gls: %.glo %.tex %.ist - $(QUIET)$(call echo-build,$<,$@) - $(QUIET)$(call run-makeindex,$<,$(a),$*.glg,$*.ist) - -# Create a glossary file from a glossary input formatted for xindy -%.gls: %.glo %.tex %.xdy - $(QUIET)$(call echo-build,$<,$@) - $(QUIET)$(call run-xindy,$<,$(a),$*,$*.glg) - -# Create the glossary file from a nomenclature file -%.gls: %.glo %.tex nomencl.ist - $(QUIET)$(call echo-build,$<,$@) - $(QUIET)$(call run-makeindex,$<,$(a),$*.glg,nomencl.ist) - -# Create the nomenclature file -%.nls: %.nlo %.tex nomencl.ist - $(QUIET)$(call echo-build,$<,$@) - $(QUIET)$(call run-makeindex,$<,$(a),$*.nlg,nomencl.ist) - -# SCRIPTED LaTeX TARGETS -# -# Keep the generated .tex files around for debugging if needed. -.SECONDARY: $(all_tex_targets) - -%.tex:: %.tex.sh - $(QUIET)$(call run-script,$(SHELL),$<,$@) - -%.tex:: %.tex.py - $(QUIET)$(call run-script,$(PYTHON),$<,$@) - -%.tex:: %.tex.pl - $(QUIET)$(call run-script,$(PERL),$<,$@) - -%.tex:: %.rst $(RST_STYLE_FILE) - $(QUIET)\ - $(call run-script,$(RST2LATEX)\ - --documentoptions=letterpaper\ - $(if $(RST_STYLE_FILE),--stylesheet=$(RST_STYLE_FILE),),$<,$@) - -# -# GRAPHICS TARGETS -# -.PHONY: all-graphics -all-graphics: $(all_graphics_targets); - -ifeq "$(strip $(BUILD_STRATEGY))" "latex" -.PHONY: all-pstex -all-pstex: $(all_pstex_targets); -endif - -.PHONY: all-dot2tex -all-dot2tex: $(all_dot2tex_targets); - -.PHONY: show-graphics -show-graphics: all-graphics - $(VIEW_GRAPHICS) $(all_known_graphics) - -$(gray_eps_file): - $(QUIET)$(call echo-build,$^,$@) - $(QUIET)$(call create-gray-eps-file,$@) - -ifeq "$(strip $(BUILD_STRATEGY))" "pdflatex" -%.pdf: %.eps $(if $(GRAY),$(gray_eps_file)) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-eps-to-pdf,$<,$@,$(GRAY)) - -ifeq "$(strip $(GPI_OUTPUT_EXTENSION))" "pdf" -%.pdf: %.gpi %.gpi.d $(gpi_sed) $(gpi_global) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-gpi,$<,$@,$(GRAY)) -endif - -%.pdf: %.fig - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-fig,$<,$@,$(GRAY)) - -%.pdf: %.svg - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-svg,$<,$@,$(GRAY)) -endif - -ifeq "$(strip $(BUILD_STRATEGY))" "xelatex" -%.pdf: %.eps $(if $(GRAY),$(gray_eps_file)) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-eps-to-pdf,$<,$@,$(GRAY)) - -ifeq "$(strip $(GPI_OUTPUT_EXTENSION))" "pdf" -%.pdf: %.gpi %.gpi.d $(gpi_sed) $(gpi_global) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-gpi,$<,$@,$(GRAY)) -endif - -%.pdf: %.fig - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-fig,$<,$@,$(GRAY)) - -endif - - -%.eps: %.gpi %.gpi.d $(gpi_sed) $(gpi_global) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-gpi,$<,$@,$(GRAY)) - -%.eps: %.fig - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-fig,$<,$@,$(GRAY)) - -%.eps: %.dot $(if $(GRAY),$(gray_eps_file)) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-dot,$<,$@,$<.log,$(GRAY)) - -%.eps: %.xvg $(if $(GRAY),$(gray_eps_file)) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-xvg,$<,$@,$(GRAY)) - -ifneq "$(default_graphic_extension)" "pdf" -# We have a perfectly good build rule for svg to pdf, so we eliminate this to -# avoid confusing make (it sometimes chooses to go svg -> eps -> pdf). -%.eps: %.svg $(if $(GRAY),$(gray_eps_file)) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-svg,$<,$@,$(GRAY)) - -# Similarly for these, we don't need eps if we have supported extensions -# already. -%.eps: %.jpg $(if $(GRAY),$(gray_eps_file)) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-jpg,$<,$@,$(GRAY)) - -%.eps: %.jpeg $(if $(GRAY),$(gray_eps_file)) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-jpg,$<,$@,$(GRAY)) - -%.eps: %.png $(if $(GRAY),$(gray_eps_file)) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-png,$<,$@,$(GRAY)) -endif - -%.eps: %.eps.gz $(if $(GRAY),$(gray_eps_file)) - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-epsgz,$<,$@,$(GRAY)) - -%.pstex: %.fig - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-fig-pstex,$<,$@,$(GRAY)) - -%.pstex_t: %.fig %.pstex - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-fig-pstex-t,$<,$(a),$*.pstex,$(GRAY)) - -%.dot_t: %.dot - $(QUIET)$(call echo-graphic,$^,$@) - $(QUIET)$(call convert-dot-tex,$<,$@) - -# -# DEPENDENCY-RELATED TARGETS. -# - -# Generate all of the information needed to get dependencies -# As a side effect, this creates a .dvi or .pdf file (depending on the build -# strategy). We need to be sure to remove it if there are errors. Errors can -# take several forms and all of them are found within the log file: -# * There was a LaTeX error -# * A needed file was not found -# * Cross references need adjustment -# -# Behavior: -# This rule is responsible for generating the following: -# %.aux -# %.d -# %.aux.make -# %.(pdf|dvi).1st.make (the .pdf or .dvi output file, moved) -# -# Steps: -# -# Run latex -# Move .pdf or .dvi somewhere else (make no judgements about success) -# Flatten the .aux file into another file -# Add source dependencies -# Add graphic dependencies -# Add bib dependencies -# -# Create cookies for various suffixes that may represent files that -# need to be read by LaTeX in order for it to function properly. -# -# Note that if some of the dependencies are discovered because they turn -# up missing in the log file, we really need the .d file to be reloaded. -# Adding a sleep command helps with this. Otherwise make is extremely -# nondeterministic, sometimes working, sometimes not. -# -# Usually we can force this by simply removing the generated pdf file and -# not creating a .1st.make file.. -# -%.$(build_target_extension).1st.make %.d %.aux %.aux.make %.fls: %.tex - $(QUIET)$(call echo-build,$<,$*.d $*.$(build_target_extension).1st.make,$(RESTARTS)-1) - $(QUIET)\ - $(call run-latex,$<,-recorder) || $(sh_true); \ - $(CP) '$*.log' '$*.$(RESTARTS)-1.log'; \ - $(call die-on-import-sty,$*.log); \ - $(call die-on-dot2tex,$*.log); \ - $(call die-on-no-aux,$*); \ - $(call flatten-aux,$*.aux,$*.aux.make); \ - $(ECHO) "# vim: ft=make" > $*.d; \ - $(ECHO) ".PHONY: $*._graphics" >> $*.d; \ - $(call get-inputs,$*.fls,$(addprefix $*.,aux aux.make d $(build_target_extension))) >> $*.d; \ - $(call get-missing-inputs,$*.log,$(addprefix $*.,aux aux.make d $(build_target_extension))) >> $*.d; \ - $(ECHO) ".SECONDEXPANSION:" >> $*.d; \ - $(call get-graphics,$*) >> $*.d; \ - $(call get-log-index,$*,$(addprefix $*.,aux aux.make)) >> $*.d; \ - $(call get-bibs,$*.aux.make,$(addprefix $*.,bbl aux aux.make)) >> $*.d; \ - $(EGREP) -q "# MISSING" $*.d && $(SLEEP) 1 && $(RM) $*.pdf; \ - $(call move-if-exists,$*.$(build_target_extension),$*.$(build_target_extension).1st.make); \ - for s in toc out lot lof lol nav; do \ - if [ -e "$*.$$s" ]; then \ - if ! $(DIFF) -q $*.$$s $*.$$s.make >/dev/null 2>&1; then \ - $(TOUCH) $*.run.cookie; \ - fi; \ - $(CP) $*.$$s $*.$$s.make; \ - fi; \ - done - -# This is a cookie that is updated if the flattened aux file has changed in a -# way that affects the bibliography generation. -.SECONDARY: $(addsuffix .auxbbl.make,$(stems_ssg)) -%.auxbbl.make: %.aux.make - $(QUIET)\ - $(call make-auxbbl-file,$<,$@.temp); \ - $(call replace-if-different-and-remove,$@.temp,$@) - -# Build a dependency file for .gpi files. These often plot data files that -# also reside in the directory, so if a data file changes, it's nice to know -# about it. This also handles loaded .gpi files, whose filename should have -# _include_. in it. -%.gpi.d: %.gpi - $(QUIET)$(call echo-build,$<,$@) - $(QUIET)$(call make-gpi-d,$<,$@) - -# Store the paper size for this document -- note that if beamer is used we set -# it to the special BEAMER paper size. We only do this, however, if the -# special comment exists, in which case we enlarge the output with psnup. -# -# The paper size is extracted from a documentclass attribute. -%.paper.make: %.tex - $(QUIET)$(SED) \ - -e '/\\documentclass/,/}/{' \ - -e ' s/%.*//' \ - -e ' H' \ - -e ' /}/{' \ - -e ' s/.*//' \ - -e ' x' \ - -e ' /\\documentclass/!d' \ - -e ' s/[\n[:space:]]*//g' \ - -e ' s/$[,{[]$$[[:alnum:]]\{1,\}$paper$[],}]$/\1%-\2-%\3/g' \ - -e ' s/$[,{[]$$landscape$$[],}]$/\1%-\2-%\3/g' \ - -e ' s/^[^%]*%-//' \ - -e ' s/-%[^%]*$$//' \ - -e ' s/-%[^%]%-/ /g' \ - -e ' p' \ - -e ' }' \ - -e ' d' \ - -e '}' \ - -e 'd' \ - $< > $@; \ - $(EGREP) -q '^[^%]*\\documentclass[^{]*{beamer}' $< && \ - (\ - $(EGREP) -q '^%%[[:space:]]*BEAMER[[:space:]]*LARGE$$' $< && \ - $(ECHO) "BEAMER" > $@ || \ - : > $@ \ - ) || $(sh_true) - -# Store embedding instructions for this document using a special comment -%.embed.make: %.tex - $(QUIET)$(EGREP) '^%%[[:space:]]*NO[[:space:]]*EMBED[[:space:]]*$$' $< \ - && $(ECHO) '' > $@ \ - || $(ECHO) '1' > $@; - -# -# HELPFUL PHONY TARGETS -# - -.PHONY: _all_programs -_all_programs: - $(QUIET)$(ECHO) "== All External Programs Used ==" - $(QUIET)$(call output-all-programs) - -.PHONY: _check_programs -_check_programs: - $(QUIET)$(ECHO) "== Checking Makefile Dependencies =="; $(ECHO) - $(QUIET) \ - allprogs=`\ - ($(call output-all-programs)) | \ - $(SED) \ - -e 's/^[[:space:]]*//' \ - -e '/^#/d' \ - -e 's/[[:space:]]*#.*//' \ - -e '/^=/s/[[:space:]]/_/g' \ - -e '/^[[:space:]]*$$/d' \ - -e 's/^[^=].*=[[:space:]]*$[^[:space:]]\{1,\}$.*$$/\\1/' \ - `; \ - spaces=' '; \ - for p in $${allprogs}; do \ - case $$p in \ - =*) $(ECHO); $(ECHO) "$$p";; \ - *) \ - $(ECHO) -n "$$p:$$spaces" | $(SED) -e 's/^$.\{0,20\}$.*$$/\1/'; \ - loc=`$(WHICH) $$p`; \ - if [ x"$$?" = x"0" ]; then \ - $(ECHO) "$(C_SUCCESS)Found:$(C_RESET) $$loc"; \ - else \ - $(ECHO) "$(C_FAILURE)Not Found$(C_RESET)"; \ - fi; \ - ;; \ - esac; \ - done - -.PHONY: _check_gpi_files -_check_gpi_files: - $(QUIET)$(ECHO) "== Checking all .gpi files for common errors =="; \ - $(ECHO); \ - for f in $(files.gpi); do \ - result=`$(EGREP) '^([^#]*set terminal |set output )' $$f`; \ - $(ECHO) -n "$$f: "; \ - if [ x"$$result" = x"" ]; then \ - $(ECHO) "$(C_SUCCESS)Okay$(C_RESET)"; \ - else \ - $(ECHO) "$(C_FAILURE)Warning: Problematic commands:$(C_RESET)";\ - $(ECHO) "$(C_ERROR)$$result$(C_RESET)"; \ - fi; \ - done; \ - $(ECHO) - -.PHONY: _all_stems -_all_stems: - $(QUIET)$(ECHO) "== All Stems ==" - $(QUIET)$(call echo-list,$(sort $(default_stems_ss))) - -.PHONY: _includes -_includes: - $(QUIET)$(ECHO) "== Include Stems ==" - $(QUIET)$(ECHO) "=== Sources ===" - $(QUIET)$(call echo-list,$(sort $(source_includes))) - $(QUIET)$(ECHO) "=== Graphics ===" - $(QUIET)$(call echo-list,$(sort $(graphic_includes))) - -.PHONY: _all_sources -_all_sources: - $(QUIET)$(ECHO) "== All Sources ==" - $(QUIET)$(call echo-list,$(sort $(all_files.tex))) - -.PHONY: _dependency_graph -_dependency_graph: - $(QUIET)$(ECHO) "/* LaTeX Dependency Graph */" - $(QUIET)$(call output-dependency-graph) - -.PHONY: _show_dependency_graph -_show_dependency_graph: - $(QUIET)$(call output-dependency-graph,$(graph_stem).dot) - $(QUIET)$(DOT) -Tps -o $(graph_stem).eps $(graph_stem).dot - $(QUIET)$(VIEW_POSTSCRIPT) $(graph_stem).eps - $(QUIET)$(call remove-temporary-files,$(graph_stem).*) - -.PHONY: _sources -_sources: - $(QUIET)$(ECHO) "== Sources ==" - $(QUIET)$(call echo-list,$(sort $(files.tex))) - -.PHONY: _scripts -_scripts: - $(QUIET)$(ECHO) "== Scripts ==" - $(QUIET)$(call echo-list,$(sort $(files_scripts))) - -.PHONY: _graphic_outputs -_graphic_outputs: - $(QUIET)$(ECHO) "== Graphic Outputs ==" - $(QUIET)$(call echo-list,$(sort $(all_graphics_targets))) - -.PHONY: _env -_env: -ifdef .VARIABLES - $(QUIET)$(ECHO) "== MAKE VARIABLES ==" - $(QUIET)$(call echo-list,$(foreach var,$(sort $(.VARIABLES)),'$(var)')) -endif - $(QUIET)$(ECHO) "== ENVIRONMENT ==" - $(QUIET)$(ENV) - -# -# CLEAN TARGETS -# -# clean-generated is somewhat unique - it relies on the .fls file being -# properly built so that it can determine which of the files was generated, and -# which was not. Expect it to silently fail if the .fls file is missing. -# -# This is used to, e.g., clean up index files that are generated by the LaTeX. -.PHONY: clean-generated -clean-generated: - $(QUIET)$(call clean-files,$(foreach e,$(addsuffix .fls,$(all_stems_source)),\ - $(shell $(call get-generated-names,$e)))) - -.PHONY: clean-deps -clean-deps: - $(QUIET)$(call clean-files,$(all_d_targets) *.make *.make.temp *.cookie) - -.PHONY: clean-tex -clean-tex: clean-deps - $(QUIET)$(call clean-files,$(rm_tex)) - -.PHONY: clean-graphics -# TODO: This *always* deletes pstex files, even if they were not generated by -# anything.... In other words, if you create a pstex and pstex_t pair by hand -# an drop them in here without the generating fig file, they will be deleted -# and you won't get them back. It's a hack put in here because I'm not sure we -# even want to keep pstex functionality, so my motivation is not terribly high -# for doing it right. -clean-graphics: - $(QUIET)$(call clean-files,$(all_graphics_targets) *.gpi.d *.pstex *.pstex_t *.dot_t) - -.PHONY: clean-backups -clean-backups: - $(QUIET)$(call clean-files,$(backup_patterns) *.temp) - -.PHONY: clean-auxiliary -clean-auxiliary: - $(QUIET)$(call clean-files,$(graph_stem).*) - -.PHONY: clean-nographics -clean-nographics: clean-tex clean-deps clean-backups clean-auxiliary ; - -.PHONY: clean -clean: clean-generated clean-tex clean-graphics clean-deps clean-backups clean-auxiliary ; - -# -# HELP TARGETS -# - -.PHONY: help -help: - $(help_text) - -.PHONY: version -version: - $(QUIET)\ - $(ECHO) "$(fileinfo) Version $(version)"; \ - $(ECHO) "by $(author)"; \ - -# -# HELP TEXT -# - -define help_text -# $(fileinfo) Version $(version) -# -# by $(author) -# -# Generates a number of possible output files from a LaTeX document and its -# various dependencies. Handles .bib files, \include and \input, and .eps -# graphics. All dependencies are handled automatically by running LaTeX over -# the source. -# -# USAGE: -# -# make [GRAY=1] [VERBOSE=1] [SHELL_DEBUG=1] <target(s)> -# -# STANDARD OPTIONS: -# GRAY: -# Setting this variable forces all recompiled graphics to be grayscale. -# It is useful when creating a document for printing. The default is -# to allow colors. Note that it only changes graphics that need to be -# rebuilt! It is usually a good idea to do a 'make clean' first. -# -# VERBOSE: -# This turns off all @ prefixes for commands invoked by make. Thus, -# you get to see all of the gory details of what is going on. -# -# SHELL_DEBUG: -# This enables the -x option for sh, meaning that everything it does is -# echoed to stderr. This is particularly useful for debugging -# what is going on in $$(shell ...) invocations. One of my favorite -# debugging tricks is to do this: -# -# make -d SHELL_DEBUG=1 VERBOSE=1 2>&1 | less -# -# KEEP_TEMP: -# When set, this allows .make and other temporary files to stick around -# long enough to do some debugging. This can be useful when trying to -# figure out why gnuplot is not doing the right things, for example -# (e.g., look for *head.make). -# -# STANDARD AUXILIARY FILES: -# -# Variables.ini (formerly Makefile.ini, which still works) -# -# This file can contain variable declarations that override various -# aspects of the makefile. For example, one might specify -# -# neverclean := *.pdf *.ps -# onlysources.tex := main.tex -# LATEX_COLOR_WARNING := 'bold red uline' -# -# And this would override the neverclean setting to ensure that pdf -# and ps files always remain behind, set the makefile to treat all -# .tex files that are not "main.tex" as includes (and therefore not -# default targets). It also changes the LaTeX warning output to be -# red, bold, and underlined. -# -# There are numerous variables in this file that can be overridden in -# this way. Search for '?=' to find them all. -# -# The Variables.ini is imported before *anything else* is done, so go -# wild with your ideas for changes to this makefile in there. It -# makes it easy to test them before submitting patches. -# -# If you're adding rules or targets, however, see Targets.ini below. -# -# Targets.ini -# -# This is included much later in the makefile, after all variables and -# targets are defined. This is where you would put new make rules, -# e.g., -# -# generated.tex: generating_script.weird_lang depA depB -# ./generating_script.weird_lang > $$@ -# -# In this file, you have access to all of the variables that the -# makefile creates, like $(onlysources.tex). While accessing those can -# be somewhat brittle (they are implementation details and may change), -# it is a great way to test your ideas when submitting feature requests. -# -# STANDARD ENVIRONMENT VARIABLES: -# -# LATEX_COLOR_WARNING '$(LATEX_COLOR_WARNING)' -# LATEX_COLOR_ERROR '$(LATEX_COLOR_ERROR)' -# LATEX_COLOR_UNDERFULL '$(LATEX_COLOR_UNDERFULL)' -# LATEX_COLOR_OVERFULL '$(LATEX_COLOR_OVERFULL)' -# LATEX_COLOR_PAGES '$(LATEX_COLOR_PAGES)' -# LATEX_COLOR_BUILD '$(LATEX_COLOR_BUILD)' -# LATEX_COLOR_GRAPHIC '$(LATEX_COLOR_GRAPHIC)' -# LATEX_COLOR_DEP '$(LATEX_COLOR_DEP)' -# LATEX_COLOR_SUCCESS '$(LATEX_COLOR_SUCCESS)' -# LATEX_COLOR_FAILURE '$(LATEX_COLOR_FAILURE)' -# -# These may be redefined in your environment to be any of the following: -# -# black -# red -# green -# yellow -# blue -# magenta -# cyan -# white -# -# Bold or underline may be used, as well, either alone or in combination -# with colors: -# -# bold -# uline -# -# Order is not important. You may want, for example, to specify: -# -# export LATEX_COLOR_SUCCESS='bold blue uline' -# -# in your .bashrc file. I don't know why, but you may want to. -# -# STANDARD TARGETS: -# -# all: -# Make all possible documents in this directory. The documents are -# determined by scanning for .tex and .tex.sh (described in more detail -# later) and omitting any file that ends in ._include_.tex or -# ._nobuild_.tex. The output is a set of .pdf files. -# -# If you wish to omit files without naming them with the special -# underscore names, set the following near the top of the Makefile, -# or (this is recommended) within a Makefile.ini in the same directory: -# -# includes.tex := file1.tex file2.tex -# -# This will cause the files listed to be considered as include files. -# -# If you have only few source files, you can set -# -# onlysources.tex := main.tex -# -# This will cause only the source files listed to be considered in -# dependency detection. All other .tex files will be considered as -# include files. Note that these options work for *any* source type, -# so you could do something similar with includes.gpi, for example. -# Note that this works for *any valid source* target. All of the -# onlysources.* variables are commented out in the shipping version of -# this file, so it does the right thing when they simply don't exist. -# The comments are purely documentation. If you know, for example, that -# file.mycoolformat is supported by this Makefile, but don't see the -# "onlysources.mycoolformat" declared in the comments, that doesn't mean -# you can't use it. Go ahead and set "onlysources.mycoolformat" and it -# should do the right thing. -# -# show: -# Builds and displays all documents in this directory. It uses the -# environment-overridable value of VIEW_PDF (currently $(VIEW_PDF)) to -# do its work. -# -# all-graphics: -# Make all of the graphics in this directory. -# -# all-pstex (only for BUILD_STRATEGY=latex): -# Build all fig files into pstex and pstex_t files. Gray DOES NOT WORK. -# -# all-gray-pstex (only for BUILD_STRATEGY=latex): -# Build all fig files into grayscale pstex and pstex_t files. -# -# all-dot2tex: -# Build all dot files into tex files. -# -# show-graphics: -# Builds and displays all graphics in this directory. Uses the -# environment-overridable value of VIEW_GRAPHICS (currently -# $(VIEW_GRAPHICS)) to do its work. -# -# clean: -# Remove ALL generated files, leaving only source intact. -# This will *always* skip files mentioned in the "neverclean" variable, -# either in this file or specified in Makefile.ini: -# -# neverclean := *.pdf *.ps -# -# The neverclean variable works on all "clean" targets below, as well. -# -# clean-graphics: -# Remove all generated graphics files. -# -# clean-backups: -# Remove all backup files: $(backup_patterns) -# (XFig and other editors have a nasty habit of leaving them around) -# Also removes Makefile-generated .temp files -# -# clean-tex: -# Remove all files generated from LaTeX invocations except dependency -# information. Leaves graphics alone. -# -# clean-deps: -# Removes all auto-generated dependency information. -# -# clean-auxiliary: -# Removes extra files created by various targets (like the dependency -# graph output). -# -# clean-nographics: -# Cleans everything *except* the graphics files. -# -# help: -# This help text. -# -# version: -# Version information about this LaTeX makefile. -# -# DEBUG TARGETS: -# -# _all_programs: -# A list of the programs used by this makefile. -# -# _check_programs: -# Checks your system for the needed software and reports what it finds. -# -# _check_gpi_files: -# Checks the .gpi files in the current directory for common errors, such -# as specification of the terminal or output file inside of the gpi file -# itself. -# -# _dependency_graph: -# Outputs a .dot file to stdout that represents a graph of LaTeX -# dependencies. To see it, use the _show_dependency_graph target or -# direct the output to a file, run dot on it, and view the output, e.g.: -# -# make _dependency_graph > graph.dot -# dot -T ps -o graph.eps graph.dot -# gv graph.eps -# -# _show_dependency_graph: -# Makes viewing the graph simple: extracts, builds and displays the -# dependency graph given in the _dependency_graph target using the value -# of the environment-overridable VIEW_POSTSCRIPT variable (currently set -# to $(VIEW_POSTSCRIPT)). The postscript viewer is used because it -# makes it easier to zoom in on the graph, a critical ability for -# something so dense and mysterious. -# -# _all_sources: -# List all .tex files in this directory. -# -# _sources: -# Print out a list of all compilable sources in this directory. This is -# useful for determining what make thinks it will be using as the -# primary source for 'make all'. -# -# _scripts: -# Print out a list of scripts that make knows can be used to generate -# .tex files (described later). -# -# _all_stems: -# Print a list of stems. These represent bare targets that can be -# executed. Listing <stem> as a bare target will produce <stem>.pdf. -# -# _includes: -# A list of .d files that would be included in this run if _includes -# weren't specified. This target may be used alone or in conjunction -# with other targets. -# -# _graphic_outputs: -# A list of all generated .eps files -# -# _env: -# A list of environment variables and their values. If supported by -# your version of make, also a list of variables known to make. -# -# FILE TARGETS: -# -# %, %.pdf: -# Build a PDF file from the corresponding %.tex file. -# -# If BUILD_STRATEGY=pdflatex, then this builds the pdf directly. -# Otherwise, it uses this old-school but effective approach: -# -# latex -> dvips -> ps2pdf -# -# The BUILD_STRATEGY can be overridden in Makefile.ini in the same -# directory. The default is pdflatex. -# -# Reasons for using latex -> dvips include the "psfrag" package, and the -# generation of postscript instead of PDF. Arguments for using pdflatex -# include "new and shiny" and "better supported." I can't argue with -# either of those, and supporting them both didn't turn out to be that -# difficult, so there you have it. Choices. -# -# %._show: -# A phony target that builds the pdf file and then displays it using the -# environment-overridable value of VIEW_PDF ($(VIEW_PDF)). -# -# %._graphics: -# A phony target that generates all graphics on which %.pdf (or %.dvi) -# depends. -# -# %.ps (only for BUILD_STRATEGY=latex): -# Build a Postscript file from the corresponding %.tex file. -# This is done using dvips. Paper size is automatically -# extracted from the declaration -# -# \documentclass[<something>paper] -# -# or it is the system default. -# -# If using beamer (an excellent presentation class), the paper -# size is ignored. More on this later. -# -# %.dvi (only for BUILD_STRATEGY=latex): -# Build the DVI file from the corresponding %.tex file. -# -# %.ind: -# Build the index for this %.tex file. -# -# %.gls: -# Build the nomenclature glossary for this %.tex file. -# -# %.nls: -# Build the (newer) nomenclature file for this %.tex file. -# -# %.eps: -# Build an eps file from one of the following file types: -# -# .dot : graphviz -# .gpi : gnuplot -# .fig : xfig -# .xvg : xmgrace -# .svg : scalable vector graphics (goes through inkscape) -# .png : png (goes through NetPBM) -# .jpg : jpeg (goes through ImageMagick) -# .eps.gz : gzipped eps -# -# The behavior of this makefile with each type is described in -# its own section below. -# -# %.pstex{,_t} (only for BUILD_STRATEGY=latex): -# Build a .pstex_t file from a .fig file. -# -# FEATURES: -# -# Optional Binary Directory: -# If you create the _out_ directory in the same place as the makefile, -# it will automatically be used as a dumping ground for .pdf (or .dvi, -# .ps, and .pdf) output files. -# -# Alternatively, you can set the BINARY_TARGET_DIR variable, either as a -# make argument or in Makefile.ini, to point to your directory of -# choice. Note that no pathname wildcard expansion is done in the -# makefile, so make sure that the path is complete before going in -# there. E.g., if you want to specify something in your home directory, -# use $$HOME/ instead of ~/ so that the shell expands it before it gets -# to the makefile. -# -# External Program Dependencies: -# Every external program used by the makefile is represented by an -# ALLCAPS variable at the top of this file. This should allow you to -# make judgments about whether your system supports the use of this -# makefile. The list is available in the ALL_PROGRAMS variable and, -# provided that you are using GNU make 3.80 or later (or you haven't -# renamed this file to something weird like "mylatexmakefile" and like -# invoking it with make -f) can be viewed using -# -# make _all_programs -# -# Additionally, the availability of these programs can be checked -# automatically for you by running -# -# make _check_programs -# -# The programs are categorized according to how important they are and -# what function they perform to help you decide which ones you really -# need. -# -# Colorized Output: -# The output of commands is colorized to highlight things that are often -# important to developers. This includes {underfull,overfull} -# {h,v}boxes, general LaTeX Errors, each stage of document building, and -# the number of pages in the final document. The colors are obtained -# using 'tput', so colorization should work pretty well on any terminal. -# -# The colors can be customized very simply by setting any of the -# LATEX_COLOR_<CONTEXT> variables in your environment (see above). -# -# Predecessors to TeX Files: -# Given a target <target>, if no <target>.tex file exists but a -# corresponding script or predecessor file exists, then appropriate -# action will be taken to generate the tex file. -# -# Currently supported script or predecessor languages are: -# -# sh: %.tex.sh -# perl: %.tex.pl -# python: %.tex.py -# -# Calls the script using the appropriate interpreter, assuming that -# its output is a .tex file. -# -# The script is called thus: -# -# <interpreter> <script file name> <target tex file> -# -# and therefore sees exactly one parameter: the name of the .tex -# file that it is to create. -# -# Why does this feature exist? I ran into this while working on -# my paper dissertation. I wrote a huge bash script that used a -# lot of sed to bring together existing papers in LaTeX. It -# would have been nice had I had something like this to make my -# life easier, since as it stands I have to run the script and -# then build the document with make. This feature provides hooks -# for complicated stuff that you may want to do, but that I have -# not considered. It should work fine with included dependencies, -# too. -# -# Scripts are run every time make is invoked. Some trickery is -# employed to make sure that multiple restarts of make don't cause -# them to be run again. -# -# reST: %.rst -# -# Runs the reST to LaTeX converter to generate a .tex file -# If it finds a file names _rststyle_._include_.tex, uses it as -# the "stylesheet" option to rst2latex. -# -# Note that this does not track sub-dependencies in rst files. It -# assumes that the top-level rst file will change if you want a -# rebuild. -# -# Dependencies: -# -# In general, dependencies are extracted directly from LaTeX output on -# your document. This includes -# -# * Bibliography information -# * \include or \input files (honoring \includeonly, too) -# * Graphics files inserted by the graphicx package -# -# Where possible, all of these are built correctly and automatically. -# In the case of graphics files, these are generated from the following -# file types: -# -# GraphViz: .dot -# GNUPlot: .gpi -# XFig: .fig -# XMgrace: .xvg -# SVG: .svg -# PNG: .png -# JPEG: .jpg -# GZipped EPS: .eps.gz -# -# If the file exists as a .eps already, it is merely used (and will not -# be deleted by 'clean'!). -# -# LaTeX and BibTeX are invoked correctly and the "Rerun to get -# cross-references right" warning is heeded a reasonable number of -# times. In my experience this is enough for even the most troublesome -# documents, but it can be easily changed (if LaTeX has to be run after -# BibTeX more than three times, it is likely that something is moving -# back and forth between pages, and no amount of LaTeXing will fix -# that). -# -# \includeonly is honored by this system, so files that are not -# specified there will not trigger a rebuild when changed. -# -# Beamer: -# A special TeX source comment is recognized by this makefile (only when -# BUILD_STRATEGY=latex, since this invokes psnup): -# -# %%[[:space:]]*BEAMER[[:space:]]*LARGE -# -# The presence of this comment forces the output of dvips through psnup -# to enlarge beamer slides to take up an entire letter-sized page. This -# is particularly useful when printing transparencies or paper versions -# of the slides. For some reason landscape orientation doesn't appear -# to work, though. -# -# If you want to put multiple slides on a page, use this option and then -# print using mpage, a2ps, or psnup to consolidate slides. My personal -# favorite is a2ps, but your mileage may vary. -# -# When beamer is the document class, dvips does NOT receive a paper size -# command line attribute, since beamer does special things with sizes. -# -# GNUPlot Graphics: -# When creating a .gpi file, DO NOT INCLUDE the "set terminal" or "set -# output" commands! The makefile will include terminal information for -# you. Besides being unnecessary and potentially harmful, including the -# terminal definition in the .gpi file makes it harder for you, the one -# writing the document, to preview your graphics, e.g., with -# -# gnuplot -persist myfile.gpi -# -# so don't do specify a terminal or an output file in your .gpi files. -# -# When building a gpi file into an eps file, there are several features -# available to the document designer: -# -# Global Header: -# The makefile searches for the files in the variable GNUPLOT_GLOBAL -# in order: -# -# ($(GNUPLOT_GLOBAL)) -# -# Only the first found is used. All .gpi files in the directory are -# treated as though the contents of GNUPLOT_GLOBAL were directly -# included at the top of the file. -# -# NOTE: This includes special comments! (see below) -# -# Font Size: -# A special comment in a .gpi file (or a globally included file) of -# the form -# -# ## FONTSIZE=<number> -# -# will change the font size of the GPI output. If font size is -# specified in both the global file and the GPI file, the -# specification in the individual GPI file is used. -# -# Grayscale Output: -# GNUplot files also support a special comment to force them to be -# output in grayscale *no matter what*: -# -# ## GRAY -# -# This is not generally advisable, since you can always create a -# grayscale document using the forms mentioned above. But, if your -# plot simply must be grayscale even in a document that allows -# colors, this is how you do it. -# -# XFig Graphics: -# No special handling is done with XFig, except when a global -# grayscale method is used, e.g. -# -# make GRAY=1 document -# -# In these cases the .eps files is created using the -N switch to -# fig2dev to turn off color output. (Only works with eps, not pstex -# output) -# -# GraphVis Graphics: -# Color settings are simply ignored here. The 'dot' program is used -# to transform a .dot file into a .eps file. -# -# If you want, you can use the dot2tex program to convert dot files -# to tex graphics. The default is to just call dot2tex with no -# arguments, but you can change the DOT2TEX definition to include -# options as needed (in your Makefile.ini). -# -# Note that, as with pstex, the makefile cannot use latex's own -# output to discover all missing dot_t (output) files, since anytime -# TeX includes TeX, it has to bail when it can't find the include -# file. It can therefore only stop on the first missing file it -# discovers, and we can't get a large list of them out easily. -# -# So, the makefile errors out if it's missing an included dot_t -# file, then prompts the user to run this command manually: -# -# make all-dot2tex -# -# GZipped EPS Graphics: -# -# A .eps.gz file is sometimes a nice thing to have. EPS files can get -# very large, especially when created from bitmaps (don't do this if you -# don't have to). This makefile will unzip them (not in place) to -# create the appropriate EPS file. -# -# -endef - -# -# DEPENDENCY CHART: -# -# digraph "g" { -# rankdir=TB -# size="9,9" -# edge [fontsize=12 weight=10] -# node [shape=box fontsize=14 style=rounded] -# -# eps [ -# shape=Mrecord -# label="{{<gpi> GNUplot|<epsgz> GZip|<dot> Dot|<fig> XFig}|<eps> eps}" -# ] -# pstex [label="%.pstex"] -# pstex_t [label="%.pstex_t"] -# tex_outputs [shape=point] -# extra_tex_files [shape=point] -# gpi_data [label="<data>"] -# gpi_includes [label="_include_.gpi"] -# aux [label="%.aux"] -# fls [label="%.fls"] -# idx [label="%.idx"] -# glo [label="%.glo"] -# ind [label="%.ind"] -# log [label="%.log"] -# tex_sh [label="%.tex.sh"] -# rst [label="%.rst"] -# tex [ -# shape=record -# label="<tex> %.tex|<include> _include_.tex" -# ] -# include_aux [label="_include_.aux"] -# file_bib [label=".bib"] -# bbl [label="%.bbl"] -# dvi [label="%.dvi"] -# ps [label="%.ps"] -# pdf [label="%.pdf"] -# fig [label=".fig"] -# dot [label=".dot"] -# gpi [label=".gpi"] -# eps_gz [label=".eps.gz"] -# -# gpi_files [shape=point] -# -# rst -> tex:tex [label="reST"] -# tex_sh -> tex:tex [label="sh"] -# tex_pl -> tex:tex [label="perl"] -# tex_py -> tex:tex [label="python"] -# tex -> tex_outputs [label="latex"] -# tex_outputs -> dvi -# tex_outputs -> aux -# tex_outputs -> log -# tex_outputs -> fls -# tex_outputs -> idx -# tex_outputs -> include_aux -# aux -> bbl [label="bibtex"] -# file_bib -> bbl [label="bibtex"] -# idx -> ind [label="makeindex"] -# glo -> gls [label="makeindex"] -# nlo -> nls [label="makeindex"] -# gls -> extra_tex_files -# nls -> extra_tex_files -# ind -> extra_tex_files -# bbl -> extra_tex_files -# eps -> extra_tex_files -# extra_tex_files -> dvi [label="latex"] -# gpi_files -> eps:gpi [label="gnuplot"] -# gpi -> gpi_files -# gpi_data -> gpi_files -# gpi_includes -> gpi_files -# eps_gz -> eps:epsgz [label="gunzip"] -# fig -> eps:fig [label="fig2dev"] -# fig -> pstex [label="fig2dev"] -# fig -> pstex_t [label="fig2dev"] -# pstex -> pstex_t [label="fig2dev"] -# dot -> eps:dot [label="dot"] -# dvi -> ps [label="dvips"] -# include_aux -> bbl [label="bibtex"] -# ps -> pdf [label="ps2pdf"] -# -# edge [ color=blue label="" style=dotted weight=1 fontcolor=blue] -# fls -> tex:include [label="INPUT: *.tex"] -# fls -> file_bib [label="INPUT: *.aux"] -# aux -> file_bib [label="\\bibdata{...}"] -# include_aux -> file_bib [label="\\bibdata{...}"] -# log -> gpi [label="Graphic file"] -# log -> fig [label="Graphic file"] -# log -> eps_gz [label="Graphic file"] -# log -> dot [label="Graphic file"] -# log -> idx [label="No file *.ind"] -# log -> glo [label="No file *.gls"] -# log -> nlo [label="No file *.nls"] -# gpi -> gpi_data [label="plot '...'"] -# gpi -> gpi_includes [label="load '...'"] -# tex:tex -> ps [label="paper"] -# tex:tex -> pdf [label="embedding"] -# } -# - -# -# DEPENDENCY CHART SCRIPT -# -# $(call output_dependency_graph,[<output file>]) -define output-dependency-graph - if [ -f '$(this_file)' ]; then \ - $(SED) \ - -e '/^[[:space:]]*#[[:space:]]*DEPENDENCY CHART:/,/^$$/!d' \ - -e '/DEPENDENCY CHART/d' \ - -e '/^$$/d' \ - -e 's/^[[:space:]]*#//' \ - $(this_file) $(if $1,> '$1',); \ - else \ - $(ECHO) "Cannot determine the name of this makefile."; \ - fi -endef -# -.PHONY: Targets.ini $(HOME)/.latex-makefile/Targets.ini --include Targets.ini --include $(HOME)/.latex-makefile/Targets.ini -# -# vim: noet sts=0 sw=8 ts=8 - diff --git a/2012/datagram-testing-plan/Targets.ini b/2012/datagram-testing-plan/Targets.ini deleted file mode 100644 index d7c8d16..0000000 --- a/2012/datagram-testing-plan/Targets.ini +++ /dev/null @@ -1,4 +0,0 @@ -datagram-testing-plan.d: vc._include_.tex - -vc._include_.tex: datagram-testing-plan.tex datagram-testing-plan.bib - ./vc -m && mv vc.tex $@ diff --git a/2012/datagram-testing-plan/datagram-testing-plan.bib b/2012/datagram-testing-plan/datagram-testing-plan.bib index e30cfcb..a92a61c 100644 --- a/2012/datagram-testing-plan/datagram-testing-plan.bib +++ b/2012/datagram-testing-plan/datagram-testing-plan.bib @@ -18,7 +18,8 @@ @techreport{datagram-comparison, title={Comparison of {T}or Datagram Designs}, author={Murdoch, Steven J.}, - note={\url{https://www.cl.cam.ac.uk/~sjm217/papers/tor11datagramcomparison.pdf}}, + institution = {The Tor Project}, month={November}, year={2011}, + number = {2011-11-001}, } diff --git a/2012/datagram-testing-plan/datagram-testing-plan.tex b/2012/datagram-testing-plan/datagram-testing-plan.tex index b285a6c..314613d 100644 --- a/2012/datagram-testing-plan/datagram-testing-plan.tex +++ b/2012/datagram-testing-plan/datagram-testing-plan.tex @@ -1,4 +1,4 @@ -\documentclass[a4paper,withtimes]{easychair} +\documentclass{tortechrep} \usepackage{doc} \usepackage{upgreek} @@ -6,7 +6,6 @@ \usepackage{fancyhdr} \usepackage{color} \usepackage{graphicx} -\input{vc._include_.tex} \usepackage{prettyref} %% Non-breaking space should really be used @@ -29,25 +28,13 @@ \newcommand{\ia}{inter alia\xspace} \makeatother -\pagestyle{fancy} -\fancyhf{} - -\fancyhead[C]{\sc revision \VCRevisionMod~(\VCDateISO~\VCTime)} -\fancyfoot[C]{\thepage} - \begin{document} \title{Datagram Testing Plan} - \author{Steven J. Murdoch} - -\date{\VCDateISO} - -% \authorrunning{} has to be set for the shorter version of the authors' names; -% otherwise a warning will be rendered in the running heads. -% -\authorrunning{Murdoch} -\titlerunning{Datagram Testing Plan} +\date{March 16, 2012} +\contact{steven.murdoch(a)cl.cam.ac.uk} +\reportid{2012-03-002} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \maketitle diff --git a/2012/datagram-testing-plan/easychair.cls b/2012/datagram-testing-plan/easychair.cls deleted file mode 100755 index 47e0ee3..0000000 --- a/2012/datagram-testing-plan/easychair.cls +++ /dev/null @@ -1,756 +0,0 @@ -% -% Some credits -% - -\def\easychairstyleauthor{easychair class style, by Serguei A. Mokhov, with changes by Andrei Voronkov <24 October 2011>} -\def\easychairstylerevision{CVS Revision: $Id: easychair.cls,v 3.0 2011/10/24 20:26:32 voronkov Exp $} -\def\easychairstylepurpose{Designed for EasyChair.org, under guidelines and suggestions of} -\def\easychairstylevoronkov{\space\space\space\space\space\space\space\space\space\space\space\space\space Andrei Voronkov <www.voronkov.com>, and} -\def\easychairstylesutcliffe{\space\space\space\space\space\space\space\space\space\space\space\space\space Geoff Sutcliffe <www.cs.miami.edu/^geoff>} -\def\easychairstylecopyright{Copyright terms are that of EasyChair.org} -\def\easychairstylebugs{For bug reports, please contact <andrei(a)voronkov.com>} - -\everyjob{\typeout{\easychairstyleauthor}} -\everyjob{\typeout{\easychairstylerevision}} -\everyjob{\typeout{\easychairstylepurpose}} -\everyjob{\typeout{\easychairstylevoronkov}} -\everyjob{\typeout{\easychairstylesutcliffe}} -\everyjob{\typeout{\easychairstylecopyright}} -\everyjob{\typeout{\easychairstylebugs}} - -\immediate\write10{\easychairstyleauthor} -\immediate\write10{\easychairstylerevision} -\immediate\write10{\easychairstylepurpose} -\immediate\write10{\easychairstylevoronkov} -\immediate\write10{\easychairstylesutcliffe} -\immediate\write10{\easychairstylecopyright} -\immediate\write10{\easychairstylebugs} - -% -% Require LaTeX 2.09 or later -% - -\NeedsTeXFormat{LaTeX2e}[1995/12/01] -\ProvidesClass{easychair}[2011/05/02 v3.0] -\def\@tempa#1#2\@nil{\edef\@classname{#1}} -\expandafter\@tempa\@currnamestack{}{}{}\@nil -\ifx\@classname\@empty \edef\@classname{\@currname}\fi - - -% -% Debug -% - -\def\easychairdebug#1{\gdef\@EasyDebug{#1}} -\def\@EasyDebug{} - -\newif\ifdebug -\debugfalse - -\DeclareOption{debug}{\debugtrue} - -\def\easychairframe#1{\gdef\@EasyFrame{#1}} -\def\@EasyFrame{} - -\newif\ifframe -\framefalse - -\DeclareOption{frame}{\frametrue} - -\def\easychairverbose#1{\gdef\@EasyVerbose{#1}} -\def\@EasyVerbose{} - -\newif\ifverbose -\verbosefalse - -\DeclareOption{verbose}{\verbosetrue} - - -% -% Thesis -% Perh Geoff, February 23, 2010 with support from Andrei -% - -\def\easythesis#1{\gdef\@EasyThesis{#1}} -\def\@EasyThesis{} - -\newif\ifthesis -\thesisfalse - -\DeclareOption{thesis}{\thesistrue} - - -% -% Times New Roman or not -% - -\def\easytimes#1{\gdef\@EasyTimes{#1}} -\def\@EasyTimes{} - -\newif\ifnotimes -\notimesfalse - -\DeclareOption{notimes}{\notimestrue} - -\newif\ifwithtimes -\withtimesfalse - -\DeclareOption{withtimes}{\withtimestrue} - - -\newif\ifauthorundefined -\authorundefinedtrue - -\let\oldauthor=\author -\renewcommand - {\author} - [1] - {% - \ifauthorundefined - \oldauthor{#1} - \authorundefinedfalse - \else - \PackageWarning{easychair}{Another use of author ignored} - \fi - } - -\newif\iftitleundefined -\titleundefinedtrue - -\let\oldtitle=\title -\renewcommand - {\title} - [1] - { - \iftitleundefined - \oldtitle{#1} - \titleundefinedfalse - \else - \PackageWarning{easychair}{Another use of title ignored} - \fi - } - - -% -% Running heads definitions -% - -%\def\titlerunning#1{\gdef\@titleRunning{#1}} -%\def\authorrunning#1{\gdef\@authorRunning{#1}} -%\titlerunning{easychair: Running title head is undefined.} -%\authorrunning{easychair: Running author head is undefined.} - -\newif\iftitlerunningundefined -\titlerunningundefinedtrue - -\newif\ifauthorrunningundefined -\authorrunningundefinedtrue - -\gdef\@titleRunning{easychair: Running title head is undefined.} -\gdef\@authorRunning{easychair: Running author head is undefined.} - -\def\titlerunning#1 -{ - \iftitlerunningundefined - \gdef\@titleRunning{#1} - \titlerunningundefinedfalse - \else - \PackageWarning{easychair}{Another use of titlerunning ignored} - \fi -} - -\def\authorrunning#1 -{ - \ifauthorrunningundefined - \gdef\@authorRunning{#1} - \authorrunningundefinedfalse - \else - \PackageWarning{easychair}{Another use of authorrunning ignored} - \fi -} - -% -% Affiliations -% - -\newcommand{\affiliation}[1]{\small{#1}\vspace{-3pt}} - - -% -% Decide between letter and A4 paper formats -% as well as orientation -% - -% Default is 'letterpaper' -\def\paperformat#1{\gdef\@PaperFormat{#1}} -\def\@PaperFormat{letterpaper} - -\newif\ifletterpaper -\newif\ifafourpaper -\newif\ifcustompaper - -\letterpapertrue - -\DeclareOption{letterpaper}{\paperformat{letterpaper}\afourpaperfalse\custompaperfalse} -\DeclareOption{a4paper}{\paperformat{a4paper}\afourpapertrue\letterpaperfalse\custompaperfalse} -\DeclareOption{custompaper}{\paperformat{letterpaper}\afourpaperfalse\letterpaperfalse\custompapertrue} - - -\newlength{\@LMarginSize} -\newlength{\@RMarginSize} -\newlength{\@TMarginSize} -\newlength{\@BMarginSize} - -\DeclareOption{lmargin}{} -\DeclareOption{rmargin}{} -\DeclareOption{tmargin}{} -\DeclareOption{bmargin}{} - - -% Default is portrait {} -\def\paperorientation#1{\gdef\@PaperOrientation{#1}} -\def\@PaperOrientation{} - -\DeclareOption{portrait}{\paperorientation{}} -\DeclareOption{landscape}{\paperorientation{landscape}} - -% Two sided running heads for titlerunning and author running -% twosided is the default -\newif\iftwosided -\twosidedfalse - -\DeclareOption{onesided}{} -\DeclareOption{twosided}{\twosidedtrue} - - -% -% Decide between 1- or 2-column formats -% - -\def\columnCount#1{\gdef\@ColumnCount{#1}} -\def\@ColumnCount{onecolumn} - -\DeclareOption{onecolumn}{} -\DeclareOption{twocolumn}{\columnCount{twocolumn}} - - -% -% Decide on line spacing -% - -\def\lineSpacing#1{\gdef\@LineSpacing{#1}} -\def\(a)LineSpacing{1.0} - -\DeclareOption{zerospacing}{\lineSpacing{0.0}} -\DeclareOption{singlespacing}{\lineSpacing{1.0}} -\DeclareOption{lineandhalfspacing}{\lineSpacing{1.5}} -\DeclareOption{doublespacing}{\lineSpacing{2.0}} - -\DeclareOption{0.0}{\lineSpacing{0.0}} -\DeclareOption{1.0}{\lineSpacing{1.0}} -\DeclareOption{1.5}{\lineSpacing{1.5}} -\DeclareOption{2.0}{\lineSpacing{2.0}} - -\DeclareOption{0.0pt}{\lineSpacing{0.0}} -\DeclareOption{1.0pt}{\lineSpacing{1.0}} -\DeclareOption{1.5pt}{\lineSpacing{1.5}} -\DeclareOption{2.0pt}{\lineSpacing{2.0}} - - -% -% Font point size; default is 10pt -% -% The \headheight will have to be changed later accordingly -% such that fancyhdr does not complain it is too small. -% - -\def\baseFontSize#1{\gdef\@BaseFontSize{#1}} -\def\headHeightSize#1{\gdef\@HeadHeightSize{#1}} -\def\headSepSize#1{\gdef\@HeadSepSize{#1}} -\def\footSkipSize#1{\gdef\@FootSkipSize{#1}} - -\def\@BaseFontSize{10pt} -\def\(a)HeadHeightSize{12.0pt} -\def\(a)HeadSepSize{16.0pt} % instead of the default 25pt -\def\(a)FootSkipSize{26.0pt} % instead of the default 30pt - -\DeclareOption{8pt}{\PackageWarning{easychair}{Option '\CurrentOption' is not supported.}} -\DeclareOption{9pt}{\PackageWarning{easychair}{Option '\CurrentOption' is not supported.}} -\DeclareOption{10pt}{\baseFontSize{10pt}\headHeightSize{12.0pt}\headSepSize{16.0pt}\footSkipSize{26pt}} -\DeclareOption{11pt}{\baseFontSize{11pt}\headHeightSize{13.6pt}\headSepSize{23.0pt}\footSkipSize{28pt}} -\DeclareOption{12pt}{\baseFontSize{12pt}\headHeightSize{14.5pt}\headSepSize{25.0pt}\footSkipSize{30pt}} -\ExecuteOptions{10pt} - -% -% Page sizing -% - -%\newif\iffullpage -%\newif\ifsavetrees -% -%\DeclareOption{fullpage}{\fullpagetrue} -%\DeclareOption{savetrees}{\savetreestrue} - - -% Bark at any unknown package option -\DeclareOption*{\PackageWarning{easychair}{Unknown option '\CurrentOption'}} -\DeclareOption*{\PassOptionsToPackage{\CurrentOption}{geometry}} -%\DeclareOption*{\PassOptionsToClass{\CurrentOption}{article}} - -%\ExecuteOptions{centertags,portrait,10pt,twoside,onecolumn,final} -%\ExecuteOptions{} -\ProcessOptions\relax - - -% -% Required packages and classes. -% -% All must be standard as per most common LaTeX -% distributions. -% - -\ifthesis - \LoadClass[\@PaperFormat,\@PaperOrientation,\@ColumnCount,\@BaseFontSize,twoside]{report} - \RequirePackage{makeidx} -\else - % We are an article (more customized later) - \LoadClass[\@PaperFormat,\@PaperOrientation,\@ColumnCount,\@BaseFontSize,twoside]{article} - %\LoadClass[\@PaperFormat,\@PaperOrientation,\@ColumnCount,\@BaseFontSize]{article} -\fi - -% Require UTF8 encoding, per Andrei Voronkov, to accomodate -% all sorts of author names. -\RequirePackage[utf8]{inputenc} - -% All \urls will be hyperlinked and will deal properly with special characters -% XXX: url is included by hyperref -%\RequirePackage{url} - -% To ensure the footnotes are always at the bottom. -% IMPORTANT: footmisc should precede hyperref for the footnotes to hyperlink -% correctly to their pages where they are at instead of always at -% page 1. Per bug reports from a couple of users and a suggestion by -% Uwe Pfeiffer. -\RequirePackage[bottom]{footmisc} - -%% TOC/thumbnail LHS preview in the PDFs as well as active URLs and other cross-refs -%% Newer versions of hyperref declare a4paper or letterpaper as obsolete and issue warnings -%%\RequirePackage[\(a)PaperFormat,pdfcreator=easychair.cls-2.0]{hyperref} -%\RequirePackage[linktocpage,pdfcreator=easychair.cls-2.0-Beta-3]{hyperref} - -% Traditional graphics processing -\RequirePackage{graphicx} -%\RequirePackage{pdflscape} -%\RequirePackage{lscape} - - -%% Fonts, generally more compact but preserving point size - -% Pick "Times Roman" as a base font unless explicitly told not to -\ifnotimes - \ifwithtimes - \PackageWarning{easychair}{Cannot really use 'notimes' and 'withtimes' together} - \PackageWarning{easychair}{Defaulting to 'notimes'...} - \else - \PackageWarning{easychair}{'notimes' has been deprecated as it is the default in 2.0} - \fi -\else - \ifwithtimes - \RequirePackage{mathptmx} - \fi -\fi - -% Pick "Helvetica" as a "Sans-Serif" font -\RequirePackage[scaled=.85]{helvet} - -% For algorithm and source code listings -\RequirePackage{listings} - -%% Different Math and non-Math symbols and definitions - -\RequirePackage{latexsym} -\RequirePackage{amsthm} -\RequirePackage{empheq} - - -%% Line spacing to be applied AFTER the above space saving packages - -\renewcommand{\baselinestretch}{\@LineSpacing} - -%% Final text printing area, per Geoff Sutcliffe - -\RequirePackage{keyval} - -\define@key{Ec}{lmargin}{\Ec@defbylen{lmargin}{#1}} - -\newlength{\@MarginSize} -\setlength{\@MarginSize}{1in} - -\setlength{\@LMarginSize}{\@MarginSize} -%\setlength{\@LMarginSize}{\Ec@lmargin} -\setlength{\@RMarginSize}{\@MarginSize} -\setlength{\@TMarginSize}{\@MarginSize} -\setlength{\@BMarginSize}{\@MarginSize} - - -% Head height is dependent on the font point size -\setlength{\headheight}{\@HeadHeightSize} -\setlength{\headsep}{\@HeadSepSize} -\setlength{\footskip}{\@FootSkipSize} - -\ifletterpaper - \immediate\write10{easychair: Selecting letter paper margin sizes.} - \RequirePackage[% - papersize={8.5in,11in}, - total={145mm,224mm}, - centering, - twoside, - includeheadfoot]{geometry} -\fi -\ifafourpaper - \immediate\write10{easychair: Selecting A4 paper margin sizes.} - \RequirePackage[% - papersize={210mm,297mm}, - total={145mm,224mm}, - centering, - twoside, - includeheadfoot]{geometry} -\fi - -\ifcustompaper - \immediate\write10{easychair: Selecting custom paper margin sizes.} - \RequirePackage[% - papersize={189mm,246mm}, - total={145mm,224mm}, - top=9mm, - left=24mm, - twoside, - includeheadfoot]{geometry} - \headHeightSize{12.0pt} - \headSepSize{16.0pt} - \footSkipSize{26pt} -\fi - -%\setlength{\textwidth}{16cm} -%\setlength{\textheight}{9in} - - -% -% Volume -% - -\RequirePackage{lastpage} - -\newif\ifvolumeundefined -\volumeundefinedtrue - -% e.g. -% \volumeinfo -% {J. Bloe} % editor(s) #1 -% {1} % No. of editors #2 -% {LICS 2008} % event title #3 -% {1} % volume number #4 -% {4} % issue #5 -% {134} % start page #6 - -\def\@EasyFontStyle{\footnotesize} -\newcommand{\headfootstyle}[1]{\def\@EasyFontStyle{#1}} - -\def\@EasyVolumeInfo{} - -\ifthesis - \newcommand{\volumeinfo}[6] - {\PackageWarning{easychair}{Cannot use volumeinfo with 'thesis' option. Ignoring...}} -\else - \newcommand{\volumeinfo}[6]{% - \ifvolumeundefined - % \def\@makefntext##1{\noindent ##1}% - \def\@EasyEdsNames{#1}% - \def\(a)EasyEds{ed.}% - \def\@EasyEvent{#3}% - \def\@EasyVolume{}% - \def\@EasyIssue{}% - \def\@EasyFirstPage{#6}% - \ifnum #2>1 \gdef\(a)EasyEds{eds.}\fi% - \ifnum #4>0 \gdef\@EasyVolume{; Volume #4}\fi% - \ifnum #5>0 \gdef\@EasyIssue{, issue: #5} \fi% - % \footnotetext[0]{\sf \@EasyEdsNames (\@EasyEds); \@EasyEvent\@EasyVolume\@EasyIssue, pp. #6-\pageref{LastPage}}% - % \def\@EasyVolumeInfo{\footnotesize{\sf\@EasyEdsNames~(\@EasyEds); \@EasyEvent\@EasyVolume\@EasyIssue, pp. \@EasyFirstPage--\pageref{LastPage}}}% - \def\@EasyVolumeInfo{\@EasyFontStyle\@EasyEdsNames~(\@EasyEds); \@EasyEvent\@EasyVolume\@EasyIssue, pp. \@EasyFirstPage--\pageref{LastPage}}% - %\def\@makefntext##1{\noindent\@makefnmark##1}% - \setcounter{page}{\@EasyFirstPage} - \volumeundefinedfalse - \else - {\PackageWarning{easychair}{May not redefine volumeinfo}} - \fi - } -\fi - -\def\@EventInfo{} -\def\@VolumeInfo{} - -\newif\ifvolumeecpsundefined -\volumeecpsundefinedtrue - -\newcommand{\volumeinfoECPS}[2]{% - \ifvolumeecpsundefined - \def\@EventInfo{#1}% - \def\@VolumeInfo{#2}% - \volumeecpsundefinedfalse - \else - {\PackageWarning{easychair}{Ignoring another definition of volumeinfoECPS}} - \fi -} - - -% -% Allow for more space to place floats. -% - -\renewcommand{\topfraction}{0.95} -\renewcommand{\bottomfraction}{0.95} -\renewcommand{\textfraction}{0.05} -\renewcommand{\floatpagefraction}{0.8} - - -% -% Running heads and ``foots'' -% - -\RequirePackage{fancyhdr} -\pagestyle{fancy} - -\fancyhead{} -%\ifdebug -% \iftwosided -% \fancyhead[RE]{\overline{\@titleRunning}} -% \fancyhead[RO]{\overline{\@authorRunning}} -% \else -% \fancyhead[LO,LE]{\begin{math}\overline{\mbox{\@titleRunning}}\end{math}} -% \fancyhead[RO,RE]{\begin{math}\overline{\mbox{\@authorRunning}}\end{math}} -% \fi -%\else - \iftwosided - \fancyhead[RE]{{\@EasyFontStyle\@titleRunning}} - \fancyhead[RO]{{\@EasyFontStyle\@authorRunning}} - \else - \fancyhead[LO,LE]{{\@EasyFontStyle\@titleRunning}} - \fancyhead[RO,RE]{{\@EasyFontStyle\@authorRunning}} - \fi -%\fi - -\fancyfoot{} -%\ifdebug -% \fancyfoot[CO,CE]{\underline{\thepage}} -% \renewcommand{\headrulewidth}{1pt} -% \renewcommand{\footrulewidth}{1pt} -%\else -% \fancyfoot[CO,CE]{\thepage} -% \fancyfoot[LO]{{\footnotesize{\sf\@EventInfo}}} -% \fancyfoot[LE]{{\footnotesize{\sf\@VolumeInfo}}} -% \fancyfoot[LO]{{\@EasyFontStyle\@EventInfo}} -% \fancyfoot[LE]{{\@EasyFontStyle\@VolumeInfo}} -\ifodd\c@page - \fancyfoot[LO]{{\@EasyFontStyle\@VolumeInfo}} - \fancyfoot[RE]{{\@EasyFontStyle\@EventInfo}} -\else - \fancyfoot[RE]{{\@EasyFontStyle\@VolumeInfo}} - \fancyfoot[LO]{{\@EasyFontStyle\@EventInfo}} -\fi -% \fancyfoot[LO,LE] -% { -%\volumeinfoECPS -% {A. Editor, B. Editor} % editors -% {2} % number of editors -% {EVENT, Month YEAR} % event -% {1} % volume -% } -% \fancyfoot[RO,RE]{{\@EasyFontStyle\thepage}} -% \fancyfoot[RO]{{\@EasyFontStyle\thepage}} -% \fancyfoot[LE]{{\@EasyFontStyle\thepage}} -\ifodd\c@page - \fancyfoot[RO]{{\normalsize\thepage}} - \fancyfoot[LE]{{\normalsize\thepage}} -\else - \fancyfoot[LE]{{\normalsize\thepage}} - \fancyfoot[RO]{{\normalsize\thepage}} -\fi - \renewcommand{\headrulewidth}{0pt} - \renewcommand{\footrulewidth}{0pt} -%\fi - -% Suppress the default date, per Geoff -\date{} - -% For the first page -\fancypagestyle{plain}{% -\fancyhf{} % clear all header and footer fields -\ifodd\c@page - \fancyfoot[L]{\@EasyVolumeInfo}% - \fancyfoot[R]{{\normalsize\thepage}} % except the center -\else - \fancyfoot[R]{\@EasyVolumeInfo}% - \fancyfoot[L]{{\normalsize\thepage}} % except the center -\fi -\renewcommand{\headrulewidth}{0pt} -\renewcommand{\footrulewidth}{0pt}} - - -\let\oldmaketitle=\maketitle -\def\@maketitle{% - \newpage - \null - % Facelift a bit the title and make it bold, per Geoff - \vspace{-1cm} - \begin{center}% - \let\footnote\thanks% - % Do not bold Times title, per Geoff - \ifwithtimes - {\LARGE{\@title}\par} - \else - {\LARGE{\bf \@title}\par} - \fi - \vskip 0.5\baselineskip - \begin{tabular}[t]{c}% - \@author - \end{tabular}\par - \@date - \end{center}% - %\volumeinfoECPS{\@EventInfo}{\@VolumeInfo} - %\titlerunning{EMPTY}% - %\authorrunning{EMPTY}% - %\authorrunning{\@authorRunning}% - %\renewcommand{\titlerunning}[1]{} - %\renewcommand{\authorrunning}[1]{} - %%\renewcommand{\volumeinfoECPS}[2]{}% - %%\renewcommand{\volumeinfo}[6]{} - %\gdef\@authorRunning{Gooo\@authorRunning}% - %\gdef\@EasyVolumeInfo{Foo\@authorRunning}% - %\gdef\@EventInfo{} - %\gdef\@VolumeInfo{} -%\volumeinfo - %{NNNNOT A. Voronkov} % editors - %{1} % number of editors - %{NYO-YO} % event - %{44} % volume - %{1} % issue - %{45} % starting page number -%\volumeinfoECPS - %{NNNNOT Super EasyChair Workshop Proceedings} - %{NNNNOT ECPS vol. 43} - \par - %\relax -} - - -% TOC/thumbnail LHS preview in the PDFs as well as active URLs and other cross-refs -% Newer versions of hyperref declare a4paper or letterpaper as obsolete and issue warnings -\RequirePackage[linktocpage,pdfcreator=easychair.cls-3.0]{hyperref} - - -% Tighten up bibliography -\let\oldthebibliography=\thebibliography -\let\endoldthebibliography=\endthebibliography -\renewenvironment{thebibliography}[1] -{ - \small - \begin{oldthebibliography}{#1} - \setlength{\parskip}{2pt} - \setlength{\itemsep}{0pt} -} -{ - \end{oldthebibliography} -} - -\ifdebug - \ifverbose - \RequirePackage[colorgrid,pscoord]{eso-pic}% - \else - \RequirePackage[pscoord]{eso-pic} - \newcommand\ShowFramePicture{% - \begingroup - \color{red} - \AtTextLowerLeft{\framebox(\LenToUnit{\textwidth},\LenToUnit{\textheight}){}}% - \AtTextUpperLeft{\put(0,\LenToUnit{\headsep}){\framebox(\LenToUnit{\textwidth},\LenToUnit{\headheight}){}}}% - \AtTextLowerLeft{\put(0,\LenToUnit{-\footskip}){\framebox(\LenToUnit{\textwidth},\LenToUnit{\headheight}){}}}% - \endgroup - } - \AddToShipoutPicture{\ShowFramePicture} - \fi - %\RequirePackage[a4,cam,center]{crop}% - %\RequirePackage[cam,center]{crop}% -\fi - -\ifframe - \ifverbose - \RequirePackage[colorgrid,pscoord]{eso-pic}% - \else - \RequirePackage[pscoord]{eso-pic} - \newcommand\ShowBlueFrame{% - \begingroup - \color{blue} - % odd page -% \AtTextLowerLeft{\put(\LenToUnit{-23.6mm},\LenToUnit{-21.8mm}){\framebox(\LenToUnit{188.3mm},\LenToUnit{245.4mm}){}}}% - % even page -% \AtTextLowerLeft{\put(\LenToUnit{-19.6mm},\LenToUnit{-21.8mm}){\framebox(\LenToUnit{188.3mm},\LenToUnit{245.4mm}){}}}% - \endgroup - } - \AddToShipoutPicture{\ShowBlueFrame} - \fi -\fi - -% \geometry{papersize={170mm,240mm},total={124mm,185mm}} - -%% Indexing options for proceedings to link up people's names to their -%% various participation and affiliation options. - -\newcommand - {\indexedperson} - [3] - {\index{#2!#1}\index{#1}\index{#1!#3}} - -\newcommand - {\indexedauthor} - [1] - {\indexedperson{#1}{Authors}{Author}} - -\newcommand - {\indexededitor} - [1] - {\indexedperson{#1}{Editors}{Editor}} - -\newcommand - {\indexedpcmember} - [1] - {\indexedperson{#1}{PC Members}{PC Member}} - -\newcommand - {\indexedreviewer} - [1] - {\indexedperson{#1}{Reviewers}{Reviewer}} - -\newcommand - {\indexedorganizer} - [1] - {\indexedperson{#1}{Organizers}{Organizer}} - -\newcommand - {\indexedwebmaster} - [1] - {\indexedperson{#1}{Webmasters}{Webmaster}} - -\newcommand - {\indexedaffiliation} - [2] - {\indexedperson{#1}{#2}{#2}} - -\newcommand - {\indexedsupervisor} - [2] - {\indexedperson{#1}{}{Supervisor: #2}\indexedperson{#2}{Supervisors}{Supervisor}} - -\endinput - -% \crop[font=\upshape\mdseries\small\textsf] - -% EOF diff --git a/2012/datagram-testing-plan/tortechrep.cls b/2012/datagram-testing-plan/tortechrep.cls new file mode 120000 index 0000000..4c24db2 --- /dev/null +++ b/2012/datagram-testing-plan/tortechrep.cls @@ -0,0 +1 @@ +../../tortechrep.cls \ No newline at end of file diff --git a/2012/datagram-testing-plan/vc b/2012/datagram-testing-plan/vc deleted file mode 100755 index 5c5a1b3..0000000 --- a/2012/datagram-testing-plan/vc +++ /dev/null @@ -1,24 +0,0 @@ -#!/bin/sh -# This is file 'vc' from the vc bundle for TeX. -# The original file can be found at CTAN:support/vc. -# This file is Public Domain. - -# Parse command line options. -full=0 -mod=0 -while [ -n "$(echo $1 | grep '-')" ]; do - case $1 in - -f ) full=1 ;; - -m ) mod=1 ;; - * ) echo 'usage: vc [-f] [-m]' - exit 1 - esac - shift -done -# English locale. -LC_ALL=C -git --no-pager log -1 HEAD --pretty=format:"Hash: %H%nAbr. Hash: %h%nParent Hashes: %P%nAbr. Parent Hashes: %p%nAuthor Name: %an%nAuthor Email: %ae%nAuthor Date: %ai%nCommitter Name: %cn%nCommitter Email: %ce%nCommitter Date: %ci%n" |gawk -v script=log -v full=$full -f vc-git.awk > vc.tex -if [ "$mod" = 1 ] -then - git status |gawk -v script=status -f vc-git.awk >> vc.tex -fi diff --git a/2012/datagram-testing-plan/vc-git.awk b/2012/datagram-testing-plan/vc-git.awk deleted file mode 100644 index 66b3526..0000000 --- a/2012/datagram-testing-plan/vc-git.awk +++ /dev/null @@ -1,89 +0,0 @@ -# This is file 'vc-git.awk' from the vc bundle for TeX. -# The original file can be found at CTAN:support/vc. -# This file is Public Domain. -BEGIN { - -### Process output of "git status". - if (script=="status") { - modified = 0 - } - -} - - - -### Process output of "git log". -script=="log" && /^Hash:/ { Hash = substr($0, 2+match($0, ":")) } -script=="log" && /^Abr. Hash:/ { AbrHash = substr($0, 2+match($0, ":")) } -script=="log" && /^Parent Hashes:/ { ParentHashes = substr($0, 2+match($0, ":")) } -script=="log" && /^Abr. Parent Hashes:/ { AbrParentHashes = substr($0, 2+match($0, ":")) } -script=="log" && /^Author Name:/ { AuthorName = substr($0, 2+match($0, ":")) } -script=="log" && /^Author Email:/ { AuthorEmail = substr($0, 2+match($0, ":")) } -script=="log" && /^Author Date:/ { AuthorDate = substr($0, 2+match($0, ":")) } -script=="log" && /^Committer Name:/ { CommitterName = substr($0, 2+match($0, ":")) } -script=="log" && /^Committer Email:/ { CommitterEmail = substr($0, 2+match($0, ":")) } -script=="log" && /^Committer Date:/ { CommitterDate = substr($0, 2+match($0, ":")) } - -### Process output of "git status". -### Changed index? -script=="status" && /^# Changes to be committed:/ { modified = 1 } -### Unstaged modifications? -script=="status" && /^# Changed but not updated:/ { modified = 2 } - - - -END { - -### Process output of "git log". - if (script=="log") { -### Standard encoding is UTF-8. - if (Encoding == "") Encoding = "UTF-8" -### Extract relevant information from variables. - LongDate = substr(AuthorDate, 1, 25) - DateRAW = substr(LongDate, 1, 10) - DateISO = DateRAW - DateTEX = DateISO - gsub("-", "/", DateTEX) - Time = substr(LongDate, 12, 14) -### Write file identification to vc.tex. - print "%%% This file has been generated by the vc bundle for TeX." - print "%%% Do not edit this file!" - print "%%%" -### Write Git specific macros. - print "%%% Define Git specific macros." - print "\\gdef\\GITHash{" Hash "}%" - print "\\gdef\\GITAbrHash{" AbrHash "}%" - print "\\gdef\\GITParentHashes{" ParentHashes "}%" - print "\\gdef\\GITAbrParentHashes{" AbrParentHashes "}%" - print "\\gdef\\GITAuthorName{" AuthorName "}%" - print "\\gdef\\GITAuthorEmail{" AuthorEmail "}%" - print "\\gdef\\GITAuthorDate{" AuthorDate "}%" - print "\\gdef\\GITCommitterName{" CommitterName "}%" - print "\\gdef\\GITCommitterEmail{" CommitterEmail "}%" - print "\\gdef\\GITCommitterDate{" CommitterDate "}%" -### Write generic version control macros. - print "%%% Define generic version control macros." - print "\\gdef\\VCRevision{\\GITAbrHash}%" - print "\\gdef\\VCAuthor{\\GITAuthorName}%" - print "\\gdef\\VCDateRAW{" DateRAW "}%" - print "\\gdef\\VCDateISO{" DateISO "}%" - print "\\gdef\\VCDateTEX{" DateTEX "}%" - print "\\gdef\\VCTime{" Time "}%" - print "\\gdef\\VCModifiedText{\\textcolor{red}{with local modifications!}}%" - print "%%% Assume clean working copy." - print "\\gdef\\VCModified{0}%" - print "\\gdef\\VCRevisionMod{\\VCRevision}%" - } - -### Process output of "git status". - if (script=="status") { - print "%%% Is working copy modified?" - print "\\gdef\\VCModified{" modified "}%" - if (modified==0) { - print "\\gdef\\VCRevisionMod{\\VCRevision}%" - } else { - print "\\gdef\\VCRevisionMod{\\VCRevision~\\VCModifiedText}%" - } - } - -}

1 0

[tech-reports/master] Update George's contact email address.
by karsten＠torproject.org 26 Aug '12

26 Aug '12

commit 3834323ea8795a4053691f6f98e16629013a7c1e Author: Karsten Loesing <karsten.loesing(a)gmx.net> Date: Tue Aug 21 06:55:37 2012 +0200 Update George's contact email address. --- 2012/pluggable-roadmap/pluggable-roadmap.tex | 2 +- 1 files changed, 1 insertions(+), 1 deletions(-) diff --git a/2012/pluggable-roadmap/pluggable-roadmap.tex b/2012/pluggable-roadmap/pluggable-roadmap.tex index 00ff356..a3ee895 100644 --- a/2012/pluggable-roadmap/pluggable-roadmap.tex +++ b/2012/pluggable-roadmap/pluggable-roadmap.tex @@ -32,7 +32,7 @@ \title{Pluggable Transports Roadmap} \author{Steven J. Murdoch and George Kadianakis} -\contact{steven.murdoch@cl.cam.ac.uk,desnacked@riseup.net} +\contact{steven.murdoch@cl.cam.ac.uk,asn@torproject.org} \date{March 17, 2012} \reportid{2012-03-003}

1 0

[tech-reports/master] Update datagram-comparison report to new style.
by karsten＠torproject.org 26 Aug '12

26 Aug '12

commit ef5e226756db78e38048fd46b371e8865b078dbf Author: Karsten Loesing <karsten.loesing(a)gmx.net> Date: Wed Aug 8 08:57:47 2012 +0200 Update datagram-comparison report to new style. --- 2011/datagram-comparison/.gitignore | 11 +-- 2011/datagram-comparison/Makefile | 21 ----- 2011/datagram-comparison/datagram-comparison.tex | 17 ++--- 2011/datagram-comparison/freedom-data.pdf | Bin 0 -> 14592 bytes 2011/datagram-comparison/liberatore-data.pdf | Bin 0 -> 14479 bytes 2011/datagram-comparison/prettyref.sty | 41 ---------- 2011/datagram-comparison/reardon-data.pdf | Bin 0 -> 14776 bytes 2011/datagram-comparison/tor-data.pdf | Bin 0 -> 14091 bytes 2011/datagram-comparison/tor-extension.pdf | Bin 0 -> 11779 bytes 2011/datagram-comparison/tortechrep.cls | 1 + 2011/datagram-comparison/vc | 24 ------ 2011/datagram-comparison/vc-git.awk | 89 ---------------------- 2011/datagram-comparison/viecco-data.pdf | Bin 0 -> 15242 bytes 13 files changed, 9 insertions(+), 195 deletions(-) diff --git a/2011/datagram-comparison/.gitignore b/2011/datagram-comparison/.gitignore index 6060eac..de61ef1 100644 --- a/2011/datagram-comparison/.gitignore +++ b/2011/datagram-comparison/.gitignore @@ -1,10 +1,3 @@ -*.swp -*.aux -*.log -*.out -*.bbl -*.blg -tor-data.pdf -tor-extension.pdf datagram-comparison.pdf -vc.tex +datagram-comparison-2011-11-07.pdf + diff --git a/2011/datagram-comparison/Makefile b/2011/datagram-comparison/Makefile deleted file mode 100644 index 05746ab..0000000 --- a/2011/datagram-comparison/Makefile +++ /dev/null @@ -1,21 +0,0 @@ -all: datagram-comparison.pdf - -%.pdf: %.svg - inkscape --without-gui --export-area-page --export-pdf=`pwd`/$@ `pwd`/$< - -datagram-comparison.pdf: tor-data.pdf tor-extension.pdf reardon-data.pdf viecco-data.pdf \ - liberatore-data.pdf freedom-data.pdf - -%.pdf: %.tex references.bib - ./vc -m - pdflatex $< - bibtex datagram-comparison - pdflatex $< - pdflatex $< - -publish: datagram-comparison.pdf - cp datagram-comparison.pdf ~/public_html/volatile - -clean: - rm -f *.aux *.bbl *.blg *.log *.out \ - tor-data.pdf tor-extension.pdf datagram-comparison.pdf vc.tex diff --git a/2011/datagram-comparison/datagram-comparison.tex b/2011/datagram-comparison/datagram-comparison.tex index 8a12791..0741547 100644 --- a/2011/datagram-comparison/datagram-comparison.tex +++ b/2011/datagram-comparison/datagram-comparison.tex @@ -1,5 +1,4 @@ -\documentclass[a4paper]{article} -\usepackage{a4wide} +\documentclass{tortechrep} \usepackage{upgreek} \usepackage{palatino} \usepackage{fancyhdr} @@ -7,7 +6,6 @@ \usepackage{graphicx} \usepackage{parskip} %\immediate\write18{sh ./vc} -\input{vc.tex} %\usepackage{draftwatermark} \usepackage{hyperref} @@ -41,20 +39,17 @@ \newrefformat{cha}{Chapter~\ref{#1}} \newrefformat{app}{Appendix~\ref{#1}} -\pagestyle{fancy} -\fancyhf{} - -\fancyhead[C]{\sc revision \VCRevisionMod~(\VCDateISO~\VCTime)} -\fancyfoot[C]{\thepage} - \newcommand{\figref}[1]{\textsf{#1}} -\title{Comparison of Tor Datagram Designs} -\author{Steven J. Murdoch} %\renewcommand{\today}{29 March 2011} \begin{document} +\title{Comparison of Tor Datagram Designs} +\author{Steven J. Murdoch} +\contact{steven.murdoch(a)cl.cam.ac.uk} +\date{November 7, 2011} +\reportid{2011-11-001} \maketitle %\setlength{\parindent}{0pt} diff --git a/2011/datagram-comparison/freedom-data.pdf b/2011/datagram-comparison/freedom-data.pdf new file mode 100644 index 0000000..680a2d2 Binary files /dev/null and b/2011/datagram-comparison/freedom-data.pdf differ diff --git a/2011/datagram-comparison/liberatore-data.pdf b/2011/datagram-comparison/liberatore-data.pdf new file mode 100644 index 0000000..1bc6b2f Binary files /dev/null and b/2011/datagram-comparison/liberatore-data.pdf differ diff --git a/2011/datagram-comparison/prettyref.sty b/2011/datagram-comparison/prettyref.sty deleted file mode 100644 index f3ce032..0000000 --- a/2011/datagram-comparison/prettyref.sty +++ /dev/null @@ -1,41 +0,0 @@ -%% -%% This is file `prettyref.sty', -%% generated with the docstrip utility. -%% -%% The original source files were: -%% -%% prettyref.dtx (with options: `style') -%% -%% Copyright (c) 1995 Kevin Ruland -%% -%% -%% prettyref v3.0 -%% -%% Copyright 1995,1998. by Kevin Ruland kevin(a)rodin.wustl.edu -%% -%% The following licence notice was added by Clea F. Rees on behalf of Kevin Ruland on 2008/11/05. -%% -%% prettyref consists of the files prettyref.dtx, prettyref.ins, prettyref.pdf, README and the derived file prettyref.sty. It is released to the public domain. -%% -\ProvidesPackage{prettyref}[1998/07/09 v3.0] -\def\newrefformat#1#2{% - \@namedef{pr@#1}##1{#2}} -\newrefformat{eq}{\textup{(\ref{#1})}} -\newrefformat{lem}{Lemma \ref{#1}} -\newrefformat{thm}{Theorem \ref{#1}} -\newrefformat{cha}{Chapter \ref{#1}} -\newrefformat{sec}{Section \ref{#1}} -\newrefformat{tab}{Table \ref{#1} on page \pageref{#1}} -\newrefformat{fig}{Figure \ref{#1} on page \pageref{#1}} -\def\prettyref#1{\@prettyref#1:} -\def\@prettyref#1:#2:{% - \expandafter\ifx\csname pr@#1\endcsname\relax% - \PackageWarning{prettyref}{Reference format #1\space undefined}% - \ref{#1:#2}% - \else% - \csname pr@#1\endcsname{#1:#2}% - \fi% -} -\endinput -%% -%% End of file `prettyref.sty'. diff --git a/2011/datagram-comparison/reardon-data.pdf b/2011/datagram-comparison/reardon-data.pdf new file mode 100644 index 0000000..7a5f631 Binary files /dev/null and b/2011/datagram-comparison/reardon-data.pdf differ diff --git a/2011/datagram-comparison/tor-data.pdf b/2011/datagram-comparison/tor-data.pdf new file mode 100644 index 0000000..699b346 Binary files /dev/null and b/2011/datagram-comparison/tor-data.pdf differ diff --git a/2011/datagram-comparison/tor-extension.pdf b/2011/datagram-comparison/tor-extension.pdf new file mode 100644 index 0000000..29167f9 Binary files /dev/null and b/2011/datagram-comparison/tor-extension.pdf differ diff --git a/2011/datagram-comparison/tortechrep.cls b/2011/datagram-comparison/tortechrep.cls new file mode 120000 index 0000000..4c24db2 --- /dev/null +++ b/2011/datagram-comparison/tortechrep.cls @@ -0,0 +1 @@ +../../tortechrep.cls \ No newline at end of file diff --git a/2011/datagram-comparison/vc b/2011/datagram-comparison/vc deleted file mode 100755 index 5c5a1b3..0000000 --- a/2011/datagram-comparison/vc +++ /dev/null @@ -1,24 +0,0 @@ -#!/bin/sh -# This is file 'vc' from the vc bundle for TeX. -# The original file can be found at CTAN:support/vc. -# This file is Public Domain. - -# Parse command line options. -full=0 -mod=0 -while [ -n "$(echo $1 | grep '-')" ]; do - case $1 in - -f ) full=1 ;; - -m ) mod=1 ;; - * ) echo 'usage: vc [-f] [-m]' - exit 1 - esac - shift -done -# English locale. -LC_ALL=C -git --no-pager log -1 HEAD --pretty=format:"Hash: %H%nAbr. Hash: %h%nParent Hashes: %P%nAbr. Parent Hashes: %p%nAuthor Name: %an%nAuthor Email: %ae%nAuthor Date: %ai%nCommitter Name: %cn%nCommitter Email: %ce%nCommitter Date: %ci%n" |gawk -v script=log -v full=$full -f vc-git.awk > vc.tex -if [ "$mod" = 1 ] -then - git status |gawk -v script=status -f vc-git.awk >> vc.tex -fi diff --git a/2011/datagram-comparison/vc-git.awk b/2011/datagram-comparison/vc-git.awk deleted file mode 100644 index 66b3526..0000000 --- a/2011/datagram-comparison/vc-git.awk +++ /dev/null @@ -1,89 +0,0 @@ -# This is file 'vc-git.awk' from the vc bundle for TeX. -# The original file can be found at CTAN:support/vc. -# This file is Public Domain. -BEGIN { - -### Process output of "git status". - if (script=="status") { - modified = 0 - } - -} - - - -### Process output of "git log". -script=="log" && /^Hash:/ { Hash = substr($0, 2+match($0, ":")) } -script=="log" && /^Abr. Hash:/ { AbrHash = substr($0, 2+match($0, ":")) } -script=="log" && /^Parent Hashes:/ { ParentHashes = substr($0, 2+match($0, ":")) } -script=="log" && /^Abr. Parent Hashes:/ { AbrParentHashes = substr($0, 2+match($0, ":")) } -script=="log" && /^Author Name:/ { AuthorName = substr($0, 2+match($0, ":")) } -script=="log" && /^Author Email:/ { AuthorEmail = substr($0, 2+match($0, ":")) } -script=="log" && /^Author Date:/ { AuthorDate = substr($0, 2+match($0, ":")) } -script=="log" && /^Committer Name:/ { CommitterName = substr($0, 2+match($0, ":")) } -script=="log" && /^Committer Email:/ { CommitterEmail = substr($0, 2+match($0, ":")) } -script=="log" && /^Committer Date:/ { CommitterDate = substr($0, 2+match($0, ":")) } - -### Process output of "git status". -### Changed index? -script=="status" && /^# Changes to be committed:/ { modified = 1 } -### Unstaged modifications? -script=="status" && /^# Changed but not updated:/ { modified = 2 } - - - -END { - -### Process output of "git log". - if (script=="log") { -### Standard encoding is UTF-8. - if (Encoding == "") Encoding = "UTF-8" -### Extract relevant information from variables. - LongDate = substr(AuthorDate, 1, 25) - DateRAW = substr(LongDate, 1, 10) - DateISO = DateRAW - DateTEX = DateISO - gsub("-", "/", DateTEX) - Time = substr(LongDate, 12, 14) -### Write file identification to vc.tex. - print "%%% This file has been generated by the vc bundle for TeX." - print "%%% Do not edit this file!" - print "%%%" -### Write Git specific macros. - print "%%% Define Git specific macros." - print "\\gdef\\GITHash{" Hash "}%" - print "\\gdef\\GITAbrHash{" AbrHash "}%" - print "\\gdef\\GITParentHashes{" ParentHashes "}%" - print "\\gdef\\GITAbrParentHashes{" AbrParentHashes "}%" - print "\\gdef\\GITAuthorName{" AuthorName "}%" - print "\\gdef\\GITAuthorEmail{" AuthorEmail "}%" - print "\\gdef\\GITAuthorDate{" AuthorDate "}%" - print "\\gdef\\GITCommitterName{" CommitterName "}%" - print "\\gdef\\GITCommitterEmail{" CommitterEmail "}%" - print "\\gdef\\GITCommitterDate{" CommitterDate "}%" -### Write generic version control macros. - print "%%% Define generic version control macros." - print "\\gdef\\VCRevision{\\GITAbrHash}%" - print "\\gdef\\VCAuthor{\\GITAuthorName}%" - print "\\gdef\\VCDateRAW{" DateRAW "}%" - print "\\gdef\\VCDateISO{" DateISO "}%" - print "\\gdef\\VCDateTEX{" DateTEX "}%" - print "\\gdef\\VCTime{" Time "}%" - print "\\gdef\\VCModifiedText{\\textcolor{red}{with local modifications!}}%" - print "%%% Assume clean working copy." - print "\\gdef\\VCModified{0}%" - print "\\gdef\\VCRevisionMod{\\VCRevision}%" - } - -### Process output of "git status". - if (script=="status") { - print "%%% Is working copy modified?" - print "\\gdef\\VCModified{" modified "}%" - if (modified==0) { - print "\\gdef\\VCRevisionMod{\\VCRevision}%" - } else { - print "\\gdef\\VCRevisionMod{\\VCRevision~\\VCModifiedText}%" - } - } - -} diff --git a/2011/datagram-comparison/viecco-data.pdf b/2011/datagram-comparison/viecco-data.pdf new file mode 100644 index 0000000..4e51fc4 Binary files /dev/null and b/2011/datagram-comparison/viecco-data.pdf differ

1 0

Jump to page: