Re: automatic generation of input/lsr/

[Graham Percival]

Werner LEMBERG wrote:
> > We're still working on formatting issues -- I tend to send one email
> > to Sebastiano each day; the latest issue was automatically escaping
> > @address@hidden for the texidoc strings.
>
> Uh.  Those braces are completely irritating!

The problem is this: in LSR, a user sees this:
----
The property @code{chordNameExceptions} can used to store a list of 
special notations for specific chords.
----

and he wonders what on earth the @code means.  Now, if we only use HTML 
for the snippet description, we could standardize on
<texttt>chordNameExceptions</texttt>
to be @code{} in the texidoc.   (err, I think \texttt is LaTeX. 
Whatever the HTML equivalent is)


I thought that {chordNameExceptions} was an acceptable compromise for 
the next couple of days until we figure out how to fix this.  It'll 
certainly be fixed before the next stable release!

> > although I'm not certain what to do about snippets that use HTML for
> > descriptions.  (currently we strip away all the HTML tags)
>
> They should be converted to texinfo format, probably manually.

No, no!  Absolutely no manual stuff!

Sebastiano is very helpful (and amazingly fast) at adding extra 
text-conversion rules.  As long as we can give an exact formulation for 
the conversion, he can add such a rule.

> > When I get a chance, I'll edit all those files in LSR to include the
> > fixes you've made.
>
> I don't care.  In case it's necessary, just drop or ignore them.

Cameron offered to do this, and it'll be good practice for him.  :)

Cheers,
- Graham