From mboxrd@z Thu Jan 1 00:00:00 1970 From: Romain Naour Date: Sun, 15 Mar 2015 17:45:51 +0100 Subject: [Buildroot] [PATCH 6/7] docs/manual: update documentation about _SOURCE, _PATCH and _EXTRA_DOWNLOADS In-Reply-To: <1425147313-17380-7-git-send-email-thomas.petazzoni@free-electrons.com> References: <1425147313-17380-1-git-send-email-thomas.petazzoni@free-electrons.com> <1425147313-17380-7-git-send-email-thomas.petazzoni@free-electrons.com> Message-ID: <5505B73F.3050702@openwide.fr> List-Id: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit To: buildroot@busybox.net Hi Thomas, Le 28/02/2015 19:15, Thomas Petazzoni a ?crit : > This commit updates the Buildroot manual for the variables used to > indicate where to download the source code from: > > - It updates the description of _SOURCE to make it clear that > Buildroot assume that the tarball is hosted at _SITE. > > - It updates the description of _PATCH to indicate that not only > file names (assumed to be hosted at _SITE) can be used, but > also full URLs. This allows to match with what the current code is > doing. > > - It updates the description of _EXTRA_DOWNLOADS to also > indicate that full URLs are now accepted, following the change made > in the previous commit. > > Signed-off-by: Thomas Petazzoni > --- Reviewed-by: Romain Naour > docs/manual/adding-packages-generic.txt | 32 ++++++++++++++++++-------------- > 1 file changed, 18 insertions(+), 14 deletions(-) > > diff --git a/docs/manual/adding-packages-generic.txt b/docs/manual/adding-packages-generic.txt > index e3029ed..2e46d55 100644 > --- a/docs/manual/adding-packages-generic.txt > +++ b/docs/manual/adding-packages-generic.txt > @@ -204,18 +204,20 @@ information is (assuming the package name is +libfoo+) : > +LIBFOO_VERSION = cb9d6aa9429e838f0e54faa3d455bcbab5eef057+ + > +LIBFOO_VERSION = stable+ > > -* +LIBFOO_SOURCE+ may contain the name of the tarball of > - the package. If +HOST_LIBFOO_SOURCE+ is not specified, it > - defaults to +LIBFOO_SOURCE+. If none are specified, then > - the value is assumed to be > - +libfoo-$(LIBFOO_VERSION).tar.gz+. + > - Example: +LIBFOO_SOURCE = foobar-$(LIBFOO_VERSION).tar.bz2+ > +* +LIBFOO_SOURCE+ may contain the name of the tarball of the package, > + which Buildroot will use to download the tarball from > + +LIBFOO_SITE+. If +HOST_LIBFOO_SOURCE+ is not specified, it defaults > + to +LIBFOO_SOURCE+. If none are specified, then the value is assumed > + to be +libfoo-$(LIBFOO_VERSION).tar.gz+. + Example: +LIBFOO_SOURCE = > + foobar-$(LIBFOO_VERSION).tar.bz2+ > > * +LIBFOO_PATCH+ may contain a space-separated list of patch file > - names, that will be downloaded from the same location as the tarball > - indicated in +LIBFOO_SOURCE+, and then applied to the package source > - code. If +HOST_LIBFOO_PATCH+ is not specified, it defaults to > - +LIBFOO_PATCH+. Note that patches that are included in Buildroot > + names, that Buildroot will download and apply to the package source > + code. If an entry contains +://+, then Buildroot will assume it is a > + full URL and download the patch from this location. Otherwise, > + Buildroot will assume that the patch should be downloaded from > + +LIBFOO_SITE+. If +HOST_LIBFOO_PATCH+ is not specified, it defaults > + to +LIBFOO_PATCH+. Note that patches that are included in Buildroot > itself use a different mechanism: all files of the form > +-*.patch+ present in the package directory inside > Buildroot will be applied to the package after extraction (see > @@ -246,10 +248,12 @@ information is (assuming the package name is +libfoo+) : > +LIBFOO_SITE=/opt/software/libfoo.tar.gz+ + > +LIBFOO_SITE=$(TOPDIR)/../src/libfoo/+ > > -* +LIBFOO_EXTRA_DOWNLOADS+ lists a number of additional files that > - Buildroot should download from +LIBFOO_SITE+ in addition to the main > - +LIBFOO_SOURCE+ (which usually is a tarball). Buildroot will not do > - anything with those additional files, except download files: it will > +* +LIBFOO_EXTRA_DOWNLOADS+ is a space-separated list of additional > + files that Buildroot should download. If an entry contains +://+ > + then Buildroot will assume it is a complete URL and will download > + the file using this URL. Otherwise, Buildroot will assume the file > + to be downloaded is located at +LIBFOO_SITE+. Buildroot will not do > + anything with those additional files, except download them: it will > be up to the package recipe to use them from +$(BR2_DL_DIR)+. > > * +LIBFOO_SITE_METHOD+ determines the method used to fetch or copy the >