From cda9ac3c3b84af0583095263e8fcf8ec8d3ea5e9 Mon Sep 17 00:00:00 2001 From: Amar Takhar Date: Sat, 26 Sep 2009 08:37:12 +0000 Subject: [PATCH] Split doxygen generation into two parts, one for aegisub and another for the reporter. Originally committed to SVN as r3548. --- aegisub/docs/doxygen/doxyfile_aegisub | 31 +++++++++++++++++ .../docs/doxygen/{doxyfile => doxyfile_base} | 33 +++---------------- aegisub/docs/doxygen/doxyfile_reporter | 31 +++++++++++++++++ aegisub/docs/doxygen/gen.sh | 27 ++++++++++----- .../doxygen/{ => pages_aegisub}/groups.dox | 0 .../{pages => pages_aegisub}/index.dox | 0 .../{pages => pages_aegisub}/license.dox | 0 .../docs/doxygen/pages_reporter/groups.dox | 7 ++++ aegisub/docs/doxygen/pages_reporter/index.dox | 17 ++++++++++ .../docs/doxygen/pages_reporter/license.dox | 5 +++ 10 files changed, 115 insertions(+), 36 deletions(-) create mode 100644 aegisub/docs/doxygen/doxyfile_aegisub rename aegisub/docs/doxygen/{doxyfile => doxyfile_base} (91%) create mode 100644 aegisub/docs/doxygen/doxyfile_reporter rename aegisub/docs/doxygen/{ => pages_aegisub}/groups.dox (100%) rename aegisub/docs/doxygen/{pages => pages_aegisub}/index.dox (100%) rename aegisub/docs/doxygen/{pages => pages_aegisub}/license.dox (100%) create mode 100644 aegisub/docs/doxygen/pages_reporter/groups.dox create mode 100644 aegisub/docs/doxygen/pages_reporter/index.dox create mode 100644 aegisub/docs/doxygen/pages_reporter/license.dox diff --git a/aegisub/docs/doxygen/doxyfile_aegisub b/aegisub/docs/doxygen/doxyfile_aegisub new file mode 100644 index 000000000..333b9bdff --- /dev/null +++ b/aegisub/docs/doxygen/doxyfile_aegisub @@ -0,0 +1,31 @@ +@INCLUDE = doxyfile_base + +PROJECT_NAME = Aegisub + +INPUT = ../../src/ ./pages_aegisub + + +EXCLUDE_PATTERNS = */.svn* */.deps* */.libs* */boost/* */scripts/* */gl/* */msvc/* */libresrc/* \ + */libosxutil/bundledirs-test.c */avisynth.h */MatroskaParser.? */md5.? + +PREDEFINED += \ + WITH_PORTAUDIO \ + WITH_ALSA \ + WITH_AUTO4_LUA \ + WITH_AUTOMATION \ + WITH_AVISYNTH \ + WITH_CSRI \ + WITH_DIRECTSOUND \ + WITH_FFMPEGSOURCE \ + WITH_FONTCONFIG \ + WITH_FREETYPE2 \ + WITH_HUNSPELL \ + WITH_LIBASS \ + WITH_OLD_HUNSPELL \ + WITH_OPENAL \ + WITH_PORTAUDIO \ + WITH_PORTAUDIO2 \ + WITH_PULSEAUDIO \ + WITH_QUICKTIME \ + WITH_STARTUPLOG \ + WITH_UNIVCHARDET diff --git a/aegisub/docs/doxygen/doxyfile b/aegisub/docs/doxygen/doxyfile_base similarity index 91% rename from aegisub/docs/doxygen/doxyfile rename to aegisub/docs/doxygen/doxyfile_base index 44a2a8185..704d97afa 100644 --- a/aegisub/docs/doxygen/doxyfile +++ b/aegisub/docs/doxygen/doxyfile_base @@ -4,7 +4,7 @@ # Project related configuration options #--------------------------------------------------------------------------- DOXYFILE_ENCODING = UTF-8 -PROJECT_NAME = Aegisub +#PROJECT_NAME = PROJECT_NUMBER = trunk OUTPUT_DIRECTORY = $(OUTPUT_DIR) CREATE_SUBDIRS = NO @@ -87,15 +87,14 @@ WARN_LOGFILE = doxygen.log #--------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = ../../src/ . +#INPUT = INPUT_ENCODING = UTF-8 FILE_PATTERNS = *.h *.cpp *.c *.dox RECURSIVE = YES -#EXCLUDE = .svn .deps .libs boost gl msvc libass universalchardet +#EXCLUDE = EXCLUDE = EXCLUDE_SYMLINKS = NO -EXCLUDE_PATTERNS = */.svn* */.deps* */.libs* */boost/* */scripts/* */gl/* */msvc/* */libresrc/* \ - */libosxutil/bundledirs-test.c */avisynth.h */MatroskaParser.? */md5.? +#EXCLUDE_PATTERNS = EXCLUDE_SYMBOLS = EXAMPLE_PATH = ../../ EXAMPLE_PATTERNS = @@ -215,29 +214,7 @@ EXPAND_ONLY_PREDEF = YES SEARCH_INCLUDES = YES INCLUDE_PATH = INCLUDE_FILE_PATTERNS = -PREDEFINED = -PREDEFINED += \ - WITH_PORTAUDIO \ - WITH_ALSA \ - WITH_AUTO4_LUA \ - WITH_AUTOMATION \ - WITH_AVISYNTH \ - WITH_CSRI \ - WITH_DIRECTSOUND \ - WITH_FFMPEGSOURCE \ - WITH_FONTCONFIG \ - WITH_FREETYPE2 \ - WITH_HUNSPELL \ - WITH_LIBASS \ - WITH_OLD_HUNSPELL \ - WITH_OPENAL \ - WITH_PORTAUDIO \ - WITH_PORTAUDIO2 \ - WITH_PULSEAUDIO \ - WITH_QUICKTIME \ - WITH_STARTUPLOG \ - WITH_UNIVCHARDET - +#PREDEFINED = PREDEFINED += WXUNUSED(x)= EXPAND_AS_DEFINED = SKIP_FUNCTION_MACROS = YES diff --git a/aegisub/docs/doxygen/doxyfile_reporter b/aegisub/docs/doxygen/doxyfile_reporter new file mode 100644 index 000000000..73c150c56 --- /dev/null +++ b/aegisub/docs/doxygen/doxyfile_reporter @@ -0,0 +1,31 @@ +@INCLUDE = doxyfile_base + +PROJECT_NAME = Aegisub Reporter + +INPUT = ../../reporter/ ./pages_reporter + + +EXCLUDE_PATTERNS = */.svn* */.deps* */.libs* */boost/* */scripts/* */gl/* */msvc/* */libresrc/* \ + */libosxutil/bundledirs-test.c */avisynth.h */MatroskaParser.? */md5.? + +PREDEFINED += \ + WITH_PORTAUDIO \ + WITH_ALSA \ + WITH_AUTO4_LUA \ + WITH_AUTOMATION \ + WITH_AVISYNTH \ + WITH_CSRI \ + WITH_DIRECTSOUND \ + WITH_FFMPEGSOURCE \ + WITH_FONTCONFIG \ + WITH_FREETYPE2 \ + WITH_HUNSPELL \ + WITH_LIBASS \ + WITH_OLD_HUNSPELL \ + WITH_OPENAL \ + WITH_PORTAUDIO \ + WITH_PORTAUDIO2 \ + WITH_PULSEAUDIO \ + WITH_QUICKTIME \ + WITH_STARTUPLOG \ + WITH_UNIVCHARDET diff --git a/aegisub/docs/doxygen/gen.sh b/aegisub/docs/doxygen/gen.sh index 5d0c1533d..96e39789e 100755 --- a/aegisub/docs/doxygen/gen.sh +++ b/aegisub/docs/doxygen/gen.sh @@ -3,16 +3,27 @@ # $Id$ # -if test -z "$1"; then - export OUTPUT_DIR="./output" -else - export OUTPUT_DIR="$1" +if test -z "$1" || test -z "$2"; then + echo "You must provide a project and output dir." + exit; fi -mkdir -vp "${OUTPUT_DIR}" -cp -v css.css "${OUTPUT_DIR}" +case "$1" in + "aegisub") + TRIM="${SRC_PWD}/src/" + ;; + "reporter") + TRIM="${SRC_PWD}/reporter/" + ;; +esac + +export OUTPUT_DIR="$2" +export SRC_TRIM="${TRIM}" + + +mkdir -vp "$2" +cp -v css.css "$2" SRC_PWD=`pwd|sed "s|/docs/doxygen||"` -export SRC_TRIM="${SRC_PWD}/src/" -doxygen doxyfile +doxygen "doxyfile_$1" diff --git a/aegisub/docs/doxygen/groups.dox b/aegisub/docs/doxygen/pages_aegisub/groups.dox similarity index 100% rename from aegisub/docs/doxygen/groups.dox rename to aegisub/docs/doxygen/pages_aegisub/groups.dox diff --git a/aegisub/docs/doxygen/pages/index.dox b/aegisub/docs/doxygen/pages_aegisub/index.dox similarity index 100% rename from aegisub/docs/doxygen/pages/index.dox rename to aegisub/docs/doxygen/pages_aegisub/index.dox diff --git a/aegisub/docs/doxygen/pages/license.dox b/aegisub/docs/doxygen/pages_aegisub/license.dox similarity index 100% rename from aegisub/docs/doxygen/pages/license.dox rename to aegisub/docs/doxygen/pages_aegisub/license.dox diff --git a/aegisub/docs/doxygen/pages_reporter/groups.dox b/aegisub/docs/doxygen/pages_reporter/groups.dox new file mode 100644 index 000000000..119e102a1 --- /dev/null +++ b/aegisub/docs/doxygen/pages_reporter/groups.dox @@ -0,0 +1,7 @@ +/** +@defgroup base Base +@defgroup Unix Unix +@defgroup windows Windows +@defgroup osx OS X +@defgroup io File I/O +*/ diff --git a/aegisub/docs/doxygen/pages_reporter/index.dox b/aegisub/docs/doxygen/pages_reporter/index.dox new file mode 100644 index 000000000..88c8ce19b --- /dev/null +++ b/aegisub/docs/doxygen/pages_reporter/index.dox @@ -0,0 +1,17 @@ +/** @mainpage + +@defgroup base Base +@defgroup Unix Unix +@defgroup windows Windows +@defgroup osx OS X +@defgroup io File I/O + +Main + - @ref base + +Library + - @ref unix + - @ref windows + - @ref osx + - @ref io +*/ diff --git a/aegisub/docs/doxygen/pages_reporter/license.dox b/aegisub/docs/doxygen/pages_reporter/license.dox new file mode 100644 index 000000000..8050be379 --- /dev/null +++ b/aegisub/docs/doxygen/pages_reporter/license.dox @@ -0,0 +1,5 @@ +/** @page License Aegisub License + +@verbinclude "LICENCE" + +*/