Michael,
Thanks!
I do have some follow up questions:
dr3d:lighting-mode, when used with 3D objects, we now say:
> The |dr3d:lighting-mode| attribute specifies the lighting algorithm
> used to render a 3D object.
>
> The value of this attribute can be |standard| or |double-sided|. If
> the value is |double-sided|, the reverse sides of the object are also
> lighted.
>
My note and the response:
> Ed. Note We should define “standard” in some meaningful way.
>
> CL: “standard” should have named “single-sided” as it is the oposite
> of “double-sided”, meaning that only front faces will be lit. Readers
> with 3D knowledge will know what a front face is, others will not care
> much...
>
Actually there is a more difficult problem than standard vs. double-sided.
Note first sentence says that the attribute "specifies the lighting
algorithm...."
We then say: "this attribute can be standard or double-sided."
And those are in fact the only values for this attribute.
I suppose one could argue that "specifies" means to choose between
algorithms that illuminate the face of an object versus both sides
rather than naming an algorithm but that sounds weak to me.
Suggest:
*****
The dr3d:lighting mode attribute specifies the illumination of a 3D object.
The dr3d:lighting-mode attribute values are:
* standard - front face of an object is illuminated
* double-sided - front and reverse sides of an object are illuminated
*****
**************************
18.134 draw:corner-radius
Now reads:
> The |draw:corner-radius| attribute specifies the radius of the circle
> used to round off the corners of a caption |