Orb/RELEASE.txt
changeset 3 d8fccb2cd802
child 4 468f4c8d3d5b
equal deleted inserted replaced
2:932c358ece3e 3:d8fccb2cd802
       
     1 License
       
     2 =======
       
     3 Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved.
       
     4 This component and the accompanying materials are made available under the terms of the License 
       
     5 "Eclipse Public License v1.0" which accompanies this distribution, 
       
     6 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html".
       
     7 
       
     8 Release notes for Orb
       
     9 =====================
       
    10 
       
    11 version 0.1.9
       
    12     Fixed bug in FLM: 
       
    13         config.dox files were being created as readonly and failing on attempts to edit. Added a chmod statement to FLM to fix.
       
    14     Deleted locations.xml as orb does not need to declare the "tr" for use the flm anymore. (Tested on sbs 2.12.4)
       
    15 	Fixed FLMs to prevent command line buffer overrun with meta.xml and config.dox. (doxygen.flm, doxygen-sdk.flm)
       
    16     Doxygen version 1.6.2-20100106_dita_0.1.50
       
    17         Fix for [#13001] NONSHARABLE_CLASS macro isn't being handled
       
    18         Tesed on esockserver OK.
       
    19     Critical Defects Fixed in release:
       
    20         Classes in wrong components
       
    21         many missings intem/broken links
       
    22         S60 Public and Platform APIs not built by SBS
       
    23         50 targets not built (FLM error) including openenvcore libc.
       
    24         Classic ui not appearing in the library.
       
    25     Fixed defect: Return arguments mising (for functions that don't return void)
       
    26         
       
    27 version 0.1.8
       
    28 	Updates to Doxygen (Doxygen version 1.6.2-20100106_dita_0.1.26-Doxygen version 1.6.2-20100106_dita_0.1.45)
       
    29 		Fixed defect - links to inherited members are to the wrong file.
       
    30 		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. 
       
    31 		Fixed generate 0.5.0 DOCTYPE declarations.
       
    32 		Removed flushing of include cache as this was correct but expensive.
       
    33 		#define CLEAR_G_ALLINCLUDES 0
       
    34 		Updated DTDs to version 0.5.0
       
    35 		Added esock_dll generated by Doxygen version 1.6.2-20100106_dita_0.1.38
       
    36 		Fixes for removing duplicates when #including.
       
    37 		Aligned with version 0.5 of the DTDs.
       
    38 		Added -d includes to dump out the include graph.
       
    39 		DTDs updated to verison 0.5.0.
       
    40 		Fixed DITA generator so that cxxInterface etc. is not written out.
       
    41 		Major fix to improve linking to #included files.
       
    42 		Added XML_DITA_OMIT_DUPLICATE_MEMBERS = YES to doxtemplate.txt
       
    43 	
       
    44 version 0.1.6
       
    45     Updates to Doxygen (Doxygen version 1.6.2-20100106_dita_0.1.18-Doxygen version 1.6.2-20100106_dita_0.1.24)
       
    46         Updated to create more compatible Dita Open Toolkit output
       
    47         Updated with option to not omit classes with incomplete function definitions (by default it does)
       
    48         keyref attributes now href attributes (conditionally compiled)
       
    49     Updates to Post Processing:
       
    50         XSLT for transforming Doxygen output to DITA Reference dtd updated for better formating in Dita Open toolkit
       
    51         Updated for more informative logging on stdout/stderr during post processing
       
    52         Updated toolchain to partially support cross referencing
       
    53         Included map creation support for non-distributed system definition 3 files
       
    54         
       
    55 version 0.1.5.1
       
    56 	Doxygen version 1.6.2-20100106_dita_0.1.15
       
    57         Fixed bug in element prefix creator that was generating spurious element names.
       
    58         Added addittional file extensions for Symbian like code.
       
    59         Fixed memory leak.
       
    60         Added extra reporting.
       
    61     Added error checking to post processing batch script and ditaot/mode option
       
    62     Updated file renamer to support dita open toolkit file names
       
    63     Updated guidiser to support dita open toolkit ids
       
    64     
       
    65 System Requirements
       
    66 ===================
       
    67 
       
    68 For information on installing all listed below see "install_orb.txt"
       
    69 
       
    70 * Symbian Build System v2 version 2.10.0
       
    71 * RVCT 2.2 onwards
       
    72 * epoc32 tree (Symbian Platform SDK/PDK)
       
    73 * 1GB memory per Symbian build system thread running doxygen.exe
       
    74 * 8GB free disk space
       
    75 
       
    76 Known issues v0.1.9
       
    77 ===================
       
    78 Missing content
       
    79 ---------------
       
    80 Some classes have no members. Doxygen is handling macros in implementation files but not those in #included files. 
       
    81 
       
    82 Library and header information missing. Library information is not in Orb output. Header information would need to be resolved by first collecting all cxxFileRef
       
    83 elements and then combining that to be able to create links to headers.
       
    84 
       
    85 Some global functions in libc not appearing in final content. e.g. clearerr is built by doxygen in libc target with it's comment from the dosc file, but does not appear in the final
       
    86 documentation.
       
    87 
       
    88 Enum members missing. Appears to be partially fixed. Some documents contain the first private enum, but not the second public anonymous enum.
       
    89 
       
    90 Misplaced content
       
    91 -----------------
       
    92 There is an issue with content in the wrong components. Critically this leaves some libraries empty.
       
    93 
       
    94 Doxygen tag support
       
    95 -------------------
       
    96 Tags currently not supported which should be are listed below:
       
    97 @see
       
    98 @pre
       
    99 @post
       
   100 @p
       
   101 @c
       
   102 @exception
       
   103 @verbatim
       
   104 @panic
       
   105 @code
       
   106 
       
   107 
       
   108 
       
   109 
       
   110 
       
   111 
       
   112 
       
   113 
       
   114