Adding, bug fixing documentation targets

gmake ThornGuide

     creates ThornGuide.ps from all the thorns in arrangements


gmake <config>-ThornGuide

     creates ThornGuide-<config>.ps for all thorns in <config>

Hopefully also improved redirection of stdout, stderr, which are now both
redirected to files.


git-svn-id: http://svn.cactuscode.org/flesh/trunk@2137 17b73243-c579-4c4c-a9d2-2d5706c11dac

1 files changed, 29 insertions, 6 deletions

diff --git a/Makefile b/Makefile
index e155dacc..cf057d8a 100644
--- a/Makefile
+++ b/Makefile
@@ -16,7 +16,7 @@
 #
 #   
 #   @enddesc 
-#   @version $Id: Makefile,v 1.109 2001-04-18 13:22:10 goodale Exp $
+#   @version $Id: Makefile,v 1.110 2001-04-28 06:55:08 allen Exp $
 # @@*/
 
 ##################################################################################
@@ -323,6 +323,7 @@ else
 	@echo "                  (forces the CST to be rerun)."
 	@echo "  -testsuite     : run the test program."
 	@echo "  -thornlist     : regenerates the ThornList file. "
+	@echo "  -ThornGuide    : creates the thorn manual for a specific configuration. "
 	@echo "  -examples      : copies thorn parameter files to examples directory."
 endif
 	@echo $(DIVIDER)
@@ -683,7 +684,7 @@ newthorn:
 	$(PERL) -s $(NEWTHORN);
 	@echo $(DIVIDER)
 
-
+###############################
 # Run the testsuite
 
 .PHONY testsuite:
@@ -709,6 +710,28 @@ endif
 	@echo Test suite aborted.
 
 
+###############################
+# Run ThornGuide on a configuration
+
+.PHONY thornguide:
+
+ifneq ($strip($(CONFIGURATIONS)),) 
+.PHONY $(addsuffix -ThornGuide,$(CONFIGURATIONS)):
+
+$(addsuffix -ThornGuide,$(CONFIGURATIONS)):
+	@echo $(DIVIDER)
+	@echo Creating ThornGuide for $(@:%-thornlist=%)
+	if [ -r $(CONFIGS_DIR)/$(@:%-ThornGuide=%)/ThornList ] ; then ($(PERL) -s lib/sbin/ParamLatex.pl -processall -sort=scope -grouping=bythorn -outdir=$(CONFIGS_DIR)/$(@:%-ThornGuide=%)/doc -section -thornlist=$(CONFIGS_DIR)/$(@:%-ThornGuide=%)/ThornList; $(PERL) -s lib/sbin/ThornGuide.pl -thornlist=$(CONFIGS_DIR)/$(@:%-ThornGuide=%)/ThornList -outdir=$(CONFIGS_DIR)/$(@:%-ThornGuide=%)/doc;  cd $(CONFIGS_DIR)/$(@:%-ThornGuide=%)/doc; cp $(CCTK_HOME)/doc/UsersGuide/bincactus2.eps bincactus.eps; latex -interaction=nonstopmode ThornGuide.tex > LATEX_MESSAGES 2>&1; latex -interaction=nonstopmode ThornGuide.tex > LATEX_MESSAGES 2>&1; dvips ./ThornGuide.dvi -o $(CCTK_HOME)/ThornGuide-$(@:%-ThornGuide=%).ps >& DVIPS_MESSAGES 2>&1); cd $(CCTK_HOME); fi
+endif
+
+%-ThornGuide:
+	@echo $(DIVIDER)
+	@echo Configuration $(@:%-testsuite=%) does not exist.
+	@echo Test suite aborted.
+
+
+##########################################
+
 ifneq ($strip($(CONFIGURATIONS)),) 
 .PHONY $(addsuffix -examples,$(CONFIGURATIONS)):
 
@@ -794,10 +817,10 @@ UsersGuide.ps: UsersGuide
 UsersGuide: 
 	@echo $(DIVIDER)
 	@echo Creating user documentation UsersGuide.ps
-	(cd doc/UsersGuide; latex UsersGuide.tex > /dev/null; latex UsersGuide.tex > /dev/null; dvips ./UsersGuide.dvi -o $(CCTK_HOME)/UsersGuide.ps >& /dev/null) ; cd $(CCTK_HOME);
+	(cd doc/UsersGuide; latex UsersGuide.tex > LATEX_MESSAGES 2>&1; latex UsersGuide.tex > LATEX_MESSAGES 2>&1; dvips ./UsersGuide.dvi -o $(CCTK_HOME)/UsersGuide.ps >& DVIPS_MESSAGES 2>&1) ; cd $(CCTK_HOME);
 	@echo $(DIVIDER)
 
-# Make the ThornGuide, new addition
+# Make the ThornGuide
 
 .PHONY: ThornGuide.ps
 ThornGuide.ps: ThornGuide
@@ -806,7 +829,7 @@ ThornGuide.ps: ThornGuide
 ThornGuide: 
 	@echo $(DIVIDER)
 	@echo Creating thorn documentation ThornGuide.ps
-	($(PERL) -s lib/sbin/ParamLatex.pl -processall -grouping=bythorn -outdir=doc/ThornGuide/ -section; $(PERL) -s lib/sbin/ThornGuide.pl -directory=arrangements/ -outdir=doc/ThornGuide/; cd doc/ThornGuide; cp ../UsersGuide/bincactus2.eps bincactus.eps; latex ThornGuide.tex > /dev/null; latex ThornGuide.tex > /dev/null; dvips ./ThornGuide.dvi -o $(CCTK_HOME)/ThornGuide.ps >& /dev/null) ; cd $(CCTK_HOME); 
+	(rm -f doc/ThornGuide/*; $(PERL) -s lib/sbin/ParamLatex.pl -processall -grouping=bythorn -outdir=doc/ThornGuide/ -section -sort=scope > doc/ThornGuide/PARAMLATEX_MESSAGES 2>&1; $(PERL) -s lib/sbin/ThornGuide.pl -directory=arrangements/ -outdir=doc/ThornGuide/ > doc/ThornGuide/THORNGUIDE_MESSAGES 2>&1; cd doc/ThornGuide; cp ../UsersGuide/bincactus2.eps bincactus.eps; latex -interaction=nonstopmode ThornGuide.tex > LATEX_MESSAGES 2>&1; latex -interaction=nonstopmode ThornGuide.tex > LATEX_MESSAGES 2>&1; dvips ./ThornGuide.dvi -o $(CCTK_HOME)/ThornGuide.ps >& DVIPS_MESSAGES 2>&1); cd $(CCTK_HOME); 
 	@echo $(DIVIDER)
 
 .PHONY: MaintGuide.ps
@@ -816,7 +839,7 @@ MaintGuide.ps: MaintGuide
 MaintGuide:
 	@echo $(DIVIDER)
 	@echo Creating maintainers documentation MaintGuide.ps
-	(cd doc/MaintGuide; latex MaintGuide.tex > /dev/null; latex MaintGuide.tex > /dev/null; dvips ./MaintGuide.dvi -o $(CCTK_HOME)/MaintGuide.ps >& /dev/null) ; cd $(CCTK_HOME); 
+	(cd doc/MaintGuide; latex MaintGuide.tex > LATEX_MESSAGES 2>&1; latex MaintGuide.tex > LATEX_MESSAGES 2>&1; dvips ./MaintGuide.dvi -o $(CCTK_HOME)/MaintGuide.ps >& DVIPS_MESSAGES 2>&1) ; cd $(CCTK_HOME); 
 	@echo $(DIVIDER)
 
 # Rule to show thorn information