From mboxrd@z Thu Jan 1 00:00:00 1970 From: Yann E. MORIN Date: Sun, 29 Mar 2015 23:10:43 +0200 Subject: [Buildroot] [PATCH 06/35] docs/manual: update documentation about _SOURCE, _PATCH and _EXTRA_DOWNLOADS In-Reply-To: <1427650429-9293-7-git-send-email-thomas.petazzoni@free-electrons.com> References: <1427650429-9293-1-git-send-email-thomas.petazzoni@free-electrons.com> <1427650429-9293-7-git-send-email-thomas.petazzoni@free-electrons.com> Message-ID: <20150329211043.GG4093@free.fr> List-Id: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit To: buildroot@busybox.net Thomas, All, On 2015-03-29 19:33 +0200, Thomas Petazzoni spake thusly: > 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 Reviewed-by: "Yann E. MORIN" Regards, Yann E. MORIN. > --- > docs/manual/adding-packages-generic.txt | 30 +++++++++++++++++------------- > 1 file changed, 17 insertions(+), 13 deletions(-) > > diff --git a/docs/manual/adding-packages-generic.txt b/docs/manual/adding-packages-generic.txt > index 6150bf7..85c9ccd 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+. + > +* +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 > -- > 2.1.0 > > _______________________________________________ > buildroot mailing list > buildroot at busybox.net > http://lists.busybox.net/mailman/listinfo/buildroot -- .-----------------.--------------------.------------------.--------------------. | Yann E. MORIN | Real-Time Embedded | /"\ ASCII RIBBON | Erics' conspiracy: | | +33 662 376 056 | Software Designer | \ / CAMPAIGN | ___ | | +33 223 225 172 `------------.-------: X AGAINST | \e/ There is no | | http://ymorin.is-a-geek.org/ | _/*\_ | / \ HTML MAIL | v conspiracy. | '------------------------------^-------^------------------^--------------------'