# HG changeset patch # User mikek # Date 1273737630 -3600 # Node ID 0232de5196ec9204db3c6c5c036576ed9ebb29a1 # Parent 787612182dd09640362d0f009319fe9b80c48501 Updating README and TODO files diff -r 787612182dd0 -r 0232de5196ec README --- a/README Thu May 13 08:38:18 2010 +0100 +++ b/README Thu May 13 09:00:30 2010 +0100 @@ -14,6 +14,7 @@ - Strategy for building this package - Preparing to build this package on Linux - Preparing to build this package on Windows +- Pushing changes to this package repo - Patch files for the upstream package == Intro == @@ -143,6 +144,17 @@ - tools_epoc.zip * Consult the README-WINDOWS file in the subdirectory cross-plat-dev-utils. +== Pushing changes to the package repo == +============================================= +The Raptor build generates a very large volume of files that are not in the +package repo (http://developer.symbian.org/oss/MCL/sftools/dev/linux_build). +If you build Raptor, then you need to remove all of these files before +pushing any other changes to the package repo. Use the script +cross-plat-dev-utils/deepclean_raptor.pl to do this (clean_raptor.pl is not +sufficient). Then remember that you will need to rebuilt Raptor after you +have pushed. + + == Patch files for the upstream package == ========================================== @@ -150,7 +162,7 @@ more files with names like 'patch-dddddddddddd.patch', for digits 'd'. The patch file 'patch-dddddddddddd.patch' shows the diffs between the upstream -package ((http://developer.symbian.org/oss/MCL/sftools/dev/build) at revision +package (http://developer.symbian.org/oss/MCL/sftools/dev/build) at revision dddddddddddd and this package as baselined on that upstream revision. Only diffs relevant to changing the upstream package are included. diff -r 787612182dd0 -r 0232de5196ec TODO --- a/TODO Thu May 13 08:38:18 2010 +0100 +++ b/TODO Thu May 13 09:00:30 2010 +0100 @@ -2,7 +2,7 @@ Things that need done for this package (in no particular order) =============================================================== -2010-05-10, mikek@symbian.org +2010-05-13, mikek@symbian.org 1. Test the built tools. No testing has been done whatsoever. @@ -17,16 +17,7 @@ 4. Differentiate the exports so that .bat files are only exported by Windows builds and .sh files are only exported by *nix builds -5. Numerous C++ warnings were fixed for constness violations. Where there - was a choice between changing the constness traits of an API and - using const_casts on pointers to cure the warning, const_casts were - always chosen, because changing the constness traits of APIs may spiral - into major refactoring. But changing the constness traits of the APIs is - the right thing. - - Get rid of const_casts by fixing the APIs. - -6. On Windows, the imgcheck target needs to link against libwsock32.a. This +5. On Windows, the imgcheck target needs to link against libwsock32.a. This library exist in the gcc mingw lib directory in the PDT, but because the library is specified with the STATICLIBRARY keyword, the linker looks for it in the epoc32\release\tools2\{deb|rel} directory and doesn't find it. @@ -37,7 +28,7 @@ Preferably, for all targets on Windows the gcc mingw libraries should be in the linker's search path. -7. Add a toplevel GNU makefile to the package and scripting to support it which +6. Add a toplevel GNU makefile to the package and scripting to support it which can generate a GNU tarball containing a "normalised Linux" simplification of the package. The normalised Linux spin will strip out everything from the package contents and build that is only required for Windows or would