From 4ebf59c5790bbe03b59899aa777e7cd90ac68b72 Mon Sep 17 00:00:00 2001 From: Herb Kuta Date: Fri, 31 May 2019 09:33:35 -0700 Subject: [PATCH] DRAFT weboslayers.py: Clarify the semantics of the "submission" item Also tweak various other portions of the commentary. --- files/weboslayers.py | 41 ++++++++++++++++++++--------------------- 1 file changed, 20 insertions(+), 21 deletions(-) diff --git a/files/weboslayers.py b/files/weboslayers.py index 62d6876..540c7c6 100644 --- a/files/weboslayers.py +++ b/files/weboslayers.py @@ -1,4 +1,4 @@ -# Copyright (c) 2008-2018 LG Electronics, Inc. +# Copyright (c) 2008-2019 LG Electronics, Inc. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. @@ -12,11 +12,9 @@ # See the License for the specific language governing permissions and # limitations under the License. # -# This implementation introduces next generation build environment for -# Open webOS. The change introduces a mechanism to add additional layers to the -# base ones: oe-core, meta-oe, and meta-webos, and to specify the commits to be -# used for each. mcf now expects the layers to be defined in this file -# (weboslayers.py in the same directory as mcf) as a list of Python data tuples: +# Configuration file for the webOS build configuration tool "mcf". The file +# specifies the name of the distribution, the supported MACHINE-s, and the +# layers used in the build. The layers are specified via: # # webos_layers = [ # ('layer-name', priority, 'URL', 'submission', 'working-dir'), @@ -31,32 +29,33 @@ # priority = Integer layer priority as defined by OpenEmbedded. It also # specifies the order in which layers are searched for files. # Larger values have higher priority. A value of -1 indicates -# that the entry is not a layer; for example, bitbake. +# that the entry is not for a metadata layer; for example, +# bitbake. # -# URL = The Git repository address for the layer from which to clone. -# A value of '' skips the cloning. +# URL = Git repository address of the layer from which to clone. A value +# of '' skips the cloning. # -# submission = The information used by Git to checkout and identify the precise -# content. Submission values could be "branch=" and -# "commit=" or "tag=". Omitted branch information means -# only that "master" will be used as the name of the local -# branch. Omitted commit or tag means origin/HEAD will be checked -# out (which might NOT be origin/master, although -# it usually is). +# submission = Information used by Git to fetch the layer and to name the local +# branch. This item has the form: +# [branch=][,][commit=|tag=] +# The default for is the branch pointed to by +# "origin/HEAD", which is usually "master". If neither "commit" +# nor "tag" are present, the current head of +# is fetched. Note that the commit fetched does not have to lie +# along . If the value of the item is '', no +# fetch is done for the layer. # # working-dir = Alternative directory for the layer. # -# The name of the distribution is also defined in this file -# along with a list of the valid MACHINE-s -# +# Value for DISTRO Distribution = "webos" # Supported MACHINE-s Machines = ['raspberrypi3','qemux86'] -# github.com/openembedded repositories are read-only mirrors of the authoritative -# repositories on git.openembedded.org +# Note that the github.com/openembedded repositories are read-only mirrors of +# the authoritative repositories on git.openembedded.org . webos_layers = [ ('bitbake', -1, 'git://github.com/openembedded/bitbake.git', 'branch=1.32,commit=0193e1f', ''),