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

[Ulrich Mueller]

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.

Ulrich