Re: texinfo bug: @table within @example

[Trevor Daniels]

Werner

I've just pushed some changes to improve these tables.
The notename/accidental table has been split into two
to avoid overrunning the right margin, and @quotation
is used instead of @example.  I've also used @file{}
for the filenames.

Could you see if you think this has made an improvement.

Thanks.

Trevor

----- Original Message ----- 
From: "Werner LEMBERG" <address@hidden>
To: <address@hidden>
Sent: Tuesday, October 28, 2008 4:29 PM
Subject: texinfo bug: @table within @example


> Folks,
>
>
> the released texinfo versions don't like this:
>
>  @example
>  @table
>  ...
>  @end table
>  @end example
>
> (the same is true for @smallexample).  While makeinfo produces
> reasonable output, texi2html doesn't work well on it; similarly,
> texinfo.tex produces bad output.
>
> Additionally, it is questionable whether a table makes sense at all
> within an @example environment.  There are two such cases in the
> english lilypond documentation (in pitches.itely).
>
> Please fix, replacing it with something different.  Below is a patch;
> however, I'm not sure whether you want this kind of formatting -- the
> table is far too wide for the PDF.
>
> Note that a forthcoming version of texinfo will contain a
> @smallquotation environment which would be exactly the right thing...
>
>
>    Werner
>
>
> ======================================================================
>
>
> --- pitches.itely.old 2008-10-16 16:43:42.000000000 +0200
> +++ pitches.itely 2008-10-22 10:15:07.000000000 +0200
> @@ -392,52 +392,51 @@
> @address@hidden "english.ly"}} to the top of the input file.
> The available language files and the note names they define are:
>
> -
> address@hidden
> address@hidden {nederlands.ly} {do re mi fa sol la sib si} {-iss/-is} 
> {-ess/-es} {-ss/-x/-sharpsharp} {-essess/-eses}
> address@hidden
> address@hidden address@hidden {do re mi fa sol la sib si} 
> {-s/-sharp} {-ess/-es} {-ss/-x/-sharpsharp} {-essess/-eses}
> @headitem Language
>   @tab Note names
>   @tab sharp @tab flat @tab double sharp @tab double flat
> address@hidden nederlands.ly
> address@hidden @file{nederlands.ly}
>   @tab c d e f g a bes b
>   @tab -is @tab -es @tab -isis @tab -eses
> address@hidden arabic.ly
> address@hidden @file{arabic.ly}
>   @tab do re mi fa sol la sib si
>   @tab -d @tab -b @tab -dd @tab -bb
> address@hidden catalan.ly
> address@hidden @file{catalan.ly}
>   @tab do re mi fa sol la sib si
>   @tab -d/-s @tab -b @tab -dd/-ss @tab -bb
> address@hidden deutsch.ly
> address@hidden @file{deutsch.ly}
>   @tab c d e f g a b h
>   @tab -is @tab -es @tab -isis @tab -eses
> address@hidden english.ly
> address@hidden @file{english.ly}
>   @tab c d e f g a bf b
>   @tab -s/-sharp @tab -f/-flat @tab -ss/-x/-sharpsharp
>     @tab -ff/-flatflat
> address@hidden espanol.ly
> address@hidden @file{espanol.ly}
>   @tab do re mi fa sol la sib si
>   @tab -s @tab -b @tab -ss @tab -bb
> address@hidden italiano.ly
> address@hidden @file{italiano.ly}
>   @tab do re mi fa sol la sib si
>   @tab -d @tab -b @tab -dd @tab -bb
> address@hidden norsk.ly
> address@hidden @file{norsk.ly}
>   @tab c d e f g a b h
>   @tab -iss/-is @tab -ess/-es @tab -ississ/-isis
>     @tab -essess/-eses
> address@hidden portugues.ly
> address@hidden @file{portugues.ly}
>   @tab do re mi fa sol la sib si
>   @tab -s @tab -b @tab -ss @tab -bb
> address@hidden suomi.ly
> address@hidden @file{suomi.ly}
>   @tab c d e f g a b h
>   @tab -is @tab -es @tab -isis @tab -eses
> address@hidden svenska.ly
> address@hidden @file{svenska.ly}
>   @tab c d e f g a b h
>   @tab -iss @tab -ess @tab -ississ @tab -essess
> address@hidden vlaams.ly
> address@hidden @file{vlaams.ly}
>   @tab do re mi fa sol la sib si
>   @tab -k @tab -b @tab -kk @tab -bb
> @end multitable
> address@hidden smallexample
> address@hidden quotation
>
> In Dutch, @code{aes} is contracted to @code{as}, but both forms
> are accepted in LilyPond.  Similarly, both @code{es} and
> @@ -464,32 +463,32 @@
> mean @q{half} and @q{one and a half}, respectively.  For the other
> languages, no special names have been defined yet.
>
> address@hidden
> address@hidden {nederlands.ly} {do re mi fa sol la sib si} {-iss/-is} 
> {-ess/-es} {-ississ/-isis} {-ississ/-isis}
> address@hidden
> address@hidden address@hidden {do re mi fa sol la sib si} 
> address@hidden address@hidden address@hidden address@hidden
> @headitem Language
>   @tab Note names
>   @tab semi-sharp @tab semi-flat @tab sesqui-sharp @tab sesqui-flat
>
> address@hidden nederlands.ly
> address@hidden @file{nederlands.ly}
>   @tab c d e f g a bes b
>   @tab -ih @tab -eh @tab -isih @tab -eseh
> address@hidden arabic.ly
> address@hidden @file{arabic.ly}
>   @tab do re mi fa sol la sib si
>   @tab -sd @tab -sb @tab -dsd @tab -bsb
> address@hidden deutsch.ly
> address@hidden @file{deutsch.ly}
>   @tab c d e f g a b h
>   @tab -ih @tab -eh @tab -isih @tab -eseh
> address@hidden english.ly
> address@hidden @file{english.ly}
>   @tab c d e f g a bf b
>   @tab -qs @tab -qf @tab -tqs @tab -tqf
> address@hidden italiano.ly
> address@hidden @file{italiano.ly}
>   @tab do re mi fa sol la sib si
>   @tab -sd @tab -sb @tab -dsd @tab -bsb
> address@hidden portugues.ly
> address@hidden @file{portugues.ly}
>   @tab do re mi fa sol la sib si
>   @tab -sqt @tab -bqt @tab -stqt @tab -btqt
> @end multitable
> address@hidden smallexample
> address@hidden quotation
>
>
> @seealso
>
>
> _______________________________________________
> lilypond-devel mailing list
> address@hidden
> http://lists.gnu.org/mailman/listinfo/lilypond-devel