From: Hans U. N. <hu...@us...> - 2005-06-20 23:59:50
|
Update of /cvsroot/libexif/libexif/doc In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv2517/doc Modified Files: Doxyfile.in Makefile.am Added Files: Doxyfile-internals.in Log Message: build both API and code internals docs with doxygen Index: Makefile.am =================================================================== RCS file: /cvsroot/libexif/libexif/doc/Makefile.am,v retrieving revision 1.5 retrieving revision 1.6 diff -u -p -d -r1.5 -r1.6 --- Makefile.am 19 Jun 2005 21:48:37 -0000 1.5 +++ Makefile.am 20 Jun 2005 23:59:11 -0000 1.6 @@ -5,12 +5,17 @@ if HAVE_DOXYGEN DOXYGEN_FILES = -DOXYGEN_STAMPS = $(DOXYGEN_OUTPUT_DIR).stamp -DOXYGEN_UPLOAD = $(DOXYGEN_OUTPUT_DIR).uploaded +DOXYGEN_STAMPS = $(HTML_APIDOC_DIR).stamp $(HTML_APIDOC_INTERNALS_DIR).stamp +DOXYGEN_UPLOAD = $(HTML_APIDOC_DIR).uploaded $(HTML_APIDOC_INTERNALS_DIR).uploaded # FIXME: Depending on the source files would be sufficient... -$(DOXYGEN_OUTPUT_DIR).stamp: Doxyfile $(top_builddir)/libexif/libexif.la - doxygen Doxyfile +$(HTML_APIDOC_DIR).stamp: Doxyfile $(top_builddir)/libexif/libexif.la + doxygen $< + echo > $@ + +# FIXME: Depending on the source files would be sufficient... +$(HTML_APIDOC_INTERNALS_DIR).stamp: Doxyfile-internals $(top_builddir)/libexif/libexif.la + doxygen $< echo > $@ $(top_builddir)/libexif/libexif.la: @@ -19,12 +24,24 @@ $(top_builddir)/libexif/libexif.la: $(HTML_APIDOC_DIR).tar.gz: $(DOXYGEN_OUTPUT_DIR).stamp (cd $(DOXYGEN_OUTPUT_DIR) && $(AMTAR) chof - $(HTML_APIDOC_DIR) | GZIP=--best gzip -c) > $@ -DOC_APIDOC_HTML = apidocs.html +$(HTML_APIDOC_INTERNALS_DIR).tar.gz: $(DOXYGEN_OUTPUT_DIR).stamp + (cd $(DOXYGEN_OUTPUT_DIR) && $(AMTAR) chof - $(HTML_APIDOC_INTERNALS_DIR) | GZIP=--best gzip -c) > $@ -install-apidocs: $(DOXYGEN_OUTPUT_DIR).stamp +DOC_APIDOC_HTML = api.html +DOC_APIDOC_INTERNALS_HTML = internals.html + +install-apidocs-internals: $(HTML_APIDOC_INTERNALS_DIR).stamp + $(INSTALL) -m 0755 -d $(DESTDIR)$(docdir)/$(DOC_APIDOC_INTERNALS_HTML) + $(INSTALL) -m 0644 $(DOXYGEN_OUTPUT_DIR)/$(HTML_APIDOC_INTERNALS_DIR)/* $(DESTDIR)$(docdir)/$(DOC_APIDOC_INTERNALS_HTML)/ + +install-apidocs: $(HTML_APIDOC_DIR).stamp $(INSTALL) -m 0755 -d $(DESTDIR)$(docdir)/$(DOC_APIDOC_HTML) $(INSTALL) -m 0644 $(DOXYGEN_OUTPUT_DIR)/$(HTML_APIDOC_DIR)/* $(DESTDIR)$(docdir)/$(DOC_APIDOC_HTML)/ +uninstall-apidocs-internals: + rm -f $(DESTDIR)$(docdir)/$(DOC_APIDOC_INTERNALS_HTML)/* + rmdir $(DESTDIR)$(docdir)/$(DOC_APIDOC_INTERNALS_HTML) + uninstall-apidocs: rm -f $(DESTDIR)$(docdir)/$(DOC_APIDOC_HTML)/* rmdir $(DESTDIR)$(docdir)/$(DOC_APIDOC_HTML) @@ -35,8 +52,9 @@ clean-apidocs: $(DOXYGEN_UPLOAD): $(DOXYGEN_STAMPS) find $(DOXYGEN_OUTPUT_DIR) \( -type d -exec chmod a+rx,go-w,g+s {} \; \) \ -or \( -type f -exec chmod a+r {} \; \) - rsync -avz --progress $(DOXYGEN_OUTPUT_DIR)/libexif-api.html/ sf:/home/users/h/hu/hun/libexif/htdocs/api/ - ssh "sf" "find /home/groups/l/li/libexif/htdocs/api \( -type d -exec chgrp libexif {} \; -exec chmod g+rwxs,a+rx {} \; \) -or \( -type f -exec chgrp libexif {} \; -exec chmod g+rw {} \; \( -name '*.html' -or -name '*.png' -or -name '*.php' -or -name '*.jpg' -or -name '*.css' -name '*.dot' -name '*.map' \) -exec chmod a+r {} \; \)" + rsync -avz --progress $(DOXYGEN_OUTPUT_DIR)/$(HTML_APIDOC_DIR)/ sf:/home/users/h/hu/hun/libexif/htdocs/api/ + rsync -avz --progress $(DOXYGEN_OUTPUT_DIR)/$(HTML_APIDOC_INTERNALS_DIR)/ sf:/home/users/h/hu/hun/libexif/htdocs/internals/ + ssh "sf" "find /home/groups/l/li/libexif/htdocs/internals /home/groups/l/li/libexif/htdocs/api \( -type d -exec chgrp libexif {} \; -exec chmod g+rwxs,a+rx {} \; \) -or \( -type f -exec chgrp libexif {} \; -exec chmod g+rw {} \; \( -name '*.html' -or -name '*.png' -or -name '*.php' -or -name '*.jpg' -or -name '*.css' -name '*.dot' -name '*.map' \) -exec chmod a+r {} \; \)" endif @@ -45,15 +63,15 @@ endif # Common part ######################################################################## -EXTRA_DIST = Doxyfile.in README.apidocs $(HTML_APIDOC_DIR).tar.gz +EXTRA_DIST = Doxyfile.in Doxyfile-internals.in README.apidocs $(HTML_APIDOC_DIR).tar.gz doc_DATA = $(DOXYGEN_FILES) README.apidocs all-local: $(DOXYGEN_STAMPS) -install-data-local: install-apidocs +install-data-local: install-apidocs install-apidocs-internals -uninstall-local: uninstall-apidocs +uninstall-local: uninstall-apidocs uninstall-apidocs-internals clean-local: clean-apidocs Index: Doxyfile.in =================================================================== RCS file: /cvsroot/libexif/libexif/doc/Doxyfile.in,v retrieving revision 1.4 retrieving revision 1.5 diff -u -p -d -r1.4 -r1.5 --- Doxyfile.in 20 Jun 2005 03:38:50 -0000 1.4 +++ Doxyfile.in 20 Jun 2005 23:59:11 -0000 1.5 @@ -219,23 +219,23 @@ SUBGROUPING = YES # Private class members and static file members will be hidden unless # the EXTRACT_PRIVATE and EXTRACT_STATIC tags are set to YES -EXTRACT_ALL = YES +EXTRACT_ALL = NO # If the EXTRACT_PRIVATE tag is set to YES all private members of a class # will be included in the documentation. -EXTRACT_PRIVATE = YES +EXTRACT_PRIVATE = NO # If the EXTRACT_STATIC tag is set to YES all static members of a file # will be included in the documentation. -EXTRACT_STATIC = YES +EXTRACT_STATIC = NO # If the EXTRACT_LOCAL_CLASSES tag is set to YES classes (and structs) # defined locally in source files will be included in the documentation. # If set to NO only classes defined in header files are included. -EXTRACT_LOCAL_CLASSES = YES +EXTRACT_LOCAL_CLASSES = NO # This flag is only useful for Objective-C code. When set to YES local # methods, which are defined in the implementation section but not in @@ -278,7 +278,7 @@ HIDE_IN_BODY_DOCS = NO # to NO (the default) then the documentation will be excluded. # Set it to YES to include the internal documentation. -INTERNAL_DOCS = YES +INTERNAL_DOCS = NO # If the CASE_SENSE_NAMES tag is set to NO then Doxygen will only generate # file names in lower-case letters. If set to YES upper-case letters are also @@ -545,7 +545,7 @@ FILTER_SOURCE_FILES = NO # Note: To get rid of all source code in the generated output, make sure also # VERBATIM_HEADERS is set to NO. -SOURCE_BROWSER = YES +SOURCE_BROWSER = NO # Setting the INLINE_SOURCES tag to YES will include the body # of functions and classes directly in the documentation. --- NEW FILE: Doxyfile-internals.in --- # Doxyfile 1.4.2 # This file describes the settings to be used by the documentation system # doxygen (www.doxygen.org) for a project # # All text after a hash (#) is considered a comment and will be ignored # The format is: # TAG = value [value, ...] # For lists items can also be appended using: # TAG += value [value, ...] # Values that contain spaces should be placed between quotes (" ") #--------------------------------------------------------------------------- # Project related configuration options #--------------------------------------------------------------------------- # The PROJECT_NAME tag is a single word (or a sequence of words surrounded # by quotes) that should identify the project. [...1179 lines suppressed...] # If the GENERATE_LEGEND tag is set to YES (the default) Doxygen will # generate a legend page explaining the meaning of the various boxes and # arrows in the dot generated graphs. GENERATE_LEGEND = YES # If the DOT_CLEANUP tag is set to YES (the default) Doxygen will # remove the intermediate dot files that are used to generate # the various graphs. DOT_CLEANUP = YES #--------------------------------------------------------------------------- # Configuration::additions related to the search engine #--------------------------------------------------------------------------- # The SEARCHENGINE tag specifies whether or not a search engine should be # used. If set to NO the values of all tags below this one will be ignored. SEARCHENGINE = NO |