[Buildroot] [PATCHv2/next 4/4] docs/manual: add new section about the DEVELOPERS file and get-developer

Thomas Petazzoni thomas.petazzoni at free-electrons.com
Wed Aug 24 14:22:59 UTC 2016


Hello,

On Wed, 24 Aug 2016 02:21:44 +0200, Arnout Vandecappelle wrote:

>  As I hinted in my reply to patch 2, I would also add this message to the end of
> the "The formatting of a patch" section in contribute.txt. Something like:
> 
> If you are interested in getting notified of build failures and of further
> changes in the packages you modified, please add yourself to the DEVELOPERS
> file. This should be done in a separate patch of the series. See
> xref:DEVELOPERS[the DEVELOPERS file] for more information.
> 
> (and add [[DEVELOPERS]] to the developers section).

Thanks for the suggestion, added.

While adding this, I noted that the references like:

   xref:label[some description]

are not rendered just has "some description" in the HTML, but as:

  "some description <the title of the section pointed to>"

For example, for:

  Before reporting any issue, please check in xref:community-resources[the mailing list archive] whether someone has

you get:

  Before reporting any issue, please check in the mailing list archive Chapter 5, Community resources whether someone has

which is not very pretty.

Maybe someone with AsciiDoc knowledge can look into this?

Thomas
-- 
Thomas Petazzoni, CTO, Free Electrons
Embedded Linux and Kernel engineering
http://free-electrons.com


More information about the buildroot mailing list