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

[Andras Mohari]

On Wed, Aug 14, 2002 at 12:51:18 +0200, Diego Biurrun wrote:
>  > Anyway, I haven't touched '!!!!!!! BUT STAY TUNED !!!!!!!!' although
>  > there are better ways to bring the reader's attention to something,
>  > for instance, by better structuring.
> 
> 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. :-)

> 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. :(

-- 
Andras Mohari
mayday at mail.nagyatad.hu