Re: Problem lilypond-book and fragments with quote and line-width

[Reinhold Kainhofer]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Am Samstag, 29. März 2008 schrieb Reinhold Kainhofer:
> Am Samstag, 29. März 2008 schrieben Sie:
> > On Fri, 28 Mar 2008 18:38:58 +0100
> >
> > > 3) Sorry, but I don't understand that third item at all. What do you
> > > mean by "quoted"?
> >
> > Indented like the lilypond code.
>
> After some playing around, it really must be some problem in one of our
> .tely files. The pdf works just fine with all @example code. And if I put
> the @example into the top node, it also works just fine in HTML. But in
> section 3.1.2 the identical @example code no longer works...

Okay, found the culprit: lilypond-book!

In particular, each @lilypond[quote,verbatim] messes things up: It sets
     @exampleindent 0
so, of course, the subsequent @example environments are not indented. That's a 
general problem with quoted verbatim snippets in lilypond-book and does not 
only happen with our docs.

For PDF, the exampleindent does not have any effect (unless it is specified in 
the document header, I guess), thus the PDF looks fine.

The problem is that without this setting, the @verbatim lilypond code (which 
is placed inside a @quotation) will also be indented by the value of 
@exampleindent and gets the default five spaces... (if it is not inside a 
@quotation, i.e. only @lilypond[verbatim] was used, then everything works 
fine).

The code generated by @lilypond[quote,verbatim,...] is:
@quotation
@exampleindent 0
@verbatim
c4
@end verbatim
@noindent
@ifinfo
@image{lilypond/lily-47cd9e8370,,,[image of music],}
@end ifinfo
@html
<p>
 <a href="lily-47cd9e8370.ly">
  <img align="middle"
    border="0" src="lily-47cd9e8370.png" alt="[image of music]">
 </a>
</p>
@end html

@iftex
@include lily-47cd9e8370-systems.texi
@end iftex
@end quotation


Unfortunately, the @exampleindent applies globally and is not confined to the 
@quotation environment :-( Also, I haven't found any other way to prevent 
@verbatim from indenting the code if it appears within a @quotation 
environment (if at top-level, there is no indentation...).

Also, notice the comment in the texinfo docs (at the end of 
http://www.gnu.org/software/hello/manual/texinfo/verbatim.html):
    "Finally, a word of warning: it is not reliable to use @verbatim inside
      other Texinfo constructs. "
I suppose we are running right into one of those cases here with 
lilypond-book.

I suppose the only thing we can do is to ask the makeinfo maintainers to 
implement correct (non-)indentation of @verbatim inside @quotation...

So, in short, this item is also a problem with texinfo...

Cheers,
Reinhold
- -- 
- ------------------------------------------------------------------
Reinhold Kainhofer, Vienna University of Technology, Austria
email: address@hidden, http://reinhold.kainhofer.com/
 * Financial and Actuarial Mathematics, TU Wien, http://www.fam.tuwien.ac.at/
 * K Desktop Environment, http://www.kde.org, KOrganizer maintainer
 * Chorvereinigung "Jung-Wien", http://www.jung-wien.at/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)

iD8DBQFH7sj5TqjEwhXvPN0RAuWCAJwPe8a3/ImUmg9iS0C1JuhIeEW9hACg3v3b
LcFjBwfnyftZnhmVoRD5ymI=
=abUs
-----END PGP SIGNATURE-----