At the moment repo doesn't support tagged manifests, so we had to
create a branch in the manifest repository to be able to make 1.5
available with repo -b.
Here's the current situation:
-in each "code" repository:
*release-1.0 is the branch for 1.0 as it was originally released. It
should be considered read-only (i.e. we don't normally accept
submissions into it).
*cdma-import is the branch that was used by Teleca (a member of OHA)
to work on CDMA support in Android. read-only.
*cupcake is the branch that follows the cupcake source tree that
exists inside Google. it's read-only.
*donut is the branch for the first named project after cupcake.It's
still in the process of being set up. At the moment it's still
identical to cupcake. We might accept limited contributions into it at
some point in the future (as we transition away from the model that we
used for cupcake).
*master is the branch for all projects after donut. We accept
contributions into it.
*android-1.0 tags the original 1.0 code drop.
*android-sdk-1.5-pre tags the 1.5 preview SDK. It's the open-source
part of the exact source that was used to build the SDK, so it can be
used e.g. to match stack traces.
*android-1.5 tags the official 1.5 release of the Android Open-Source
Project. It's the one that should be used by people porting Android
1.5 to devices.
-within the "manifest" repository:
*there are the same branches as in the "code" repositories, which
point to the matching branches in all the code repositories.
*there are branches for android-1.5 and android-sdk-1.5-pre, which
point to the matching tags in all the code repositories (those have to
be branches as an artifact of the way repo currently works).
*there are the same tags as in the "code" repositories.
In summary, for practical purposes:
-globally:
*use repo init -b {release-1.0,cupcake,donut,master} to track the
state of those projects (though obviously release-1.0 and cupcake
aren't going to see much more action at this point).
*use repo init -b {android-sdk-1.5-pre,android-1.5} to get the frozen
state of those releases.
-locally in a "code" repository:
*the korg/{release-1.0,cupcake,donut,master} remotes branches point to
the matching upstream branches.
*the {android-sdk-1.5-pre,android-1.5} tags point to those specific releases.
I hope that makes sense.
JBQ
--
Jean-Baptiste M. "JBQ" Queru
Android Engineer, Google.
Questions sent directly to me that have no reason for being private
will likely get ignored or forwarded to a public forum with no further
warning.