Re: markup{} vs TextScript

[Stephen]

That is a hard one because they are both accurate terms in their own right, 
but they stem from different sources or contexts. I think maybe markup is a 
false analogy and textscript is a bit more literal. Still, I am no expert 
and I suspect both terms are equally accurate and descriptive, which is my 
criterion for choosing names.

The important thing is making it clear that changing TextScript properties 
will affect anything created with \markup. Which just adding the link would 
do. Changing \markup to \text or \textscript might make things more clear in 
most contexts, but I am not sure. Anyway, that is the way I would go with 
it. As I see it the issue is is there a difference between text and markup 
text or is it all just text? I suspect it is all just text and the term 
'markup is unnecessary.

The first sentence in 5.7.5 Text scripts is:

It is possible to place arbitrary strings of text or markup text (see Text 
markup) above or below notes by using a string c^"text".

'text or markup text'? If there is any distiction between these two things, 
I am all for keeping both terms, otherwise I think 'markup' could easily be 
dropped. That is the kind of sentence that I keep in the back of my brain, 
until I figure out whether there really is a distiction between the two and 
what it is.

Stephen

----- Original Message ----- 
From: "Graham Percival" <address@hidden>
To: "Stephen" <address@hidden>
Cc: "lilypond devel" <address@hidden>
Sent: Tuesday, May 10, 2005 10:44 PM
Subject: markup{} vs TextScript


> On 10-May-05, at 10:16 AM, Stephen wrote:
>
> > Thinking about it even more, I realise that having a link to TextScript 
> > in the programming reference somewhere under 7.4 Text markup instead of 
> > just under 5.7.5 Text scripts to make up for the confusion in terminology 
> > that Text script and Text markup are two terms that basically describe 
> > the same thing.
>
> Thanks, this is a useful report.  Fixed in CVS.
>
> I can (and will) certainly update the docs to reflect this, but would it 
> be possible
> to standardize the lilypond internals?  Could "TextScript" be renamed to
> "TextMarkup" and "TextScriptEvent" be renamed to "TextMarkupEvent" ?
> I think that's a better solution than renaming \markup{} to \script{}.
>
> Cheers,
> - Graham