From ff234b65ea2415708581089ef2061e26ee1fa6da Mon Sep 17 00:00:00 2001 From: Xiang Chen <xionchen@foxmail.com> Date: Mon, 25 Jul 2016 10:15:42 +0800 Subject: [PATCH] Explain difference between two envvars Explain difference between 'DIB_OFFLINE' and 'DIB_DEBIAN_USE_DEBOOTSTRAP_CACHE' Those variables are not redundant,they hava different effective ranges. However,some people may be confused about this and reported a bug. So,this difference should be writen in the README file. Closes-Bug: #1506275 Change-Id: Ie5316de41d129bf98781708954f09ef0b2592b53 --- elements/debian-minimal/README.rst | 4 ++++ elements/debian/README.rst | 4 ++++ elements/debootstrap/README.rst | 4 +++- elements/ubuntu-minimal/README.rst | 4 ++++ 4 files changed, 15 insertions(+), 1 deletion(-) diff --git a/elements/debian-minimal/README.rst b/elements/debian-minimal/README.rst index 4e3ef26e0..04f1fbdeb 100644 --- a/elements/debian-minimal/README.rst +++ b/elements/debian-minimal/README.rst @@ -60,6 +60,10 @@ pass extra arguments to the debootstrap command used to create the base filesystem image. If --keyring is is used in `DIB_DEBOOTSTRAP_EXTRA_ARGS`, it will override `DIB_APT_KEYRING` if that is used as well. +For further information about `DIB_DEBIAN_DEBOOTSTRAP_SCRIPT` , +`DIB_DEBIAN_USE_DEBOOTSTRAP_CACHE` and `DIB_DEBOOTSTRAP_EXTRA_ARGS` +please consult "README.rst" of the debootstrap element. + ------------------- Note on ARM systems ------------------- diff --git a/elements/debian/README.rst b/elements/debian/README.rst index d079f3988..08090e438 100644 --- a/elements/debian/README.rst +++ b/elements/debian/README.rst @@ -28,6 +28,10 @@ pass extra arguments to the debootstrap command used to create the base filesystem image. If --keyring is is used in `DIB_DEBOOTSTRAP_EXTRA_ARGS`, it will override `DIB_APT_KEYRING` if that is used as well. +For further information about `DIB_DEBIAN_DEBOOTSTRAP_SCRIPT` , +`DIB_DEBIAN_USE_DEBOOTSTRAP_CACHE` and `DIB_DEBOOTSTRAP_EXTRA_ARGS` +please consult "README.rst" of the debootstrap element. + ------------------- Note on ARM systems ------------------- diff --git a/elements/debootstrap/README.rst b/elements/debootstrap/README.rst index 9e61306e1..108f52e1c 100644 --- a/elements/debootstrap/README.rst +++ b/elements/debootstrap/README.rst @@ -18,7 +18,9 @@ and Fedora. The `DIB_OFFLINE` or more specific `DIB_DEBIAN_USE_DEBOOTSTRAP_CACHE` variables can be set to prefer the use of a pre-cached root filesystem -tarball. +tarball. Setting `DIB_OFFLINE` may cause other element to use cached data, +while `DIB_DEBIAN_USE_DEBOOTSTRAP_CACHE` only functions in the debootstrap +element. The `DIB_DEBOOTSTRAP_EXTRA_ARGS` environment variable may be used to pass extra arguments to the debootstrap command used to create the diff --git a/elements/ubuntu-minimal/README.rst b/elements/ubuntu-minimal/README.rst index dd0bf6247..23764a45b 100644 --- a/elements/ubuntu-minimal/README.rst +++ b/elements/ubuntu-minimal/README.rst @@ -26,3 +26,7 @@ The `DIB_DEBOOTSTRAP_EXTRA_ARGS` environment variable may be used to pass extra arguments to the debootstrap command used to create the base filesystem image. If --keyring is is used in `DIB_DEBOOTSTRAP_EXTRA_ARGS`, it will override `DIB_APT_KEYRING` if that is used as well. + +For further information about `DIB_DEBIAN_DEBOOTSTRAP_SCRIPT`, +`DIB_DEBIAN_USE_DEBOOTSTRAP_CACHE` and `DIB_DEBOOTSTRAP_EXTRA_ARGS` +please consult "README.rst" of the debootstrap element.