memana/analyzetoolclient/group/ReleaseNotes_AnalyzeTool.txt
changeset 0 f0f2b8682603
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/memana/analyzetoolclient/group/ReleaseNotes_AnalyzeTool.txt	Thu Feb 11 15:51:35 2010 +0200
@@ -0,0 +1,328 @@
+===============================================================================
+
+RELEASE NOTES - AnalyzeTool v1.8.0
+RELEASED 1st December 2009
+
+===============================================================================
+
+Product Description:
+====================
+
+AnalyzeTool is a test software tool that is used for testing Symbian software
+for memory leaks and pinpointing the leaking problems from the source code.
+
+
+Main Features:
+==============
+- Pinpoints memoryleaks from target hardware and emulator to source code lines
+- Discovers resource leaks from process
+- Command line interface and Carbide.c++ Extension
+
+===============================================================================
+
+What's New in 1.8.0
+===================
+
+-New:[AT-45] - Memory usage shown as graph.
+
+===============================================================================
+
+Installation Notes:
+===================
+PDK Tools Overlay installer should be used to install AnalyzeTool to the used
+environment. After that AnalyzeTool should be build to all used platforms and
+both build types (udeb/urel) in that environment.
+ 
+AnalyzeTool is found from sf\pdt\dynaanactrlandcptr\memana\analyzetoolclient
+folder. Building should be done in group folder.
+
+Note: Before building check symbian_version.hrh file that it defines correct
+version for your environment.
+
+===============================================================================
+
+System Requirements:
+====================
+- Windows XP
+- Trace connection for real time data gathering to PC
+
+Additional Requirements:
+- Carbide.c++ v2.x
+
+===============================================================================
+
+Compatibility Issues:
+=====================
+- Not compatible with versions older than 1.5.0 of AnalyzeTool
+- Kernel code analysis not supported
+
+===============================================================================
+
+Known Issues:
+=============
+- When using monitored internal data gathering mode (-mi) and hooked application contains huge 
+amounts of allocations, AnalyzeTool storageserver might run out of memory to store the data. This 
+message "Symbian error code -4" is seen in the data file. Solution is to 
+use external / monitored external data gathering mode. No fix is planned yeat. 
+
+- Switch allocator. AnalyzeTool change the application memory allocator to AnalyzeTool own memory 
+allocator and using the User::SwitchAllocator function can lead to situation where the tested 
+application does not work properly. No fix is planned yeat. 
+
+- AnalyzeTool hooked QT applications becomes too slow to run. Improved in release 1.7.4 where you 
+can use small size call stack(s) and new logging mode (external -e). 
+
+- Stif test case with AnalyzeTool can inform wrong memory leak alert. No fix is planned yeat. 
+
+- AnalyzeTool overwrites functions TInt User::ProcessCritical(TCritical aCritical) and TInt 
+User::SetProcessCritical(TCritical aCritical), but this works only when the function is called from 
+hooked exe application. So if setting critical is done from DLL (even if it's hooked with 
+AnalyzeTool) the overwriting does not work and the process stays set critical during the testing. No 
+fix is planned yeat. 
+
+- If hooked application is closed by calling User::Exit() from DLL instead of .exe application 
+AnalyzeTool reports "abnormal process end" and can't report proper memory leaks. No fix is planned 
+yeat. 
+
+===============================================================================
+Version History:
+================
+
+Version in 1.7.4 - 4th November 2009
+---------------------------------
+-New: [AT-560] - Third data gathering mode which is simple and fast.
+-New: [AT-592] - Support for specifying call stack size(s).
+-New: [AT-627] - Button to open preferences.
+-New: [AT-551] - New error dialogs in Carbide extension.
+-New: [AT-583] - Extension version number shown in AnalyzeTool view.
+-Fix: [AT-568] - Inform user in build phase that kernel mode is not supported/hooked.
+-Fix: [AT-623] - Version conflict not shown to user.
+-Fix: [AT-632] - Selecting leak from sub test does not give call stack info.
+-Fix: [AT-630] - Console UI leaks memory.
+
+Version in 1.7.3 - 1st October 2009
+---------------------------------
+-New: [AT-570] - Support reading debug data from ROFS files.
+-New: [AT-495] - Timestamps in DLL load/unload messages.
+-New: [AT-540] - Support for DLL timestamps in CLI.
+-New: [AT-544] - Use all found emulator binaries in analyze.
+-New: [AT-527] - Timestamp in free trace message.
+-Fix: [AT-463] - Memory card drive letter hard coded.
+
+Version in 1.7.2 - 3th September 2009
+---------------------------------
+-Fix: [AT-569] - False memory leak reported when test had handle leak(s)
+-Fix: [AT-535] - Hooked application panics on exit at certain environment
+
+Version in 1.7.1 - 19th August 2009
+---------------------------------
+-Fix: [AT-542] - Decrease extension memory usage when creating results.
+-Fix: [AT-548] - Write protected mmp files will not prevent building project.
+-Fix: [AT-553] - Device data file input should not accept path.
+-Fix: [AT-554] - User build accidentally slow debug version of AnalyzeTool
+-Fix: [AT-528] - Mutex access violation error in certain environment.
+-Fix: [AT-562] - Two tests in one log file may fail to pinpoint.
+-Fix: [AT-563] - Analysis takes allocations before process start tag.
+-Fix: [AT-526] - Memory check related macro panics when application is hooked.
+-Fix: [AT-541] - Opening help on hooked application causes panic.
+-Fix: [AT-555] - AnalyzeTool skips some reallocations.
+-New: [AT-558] - Supporting new environment.
+
+Version in 1.7.0 - 25th June 2009
+---------------------------------
+-Fix: [AT-521] - AnalyzeTool results can be incorrect if new line is non-standard
+-Fix: [AT-414] - Logging level 2 does not work in raptor and build type urel correctly
+-Fix: [AT-508] - Show error if illegal parameters
+-Fix: [AT-464] - Verbose output renders AnalyzeTool unusable slow
+-Fix: [AT-517] - Improve parsing speed of addresses
+-New: [AT-320] - Create support to use xml project definition when building using raptor.
+-New: [AT-389] - User can easily check version of AnalyzeTool in SDK
+-New: [AT-134] - Carbide.c++ AnalyzeTool building of a QT project
+-New: [AT-236] - Refresh button which makes results again
+-New: [AT-136] - Carbide extension to visualize results for emulator/simulator memory leaks automatically
+
+Version in 1.6.0 - 20th April 2009
+---------------------------------
+-New: [AT-475] - Number of max callstack items increased to 40
+-New: [AT-453] - On the fly call stack filtering improved
+-New: [AT-481] - "PROCESS_END x ABNORMAL" are now printed also when internal data gathering mode is used
+-Fix: [AT-491] - Error info improved with new command line parameters
+
+Version in 1.5.2 - 2nd April 2009
+---------------------------------
+-New: [AT-455] - A lot of changes to atool.exe parameters
+-New: [AT-257] - addr2line.exe in now used to pinpoint code lines
+-New: [AT-337] - Supports for pinpointing codelines from GCCE binaries
+-New: [AT-113] - Pinpoint memory leaks to code lines also in urel builds
+-Fix: [AT-461] - Pinpointing works also to dlls in emulator environment.
+-Fix: [AT-470] - Logging levels 1&2 (atool -a l1 or atool -a l2) shows now only pinpointed lines
+-Fix: [AT-483] - Commandline crash fixed when project build to winscw platform
+-Fix: [AT-328] - User is now warned when build type differs between data and project
+-Fix: [AT-419] - Clear AnalyzeTool changes (atool -c) runs reallyclean also
+-Fix: [AT-446] - Error message is display when user analysis invalid data
+-Fix: [AT-413] - Building errors fixed
+
+Version 1.5.1 - 19th March 2009
+-------------------------------
+-Fix: [AT-422] - Abnormal process ends not anymore showed for non-AnalyzeTool processes
+-Fix: [AT-433] - Summary info fixed when executing atool.exe with -uninst parameter
+-Fix: [AT-415] - New mmp specified error message added to sbs2 builds
+-Fix: [AT-449] - Thread killing now handled correctly
+-Fix: [AT-452] - All library events are now handled by DAnalyzeToolEventHandler
+-New: [AT-443] - Atool version is checked when hooked application is started
+-New: [AT-343] - System components info in callstack is read from rom symbols file
+-New: [AT-451] - Added support for pinpointing codelines from static libraries in ARMV5 platform
+
+Version 1.5.0 - 19th February 2008
+----------------------------------
+-Fix: [AT-317] - Multible processes can log to same datafile
+-Fix: [AT-350] - Running atool -c in directory where only empty atool_temp directory exists will not delete atool_temp directory
+-Fix: [AT-330] - In analyze report pinpointed memoryleak count is always zero when using raptor, in logging levels 1 & 2
+-Fix: [AT-333] - Use of raptor build variables leads to incorrect listing file name with certain types
+-Fix: [AT-357] - AnalyzeTool can share existing TraceViewer connection
+-Fix: [AT-361] - Unnecessary "Can not analyze" dialog is no longer displayed after the project is built with AnalyzeTool.
+-Fix: [AT-363] - Needed files for AnalyzeTool hooking are also checked for winscw
+-Fix: [AT-376] - Analyze Tool Pre- and Post-Build Errors are added to Problems View
+-Fix: [AT-272] - AnalyzeTool debug logging improved
+-Fix: [AT-374] - Start tracing icon changed
+-Fix: [AT-332] - Only supported mmp target types are now hooked
+-Fix: [AT-372] - If SDK prefs not ok in Carbide, atool gives error: missing libraries from SDK
+-Fix: [AT-378] - Crash when trying to navigate to source location
+-Fix: [AT-388] - Hooked application no longer panics if there is old version of atool in SDK (now application does not start if versions do not match)
+-Fix: [AT-390] - Emulator pinpoints to wrong cpp file
+-Fix: [AT-393] - Progress monitor is shown while starting the TraceViewer connection
+-Fix: [AT-417] - AnalyzeTool configUI memory leaks fixed
+-Fix: [AT-316] - New 'How to use examples' added to command line help
+-Fix: [AT-410] - Command line tool, "atool.exe", is bundled into the Carbide extension
+-Fix: [AT-325] - unnecessary copying of trace file removed from Carbide
+-Fix: [AT-358] - Disable unnecessary AnalyzeTool buttons when trace is started.
+-New: [AT-296] - AnalyzeTool supports hooking and unhooking of project in command line
+-New: [AT-254] - AnalyzeTool to work also in emulator
+-New: [AT-323] - AnalyzeTool Carbide extension can be used without Traceviewer Extension
+
+Version 1.4.1 - 19th December 2008
+----------------------------------
+-Fix: [AT-310] - AnalyzeTool consoleapplication does not show all process information
+
+Version 1.4.0 - 12th December 2008
+----------------------------------
+-New: [AT-263] - Atool supports Symbian build system version 2 (SBS v.2)
+-Fix: [AT-271] - "atool -c" gives badly formed error texts
+-Fix: [AT-294] - Atool.exe to check if there is process start and dll_load in datafile
+
+Version 1.3.3 - 27th November 2008
+----------------------------------
+-Fix: [AT-237] - Support analysing datafiles without /epoc32/build content or from sub folder where build was made
+-Fix: [AT-285] - Temporary file left to output directory in atool.exe analyze
+-Fix: [AT-292] - S60_UPGRADABLE_APP_REG_RSC macro not always available
+-Fix: [AT-283] - AnalyzeTool.iby works also on PP environment
+
+Version 1.3.2 - 13th November 2008
+----------------------------------
+-Fix: [AT-224] - Multiple modules use same source files (objects listing files)
+-Fix: [AT-220] - Atool.exe to show what is trying to copy or move
+-Fix: [AT-238] - Logging level filtering summary
+-New: [AT-233] - Results include processes udeb/urel info.
+
+Version 1.3.1 - 30th October 2008
+---------------------------------
+-Fix: [AT-228] - Atool tries to delete same temp directory multiple times
+-Fix: [AT-247] - run abld reallyclean instead of abld clean
+-Fix: [AT-215] - AnalyzeTool panics on certain environment
+
+Version 1.3.0 - 23rd October 2008
+---------------------------------
+-Fix: [AT-156] - Multiple subtests within test run show only one subtest
+-Fix: [AT-179] - Atool misinterprets data filename which contains "-l" in string as logging argument
+-Fix: [AT-181] - Logging levels 1 and 3 produce same results when using UREL target
+-Fix: [AT-204] - Memoryhook prints PROCESS_END when child threads are killed
+-Fix: [AT-206] - Atool reports runs from irrelevant PROCESS_ENDS
+-Fix: [AT-210] - Logging level 2 incorrect call stack data
+-Fix: [AT-222] - No error message data file can not be opened
+-Fix: [AT-225] - NPE when using the Analyze View in Carbide 2.0.
+-Fix: [AT-227] - AnalyzeTool uses default variant if no variant parameter is used and default level1 makefiles content is invalid
+-Doc: [AT-175] - AnalyzeTool user guide to have advanced section which explains in detail how tool works
+-New: [AT-66]  - Merge call stack info from main exe and dlls.
+-New: [AT-118] - Show urel/udeb info from main process
+-New: [AT-145] - Analyze is made to given module target name
+-New: [AT-162] - bldmake bldfiles to call only for needed components
+-New: [AT-163] - a single process start - end, should not be a test run
+-New: [AT-183] - atool continues even if bldmake bldfiles fails
+-New: [AT-189] - Carbide.c++ Extension shows ABNORMAL text when system exception happens in the phone
+-New: [AT-190] - Carbide.c++ Extension could filter memory leaks which does not contain any call stack
+-New: [AT-191] - MemoryHook reports PROCESS_END with ABNORMAL tag
+-New: [AT-192] - atool -c to undo mmp change
+-New: [AT-196] - logging datafile shown in Configuration UI
+-New: [AT-202] - Modules with read only mmp files can be hooked
+-New: [AT-209] - Print logging filename if not given
+-New: [AT-211] - AnalyzeTool supports new environments
+-New: [AT-214] - atool could check "build" parameter before assuming debug build
+
+Version 1.2.1 - 2nd October 2008
+--------------------------------
+-Fix: [AT-165] - Process end is not get when process is killed
+-Fix: [AT-176] - Should not hook STATIC libraries
+-Fix: [AT-177] - atool.exe makes changes before creating backup from mmp file
+-Fix: [AT-188] - Atool can not pinpoint codelines from variant modules.
+-New: [AT-142] - Subtests supports handle leak detection
+-New: [AT-159] - AnalyzeTool no longer hooks kernel side components
+-New: [AT-123] - Configuration UI could be used to kill processes in device
+
+Version 1.2.0 - 18th September 2008
+-----------------------------------
+-Fix: [AT-56] - Error when project is build in Carbide.
+-Fix: [AT-73] - White space not ignored when reading target from MMP-file
+-Fix: [AT-87] - XML report file is incorrect when executing multiple test runs with subtest
+-Fix: [AT-93] - Error note "AnalyzeTool can not find all .cpp files" even when project consists of only .c files.
+-Fix: [AT-101] - UI fixes
+-Fix: [AT-102] - MMP selection dialog during build
+-Fix: [AT-109] - Does not follow build order
+-Fix: [AT-110] - Jump to code line does not work
+-Fix: [AT-119] - Updating AnalyzeTool, installed on ROM, with a SIS-file fails.
+-Fix: [AT-143] - Save button menu in previous (wrong) place
+-Fix: [AT-157] - "Number of memory allocations: " can be wrong with multiple test runs
+-Fix: [AT-160] - Carbide.c++ start trace dialog does not contain cancel option
+-New: [AT-74] - Get module info from makefile
+-New: [AT-90] - Check for missing files before building
+-New: [AT-98] - Use makefile templates
+-New: [AT-116] - Improved AnalyzeTool Carbide.c++ Extension to use Carbide builder
+-New: [AT-117] - Improve results showing
+-New: [AT-121] - Urel build selection in Carbide
+-New: [AT-144] - Environment changes zips to include also binaries for various environments
+-New: [AT-149] - Check that AnalyzeTool works with mmp files without .mmp extension
+-New: [AT-53] - AnalyzeTool supports also building and analysing urel binaries
+
+Version 1.1.2 - 21th August 2008
+--------------------------------
+-Fix: [AT-50] - Atool result not always displayed.
+-Fix: [AT-97] - Launching Carbide generates error message to error log
+-Fix: [AT-99] - 'Module not build with AnalyzeTool' is still displayed after AnalyzeTool build.
+
+Version 1.1.1 - 7th August 2008
+-------------------------------
+-Fix: [AT-72] - Command line tool can not handle project where two MMP-files are in same directory
+
+Version 1.1.0 - 10th July 2008
+------------------------------
+-Fix: [AT-70] - Redundant handle leak information
+-New: [AT-59] - Trace data can be saved to a file.
+-New: [AT-68] - Cancel logging from ConfigUI feature.
+
+===============================================================================
+
+/*
+* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). 
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+* 
+* Description:
+*
+*/