--- a/Orb/RELEASE.txt Thu Jan 21 17:29:01 2010 +0000
+++ b/Orb/RELEASE.txt Thu Mar 18 18:26:18 2010 +0000
@@ -7,8 +7,44 @@
Release notes for Orb
================================================
-version 0.1.5
-
+version 0.1.7
+ Updates to Doxygen (Doxygen version 1.6.2-20100106_dita_0.1.26-Doxygen version 1.6.2-20100106_dita_0.1.45)
+ Fixed defect - links to inherited members are to the wrong file.
+ Added option: CLEAR_INCLUDE_CACHE - This clears the include cache after each component has been read so that the include files will be read again.
+ Fixed generate 0.5.0 DOCTYPE declarations.
+ Removed flushing of include cache as this was correct but expensive.
+ #define CLEAR_G_ALLINCLUDES 0
+ Updated DTDs to version 0.5.0
+ Added esock_dll generated by Doxygen version 1.6.2-20100106_dita_0.1.38
+ Fixes for removing duplicates when #including.
+ Aligned with version 0.5 of the DTDs.
+ Added -d includes to dump out the include graph.
+ DTDs updated to verison 0.5.0.
+ Fixed DITA generator so that cxxInterface etc. is not written out.
+ Major fix to improve linking to #included files.
+ Added XML_DITA_OMIT_DUPLICATE_MEMBERS = YES to doxtemplate.txt
+
+version 0.1.6
+ Updates to Doxygen (Doxygen version 1.6.2-20100106_dita_0.1.18-Doxygen version 1.6.2-20100106_dita_0.1.24)
+ Updated to create more compatible Dita Open Toolkit output
+ Updated with option to not omit classes with incomplete function definitions (by default it does)
+ keyref attributes now href attributes (conditionally compiled)
+ Updates to Post Processing:
+ XSLT for transforming Doxygen output to DITA Reference dtd updated for better formating in Dita Open toolkit
+ Updated for more informative logging on stdout/stderr during post processing
+ Updated toolchain to partially support cross referencing
+ Included map creation support for non-distributed system definition 3 files
+
+version 0.1.5.1
+ Doxygen version 1.6.2-20100106_dita_0.1.15
+ Fixed bug in element prefix creator that was generating spurious element names.
+ Added addittional file extensions for Symbian like code.
+ Fixed memory leak.
+ Added extra reporting.
+ Added error checking to post processing batch script and ditaot/mode option
+ Updated file renamer to support dita open toolkit file names
+ Updated guidiser to support dita open toolkit ids
+
System Requirements
===================
@@ -17,19 +53,32 @@
* Symbian Build System v2 version 2.10.0
* RVCT 2.2 onwards
* epoc32 tree (Symbian Platform SDK/PDK)
+* 1GB memory per Symbian build system thread running doxygen.exe
+* 8GB free disk space
-Known issues
-============
+Known issues v0.1.7
+===================
+Missing content
+---------------
+Some classes have no members. There are approximately 1600 exported classes using the NONSHARABLE_CLASS macro. Doxygen is handling macros in
+implementation files but not those in #included files.
+
+Still losing whole components due to DITA-OT memory issues. This results in large groups of missing links.
-Doxygen produces a dialog box that appears under certain error conditions.
-The dialog indicates that an error has occured with doxygen and this suspends the
-execution of doxygen until the ok button is pressed on the dialog.
-If doxygen is being run by a continuous integration system this dialog may be hidden.
-Invalid C++ is one known cause of this problem.
+Misplaced content
+-----------------
+There is an issue with content in the wrong components. Critically this leaves some libraries empty.
+
+Potential issues
+----------------
+There are still out of memory issues in DITA-OT, which are exacerbated by the “classes in wrong components” issue that is causing the maps
+of some components to be larger than they should be.
-Doxygen has been known to take many days to run the full Symbian OS source.
-It is suspected that this is due to a large amount of page faults when ram runs low.
-Each doxygen process can use 500mb of ram and Raptor runs one doxygen process for each cpu.
-The space required for the working directory used by doxygen is greater than 80Gb.
-Please take this into consideration when choosing a build environment for Orb.
+Missing targets
+---------------
+Missing targets caused by command lines that are too long. Orb outputs a file (meta.xml) which outputs all the includes using echo.
+Unfortunately there is a character limit on the command line so the entire echo doesn't get printed which means that the file is invalid.
+
+
+