[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

HTML formatting for *all* LSR snippets descriptions?

From: Valentin Villenave
Subject: HTML formatting for *all* LSR snippets descriptions?
Date: Fri, 7 Aug 2009 22:45:59 +0200

Greetings everybody,

Currently, the LSR offers three options for snippets descriptions formatting:
 - Pure Unicode text
 - Full HTML
 - HTML fragment

`Full HTML' is not used in any snippet.
`HTML fragment' is used in most of the snippets; when generating the
doc-snippets, tags are automatically converted into texinfo:
<code></code> becomes @code{}, <q></q> becomes @qq{} (Seba has just
implemented this one, and I've rewritten all snippets accordingly, as
Werner asked).
`Pure Unicode' is sometimes used, but I think we shouldn't recommend
it any longer, since such (lack of) formatting doesn't meet our
documentation-writing guidelines. Besides, any user who want to write
plain text can do so in HTML too.

So, I'm thinking that we'd better junk these pseudo-options, and ask
Seba to make HTML formatting allowed in all snippet descriptions.



reply via email to

[Prev in Thread] Current Thread [Next in Thread]