Diff for Firefox rendering of source xml files

Heya all,

Fairly long time lurker, first time poster.

Trying to wrap my brain around how some of the documentation
stuff works
for httpd.

I figured starting with something simple would be wise,
though I'm not
sure I actually picked something simple.  *shrug*

This patch allows Firefox to render the source xml files for
manual/howto/auth.xml and manual/custom-error.xml

Basically all it does is replace " " with
" ".  For some
reason, Firefox doesn't seem to find the entity definition
for " ".

There are a couple of instances of this in some other files
in other
languages, but I'm not confident that my setup won't mangle
a file in
other charsets, so I'll hold off on submitting any of those
changes
right now.

There may be other reasons that Firefox won't render some of
the files,
but this should at least be a step in the right direction,
and makes
howto/auth.xml and custom-error.xml work for me.  Only
downside I see is
that it makes the source files slightly more obtuse since I
think its
more evident what nbsp does in comparison to #160.
-- 
Jeff McAdams
"They that can give up essential liberty to obtain a
little temporary safety deserve neither liberty nor
safety."
                                       -- Benjamin Franklin

On 10/13/06, Jeff McAdams <jeffmiglou.com> wrote:

> Basically all it does is replace "&nbsp;"
with "&#160;".  For some
> reason, Firefox doesn't seem to find the entity
definition for "&nbsp;".

It is my understanding (based on possibly-faulty long-term
memory)
that we define certain entities in external dtds.  (See, for
example,
style/lang.dtd.)  For security reasons, browser-based xml
renderers
will not read external dtds, so this essentially prevents
direct
rendering.

I don't think there is any easy workaround, since using only
numeric
entities would make the source of the docs quite unreadable,
and would
prevent the use of things like the version number entities
defined in
style/version.ent.  But we're always interested in other
ideas or
opinions.

Joshua.

------------------------------------------------------------
---------
To unsubscribe, e-mail: docs-unsubscribehttpd.apache.org
For additional commands, e-mail: docs-helphttpd.apache.org

Joshua Slive wrote:
> On 10/13/06, Jeff McAdams <jeffmiglou.com> wrote:
> 
>> Basically all it does is replace
"&nbsp;" with "&#160;".  For
some
>> reason, Firefox doesn't seem to find the entity
definition for "&nbsp;".
> 
> It is my understanding (based on possibly-faulty
long-term memory)
> that we define certain entities in external dtds. 
(See, for example,
> style/lang.dtd.)  For security reasons, browser-based
xml renderers
> will not read external dtds, so this essentially
prevents direct
> rendering.

> I don't think there is any easy workaround, since using
only numeric
> entities would make the source of the docs quite
unreadable, and would
> prevent the use of things like the version number
entities defined in
> style/version.ent.  But we're always interested in
other ideas or
> opinions.

Yes, all those thoughts went through my head when I was
looking at this.
 And, yes, I saw that it was in lang.dtd.  I had not
realized that there
were other entities that would blow these things up.

So, I would agree...probably a fool's errand to start down
that path.

Ah well, couple of things learned, so that's a bit of a
useful endeavor,
I guess.
-- 
Jeff McAdams
"They that can give up essential liberty to obtain a
little temporary safety deserve neither liberty nor
safety."
                                       -- Benjamin Franklin