[gentoo-pms] Re: RFC: Promote 11.3.3 "Ebuild-specific commands" to a section

[Ulrich Mueller]

>>>>> On Thu, 28 Sep 2017, Ulrich Mueller wrote:

> Currently chapter 11 "The Ebuild Environment" is the largest chapter
> by far with 23 pages (second is chapter 9 "Ebuild-defined functions"
> with only 8 pages). Subsection 11.3.3 "Ebuild-specific commands" alone
> has 14 pages, and with EAPI 7 it will grow further.

> So I wonder if we could promote "Ebuild-specific commands" to a
> section. I see two possibilities:

> - Most straight forward would be to promote section 11.3 "Available
>   Commands" to a chapter. OTOH, that would also move 11.3.2 to section
>   level, which feels wrong because it has only three lines.

> - Alternatively, we could leave the chapter structure alone, rename
>   section 11.3 to "External Commands", and promote 11.3.3 to a new
>   section 11.4. Chapter 11 would keep its somewhat excessive length,
>   though.

> I would slightly prefer the second plan, unless anybody has a better
> idea.

Actually the first plan requires fewer changes of text. A series of
two patches will follow, please review.

Ulrich