Updating README and TODO files
authormikek
Thu, 13 May 2010 09:00:30 +0100
changeset 7 0232de5196ec
parent 6 787612182dd0
child 8 b260811257d2
Updating README and TODO files
README
TODO
--- 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.
 
--- 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