Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-09-02 Thread Valentin Villenave
2007/9/2, Graham Percival <[EMAIL PROTECTED]>: > You probably missed the nuance of this email: > http://lists.gnu.org/archive/html/lilypond-devel/2007-08/msg00178.html Oh yes. It may be too diplomatic for me though :) Thank you for rephrasing. > > (As I already said, both verbatim and > > non-

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-09-02 Thread Graham Percival
Valentin Villenave wrote: Hmmm... Does it means that Trevor's Debussy examples are not to be added? I must have missed something in the discussion; I thought wherever we could find "nice" and simple examples, the current manual examples could be replaced with those. You probably missed the nu

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-09-02 Thread Valentin Villenave
2007/9/2, Graham Percival <[EMAIL PROTECTED]>: > Trevor Bača wrote: > > I think what Graham's wanting to try out to get started is a beautiful > > example per major *section* of the manual rather than per minor > > *subsection*. > > > Yes, absolutely. Hmmm... Does it means that Trevor's Debussy ex

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-09-02 Thread Graham Percival
Trevor Bača wrote: I think what Graham's wanting to try out to get started is a beautiful example per major *section* of the manual rather than per minor *subsection*. Yes, absolutely. So with that in mind I've started thinking more about "what one snippet would best show off contemporary no

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-09-02 Thread Trevor Bača
On 9/2/07, Valentin Villenave <[EMAIL PROTECTED]> wrote: > 2007/8/31, Trevor Bača <[EMAIL PROTECTED]>: > > In fact, glancing at the manual sections now, it looks like chapter 8 > > is as good a place to start as any. I'll take a stab at 8.1.1 through > > 8.1.11 tomorrow, probably skipping over 8.1.

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-09-02 Thread Valentin Villenave
2007/8/31, Trevor Bača <[EMAIL PROTECTED]>: > In fact, glancing at the manual sections now, it looks like chapter 8 > is as good a place to start as any. I'll take a stab at 8.1.1 through > 8.1.11 tomorrow, probably skipping over 8.1.7 ... Hi Trevor, hi everybody, I've just seen the examples in 8

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-08-31 Thread Trevor Bača
On 8/30/07, Graham Percival <[EMAIL PROTECTED]> wrote: > Trevor Bača wrote: > > Sure, I'd be happy to. (And if winds up being too complicated, then > > that's certainly OK; just keep me in check!) > > > Go nuts. :) My only concern is the vertical space of the printed > music on the page. For th

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-08-30 Thread Graham Percival
Trevor Bača wrote: Sure, I'd be happy to. (And if winds up being too complicated, then that's certainly OK; just keep me in check!) Go nuts. :) My only concern is the vertical space of the printed music on the page. For the lilypond input, do whatever you want. Overrides, scheme, Turing

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-08-30 Thread Trevor Bača
On 8/30/07, Trevor Bača <[EMAIL PROTECTED]> wrote: > On 8/30/07, Graham Percival <[EMAIL PROTECTED]> wrote: > > Han-Wen Nienhuys wrote: > > > Graham Percival escreveu: > > > > > > > > >> ... hmm, I might see a use for that. We could have one really fancy > > >> example, *without* input code, in th

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-08-30 Thread Trevor Bača
On 8/30/07, Graham Percival <[EMAIL PROTECTED]> wrote: > Han-Wen Nienhuys wrote: > > Graham Percival escreveu: > > > > > >> ... hmm, I might see a use for that. We could have one really fancy > >> example, *without* input code, in the "root" node of each section. > >> > > > > I concur with this. S

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-08-30 Thread Graham Percival
Han-Wen Nienhuys wrote: Graham Percival escreveu: ... hmm, I might see a use for that. We could have one really fancy example, *without* input code, in the "root" node of each section. I concur with this. Some 'real' examples also help give users an idea what some features (eg. fatTe

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-08-30 Thread Han-Wen Nienhuys
Graham Percival escreveu: > ... hmm, I might see a use for that. We could have one really fancy > example, *without* input code, in the "root" node of each section. I concur with this. Some 'real' examples also help give users an idea what some features (eg. fatText) could be used for. -- Han-

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-08-30 Thread Trevor Bača
On 8/30/07, Graham Percival <[EMAIL PROTECTED]> wrote: > Trevor Bača wrote: > > The second example was infinitely easier: we just needed something to > > show a text script complicated enough to require a markup (which is > > almost everything). The indication, is, of course, Debussy's famous > > m

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-08-30 Thread Graham Percival
Trevor Bača wrote: The second example was infinitely easier: we just needed something to show a text script complicated enough to require a markup (which is almost everything). The indication, is, of course, Debussy's famous marking at the beginning of Des pas sur la neige. Let's ignore the \f

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-08-30 Thread Graham Percival
Valentin Villenave wrote: 2007/8/31, Graham Percival <[EMAIL PROTECTED]>: There's a few other places in the manual where they're used. Yes, they could of course be used in more places. I'm sure that both of you know why they aren't yet. :) Let me guess... Everyone tried to help but

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-08-30 Thread Valentin Villenave
2007/8/31, Graham Percival <[EMAIL PROTECTED]>: Great! I noticed the glissando link indeed, but never had the curiosity to look at the source file. > There's a few other places in the manual where they're used. Yes, they > could of course be used in more places. I'm sure that both of you know >

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-08-30 Thread Graham Percival
Valentin Villenave wrote: Leaving the feature page aside, what I often tried to figure out was: how to better integrate the LSR with the manual. I can't put links to the manual in the snippets descriptions (since the links are likely to be broken soon); neither can I put links to the LSR snippets

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-08-30 Thread Valentin Villenave
2007/8/30, Trevor Bača <[EMAIL PROTECTED]>: > [I'm a little hesitant to speak on this issue because I think my > opinions differ a bit from the rest of the team. So fair warning, > subjective opinion coming up. I personally *love* and adore the > manual. I use it every day. I read it more often t

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-08-30 Thread Trevor Bača
On 8/30/07, Han-Wen Nienhuys <[EMAIL PROTECTED]> wrote: > 2007/8/30, Trevor Bača <[EMAIL PROTECTED]>: > > > The first example -- the one for \fatText -- was quite difficult to > > come up with. I looked at the existing \fatText last night and thought > > "what possible musical context is there for

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-08-30 Thread Han-Wen Nienhuys
2007/8/30, Trevor Bača <[EMAIL PROTECTED]>: > The first example -- the one for \fatText -- was quite difficult to > come up with. I looked at the existing \fatText last night and thought > "what possible musical context is there for making text open up a gap > in the middle of a score; where on ea

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-08-30 Thread Valentin Villenave
2007/8/30, Trevor Bača <[EMAIL PROTECTED]>: > I tried to make the point visually this morning by mocking up 8.1.1 > "Text scripts" in LaTeX. I don't think I got all the settings right to > match the docs, but at least here I can kinda give a little bit by > contributing an example (instead of just

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-08-29 Thread Graham Percival
Han-Wen said pretty much everything I was planning on saying, but I'll add/summarize some points: 1. Long musical examples in the manual are out. (cut+paste difficulty, looks complicated, adds unnecessary length to sections -- my ideal length is no more than two pages of HTML for each subsec

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-08-29 Thread Han-Wen Nienhuys
It's been a long day, and don't have a coherent response to such a long mail with such good points, but I'll just put in a little counterpoint. 1. we actually used to have longer examples and "schubert lied in 10 steps" type of examples, in the tutorial. They were removed as they were too intimid

Re: For future 2.14 doc discussion -- increasingly realistic musical examples

2007-08-29 Thread Valentin Villenave
2007/8/29, Trevor Bača <[EMAIL PROTECTED]>: > Hi, Hi Trevor, quite a long mail (very interesting though). You're right, musical examples are extremely important. Besides, I noticed we're using less musical examples than several years ago (I remember, in 1.x manuals, a Brahms example, and the Samm

For future 2.14 doc discussion -- increasingly realistic musical examples

2007-08-29 Thread Trevor Bača
Hi, It looks like we're getting close to a 2.12 release, which is awesome. It's been quite amazing to watch the increase of new features and, in some cases, entire new subsystems enter the program over the last couple of major releases. First a background observation and then a specific suggestio