Skip to content

gendoc infra: make it useable for other documents (branch yem/manual)

Yann E. MORIN buildroot 4 versions – New

Get series with b4
b4 am [email protected]

Versions newest first · linked by author and title

  1. v5 Latest posting 2/20 of 23 patches 0 repliesNew
  2. v5 posting 1/223 patches 0 repliesSuperseded
  3. v418 patches 0 repliesSuperseded
Earlier versions · 1
VersionPostedPatchesRepliesStatus
v32 of 4 patches0 repliesSuperseded

Patches in v5 posting 2/2 No applies recorded yet

None of the 23 patches the cover letter announces are in this archive.

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v5 yet.

Read the v5 thread

Cover letter [Buildroot] [PATCH 0/23 v5] gendoc infra: make it useable for other documents (branch yem/manual)

All,

Gee... I forgot to update the series description in the cover letter. Sorry... :-(

Here it is:

On 2014-09-14 13:07 +0200, Yann E. MORIN spake thusly:

Quoted 8 lines

This series builds up on top of Samuel previous series, and further enhances the GENDOC infrastructure to be useable to generate other documents, and especially documents in br2-external.

The series is articulated as thus:

- patches 1-4 from Samuel, virtually untouched by me, save for the

    check for xsltproc, see the changelog in patch 4;

Unchanged from previous iteration.

Quoted 5 lines

- then, patches 5-16 to remove hard-coded reference to 'manual' in either GENDOC or GENDOC_INNER, and to remove hard-coded paths to our manual, and to properly separate GENDOC generic rules from document-specific rules, and make GENDOC look more like the pkg-XXX infrastructures;

Replaced with:

- patches 5-14: properly separate our manual defintion from the actual

    infrastructure;

- patches 15-16: make the gendoc infra behave more like the pkg

    infras, by using hooks rather than extra rules;

- patch 17: workaround asciidoc deficiency when calling filters;

- patches 18-19: move and rename 'gendoc' to 'doc-asciidoc';

- patches 20-21: further tweak the new infra so it looks more like other infras: only call pkgdir and pkgname from the frontend macro, and use stamp files so we can use $(@D);

- patch 22: allow using doc-asciidoc from br2-external;

- patch 23: document this new infra in the manual.

Here is an example of using this new infra from a br2-external tree:

http://ymorin.is-a-geek.org/download/tmp/br.config/brsh-manual.html

Regards,
Yann E. MORIN.

Signature · 6 lines
.-----------------.--------------------.------------------.--------------------.
|  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.  |
'------------------------------^-------^------------------^--------------------'