srcanamdw/appdep/group/ReleaseNote.txt
author noe\swadi
Sat, 09 Jan 2010 10:04:12 +0530
changeset 0 509e4801c378
permissions -rw-r--r--
1. Copyrights changed to EPL 2. Feature updates mentioned in release notes.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
     1
========================================================================
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
     2
RELEASE NOTE FOR APPDEP, 2.2
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
     3
========================================================================
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
     4
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
     5
Product Description:
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
     6
====================
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
     7
AppDep is a command line tool that can be used to resolve static
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
     8
dependency information of a component within a Symbian OS build (either
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
     9
platform or custom). The tool generates a cache file by reading the data
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    10
from all binaries and import libraries within a release, by using an
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    11
external compiler tool set. The use of a cache file is a fast way to make
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    12
a dependency review, such as what dependencies a binary has, and functions
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    13
and ordinals used in a binary, and to generate dependency lists to a
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    14
component or a function. The tool can also be used to view the properties
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    15
of a binary.
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    16
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    17
Features:
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    18
=========
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    19
- Generates a cache file appdep-cache-symbol-tables.txt which contain
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    20
  symbol tables of all import libraries within a release
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    21
- Generates a cache file appdep-cache-dependencies.txt which contain
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    22
  dependency information of all binaries within a release
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    23
- Reading data from AppDep generated cache files or from platform
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    24
  generated StaticDependencies.txt
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    25
- Include SIS files under analysis  
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    26
- Support for defining multiple target types
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    27
- Support for reading binaries from a release or a debug build
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    28
- Support for reading .lib files or .dso files
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    29
- Display properties of a file
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    30
- Print all static dependencies of a component
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    31
- Print all components that depends on a component
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    32
- Print all functions used by a component
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    33
- Print all components that are using a function
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    34
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    35
Fixed issues:
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    36
=============
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    37
- Added support for components that include "-" character in the middle of the component name i.e. now 
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    38
  also imported function lines of format '27 imports from libdbus-utils{000a0000}[20010154].dll' are parsed
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    39
  correctly from dump created by elftran.exe.
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    40
- Fixed issue 'command '-showfunctions' may report functions with same ordinal twice' which was due to duplicate
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    41
  import function instances found from cache file. Now the possible duplicate import function instances are detected
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    42
  during cache creation and only one import function instance is stored.
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    43
   
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    44
Enhancements:
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    45
=============
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    46
- Appdep now scans *.agt and *.fxt files as binaries
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    47
- Changed tool to use elftran.exe instead petran.exe for GCCE and RVCT toolchains (petran.exe is still used for GCC).
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    48
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    49
New Features:
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    50
=============
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    51
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    52
System Requirements:
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    53
====================
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    54
Basic Requirements:
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    55
- Windows 2000
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    56
- External RVCT or GCCE tool chain installed when Symbian OS 9.x is
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    57
  being used
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    58
- Symbian OS development environment installed including all related
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    59
  import libraries (.lib or .dso)
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    60
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    61
Compatibility Issues:
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    62
=====================
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    63
N/A
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    64
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    65
Known Issues:
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    66
=============
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    67
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    68
RVCT toolset slowness
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    69
---------------------
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    70
- If your installed RVCT toolset does not have a fixed license, it will
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    71
  get a license for each import library every time. This may cause the
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    72
  cache generation become very slow. If this is causing problems, try
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    73
  --uselibs parameter or use GCCE tool chain instead.
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    74
  
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    75
C++filt location when RVCT toolchain is used
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    76
--------------------------------------------
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    77
- When you RVCT toolchain, you must also specify a location to C++filt
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    78
  tool since RVCT toolchain does not provide that. It is recommended to
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    79
  use the cfilt.exe provided with AppDep installed since it has been
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    80
  tested to work correctly. C++filt.exe provided by the platform cannot
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    81
  be used since it is not compatible.
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    82
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    83
Copyright (c) 2001-2009 Nokia Corporation and/or its subsidiary(-ies).
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    84
All rights reserved.
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    85
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    86
This component and the accompanying materials are made available
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    87
under the terms of "Eclipse Public License v1.0"
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    88
which accompanies this distribution, and is available
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    89
at the URL "http://www.eclipse.org/legal/epl-v10.html".
509e4801c378 1. Copyrights changed to EPL
noe\swadi
parents:
diff changeset
    90