Re: correct usage of @funindex and friends
On Sat, Nov 22, 2008 at 10:08:51AM -, Trevor Daniels wrote:
>
> Graham Percival wrote Saturday, November 22, 2008 9:52 AM
>
>> That said, I'm not too certain what the distinction is between
>> "keyword" and "command"... and if *I'm* not certain, then we
>> definitely can't assume that the reader knows the difference. If
>> that difference matters at all in this case.
>
> Graham, try this:
>
> override = junk
> { a }
Ah, I see.
Cheers,
- Graham
___
lilypond-devel mailing list
lilypond-devel@gnu.org
http://lists.gnu.org/mailman/listinfo/lilypond-devel
Re: correct usage of @funindex and friends
Graham Percival wrote Saturday, November 22, 2008 9:52 AM
On Sat, Nov 22, 2008 at 09:27:18AM -, Trevor Daniels wrote:
The description of the contents of the Function index states that it
"lists all the LilyPond
commands and keywords". \foo is a command and foo is a keyword, so I am
now of
the view that both should appear in the function index.
I don't think that "foo" is a keyword. I'd say that "\foo" is a
command, and "r" or "c" is a keyword.
That said, I'm not too certain what the distinction is between
"keyword" and "command"... and if *I'm* not certain, then we
definitely can't assume that the reader knows the difference. If
that difference matters at all in this case.
Graham, try this:
override = junk
{ a }
Trevor
Cheers,
- Graham
___
lilypond-devel mailing list
lilypond-devel@gnu.org
http://lists.gnu.org/mailman/listinfo/lilypond-devel
Re: correct usage of @funindex and friends
On Sat, Nov 22, 2008 at 09:27:18AM -, Trevor Daniels wrote: > The description of the contents of the Function index states that it > "lists all the LilyPond > commands and keywords". \foo is a command and foo is a keyword, so I am > now of > the view that both should appear in the function index. I don't think that "foo" is a keyword. I'd say that "\foo" is a command, and "r" or "c" is a keyword. That said, I'm not too certain what the distinction is between "keyword" and "command"... and if *I'm* not certain, then we definitely can't assume that the reader knows the difference. If that difference matters at all in this case. Cheers, - Graham ___ lilypond-devel mailing list lilypond-devel@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-devel
Re: correct usage of @funindex and friends
Werner, Patrick Originally I opposed the @funindex foo form as being both redundant and misleading, but was out-voted (3 to 1). But on thinking about it again I have changed my mind, for the following reason. The description of the contents of the Function index states that it "lists all the LilyPond commands and keywords". \foo is a command and foo is a keyword, so I am now of the view that both should appear in the function index. Trevor - Original Message - From: "Patrick McCarty" <[EMAIL PROTECTED]> To: "Werner LEMBERG" <[EMAIL PROTECTED]> Cc: Sent: Friday, November 21, 2008 10:23 PM Subject: Re: correct usage of @funindex and friends Hi Werner, On Fri, Nov 21, 2008 at 2:07 AM, Werner LEMBERG <[EMAIL PROTECTED]> wrote: in the manual I often see both [EMAIL PROTECTED] foo' and [EMAIL PROTECTED] \foo'. IMHO, one of those forms is redundant. Which one? I'll walk over all such index entries and fix it accordingly, but I ask you to decide which form is the right one. I think the [EMAIL PROTECTED] foo' form is redundant, since the actual function/command names always begin with a backslash. However, I think it would be acceptable to use [EMAIL PROTECTED] foo' as well as the [EMAIL PROTECTED] \foo'. -Patrick ___ lilypond-devel mailing list lilypond-devel@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-devel ___ lilypond-devel mailing list lilypond-devel@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-devel
Re: correct usage of @funindex and friends
On Fri, Nov 21, 2008 at 11:07:29AM +0100, Werner LEMBERG wrote: > > in the manual I often see both [EMAIL PROTECTED] foo' and [EMAIL PROTECTED] > \foo'. > IMHO, one of those forms is redundant. Which one? I'll walk over all > such index entries and fix it accordingly, but I ask you to decide > which form is the right one. See discussion here: http://lists.gnu.org/archive/html/lilypond-user/2008-08/msg00063.html The answer appears to be "both". I don't think that's optimal, but people didn't seem to like the \command style only. :( Cheers, - Graham ___ lilypond-devel mailing list lilypond-devel@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-devel
Re: correct usage of @funindex and friends
Hi Werner, On Fri, Nov 21, 2008 at 2:07 AM, Werner LEMBERG <[EMAIL PROTECTED]> wrote: > > in the manual I often see both [EMAIL PROTECTED] foo' and [EMAIL PROTECTED] > \foo'. > IMHO, one of those forms is redundant. Which one? I'll walk over all > such index entries and fix it accordingly, but I ask you to decide > which form is the right one. I think the [EMAIL PROTECTED] foo' form is redundant, since the actual function/command names always begin with a backslash. However, I think it would be acceptable to use [EMAIL PROTECTED] foo' as well as the [EMAIL PROTECTED] \foo'. -Patrick ___ lilypond-devel mailing list lilypond-devel@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-devel
