Document opt_CMAKE_BOOL and opt_CMAKE_BOOL_OFF.

[wblock]

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

4360 ↗

(On Diff #17890)

If/then sentence, so try to reword to avoid the halting pause after the if condition:

See <xref linkend="options-cmake_bool"/> for a shorter helper
when the value is boolean.

4370 ↗

(On Diff #17890)

This sentence is kind of hard to parse (shown without markup):
"When option OPT_CMAKE_BOOL_OFF is selected, for each entry in OPT_CMAKE_BOOL then
-Dentry:BOOL=true is appended to CMAKE_ARGS."

"Selected" is also a little unclear. Maybe "used" or "specified". For the rest of the sentence:

When option OPT_CMAKE_BOOL_OFF is used, an
-Dentry:BOOL=true is appended to CMAKE_ARGS
for each entry in OPT_CMAKE_BOOL.

4376 ↗

(On Diff #17890)

Again, kind of a confusing sentence, partly due to "selected", partly due to "option OPT".

4381 ↗

(On Diff #17890)

"works in the same way but reversed" is kind of the text equivalent of a "not". Better to say "...is the opposite, "

[mat]

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

4370 ↗

(On Diff #17890)

"selected" is the verb used in for all the options helpers in this chapter, and it is the right one, when the user builds a port, if there are options, he is presented with an option dialog where he selects the options he wants.

[mat]

• Reword.

[wblock]

Thank you.