Ciaran McCreesh wrote:
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.

Pointless nit.

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

your opinion, just yours.

Third, you should have a non-breaking space between 'see' and the
reference.

Pointless nit.

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.

As usual for xml markups.

lu

--

Luca Barbato
Gentoo Council Member
Gentoo/linux Gentoo/PPC
http://dev.gentoo.org/~lu_zero

--
gentoo-dev@lists.gentoo.org mailing list

Reply via email to