[MPlayer-dev-eng] [PATCH] Docs fixes

[Diego Biurrun]

Andras Mohari writes:
 > On Wed, Aug 14, 2002 at 12:51:18 +0200, Diego Biurrun wrote:
 > > The problem here is that ASCII structuring techniques are mixed with
 > > HTML structure throughout the docs.  In plain text docs it is ok to
 > > use some kind of email/IRC style with ALL CAPS, _underlined_ and such
 > > for stuff that is *really* IMPORTANT!!!  HTML does offer markup like
 > > <i> and <b> or even better <em> and <strong> for this and in the HTML
 > > documentation these should be the preferred method of putting emphasis
 > > on certain aspects.
 > 
 > I agree. <em> and <strong> would do just fine.  Very important notes
 > could be displayed in separate blocks with large margins (similar to the
 > way DocBook formats notes/warnings/tips).  But it would be an impossible
 > search & replace mission. :-)

I am currently converting the docs to use proper headings tags, expect
a commit in the next days.  Changing <B> to <STRONG> or <EM> would be
a logical next step, let's see.  skin-en.html does it very nice with
red warnings and green notes, maybe we could adopt that for the rest
of the docs.  So many ideas, so little time :-(

 > > Who knows, once we have XML, maybe we can make a stylesheet that
 > > translates into plaintext with these types of emphasis..
 > 
 > Hm, yes, if somebody is a master at stylesheets... I'm not. :(

Of course that is just a pie in the sky fantasy, but who knows :-)

Diego