Details
- Reviewers
gjb wblock - Commits
- rD47055: Convert the USES table into multiple <sect1>.
Diff Detail
- Repository
- rD FreeBSD doc repository - subversion
- Lint
No Lint Coverage - Unit
No Test Coverage
Event Timeline
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 | Probably should not phrase this as a question. Maybe just USES Values | |
35–39 | 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 | Britishm->Americanism: 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. |
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 | 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 | Damn, I wrote behavior, and replaced it with behaviour thinking it was the en_US way, I'll try to remember it. |
en_US.ISO8859-1/books/porters-handbook/uses/chapter.xml | ||
---|---|---|
33 | Using USES Macros If you want to keep it in the form of a question, add a question mark to the original: But it's not really a question/answer format. |