README.tizen-distro

   1 About tizen-distro
   2 ==================
   3
   4 tizen-distro is a combination of several different components in a
   5 single repository:
   6 - bitbake
   7 - openembedded-core
   8 - meta-openembedded
   9 - meta-qt5
  10 - meta-tizen
  11
  12 The top-level directory comes from openembedded-core, everything else
  13 is in its own sub-directory. tizen-distro gets updated by copying
  14 importing patches from the component's repostories. Please submit
  15 patches against those instead of tizen-distro.
  16
  17 Updating tizen-distro
  18 =====================
  19
  20 Everyone with a copy of the tizen-distro repository can use
  21 scripts/combo-layer to import patches from the components. That works
  22 because the "last_revision" property which gets changed after each
  23 import gets committed to the combined repostory.
  24
  25 First, copy conf/combo-layer-local-sample.conf into
  26 conf/combo-layer-local.conf and set the paths for each component
  27 repository to a suitable location.
  28
  29 Then run:
  30 - "scripts/combo-layer init" (only once)
  31 - "scripts/combo-layer update <component>" where <component> is either one of
  32   components above (for updating just that one) or empty (for updating all)
  33
  34 Branching tizen-distro
  35 ======================
  36
  37 Each branch in tizen-distro tracks one branch in each component. To
  38 create a new branch:
  39 - checkout a new branch in tizen-component
  40 - change the "branch" properties in conf/combo-layer.conf
  41 - change the branch part in the last_revision sections
  42 - commit
  43 - continue as before
  44
  45 This works best if the last imported revision from each component is
  46 the branching point of that component. Ensure that by updating before
  47 the components branch. If it is too late, either select patches
  48 interactively or import too many patches and then drop unwanted ones
  49 via "git rebase" or "git reset --hard". Remember to keep
  50 "last_revision" correct when doing that.