Re: GDP: Opinions sought on markup command snippets

2008-04-14 Thread Neil Puttock
Hi everybody,

I'd like to thank David and the two Trevors for their input on this issue.

I've decided to follow the approach of examples in isolation for the
majority of cases, plus fuller examples where warranted.

Once I've added a few snippets, we'll get a clearer idea of what's
likely to work best, so please don't hesitate to comment further once
I've started.

Regards,
Neil


___
lilypond-user mailing list
lilypond-user@gnu.org
http://lists.gnu.org/mailman/listinfo/lilypond-user


Re: GDP: Opinions sought on markup command snippets

2008-04-03 Thread Neil Puttock
Hi Trevor,

On 03/04/2008, Trevor Bača <[EMAIL PROTECTED]> wrote:

> My first thought was "stuff is, in general, almost always better with an
> actual score example." But, clicking back through B.6 and rereading, I think
> exactly the opposite conclusion is warranted here. I think the
> examples-in-isolation approach (#2) will do perfectly.

I'm certainly gravitating towards the second option. :) As a first
draft, it's probably the best solution, and I think it fits in better
with the purpose of appendix B.6 as a quick reference for users who
have already familiarized themselves with text markup.

Regards,
Neil
___
lilypond-user mailing list
lilypond-user@gnu.org
http://lists.gnu.org/mailman/listinfo/lilypond-user


Re: GDP: Opinions sought on markup command snippets

2008-04-03 Thread Neil Puttock
Hi David,

On 02/04/2008, David Fedoruk <[EMAIL PROTECTED]> wrote:
> Hello:
>
>  In general I prefer the first option. However, may I propose a compromise?
>
>  I always find examples *in context* the most valuable. That said, it
>  is sometimes difficult to tell where the example command illustrated
>  and the surrounding context begin and leave off. If there were some
>  way of delineating these things it would be most helpful!
>
>  Thanx

In the case of musical examples, I'd tend to agree with you; but
surely the simplest method of delineating markup commands would be to
strip away all the extraneous material, thus providing a concise
demonstration of their properties?

Regards,
Neil


___
lilypond-user mailing list
lilypond-user@gnu.org
http://lists.gnu.org/mailman/listinfo/lilypond-user


Re: GDP: Opinions sought on markup command snippets

2008-04-03 Thread Trevor Bača
On Tue, Apr 1, 2008 at 3:55 PM, Neil Puttock <[EMAIL PROTECTED]> wrote:

> Hi everybody,
>
> I'm just about to start work on creating snippets for each of the
> \markup commands listed in appendix B.6.


Excellent! Embedded examples will be *extremely* useful ...




> Before I begin, I'd like to
> canvass opinion on how they should be demonstrated.
>
> As I see it, there are two options:
>
> 1. Continue in the same vein as the two existing examples (\raise and
> \super), where each command is part of a markup in a score;
>
> 2. Show each command in isolation, i.e., within a bald \markup block,
> displaying text marks only.
>
> Naturally, the latter option would be much quicker to implement, but
> is a more artificial way of demonstrating text markup since most users
> will be incorporating text into scores. It is also likely to look less
> pleasing than minimal score snippets, since they would serve as a
> regular break between the commands.
>
> I welcome your thoughts as to the best way forward.



My first thought was "stuff is, in general, almost always better with an
actual score example." But, clicking back through B.6 and rereading, I think
exactly the opposite conclusion is warranted here. I think the
examples-in-isolation approach (#2) will do perfectly. It seems that getting
LilyPond markup down has been, for me, a lot like getting LaTeX markup down
-- learn to visualize the *boxes* and slots that stuff fills. I haven't
really needed markup to attach to a staff to learn that lesson ... it's been
enough to work with examples in otherwise empty scores.

So I would vote for #2 as being the best option and likely to give the
cleanest look to B.6; it's gravy that #2 also happens to be quicker to
author!


Trevor.


-- 
Trevor Bača
[EMAIL PROTECTED]
___
lilypond-user mailing list
lilypond-user@gnu.org
http://lists.gnu.org/mailman/listinfo/lilypond-user


GDP: Opinions sought on markup command snippets

2008-04-01 Thread Neil Puttock
Hi everybody,

I'm just about to start work on creating snippets for each of the
\markup commands listed in appendix B.6. Before I begin, I'd like to
canvass opinion on how they should be demonstrated.

As I see it, there are two options:

1. Continue in the same vein as the two existing examples (\raise and
\super), where each command is part of a markup in a score;

2. Show each command in isolation, i.e., within a bald \markup block,
displaying text marks only.

Naturally, the latter option would be much quicker to implement, but
is a more artificial way of demonstrating text markup since most users
will be incorporating text into scores. It is also likely to look less
pleasing than minimal score snippets, since they would serve as a
regular break between the commands.

I welcome your thoughts as to the best way forward.

Regards,
Neil


___
lilypond-user mailing list
lilypond-user@gnu.org
http://lists.gnu.org/mailman/listinfo/lilypond-user