docs(docs): rebuilt docs

docs/latex/Makefile

@@ -1,23 +1,42 @@
-LATEX_CMD=pdflatex
+LATEX_CMD?=pdflatex
+MKIDX_CMD?=makeindex
+BIBTEX_CMD?=bibtex
+LATEX_COUNT?=8
+MANUAL_FILE?=refman
 
-all: refman.pdf
+all: $(MANUAL_FILE).pdf
 
-pdf: refman.pdf
+pdf: $(MANUAL_FILE).pdf
 
-refman.pdf: clean refman.tex
-	$(LATEX_CMD) refman
-	makeindex refman.idx
-	$(LATEX_CMD) refman
-	latex_count=8 ; \
-	while egrep -s 'Rerun (LaTeX|to get cross-references right)' refman.log && [ $$latex_count -gt 0 ] ;\
+$(MANUAL_FILE).pdf: clean $(MANUAL_FILE).tex
+	$(LATEX_CMD) $(MANUAL_FILE) || \
+	if [ $$? != 0 ] ; then \
+	        \echo "Please consult $(MANUAL_FILE).log to see the error messages" ; \
+	        false; \
+	fi
+	$(MKIDX_CMD) $(MANUAL_FILE).idx
+	$(LATEX_CMD) $(MANUAL_FILE) || \
+	if [ $$? != 0 ] ; then \
+	        \echo "Please consult $(MANUAL_FILE).log to see the error messages" ; \
+	        false; \
+	fi
+	latex_count=$(LATEX_COUNT) ; \
+	while grep -E -s 'Rerun (LaTeX|to get cross-references right|to get bibliographical references right)' $(MANUAL_FILE).log && [ $$latex_count -gt 0 ] ;\
 	    do \
 	      echo "Rerunning latex...." ;\
-	      $(LATEX_CMD) refman ;\
+	      $(LATEX_CMD) $(MANUAL_FILE) || \
+	      if [ $$? != 0 ] ; then \
+	              \echo "Please consult $(MANUAL_FILE).log to see the error messages" ; \
+	              false; \
+	      fi; \
 	      latex_count=`expr $$latex_count - 1` ;\
 	    done
-	makeindex refman.idx
-	$(LATEX_CMD) refman
-
+	$(MKIDX_CMD) $(MANUAL_FILE).idx
+	$(LATEX_CMD) $(MANUAL_FILE) || \
+	if [ $$? != 0 ] ; then \
+	        \echo "Please consult $(MANUAL_FILE).log to see the error messages" ; \
+	        false; \
+	fi
 
 clean:
-	rm -f *.ps *.dvi *.aux *.toc *.idx *.ind *.ilg *.log *.out *.brf *.blg *.bbl refman.pdf
+	rm -f *.ps *.dvi *.aux *.toc *.idx *.ind *.ilg *.log *.out *.brf *.blg *.bbl $(MANUAL_FILE).pdf