[MPlayer-dev-eng] Re: [PATCH] Development (Was: Clean up

Wed Feb 27 19:55:22 CET 2002

Hi,

> > > > Heh?
> > > <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
> > What for? It won't change page's appearance, and browsers care not.
> 
> That's not entirely true.  I only know the details for Mozilla, but I am
> quite sure other browsers handle it equally (IE does).  There is a
> "standards mode" and a "quirks mode".  If a doctype declaration is missing
> quirks mode gets triggered and the browser enters a compatibility mode that
> emulates the rendering of previous browser generations, the 4x series,
> mostly.  Rendering *is* different in both modes.

Hmm. Anyway, docs doens't use any extra new features of 5.x+ browsers, it
has only basic tags like <B> <I> <FONT> <A HREF=...>, and a few simple TABLE
i think even html 1.0 covers it...

> > > > > tags are wrongly nested and
> > > > Huh?
> > > There are rules which tags may appear within others and the have to
> > > be closed in exactly reverse order.
> > > <p> <b> Test </p> </b> 
> > Still better than if it wasn't closed at all :))
> 
> Performance should be better if tags are closed correctly because the error
> routines of the browser will not get triggered.
I agree. But unfortunatelly gabu is too lazy to do it well :(
He just writes the text and sometimes adds few tags to be better than
plaintext... If you send patch to fix just these, it will be accepted.

> > > I'm lacking an example here because I'm offline, but the validator
> > > showed me that you used some attributes in tags which are not
> > > allowed to contain them.
> > So what? It works.
> 
> Yes, it works.  I don't mean to sound negative, you did some great work with
> the docs.  I do not want to nitpick, I just want to point out that there is
> some truth behind Daniel's claims.  The new docs will change the situation,
> anyway...
> 
> While I am at it, I volunteer to help in the documentation rewrite.  I know
> English, German, Spanish and a little French, am a tenacious proofreader and
> think I have some talent for (technical) writing.  Feel free to contact me
> for help.
I hope he will contact you and others offering help, a document writer team
would be much better than single doxwritter.

> I believe an XML solution would be best in the long run.  This will be
> convertible to all other formats.  I use LaTeX for writing papers, but I do
> not believe it will be the best solution for software documentation.
I agree in this too, but Gabu refuses to use sgml or linuxdoc, as he failed
to install required tools :(((

A'rpi / Astral & ESP-team

--
Developer of MPlayer, the Movie Player for Linux - http://www.MPlayerHQ.hu