diff options
author | Lennart Johansson <lennart.johansson@enea.com> | 2017-03-28 13:42:06 +0200 |
---|---|---|
committer | Lennart Johansson <lennart.johansson@enea.com> | 2017-03-28 13:42:06 +0200 |
commit | 9b5b099ac72c125a8dc75c6f02346f2a1c6a5d38 (patch) | |
tree | ebfaca93f8e60febb3cecf7fe83e1167d4200d39 /doc/book-enea-linux-release-info/doc/getting_enea_linux.xml | |
parent | 6aff72624ec1c001e065f270f1140049db05fbb9 (diff) | |
download | el_releases-standard-9b5b099ac72c125a8dc75c6f02346f2a1c6a5d38.tar.gz |
Use new eltf_params_updates.xml for later ELTF autoupdate
LXCR-7377 Change to allow ELTF to autoupdate all parameters
in the release info and the open-source books.
All parameters, including also multiline commands
and complete tables of all target machine parameters
are stored in one file eltf_params_updates.xml
Prepared for auto-updating by ELTF by using a template
elft_params_template.xml with ELTF_* variables
from which a new eltf_params_updates.xml can be created
and pushed (if changed)
This includes the -b option to the repo command, which is
the branch or tag of the MANIFEST. This is what the user
uses to get the source. In a final distribution this tag
shall be same as the tag given in manifest_conf.mk
Left is manifest_conf.mk but MANIFESTHASH can
be overridden by an env.variable when building.
MANIFESTHASH still defines which MANIFEST to clone
when building the doc to get a list of valid MACHINE names
and to get the valid build/boot commands from the MANIFEST.
Left is also pardoc-distro.xml with three version variables
used by gen_known_issues.py and gen_pkgdiff.py
Signed-off-by: Lennart Johansson <lennart.johansson@enea.com>
Diffstat (limited to 'doc/book-enea-linux-release-info/doc/getting_enea_linux.xml')
-rw-r--r-- | doc/book-enea-linux-release-info/doc/getting_enea_linux.xml | 46 |
1 files changed, 21 insertions, 25 deletions
diff --git a/doc/book-enea-linux-release-info/doc/getting_enea_linux.xml b/doc/book-enea-linux-release-info/doc/getting_enea_linux.xml index 93a5c59..055be15 100644 --- a/doc/book-enea-linux-release-info/doc/getting_enea_linux.xml +++ b/doc/book-enea-linux-release-info/doc/getting_enea_linux.xml | |||
@@ -33,38 +33,34 @@ | |||
33 | <orderedlist> | 33 | <orderedlist> |
34 | <listitem> | 34 | <listitem> |
35 | <para>Make sure that the repo tool is installed. If not, follow the | 35 | <para>Make sure that the repo tool is installed. If not, follow the |
36 | instructions below:</para> | 36 | instructions below. The instruction assumes a suitable place in your |
37 | PATH to use. You might change that.<remark>INFO: Below is include of | ||
38 | ID "eltf-getting-repo-install-command" from | ||
39 | eltf_params_updated.xml</remark></para> | ||
37 | 40 | ||
38 | <para><programlisting>$ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo | 41 | <xi:include href="eltf_params_updated.xml" |
39 | $ chmod a+x ~/bin/repo</programlisting>The instruction assumes that ~/bin | 42 | xmlns:xi="http://www.w3.org/2001/XInclude" |
40 | exists and is included in the PATH variable.</para> | 43 | xpointer="element(eltf-getting-repo-install-command/1)" /> |
41 | </listitem> | 44 | </listitem> |
42 | 45 | ||
43 | <listitem> | 46 | <listitem> |
44 | <para>Use the repo tool to download the source:<remark>FIXME: At final | 47 | <para>Use the repo tool to download the source: Please define MACHINE |
45 | release the tag for the manifest must be set in mainfest_conf.mk as | 48 | to your target, uncomment and use one of the MACHINE lines listed |
46 | MANIFESTHASH, typically something like refs/tags/EL6. Before final | 49 | here,<remark>Below is the "machine_list" programlisting in |
47 | release, it is possible to set MANIFESTHASH on the make command line | 50 | machine_list_generated.xml created by the make system by extracting |
48 | to override the value, e.g. with a commit hash string for a release | 51 | from the manifest</remark></para> |
49 | candidate to be tested</remark></para> | ||
50 | 52 | ||
51 | <programlisting>$ mkdir enea-linux | 53 | <xi:include href="machine_list_generated.xml" |
52 | $ cd enea-linux | 54 | xmlns:xi="http://www.w3.org/2001/XInclude" |
53 | $ repo init -u <xi:include href="../../s_docsrc_common/pardoc-distro.xml" | 55 | xpointer="element(machine-list/1)" /> |
54 | xmlns:xi="http://www.w3.org/2001/XInclude" | ||
55 | xpointer="element(EneaLinux_MANIFESTURL/1)" /> \ | ||
56 | -b <xi:include href="../../s_docsrc_common/pardoc-distro.xml" | ||
57 | xmlns:xi="http://www.w3.org/2001/XInclude" | ||
58 | xpointer="element(EneaLinux_MANIFESTHASH/1)" /> \ | ||
59 | -m <manifest file> | ||
60 | $ repo sync</programlisting> | ||
61 | 56 | ||
62 | <para>The parameter <manifest file> depends on the target. Use | 57 | <para>and use the repo command below:<remark> Below is include of ID |
63 | the following:</para> | 58 | "eltf-repo-cloning-enea-linux" from eltf_params_updated.xml. Here the |
59 | $MACHINE shall be given!</remark></para> | ||
64 | 60 | ||
65 | <xi:include element="manifestfiles/1" | 61 | <xi:include href="eltf_params_updated.xml" |
66 | href="manifestfiles_generated.xml" | 62 | xmlns:xi="http://www.w3.org/2001/XInclude" |
67 | xmlns:xi="http://www.w3.org/2001/XInclude" /> | 63 | xpointer="element(eltf-repo-cloning-enea-linux/1)" /> |
68 | </listitem> | 64 | </listitem> |
69 | </orderedlist> | 65 | </orderedlist> |
70 | 66 | ||