Re: Is postgres.gif missing in cvs?

Andrew Dunstan <andrew@dunslane.net> writes:
> Tom Lane wrote:
>> Hmph.  What version of the SGML tools are you using?  It seems more
>> prone to get confused by non-entity-ized '<' and '>' than what the
>> rest of us are using.

> I'm not totally au fait with the rules of SGML. Does it allow literal 
> '<' in text nodes? In most places I looked in our docs we seem to use 
> '<' as I would have expected.

It appears to me that the tools will silently take < (and also &)
as literal characters, *if* what follows them happens to not look
too much like a tag or entity :-(.  Pretty ugly.  The particular
cases that were biting Devrim seemed to all be occurrences of <>
which perhaps is an allowed tag in his release.

I found out that -wxml will cause openjade to warn about these cases.
It turns on a boatload of other warnings that we probably don't care
about, so I'm not going to recommend using it by default, but it
enabled me to find a lot of problem spots just now.

Oh, another interesting behavior that was turned up by this ---
apparently you can get away with leaving off the ";" in "<",
because we had done so in a few places.  -wxml catches that too.
        regards, tom lane