Improved comments in paper.mk and README.md

In 'README.md' I tried to explain a little better that TeXLive will only
install its necessary packages, not the full TeXLive library! Also in
paper.mk, I slightly improved the comments with very minor edits.

Both these parts are slated to go into the core Maneage branch, so its
important to maintain them here for now.

1 files changed, 5 insertions, 1 deletions

diff --git a/reproduce/analysis/make/paper.mk b/reproduce/analysis/make/paper.mk
index 6d69d49..b00ed5a 100644
--- a/reproduce/analysis/make/paper.mk
+++ b/reproduce/analysis/make/paper.mk
@@ -91,12 +91,14 @@ $(mtexdir)/project.tex: $(mtexdir)/verify.tex
 # PDF.
 $(texbdir)/paper.bbl: tex/src/references.tex $(mtexdir)/dependencies-bib.tex \
                       | $(mtexdir)/project.tex
+
         # If `$(mtexdir)/project.tex' is empty, don't build PDF.
 	@macros=$$(cat $(mtexdir)/project.tex)
 	if [ x"$$macros" != x ]; then
 
           # Unfortunately I can't get bibtex to look into a special
-          # directory for the references, so we'll copy it here.
+          # directory for the references, so we'll copy it into the LaTeX
+          # building directory.
 	  p=$$(pwd)
 	  if ! [ -L $(texbdir)/references.bib ]; then
 	    ln -s $$p/tex/src/references.tex $(texbdir)/references.bib
@@ -133,6 +135,8 @@ $(texbdir)/paper.bbl: tex/src/references.tex $(mtexdir)/dependencies-bib.tex \
 	    | sed -e 's/\([^,]\) *\( \|EOLINE\) *\\eprint/\1, \\eprint/g' \
 	    | sed -e 's/\([^,]\) *\( \|EOLINE\) *\\doi/\1, \\doi/g' \
 	    | sed -e 's/EOLINE/\n/g' > paper.bbl
+
+          # The pre-final run of LaTeX after 'paper.bb' was created.
 	  latex -shell-escape -halt-on-error $$p/paper.tex
 	fi