On Mon, 09 Jun 2008 03:28:03 -0700
Josh Saddler <[EMAIL PROTECTED]> wrote:
> <p>
> Global variables must only contain invariant values (see <uri 
> link="#metadata-invariance">link</uri>). If a global variable's value
> is invariant, it may have the value that would be generated at any
> given point in the build sequence.
> </p>

First, your link is incorrect. metadata-invariance is in a different
file.

Second, the link's text should be the section name or chapter number.
Rendered as "(see link)" is horribly ugly.

Third, you should have a non-breaking space between 'see' and the
reference.
 
> <p>
> This is demonstrated by the following:
> </p>
> 
> <pre caption="Environment state between functions" id="env-saving">
> bunch o'neat code
> </pre>

How does "bunch o'neat code" deal with our code file containing things
that XML considers to be reserved characters? That code probably has
ampersands and angle brackets in it.

-- 
Ciaran McCreesh

Attachment: signature.asc
Description: PGP signature

Reply via email to