[Top][All Lists]

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

Re: automatic generation of input/lsr/

From: Graham Percival
Subject: Re: automatic generation of input/lsr/
Date: Fri, 09 Feb 2007 16:37:39 -0800
User-agent: Thunderbird (Macintosh/20061207)

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

- Graham

reply via email to

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