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
