1 ===============================================================

     2 Things that need done for this package (in no particular order)

     3 ===============================================================

     4 

     5 2010-05-10, mikek@symbian.org

     6 

     7 1.	Test the built tools. No testing has been done whatsoever.

     8 

     9 2.	Build the package on platforms not listed here, and add them to the

    10 	list:

    11 		Windows XP 32bit

    12 		Ubuntu 10.4 32bit

    13 

    14 3.	Find all the perl scripts that are exported and ensure they run on

    15 	Linux.

    16 

    17 4.	Differentiate the exports so that .bat files are only exported by

    18 	Windows builds and .sh files are only exported by *nix builds

    19 

    20 5.	Numerous C++ warnings were fixed for constness violations. Where there

    21 	was a choice between changing the constness traits of an API and

    22 	using const_casts on pointers to cure the warning, const_casts were

    23 	always chosen, because changing the constness traits of APIs may spiral

    24 	into major refactoring. But changing the constness traits of the APIs is

    25 	the right thing.

    26 

    27 	Get rid of const_casts by fixing the APIs.

    28 

    29 6.	On Windows, the imgcheck target needs to link against libwsock32.a. This

    30 	library exist in the gcc mingw lib directory in the PDT, but because

    31 	the library is specified with the STATICLIBRARY keyword, the linker looks

    32 	for it in the epoc32\release\tools2\{deb|rel} directory and doesn't find it.

    33 	It is not included in the upstream package, so it cannot be exported there.

    34 	This bug has been worked around as one of the things done by the

    35 	fix_epoc32_win.pl script - it just copies libwsock32.a from the PDT to

    36 	the tools2 release deb|rel directories, but a real solution should be found.

    37 	Preferably, for all targets on Windows the gcc mingw libraries should be in

    38 	the linker's search path.

    39 

    40 7.	Add a toplevel GNU makefile to the package and scripting to support it which

    41 	can generate a GNU tarball containing a "normalised Linux" simplification of

    42 	the package. The normalised Linux spin will strip out everything from the

    43 	package contents and build that is only required for Windows or would

    44 	normally be provided by package prerequisities in a Linux setting, e.g. it

    45 	will not contain Windows binaries or build its own versions of make, bash,

    46 	cpp, python. A normalised Linux spin would be the right basis on which

    47 	to build .deb or .rpm packaging. 

    48