Changeset 560 for trunk/SConstruct

Timestamp:

02/26/07 14:29:12 (2 years ago)

Author:

dirk

Message:

Added doxygen support (first round)

Files:

• trunk (modified) (1 prop)
• trunk/SConstruct (modified) (10 diffs)

trunk/SConstruct

@@ -40 +40 @@
-from LibraryUtils import *
-from sets import Set
+from socket import gethostname
-
-# If we have pysvn, load it
@@ -457 +458 @@
-        modifiedStr = ""
-        for file in glob.glob("Doc/*"):
-            print file
-            fileRev, fileMod = self._getSVNInfo(file)
-            
@@ -500 +500 @@
-SourceSignatures('MD5')
-#SourceSignatures('timestamp')
-#SConsignFile('.sconsign.'+GetPlatform())
-opensg_version_string = file("VERSION").readline().strip()
-
@@ -516 +515 @@
-   # XXX: Temp hack to get msvs version setting
-   if ARGUMENTS.has_key("MSVS_VERSION"):
-
+
+
+
-   else:
-
+tools = ['default', 'doxygen'], toolpath = '.'
-else:
-   if ARGUMENTS.has_key("icc"):
@@ -527 +528 @@
-         
-      common_env = Environment(ENV = os.environ,
-
-
+
+
+
-   else:
-
+
+
+
-
-SConsignFile('.sconsign.'+GetPlatform()+common_env.subst('$CXX'))
@@ -703 +707 @@
-    "enable_scanparse_regen", "Enable regenerating the scanner/parser files using flex and bison", False);
-
+feature_options["docs_mode"] = sca_opts.EnumOption(
+    "docs_mode", "Select the mode for documentation generation",
+    "NONE", ["NONE", "STANDALONE", "TRAC"])
+
-if "win32" == platform:
-    feature_options["enable_win_localstorage"] = sca_opts.BoolOption(
@@ -846 +854 @@
-   
-   # Add lexer to the build
-
-
+      
+
-   # -- Common builder settings
-   variant_helper.readOptions(common_env)
@@ -932 +940 @@
-   # Revision tracking
-   # For each library, find its Def.cpp file(s) and set the revision to the highest one found
-ht
+th
-   # This could go into scons-addons at some point...
-   if common_env["enable_revision_tags"]:
-      tagWriter = RevisionTagWriter(lib_map)
-      tagWriter.run()
+      
+   # Documentation
+   if "NONE" != common_env["docs_mode"]:
+      # Todo: 
+      #   - put output into build dir
+      #   - handle different doc levels
+      #   - handle different output types
+
+      # Get all used source/header files
+      dox_inp = ""
+      for (name,lib) in lib_map.iteritems():
+         for i in lib.source_files:
+            dox_inp += "../Source/" + i + " "
+         for i in lib.header_files:
+            dox_inp += "../Source/" + i + " "
+      
+      # Need to use my private doxygen version until the parameter macro patch is in
+      if "dream.lite3d.com" == gethostname():
+         common_env["DOXYGEN"] = "/home/reiners/software/DocumentationTools/doxygen-cvs/doxygen-070225/bin//doxygen"
+      common_env["DOX_INPUT"] = dox_inp
+      common_env["DOX_VERSION"] = opensg_version_string
+      
+      if "STANDALONE" == common_env["docs_mode"]:
+         common_env.Doxygen("Doc/standalone.doxy")
+      elif "TRAC" == common_env["docs_mode"]:
+         common_env.Doxygen("Doc/trac.doxy")
+      else:
+         raise "Unknown docs_mode %s" % common_env["docs_mode"]
-      
-   # ---- FOR EACH VARIANT ----- #
@@ -946 +982 @@
-      
-   # We tread the first variant type special (auto link from libs here)
-
-
+
+
+
+
+
-   for combo in variant_helper.iterate(locals(), base_bldr, common_env):
-      #baseEnv = env_bldr.applyToEnvironment(common_env.Copy(), variant=combo,options=opts)
@@ -971 +1010 @@
-      for d in sub_dirs:
-         SConscript(pj(d, 'SConscript'), build_dir = pj(full_build_dir, d), duplicate = 0)
-   
+
-      # Build -config file based on first set installed
-      if 0 == variant_pass: