Imported recent work in master, minor conflict fixed in paper.mk

Only two conflicts came up in the newly added comments of 'paper.mk' in the
Maneage branch. It happened because in this project we don't use
'pdflatex', but 'latex' alone.

1 files changed, 11 insertions, 0 deletions

diff --git a/reproduce/analysis/make/paper.mk b/reproduce/analysis/make/paper.mk
index cc43117..6d69d49 100644
--- a/reproduce/analysis/make/paper.mk
+++ b/reproduce/analysis/make/paper.mk
@@ -112,8 +112,16 @@ $(texbdir)/paper.bbl: tex/src/references.tex $(mtexdir)/dependencies-bib.tex \
           # for `biber') and then run `biber' to generate the `.bbl' file.
 	  export TEXINPUTS=$$p:
 	  cd $(texbdir);
+
+          # Note: the option '-shell-escape' is "normally disallowed for
+          # security reasons" according to the `info pdflatex' manual, but
+          # is enabled here in order to allow the use of PGFPlots. If you
+          # do not use PGFPlots, then you should remove the `-shell-escape'
+          # option for better security. See
+          # https://savannah.nongnu.org/task/?15694 for details.
 	  latex -shell-escape -halt-on-error $$p/paper.tex
 	  bibtex paper
+
           # Hack: tidy up eprint+doi style that didn't work in .bst file.
           # TODO (better): read Part 4 of
           # http://mirrors.ctan.org/info/bibtex/tamethebeast/ttb_en.pdf
@@ -150,6 +158,9 @@ paper.pdf: $(mtexdir)/project.tex paper.tex $(texbdir)/paper.bbl
 	  p=$$(pwd)
 	  export TEXINPUTS=$$p:
 	  cd $(texbdir)
+
+          # See above for a warning and brief discussion on the the
+          # pdflatex option `-shell-escape'.
 	  latex -shell-escape -halt-on-error $$p/paper.tex
 
           # Convert the DVI to PostScript, and the PostScript to PDF. The