Browse Source

attempt to recover programmers manual

git-svn-id: https://svn.osgeo.org/grass/grass/trunk@44040 15284696-431f-4ddb-bdfa-cd5b030d7da7
Martin Landa 14 years ago
parent
commit
e0b639d50f

+ 3 - 2
Makefile

@@ -122,10 +122,11 @@ distclean: clean
 	-rm -f include/config.h include/version.h
 	-rm -f include/Make/Platform.make include/Make/Doxyfile_arch_html include/Make/Doxyfile_arch_latex 2>/dev/null
 
-DOXNAME=grass
-
 include $(MODULE_TOPDIR)/include/Make/Install.make
 include $(MODULE_TOPDIR)/include/Make/Docs.make
+include $(MODULE_TOPDIR)/include/Make/Doxygen.make
+
+DOXNAME=grass
 
 .PHONY: default libs
 .PHONY: cleandistdirs cleanscriptstrings clean libsclean distclean

+ 7 - 7
include/Make/Docs.make

@@ -8,13 +8,12 @@ GRASS_PDFDIR=		$(DOCSDIR)/pdf
 # generate programmer's manual as single HTML document:
 
 htmldocs-single:
+	$(MAKE) -C . htmldox-single
 	for dir in lib rfc gui/wxpython ; do \
-	  $(MAKE) -C $$dir htmldocs-single ; \
+	  $(MAKE) -C $$dir htmldox-single ; \
 	done
 
 # generate programmer's manual as multiple HTML documents:
-htmldocs:
-
 docs_dirs = \
 	lib/db \
 	lib/g3d \
@@ -34,25 +33,26 @@ htmldocs_dirs := $(patsubst %,%/html,$(docs_dirs))
 latexdocs_dirs := $(patsubst %,%/latex,$(docs_dirs))
 
 htmldocs:
+	$(MAKE) -C . htmldox
 	for dir in $(docs_dirs) ; do \
-	  $(MAKE) -C $$dir htmldocs ; \
+	  $(MAKE) -C $$dir htmldox ; \
 	  done
 
 packagehtmldocs: htmldocs
 	tar chvfz $(GRASS_NAME)refman_$(DATE)_html.tar.gz $(htmldocs_dirs)
 
 #alternatively, the docs can be generated as single PDF document (see doxygen FAQ for 'TeX capacity exceeded'):
-#  (cd lib/ ; make pdfdocs)
+#  (cd lib/ ; make pdfdox)
 
 pdfdocs:
 	for dir in $(docs_dirs) ; do \
-	  $(MAKE) -C $$dir pdfdocs ; \
+	  $(MAKE) -C $$dir pdfdox ; \
 	  done
 	@echo "Written PDF docs in: $(latexdocs_dirs)"
 
 cleandocs:
 	for dir in $(docs_dirs) ; do \
-	  $(MAKE) -C $$dir cleandocs ; \
+	  $(MAKE) -C $$dir cleandox ; \
 	  done
 
 indices = \

+ 3 - 2
include/Make/Doxyfile_arch_html.in

@@ -448,17 +448,18 @@ RECURSIVE              = YES
 # excluded from the INPUT source files. This way you can easily exclude a 
 # subdirectory from a directory tree whose root is specified with the INPUT tag.
 
-EXCLUDE                = bin.* \
+EXCLUDE                = bin.@ARCH@ \
 		         db \
 			 debian \
 			 demolocation \
 			 display \
-			 dist.* \
+			 dist.@ARCH@ \
 			 doc \
 			 general \
 		         gui/wxpython/vdigit \
 			 gui/wxpython/nviz \
 			 imagery \
+			 include \
                          lib/python/ctypes \
 			 locale \
 			 macosx \

+ 3 - 2
include/Make/Doxyfile_arch_latex.in

@@ -448,17 +448,18 @@ RECURSIVE              = YES
 # excluded from the INPUT source files. This way you can easily exclude a 
 # subdirectory from a directory tree whose root is specified with the INPUT tag.
 
-EXCLUDE                = bin.* \
+EXCLUDE                = bin.@ARCH@ \
 		         db \
 			 debian \
 			 demolocation \
 			 display \
-			 dist.* \
+			 dist.@ARCH@ \
 			 doc \
 			 general \
 		         gui/wxpython/vdigit \
 			 gui/wxpython/nviz \
 			 imagery \
+			 include \
                          lib/python/ctypes \
 			 locale \
 			 macosx \

+ 5 - 5
include/Make/Doxygen.make

@@ -8,12 +8,12 @@ checkdoxygen:
 	@(type doxygen > /dev/null || (echo "ERROR: Install 'doxygen' software first (get from http://www.doxygen.org)" && exit 1))
 
 # generate docs as single HTML document:
-htmldocs-single: checkdoxygen cleandocs
+htmldox-single: checkdoxygen cleandox
 	doxygen $(MODULE_TOPDIR)/include/Make/Doxyfile_arch_html
 	@echo "HTML reference in directory ./html/index.html"
 
 # generate docs as multiple HTML documents:
-htmldocs: checkdoxygen cleandocs
+htmldox: checkdoxygen cleandox
 # hack needed to get main page at beginning:
 	@mv $(DOXINPUT) $(DOXINPUT).org
 	@sed 's+/\*! \\page +/\*! \\mainpage +g' $(DOXINPUT).org > $(DOXINPUT)
@@ -22,7 +22,7 @@ htmldocs: checkdoxygen cleandocs
 	@echo "HTML reference in directory ./html/index.html"
 
 # NOTE: stubs/ and sqlp/ are excluded in ./Doxyfile_arch_latex
-latexdocs: checkdoxygen cleandocs
+latexdox: checkdoxygen cleandox
 	test ! -d latex || (cd ./latex && $(MAKE) clean)
 # hack needed to get main page at beginning:
 	@mv $(DOXINPUT) $(DOXINPUT).org
@@ -34,7 +34,7 @@ latexdocs: checkdoxygen cleandocs
 	@mv $(DOXINPUT).org $(DOXINPUT)
 	@echo "Latex reference in directory ./latex/refman.dvi"
 
-pdfdocs: checkdoxygen cleandocs
+pdfdox: checkdoxygen cleandox
 	test ! -d latex || (cd ./latex && $(MAKE) clean)
 # hack needed to get main page at beginning:
 	@mv $(DOXINPUT) $(DOXINPUT).org
@@ -46,5 +46,5 @@ pdfdocs: checkdoxygen cleandocs
 	@mv $(DOXINPUT).org $(DOXINPUT)
 	@echo "PDF reference in directory ./latex/grass${GRASS_VERSION_MAJOR}${GRASS_VERSION_MINOR}$(DOXOUTPUT)_`date '+%Y_%m_%d'`_refman.pdf"
 
-cleandocs:
+cleandox:
 	rm -rf ./latex ./html