Re: literal titles

Gabor Hojtsy wrote:

I noticed a problem in livedocs, and when I ran it by Ilia, he agreed that livedocs should be fixed, but wondered about the wisdom of doing what we do. I told him I'd run it by the list. Why do we have completely literal titles? For example: [phpdoc/en/language/control-structures.xml] <title><literal>if</literal></title> I'd understand something like: <title>part of this is <literal>literal</literal></title> But an entirely literal title? What do the rest of you think?

It is safe to completely tag-strip the title IMHO (in the HTML title tag), I have no idea about any other option. These literals are visual sugar in the first place, HTML <title>-s should be understandable without them. Otherwise, in HTML content, these should be rendered with fixed width fonts, as in the DSSSL and XSLT outputs.

The good question to ask, as we're talking about XML (only logic is involved here, not rendering), is : Do this "if" really belong in a literal ? At first sight, the answer is yes. didou