summaryrefslogtreecommitdiffstats
path: root/docs
Commit message (Collapse)AuthorAgeFilesLines
* support/download: alternative access methods to CVSJoao Mano2016-01-201-1/+6
| | | | | | | | | | | | | Allows user to specify other access methods than :pserver:anonymous@ on CVS repositories. This shall be defined in the <pkg>_SITE variable. [Thomas: - as suggested by Yann, quote the variable expansion - as suggested by Yann, use a regexp match - tweak commit log] Signed-off-by: Joao Mano <joao@datacom.ind.br> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* docs/manual: add ordering of kconfig options' attributesYann E. MORIN2016-01-191-0/+9
| | | | | | | | | | | | | | | We want to ensure all packages follow the same coding style, so we add a blurb about the order of kconfig options' attributes: - first, the type and the prompt - the default value if needed - then dependencies of the 'depends on' category - followed by dependencies of the 'select' form - with eventually the help text Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Acked-by: Arnout Vandecappelle (Essensium/Mind) <arnout@mind.be> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* docs/manual: slightly compactify a paragraphYann E. MORIN2016-01-191-6/+5
| | | | | | Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Acked-by: Arnout Vandecappelle (Essensium/Mind) <arnout@mind.be> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* docs/website: fixing mixing content errorAngelo Compagnucci2016-01-131-1/+1
| | | | | | | | | Firefox recently activated mixing content mode protection (http elements in an https page). This patch changes the external slides service to https. Signed-off-by: Angelo Compagnucci <angelo.compagnucci@gmail.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* Config.in: add symbols for BR2_HOST_GCC_AT_LEAST_X_YArnout Vandecappelle2015-12-311-0/+7
| | | | | | | | | | | | | | Some host packages need a recent gcc version. Add symbols to Config.in to specify the HOSTCC version. The values are passed through the environment, and this environment is generated in a new support script. Also update the documentation to mention the new symbols. [Thomas: simplify by using only make logic instead of an external shell script.] Signed-off-by: Arnout Vandecappelle (Essensium/Mind) <arnout@mind.be> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* docs/website: fixing pre block indentationAngelo Compagnucci2015-12-291-3/+3
| | | | | | | | Pre block should not be indented, this patch fixes wrong indentation. Signed-off-by: Angelo Compagnucci <angelo.compagnucci@gmail.com> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* docs/manual: document the new kconfig-package variableYann E. MORIN2015-12-221-0/+10
| | | | | | | | | | | | | | The previous patch introduced the new FOO_KCONFIG_DEFCONFIG variable to specify a defconfig rule rather than a (def)config file. Add this to the manual. Also document the pre-existing FOO_KCONFIG_FILE for which the explanations were missing altogether. Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Cc: Sam Bobroff <sam.bobroff@au1.ibm.com> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* manual: clarify policy when updating a package patchArnout Vandecappelle2015-12-161-0/+4
| | | | | | Signed-off-by: Arnout Vandecappelle (Essensium/Mind) <arnout@mind.be> Cc: Renaud AUBIN <root@renaud.io> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* docs: website: update for 2015.11.1Peter Korsgaard2015-12-052-9/+28
| | | | Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* docs/website/news.html: add 2015.11 announcement linkPeter Korsgaard2015-12-011-1/+2
| | | | Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* Update for 2015.112015.11Peter Korsgaard2015-11-302-10/+29
| | | | Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* docs/website: fix invalid links to the mailing list pageThomas Petazzoni2015-11-281-7/+7
| | | | | | | As noticed by Peter Korsgaard, all the links to links.html are broken, they should point to support.html instead. Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* docs/website: fix invalid linkThomas Petazzoni2015-11-281-1/+1
| | | | Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* docs: images: re-add github imagePeter Korsgaard2015-11-261-0/+0
| | | | | | | This got removed with the addition of the new website, but it is used by the manual so it no longer builds. Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* Update for 2015.11-rc3Peter Korsgaard2015-11-262-9/+32
| | | | Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* news.html: fix typo in 2015.05-rc3 linkPeter Korsgaard2015-11-261-1/+1
| | | | Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* docs/website: New websiteAngelo Compagnucci2015-11-2343-3164/+4012
| | | | | | | | | | | | | | This patch introduces a new buildroot website based on a modern flat layout inspired by material design. Each page of the old website is converted to the new css/layout, the big bump is in main page which is completely rewritten. Content of the old website is copied more or less verbatim, planning to add more content in the future. Signed-off-by: Angelo Compagnucci <angelo.compagnucci@gmail.com> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* Update for 2015.11-rc2Peter Korsgaard2015-11-192-5/+18
| | | | Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* docs/manual: fix bash export syntax in example codeLuca Ceresoli2015-11-111-1/+1
| | | | | | | | To export a variable in .bashrc we shouldn't put a '$' at the beginning of the line, and there must be a '=' between key and value. Signed-off-by: Luca Ceresoli <luca@lucaceresoli.net> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* website/news: update with release date and announcement e-mail linkThomas Petazzoni2015-11-081-2/+4
| | | | Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* Update for 2015.11-rc1Thomas Petazzoni2015-11-072-7/+20
| | | | Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* docs/manual: fix typo in $(FOO_PKGDIR) documentationArnout Vandecappelle2015-11-051-1/+1
| | | | | Signed-off-by: Arnout Vandecappelle (Essensium/Mind) <arnout@mind.be> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* docs/manual: document $(FOO_PKGDIR)Yann E. MORIN2015-11-051-0/+5
| | | | | | | | | | | | In the manual, add a note that packages can use $(FOO_PKGDIR) to get the path to the directory containg the .mk and Config.in files, if they need it to e.g. copy files from there, like startup scripts, systemd units or any other resource. Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Cc: Samuel Martin <s.martin49@gmail.com> Cc: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* docs/manual: do not override BR2_EXTERNALYann E. MORIN2015-11-031-3/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Currently, we forcibly override BR2_EXTERNAL when building the manual, so as to avoid referring to packages therein from the manual. However, when generating the lists of packages, we limit ourselves to scanning for packages in (Buildroot's) TOPDIR and never search in BR2_EXTERNAL. So, we do not really need to override BR2_EXTERNAL when generating the manual to achieve the same result. Furthermore, we're only looking for packages that are defined in the sub-menu "Target packages", and never anywhere else, and especially not in the sub-menu "User-provided options". Finally, we're soon to completely eliminate use of BR2_EXTERNAL in Kconfig altogether, so that would no longer have any impact anyway. So, just leave BR2_EXTERNAL alone when generating the manual. Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Cc: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Cc: Peter Korsgaard <jacmet@uclibc.org> Cc: Thomas De Schampheleire <patrickdepinguin@gmail.com> Cc: Arnout Vandecappelle <arnout@mind.be> Cc: Samuel Martin <s.martin49@gmail.com> Acked-by: Arnout Vandecappelle (Essensium/Mind) <arnout@mind.be> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* core/pkg-generic: allow packages to exclude files when extractingYann E. MORIN2015-11-031-0/+4
| | | | | | | | | | | | | | | | | Currently, packages that need to exclude parts of the archives when extracting (e.g. to gain space), like gcc or toolchain-external, have to provide custom extract commands, just for the sake of adding a bunch of --exclude directives when calling tar. Add a new variable that packages may set, to provide a space-separated list of patterns to exclude. Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Cc: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Cc: Vicente Olivert Riera <Vincent.Riera@imgtec.com> Reviewed-by: Romain Naour <romain.naour@openwide.fr> Reviewed-by: Vicente Olivert Riera <Vincent.Riera@imgtec.com> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* Revert "manual: Add notes about GitHub and hashes"Samuel Martin2015-10-181-10/+2
| | | | | | | | | | | | | | | | This note is no longer needed, so remove it. Tarballs generated by GitHub are always the same, so hashes can be checked. This reverts commit 9474cc2594c8643301164500ce6eb62546da2b8f. [Thomas: fix other remaining references to not using hashes for github, as noticed by Maxime Hadjinlian.] Cc: Maxime Hadjinlian <maxime.hadjinlian@gmail.com> Signed-off-by: Samuel Martin <s.martin49@gmail.com> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* ccache: allow for BR2_CCACHE_DIR environment overrideGustavo Zacarias2015-10-171-0/+3
| | | | | | | | | | | | | Allow the BR2_CCACHE_DIR .config option to be overriden by the BR2_CCACHE_DIR env variable. This is useful for big projects where in some cases the developers home directory might be a NFS mount (slow) and real production builds aren't. Update documentation accordingly as well. Signed-off-by: Gustavo Zacarias <gustavo.zacarias@free-electrons.com> Acked-by: Arnout Vandecappelle (Essensium/Mind) <arnout@mind.be> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* docs/manual: add section about size graphingThomas Petazzoni2015-10-171-0/+41
| | | | | | | | Document the new graph-size target and its possibilities. Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Reviewed-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* ccache: support changing the output directoryArnout Vandecappelle2015-10-041-0/+20
| | | | | | | | | | | | | | | | | | | | When building in a different output directory than the original build, there will currently be a lot of ccache misses because in many cases there is some -I/... absolute path in the compilation. Ccache has an option CCACHE_BASEDIR to substitute absolute paths with relative paths, so they wil be the same in the hash (and in the output). Since there are some disadvantages to this path rewriting, it is made optional as BR2_CCACHE_USE_BASEDIR. It defaults to y because the usefulness of ccache is severely reduced without this option. In addition to CCACHE_BASEDIR, we also substitute away the occurences of $(HOST_DIR) in the calculation of the compiler hash. This is done regardless of the setting of BR2_CCACHE_USE_BASEDIR because it's quite harmless. Signed-off-by: Arnout Vandecappelle (Essensium/Mind) <arnout@mind.be> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* docs/manual: document new actual source package variablesLuca Ceresoli2015-10-041-0/+19
| | | | | | | Signed-off-by: Luca Ceresoli <luca@lucaceresoli.net> Cc: Thomas De Schampheleire <patrickdepinguin@gmail.com> Cc: Arnout Vandecappelle <arnout@mind.be> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* system: clarify /dev management using devtmpfs + {mdev, eudev}Luca Ceresoli2015-10-041-27/+30
| | | | | | | | | | | | | | | | | The "Dynamic using mdev" and "Dynamic using eudev" /dev management methods are using devtmpfs, just like "Dynamic using devtmpfs only", on top of which they add either mdev or eudev. But their names might suggest they use mdev only or eudev only. Clarify their descriptions by adding "devtmpfs +" to make it unambiguous. [Thomas: rewrap the paragraphs in the manual. It makes the diff a lot less readable, but we actually want the result to be wrapped.] Signed-off-by: Luca Ceresoli <luca@lucaceresoli.net> Reviewed-by: Arnout Vandecappelle (Essensium/Mind) <arnout@mind.be> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* docs/manual: FOO_SITE must not have a trailing slashLuca Ceresoli2015-10-021-2/+4
| | | | | | | | | This has been the best practice since a long time, but it was not clearly stated in the manual. Now it is mandatory, so mention it explicitly. Signed-off-by: Luca Ceresoli <luca@lucaceresoli.net> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* docs/manual: add useful tips on patch versioning and patch submissionFrancesco Nwokeka2015-09-191-0/+14
| | | | | | | | | | | Added an alternative on patch versioning (the -v option) and added a tip on how to automatically mark a previous commit as superseded. [Thomas: minor tweaks.] Signed-off-by: Francesco Nwokeka <francesco.nwokeka@gmail.com> Acked-by: Arnout Vandecappelle (Essensium/Mind) <arnout@mind.be> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* docs: use lists.buildroot.org to refer to the mailman archivesPeter Korsgaard2015-09-144-50/+50
| | | | | | | Now that mailman handles lists.buildroot.org lets use that everywhere in the documentation as well. Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* docs/manual: use bugs.buildroot.org for bugtrackerPeter Korsgaard2015-09-142-2/+2
| | | | | | | Now that we have a bugs.buildroot.org CNAME for bugzilla lets use that in the manual as well. Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* docs/website: add a space between attributesVicente Olivert Riera2015-09-071-1/+1
| | | | | | | | | | | Error highlighted by the W3 HTML validator: Error: No space between attributes. At line 71, column 64 e="width:100%;"href="/download Signed-off-by: Vicente Olivert Riera <Vincent.Riera@imgtec.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* docs/manual: add the "mark as superseded" hintVicente Olivert Riera2015-09-071-0/+8
| | | | | | Signed-off-by: Vicente Olivert Riera <Vincent.Riera@imgtec.com> Acked-by: Arnout Vandecappelle (Essensium/Mind) <arnout@mind.be> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* docs: website: update for 2015.08.1Peter Korsgaard2015-09-062-5/+15
| | | | Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* docs/website/news.html: add 2015.08 announcement linkPeter Korsgaard2015-09-011-1/+2
| | | | Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* Update for 2015.08Peter Korsgaard2015-08-312-7/+16
| | | | Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* docs/website: remove broken symlink for top-level manualYann E. MORIN2015-08-291-1/+0
| | | | | | | | | | | | | | | Recently, we've tried to have the manual lie at the top-level of the site, to get a shorter URL. However, that is broken: we do not need only a link the the HTML, but also to the CSS and to any resource linked from the html (images...). The server configuration has now been updated to add a redirect, so we no longer need that symlink anyway. Remove it. Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Cc: Peter Korsgaard <jacmet@uclibc.org> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* docs/manual: makedevs only accepts numerical valuesYann E. MORIN2015-08-291-4/+7
| | | | | | | | | | | | | | | | | | | | | | | | | Because of a limitation in how makedevs resolves names [0], usernames and groupnames would be resolved with UIDs and GIDs from the host, not the target. Fixing makedevs would involve us rewriting a /etc/passwd and /etc/group parser (not too complex, still not trivial). Document that the user and group fields should only be numbers, not names. Also, the manual is currently misleading, as an example indeed uses names for the user and group fields. Fix that and expand the explanations. The mode field should also be numbers, not a rwx combo. Slight typographical eye-candy about major/minor fields. [0] it uses getpwnma(3) and getgrnam(3) to resolve names to IDs, and those only resolve names on the host (i.e. there is no way to specify a chroot-like feature) Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* docs/website: fix manual symlinkYann E. MORIN2015-08-261-1/+1
| | | | | | | It should point to the filesystem path on the server, not the HTTP virtual path. Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* website: make a symlink for the manual at the root of the websiteYann E. MORIN2015-08-263-2/+3
| | | | | | | | | | | | This will give us a shorter URL, that we can more easily refer to in the documetation itself, in help texts, on IRC... [Peter: Use buildroot.org everywhere] Suggested-by: Arnout Vandecappelle <arnout@mind.be> Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Cc: Arnout Vandecappelle <arnout@mind.be> Cc: Peter Korsgaard <jacmet@uclibc.org> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* Add link to 2015.08-rc2 announcement e-mailThomas Petazzoni2015-08-241-1/+3
| | | | Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* Update for 2015.08-rc2Thomas Petazzoni2015-08-242-5/+18
| | | | Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* docs/website: add announcement e-mail link for 2015.08-rc1Thomas Petazzoni2015-08-051-3/+4
| | | | Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* Update for 2015.08-rc1Thomas Petazzoni2015-08-052-7/+18
| | | | Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* docs/manual: document gcc version dependenciesThomas Petazzoni2015-08-051-0/+6
| | | | | | | | | This commit updates the Buildroot manual to document how to detail the gcc version dependencies in Config.in comments of packages, like we do for kernel headers version. Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Reviewed-by: "Yann E. MORIN" <yann.morin.1998@free.fr>
* docs/manual: Modify GitHub FOO_SITE explanationMaxime Hadjinlian2015-07-282-8/+10
| | | | | | | | | | | GitHub has changed its layout, there is no longer any green nor grey button, it's a link with a tiny icon that indicates if it's uploaded by the maintainer or not. In order to not confuse anyone, adding an image should make it clear. Signed-off-by: Maxime Hadjinlian <maxime.hadjinlian@gmail.com> Reviewed-by: Lionel Orry <lionel.orry@gmail.com> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
OpenPOWER on IntegriCloud