README
author imk
Wed, 19 May 2010 19:30:59 +0100
changeset 16 7f8c9f0bae61
parent 11 d610106f78c9
permissions -rwxr-xr-x
Updating TODO, README in light of 64-bit build success
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
2
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
     1
# Copyright (c) 2010 Symbian Foundation Ltd
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
     2
# This component and the accompanying materials are made available
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
     3
# under the terms of the License "Eclipse Public License v1.0"
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
     4
# which accompanies this distribution, and is available
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
     5
# at the URL "http://www.eclipse.org/legal/epl-v10.html".
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
     6
#
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
     7
# Initial Contributors:
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
     8
# Mike Kinghan, mikek@symbian.org, for Symbian Foundation Ltd - initial
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
     9
# contribution.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    10
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    11
== Contents ==
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    12
==============
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    13
- Intro
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    14
- Strategy for building this package
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    15
- Preparing to build this package on Linux
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    16
- Preparing to build this package on Windows
7
0232de5196ec Updating README and TODO files
mikek
parents: 4
diff changeset
    17
- Pushing changes to this package repo
2
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    18
- Patch files for the upstream package
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    19
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    20
== Intro ==
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    21
===========
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    22
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    23
This README describes the status quo at a point in time and it may be out of
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    24
date. See also the files TODO and NEWS for possibly more current information.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    25
This README will be updated from time to time.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    26
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    27
This package is a branch from the Symbian Build package
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    28
(http://developer.symbian.org/oss/MCL/sftools/dev/build) at Mercurial revision
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    29
mentioned in the file baseline.txt. The Build package "provides everything you
4
1f8f87c60526 Delete a scratch file inadvertently committed and fix some typos
mikek
parents: 2
diff changeset
    30
need to build the Symbian platform." This branch is work-in-progress toward
2
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    31
enabling those tools to build without problems and run correctly on a
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    32
conventional GNU/Linux host, as well Windows hosts.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    33
 
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    34
It fixes the upstream package so that:-
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    35
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    36
* All targets will build without errors or warnings on a GNU/Linux host using
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    37
the GCC 4.4.x toolchain and Standard C++ Library.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    38
* All targets will build without errors or warnings on a Windows host using the
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    39
Mingw GCC 3.4.x toolchain Standard C++ Library, from a Symbian PDT 1.6
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    40
installation.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    41
16
7f8c9f0bae61 Updating TODO, README in light of 64-bit build success
imk
parents: 11
diff changeset
    42
(The Raptor test-suite targets are skipped, and there is one unimportant
7f8c9f0bae61 Updating TODO, README in light of 64-bit build success
imk
parents: 11
diff changeset
    43
target export target that cannot be built. This is the sbsv2guide
2
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    44
target, which merely exports documentation for Raptor. It cannot be fixed
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    45
because the documentation is not present in the upstream package at the branched
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    46
revision, bug #2607.)
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    47
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    48
These fixes *do not* suffice to make all the tools fit for purpose on both Linux
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    49
and Windows. That requires more work, which you are invited to undertake and
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    50
conrtibute to this package. See the TODO and NEWS files.   
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    51
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    52
== Strategy for building this package ==
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    53
========================================
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    54
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    55
The strategy for building this package on Linux was:
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    56
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    57
* Build Raptor, using the native GCC 4.4 toolchain and Standard Library.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    58
* Configure Raptor to use the native GCC toolchain and Standard Library, and
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    59
compile according to the C++0x language standard.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    60
* Build the remaining targets conventionally using Raptor.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    61
* Fix the compilation errors and warnings that appeared in this environment in a
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    62
way that is proved portable to the Windows build.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    63
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    64
The strategy for building the package on Windows was:
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    65
* Install PDT 1.6 to get Raptor, with the Mingw GCC 3.4 toolchain and Standard
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    66
Library
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    67
* Configure Raptor to use the Mingw Standard Library.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    68
* Build the targets, except Raptor itself, conventionally using Raptor.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    69
* Fix the compilation errors and warnings that appeared in this environment in a
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    70
way that is proved portable to the Linux build.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    71
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    72
The Windows and Linux fix/build cycles were alternated iteratively until both
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    73
were error free. The Windows build was performed solely as a portability check,
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    74
since all the tools in the package are provided for Windows in the PDT. The
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    75
Windows build did not include the building of Raptor itself, since nothing
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    76
needs fixed to build Raptor.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    77
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    78
For both Linux and Windows, the upstream Raptor configuration was amended to
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    79
make GCC invoke the Standard Library installed with the toolchain, and not the
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    80
retro STLPort implementation that is included in PDKs and which GCC is
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    81
configured to use by default. The code dependencies on this STLPort library are 
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    82
superficial and are fixed.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    83
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    84
If you contribute to this package, *please ensure your preverse portability
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    85
between Windows and Linux*
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    86
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    87
== Preparing to build this package on Linux ==
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    88
==============================================
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    89
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    90
* Install the host GCC toolchain, if not already present.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    91
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    92
* Install preqrequisities for building Raptor.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    93
  - bison
11
d610106f78c9 1) Update README and TODO
mikek
parents: 7
diff changeset
    94
  - libncurses & its headers
2
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    95
  - libbz2 & its headers
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    96
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    97
* Install the boost libraries and their headers. The upstream package bundles
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    98
a defective copy of the boost libraries v1.39 for building the imgtools/imglib
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
    99
target. The headers of this copy compile for Windows (with one small fix)
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   100
but are broken for Linux, so the Linux build is fixed to expect boost libraries
11
d610106f78c9 1) Update README and TODO
mikek
parents: 7
diff changeset
   101
from the system. v1.40 is OK. (v1.35 is too old)
2
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   102
  
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   103
* Install libxml2 and its headers. These are also bundled with the upstream
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   104
package for building the imgtools/imgcheck target, but there is no target that
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   105
exports them so they are not found by the imgcheck build.
16
7f8c9f0bae61 Updating TODO, README in light of 64-bit build success
imk
parents: 11
diff changeset
   106
7f8c9f0bae61 Updating TODO, README in light of 64-bit build success
imk
parents: 11
diff changeset
   107
* N.B. On a 64-bit host, you must install the 32-bit variants of the boost and libxml2
7f8c9f0bae61 Updating TODO, README in light of 64-bit build success
imk
parents: 11
diff changeset
   108
libraries. Raptor is built to the host's native wordsize, but all the targets
7f8c9f0bae61 Updating TODO, README in light of 64-bit build success
imk
parents: 11
diff changeset
   109
that are built with Raptor must be 32-bit for compatibility with epoc32 APIs.
2
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   110
    
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   111
* Clone, copy or extract this package into a directory that is going to be your
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   112
EPOCROOT for Raptor builds.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   113
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   114
* Browse to the Symbian Developer website, http://developer.symbian.org
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   115
* Navigate: Tools & Kits -> Download the Symbian^3 kits.
16
7f8c9f0bae61 Updating TODO, README in light of 64-bit build success
imk
parents: 11
diff changeset
   116
* This package is built using Symbian headers from PDK 3.0.i. If that is not the
2
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   117
current PDK listed under Downloads, then click "Previous releases" and navigate
16
7f8c9f0bae61 Updating TODO, README in light of 64-bit build success
imk
parents: 11
diff changeset
   118
to the download page for PDK 3.0.i.
7f8c9f0bae61 Updating TODO, README in light of 64-bit build success
imk
parents: 11
diff changeset
   119
* Download the following 3 zip archives from PDK 3.0.i and extract them into
2
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   120
your EPOCROOT directory:
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   121
  - binaries_epoc.zip, 
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   122
  - binaries_epoc_sdk.zip 
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   123
  - tools_epoc.zip
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   124
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   125
* Consult the README-LINUX file in the subdirectory cross-plat-dev-utils.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   126
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   127
== Preparing to build this package on Windows ==
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   128
================================================
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   129
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   130
* Browse to the Symbian Developer website, http://developer.symbian.org
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   131
* Navigate: Tools & Kits -> Download the PDT
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   132
* For Windows, this package is built using Raptor 2.12.1 in PDT 1.6 If 1.6 is
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   133
not the current PDT listed under Downloads, then click "Previous releases" and
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   134
navigate to the download page for PDT 1.6.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   135
* Download and install PDT 1.6
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   136
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   137
* Clone, copy or extract this package into a directory that is going to be your
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   138
EPOCROOT for Raptor builds.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   139
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   140
* Browse to the Symbian Developer website, http://developer.symbian.org
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   141
* Navigate: Tools & Kits -> Download the Symbian^3 kits.
16
7f8c9f0bae61 Updating TODO, README in light of 64-bit build success
imk
parents: 11
diff changeset
   142
* This package is built using Symbian headers from PDK 3.0.i. If that is not the
2
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   143
current PDK listed under Downloads, then click "Previous releases" and navigate
16
7f8c9f0bae61 Updating TODO, README in light of 64-bit build success
imk
parents: 11
diff changeset
   144
to the download page for PDK 3.0.i.
7f8c9f0bae61 Updating TODO, README in light of 64-bit build success
imk
parents: 11
diff changeset
   145
* Download the following 3 zip archives from PDK 3.0.i and extract them into
2
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   146
your EPOCROOT directory:
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   147
  - binaries_epoc.zip, 
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   148
  - binaries_epoc_sdk.zip 
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   149
  - tools_epoc.zip
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   150
* Consult the README-WINDOWS file in the subdirectory cross-plat-dev-utils.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   151
7
0232de5196ec Updating README and TODO files
mikek
parents: 4
diff changeset
   152
== Pushing changes to the package repo ==
0232de5196ec Updating README and TODO files
mikek
parents: 4
diff changeset
   153
=============================================
0232de5196ec Updating README and TODO files
mikek
parents: 4
diff changeset
   154
The Raptor build generates a very large volume of files that are not in the
0232de5196ec Updating README and TODO files
mikek
parents: 4
diff changeset
   155
package repo (http://developer.symbian.org/oss/MCL/sftools/dev/linux_build).
0232de5196ec Updating README and TODO files
mikek
parents: 4
diff changeset
   156
If you build Raptor, then you need to remove all of these files before
0232de5196ec Updating README and TODO files
mikek
parents: 4
diff changeset
   157
pushing any other changes to the package repo. Use the script
0232de5196ec Updating README and TODO files
mikek
parents: 4
diff changeset
   158
cross-plat-dev-utils/deepclean_raptor.pl to do this (clean_raptor.pl is not
0232de5196ec Updating README and TODO files
mikek
parents: 4
diff changeset
   159
sufficient). Then remember that you will need to rebuilt Raptor after you
0232de5196ec Updating README and TODO files
mikek
parents: 4
diff changeset
   160
have pushed. 
0232de5196ec Updating README and TODO files
mikek
parents: 4
diff changeset
   161
0232de5196ec Updating README and TODO files
mikek
parents: 4
diff changeset
   162
2
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   163
== Patch files for the upstream package ==
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   164
==========================================
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   165
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   166
In the directory cross-plat-dev-utils/patch-files/diffs you will find one or
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   167
more files with names like 'patch-dddddddddddd.patch', for digits 'd'.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   168
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   169
The patch file 'patch-dddddddddddd.patch' shows the diffs between the upstream
7
0232de5196ec Updating README and TODO files
mikek
parents: 4
diff changeset
   170
package (http://developer.symbian.org/oss/MCL/sftools/dev/build) at revision
2
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   171
dddddddddddd and this package as baselined on that upstream revision. Only
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   172
diffs relevant to changing the upstream package are included.
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   173
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   174
You can also apply this patch file to the upstream package at revision
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   175
dddddddddddd to make it the same as the revision of this package from which it
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   176
was diffed. You can use the utility cross-plat-dev-tools/patch_upstream.pl to
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   177
do this. 
39c28ec933dd Removing all prior files. Adding a complete branch of the 'build' package with fixes
mikek
parents:
diff changeset
   178