2012-11-11 04:14:52 +01:00
|
|
|
// -*- mode:doc; -*-
|
2013-02-13 13:59:02 +01:00
|
|
|
// vim: set syntax=asciidoc:
|
2012-11-11 04:14:52 +01:00
|
|
|
|
2014-08-12 22:20:08 +02:00
|
|
|
== Community resources
|
2012-11-11 04:14:52 +01:00
|
|
|
|
|
|
|
Like any open source project, Buildroot has different ways to share
|
|
|
|
information in its community and outside.
|
|
|
|
|
|
|
|
One piece of it is the document you are currently reading ;-).
|
|
|
|
|
|
|
|
Each of those ways may interest you if you are looking for some help,
|
|
|
|
want to understand Buildroot or contribute to the project.
|
|
|
|
|
manual: high-level restructuring
The structure of the buildroot manual is not always clear. There is a large
number of chapters, and some chapters seem to overlap. The distinction
between general usage and developer information is not always clear.
This patch restructures the manual into four large parts:
- getting started
- user guide
- developer guide
- appendix
Except for the names of these parts, the section names are not yet changed.
Content-wise there are no changes yet either. This will be handled in
subsequent patches.
In order to achieve the introduction of a new level 'parts' above
'chapters', the section indicators (=, ==, ===, ...) of several sections
have to be moved one level down. Additionally, the leveloffset indication to
asciidoc has to be removed. Finally, to maintain more or less the same level
of detail in the table of contents, the toc.section.depth attribute is
reduced as well. Note that for some sections, less detail is visible now.
Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
2014-08-12 22:20:06 +02:00
|
|
|
=== Mailing List
|
2012-11-11 04:14:52 +01:00
|
|
|
|
|
|
|
Buildroot has a mailing list
|
|
|
|
http://lists.busybox.net/pipermail/buildroot[] for discussion and
|
|
|
|
development.
|
|
|
|
|
|
|
|
[[mailing-list-subscribe]]
|
|
|
|
|
manual: high-level restructuring
The structure of the buildroot manual is not always clear. There is a large
number of chapters, and some chapters seem to overlap. The distinction
between general usage and developer information is not always clear.
This patch restructures the manual into four large parts:
- getting started
- user guide
- developer guide
- appendix
Except for the names of these parts, the section names are not yet changed.
Content-wise there are no changes yet either. This will be handled in
subsequent patches.
In order to achieve the introduction of a new level 'parts' above
'chapters', the section indicators (=, ==, ===, ...) of several sections
have to be moved one level down. Additionally, the leveloffset indication to
asciidoc has to be removed. Finally, to maintain more or less the same level
of detail in the table of contents, the toc.section.depth attribute is
reduced as well. Note that for some sections, less detail is visible now.
Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
2014-08-12 22:20:06 +02:00
|
|
|
==== Subscribing to the mailing list
|
2012-11-11 04:14:52 +01:00
|
|
|
|
|
|
|
You can subscribe by visiting
|
|
|
|
http://lists.busybox.net/mailman/listinfo/buildroot[].
|
|
|
|
Only subscribers to the Buildroot mailing list are allowed to post to
|
|
|
|
this list.
|
|
|
|
|
|
|
|
The list is also available through _Gmane_ http://gmane.org[], at
|
|
|
|
+gmane.comp.lib.uclibc.buildroot+
|
|
|
|
http://dir.gmane.org/gmane.comp.lib.uclibc.buildroot[].
|
|
|
|
|
manual: high-level restructuring
The structure of the buildroot manual is not always clear. There is a large
number of chapters, and some chapters seem to overlap. The distinction
between general usage and developer information is not always clear.
This patch restructures the manual into four large parts:
- getting started
- user guide
- developer guide
- appendix
Except for the names of these parts, the section names are not yet changed.
Content-wise there are no changes yet either. This will be handled in
subsequent patches.
In order to achieve the introduction of a new level 'parts' above
'chapters', the section indicators (=, ==, ===, ...) of several sections
have to be moved one level down. Additionally, the leveloffset indication to
asciidoc has to be removed. Finally, to maintain more or less the same level
of detail in the table of contents, the toc.section.depth attribute is
reduced as well. Note that for some sections, less detail is visible now.
Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
2014-08-12 22:20:06 +02:00
|
|
|
==== Searching the List Archives
|
2012-11-11 04:14:52 +01:00
|
|
|
|
|
|
|
Please search the mailing list archives before asking questions on the
|
|
|
|
mailing list, since there is a good chance someone else has asked the
|
|
|
|
same question before. Checking the archives is a great way to avoid
|
|
|
|
annoying everyone on the list with frequently asked questions...
|
|
|
|
|
manual: high-level restructuring
The structure of the buildroot manual is not always clear. There is a large
number of chapters, and some chapters seem to overlap. The distinction
between general usage and developer information is not always clear.
This patch restructures the manual into four large parts:
- getting started
- user guide
- developer guide
- appendix
Except for the names of these parts, the section names are not yet changed.
Content-wise there are no changes yet either. This will be handled in
subsequent patches.
In order to achieve the introduction of a new level 'parts' above
'chapters', the section indicators (=, ==, ===, ...) of several sections
have to be moved one level down. Additionally, the leveloffset indication to
asciidoc has to be removed. Finally, to maintain more or less the same level
of detail in the table of contents, the toc.section.depth attribute is
reduced as well. Note that for some sections, less detail is visible now.
Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
2014-08-12 22:20:06 +02:00
|
|
|
=== IRC
|
2012-11-11 04:14:52 +01:00
|
|
|
|
|
|
|
The Buildroot IRC is irc://freenode.net/#buildroot[].
|
|
|
|
The channel +#buildroot+ is hosted on Freenode
|
|
|
|
http://webchat.freenode.net[].
|
|
|
|
|
|
|
|
When asking for help on IRC, share relevant logs or pieces of code
|
2012-11-16 05:54:19 +01:00
|
|
|
using a code sharing website.
|
2012-11-11 04:14:52 +01:00
|
|
|
|
|
|
|
[[patchwork]]
|
manual: high-level restructuring
The structure of the buildroot manual is not always clear. There is a large
number of chapters, and some chapters seem to overlap. The distinction
between general usage and developer information is not always clear.
This patch restructures the manual into four large parts:
- getting started
- user guide
- developer guide
- appendix
Except for the names of these parts, the section names are not yet changed.
Content-wise there are no changes yet either. This will be handled in
subsequent patches.
In order to achieve the introduction of a new level 'parts' above
'chapters', the section indicators (=, ==, ===, ...) of several sections
have to be moved one level down. Additionally, the leveloffset indication to
asciidoc has to be removed. Finally, to maintain more or less the same level
of detail in the table of contents, the toc.section.depth attribute is
reduced as well. Note that for some sections, less detail is visible now.
Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
2014-08-12 22:20:06 +02:00
|
|
|
=== Patchwork
|
2012-11-11 04:14:52 +01:00
|
|
|
|
2013-10-09 22:46:15 +02:00
|
|
|
Patchwork is a web-based patch tracking system designed to facilitate
|
|
|
|
the contribution and management of contributions to an open-source
|
|
|
|
project. Patches that have been sent to a mailing list are \'caught' by
|
|
|
|
the system, and appear on a web page. Any comments posted that
|
|
|
|
reference the patch are appended to the patch page too. For more
|
|
|
|
information on Patchwork see
|
|
|
|
http://jk.ozlabs.org/projects/patchwork[].
|
|
|
|
|
|
|
|
Buildroot's Patchwork website is mainly for use by Buildroot's
|
|
|
|
maintainer to ensure patches aren't missed. The website however,
|
|
|
|
exposes patches and their corresponding review comments in a clean
|
|
|
|
and concise web interface.
|
|
|
|
|
|
|
|
The Buildroot patch management interface is available at
|
2012-11-11 04:14:52 +01:00
|
|
|
http://patchwork.buildroot.org[].
|
|
|
|
|
2013-10-09 22:46:15 +02:00
|
|
|
[[apply-patches-patchwork]]
|
manual: high-level restructuring
The structure of the buildroot manual is not always clear. There is a large
number of chapters, and some chapters seem to overlap. The distinction
between general usage and developer information is not always clear.
This patch restructures the manual into four large parts:
- getting started
- user guide
- developer guide
- appendix
Except for the names of these parts, the section names are not yet changed.
Content-wise there are no changes yet either. This will be handled in
subsequent patches.
In order to achieve the introduction of a new level 'parts' above
'chapters', the section indicators (=, ==, ===, ...) of several sections
have to be moved one level down. Additionally, the leveloffset indication to
asciidoc has to be removed. Finally, to maintain more or less the same level
of detail in the table of contents, the toc.section.depth attribute is
reduced as well. Note that for some sections, less detail is visible now.
Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
2014-08-12 22:20:06 +02:00
|
|
|
==== Applying Patches from Patchwork
|
2013-10-09 22:46:15 +02:00
|
|
|
|
|
|
|
The main use of Buildroot's Patchwork website for a developer is for
|
|
|
|
pulling in patches into their local git repository for testing
|
|
|
|
purposes.
|
|
|
|
|
|
|
|
When browsing patches in the patchwork management interface, an +mbox+
|
|
|
|
link is provided at the top of the page. Copy this link address and
|
|
|
|
run the following commands:
|
|
|
|
|
|
|
|
---------------------
|
|
|
|
$ git checkout -b <test-branch-name>
|
|
|
|
$ wget -O - <mbox-url> | git am
|
|
|
|
---------------------
|
|
|
|
|
|
|
|
Another option for applying patches is to create a bundle. A bundle is
|
|
|
|
a set of patches that you can group together using the patchwork
|
|
|
|
interface. Once the bundle is created and the bundle is made public,
|
|
|
|
you can copy the +mbox+ link for the bundle and apply the bundle
|
|
|
|
using the above commands.
|
2012-11-11 04:14:52 +01:00
|
|
|
|
2012-11-11 04:14:53 +01:00
|
|
|
[[bugtracker]]
|
manual: high-level restructuring
The structure of the buildroot manual is not always clear. There is a large
number of chapters, and some chapters seem to overlap. The distinction
between general usage and developer information is not always clear.
This patch restructures the manual into four large parts:
- getting started
- user guide
- developer guide
- appendix
Except for the names of these parts, the section names are not yet changed.
Content-wise there are no changes yet either. This will be handled in
subsequent patches.
In order to achieve the introduction of a new level 'parts' above
'chapters', the section indicators (=, ==, ===, ...) of several sections
have to be moved one level down. Additionally, the leveloffset indication to
asciidoc has to be removed. Finally, to maintain more or less the same level
of detail in the table of contents, the toc.section.depth attribute is
reduced as well. Note that for some sections, less detail is visible now.
Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
2014-08-12 22:20:06 +02:00
|
|
|
=== Bugtracker
|
2012-11-11 04:14:52 +01:00
|
|
|
|
|
|
|
The Buildroot bugtracker is at https://bugs.busybox.net[].
|
|
|
|
|
2012-11-11 04:14:53 +01:00
|
|
|
To open a bug, see xref:reporting-bugs[].
|
|
|
|
|
manual: high-level restructuring
The structure of the buildroot manual is not always clear. There is a large
number of chapters, and some chapters seem to overlap. The distinction
between general usage and developer information is not always clear.
This patch restructures the manual into four large parts:
- getting started
- user guide
- developer guide
- appendix
Except for the names of these parts, the section names are not yet changed.
Content-wise there are no changes yet either. This will be handled in
subsequent patches.
In order to achieve the introduction of a new level 'parts' above
'chapters', the section indicators (=, ==, ===, ...) of several sections
have to be moved one level down. Additionally, the leveloffset indication to
asciidoc has to be removed. Finally, to maintain more or less the same level
of detail in the table of contents, the toc.section.depth attribute is
reduced as well. Note that for some sections, less detail is visible now.
Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
2014-08-12 22:20:06 +02:00
|
|
|
=== Buildroot wikipage
|
2012-11-11 04:14:52 +01:00
|
|
|
|
|
|
|
After the Buildroot developer day on February 3, 2012,
|
|
|
|
a page dedicated to Buildroot has been created on
|
|
|
|
http://elinux.org[elinux.org].
|
|
|
|
|
|
|
|
This page is reachable at http://elinux.org/Buildroot[].
|
|
|
|
|
|
|
|
Currently, this page is mainly used as a _todo-list_.
|