Convert the USES table into multiple <sect1>.

[mat]

Summary

http://aragorn.in.absolight.net/d2/new-uses-order/en_US.ISO8859-1/books/porters-handbook/uses.html
http://aragorn.in.absolight.net/d2/new-uses-order/en_US.ISO8859-1/books/porters-handbook/book.html#uses

[wblock]

Mostly just looked at the introduction. I like this in some ways, but I liked the compactness of the table version, too. The html-split version of this only has a table of contents at the very start. It's probably fine, though.

en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml

33 ↗

(On Diff #7137)

Probably should not phrase this as a question. Maybe just

USES Values
or
USES Macros
or
Simplifying Ports with USES Macros

35 ↗

(On Diff #7137)

Should be "USES macros" or "USES values" or something like that.

<para><varname>USES</varname> macros make it easy to declare requirements and settings for a port.

37 ↗

(On Diff #7137)

Britishm->Americanism:
s/behaviour/behavior/

Good, but "and so on." is preferred to "etc." Nice to also point out it is easier than doing it manually:

...add metadata to packages, and so on, all by selecting simple, preset values.

[mat]

In D3142#62662, @wblock wrote:

Mostly just looked at the introduction. I like this in some ways, but I liked the compactness of the table version, too. The html-split version of this only has a table of contents at the very start. It's probably fine, though.

I liked the compact table, but it was getting bigger and bigger, and I did not like the way it was growing.
I don't really like the fact that in the html-split version there's now only one USES, but it's a rendering problem, not a documentation problem. Maybe there could be some new metadata added to the chapter telling it to not split itself into 60+ sub-sections.

en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml

33 ↗

(On Diff #7137)

Yes, but, the title of the chapter is already Values of USES, this sect1 being an introduction on what this is, and how to use it, I wanted something more catchy. Or at least, different from the chapter's title.

37 ↗

(On Diff #7137)

Damn, I wrote behavior, and replaced it with behaviour thinking it was the en_US way, I'll try to remember it.

[mat]

• Reword first §.

[wblock]

en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml

33 ↗

(On Diff #7172)

Using USES Macros
An Introduction to USES
Simplifying Ports with USES

If you want to keep it in the form of a question, add a question mark to the original:
What Are USES?

But it's not really a question/answer format.

[mat]

• Rename the chapter's title, and the first section's.

[wblock]

Please remember to check with igor and build-test before commit. Thanks!