GNU bug report logs - #10486
Patch: Fix case in identifiers starting sentences in doc/r5rs/r5rs.texi

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 10486 in the body.
You can then email your comments to 10486 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Bake Timmons <b3timmons <at> speedymail.org>
To: bug-guile <at> gnu.org
Subject: Patch: Fix case in identifiers starting sentences in
	doc/r5rs/r5rs.texi
Date: Thu, 12 Jan 2012 11:11:50 -0500

[Message part 1 (text/plain, inline)]

The GNU coding standards advise sticking with proper case for
identifiers, even if the identifier starts with a lowercase letter and
appears at the beginning of a sentence.

The Guile manual seems to follow this convention, with the exception of
r5rs.texi, hence the attached patch.

[0001-Fix-case-in-identifiers-starting-sentences-in-doc-r5.patch (text/x-diff, attachment)]

Message #10 received at 10486-done <at> debbugs.gnu.org (full text, mbox):

From: Andy Wingo <wingo <at> pobox.com>
To: b3timmons <at> speedymail.org
Cc: 10486-done <at> debbugs.gnu.org
Subject: Re: bug#10486: Patch: Fix case in identifiers starting sentences in
	doc/r5rs/r5rs.texi
Date: Thu, 02 Feb 2012 12:29:44 +0100

On Thu 12 Jan 2012 17:11, Bake Timmons <b3timmons <at> speedymail.org> writes:

> The GNU coding standards advise sticking with proper case for
> identifiers, even if the identifier starts with a lowercase letter and
> appears at the beginning of a sentence.
>
> The Guile manual seems to follow this convention, with the exception of
> r5rs.texi, hence the attached patch.

Applied, thanks.  Note that as R5RS is a historical document, we
probably won't be accepting textual changes to this file, though you
probably knew that already.

Andy
-- 
http://wingolog.org/

Message #13 received at 10486 <at> debbugs.gnu.org (full text, mbox):

From: Mark H Weaver <mhw <at> netris.org>
To: Bake Timmons <b3timmons <at> speedymail.org>
Cc: wingo <at> pobox.com, 10486 <at> debbugs.gnu.org
Subject: Re: bug#10486: Patch: Fix case in identifiers starting sentences in
	doc/r5rs/r5rs.texi
Date: Thu, 02 Feb 2012 09:30:42 -0500

Andy Wingo <wingo <at> pobox.com> writes:

> On Thu 12 Jan 2012 17:11, Bake Timmons <b3timmons <at> speedymail.org> writes:
>
>> The GNU coding standards advise sticking with proper case for
>> identifiers, even if the identifier starts with a lowercase letter and
>> appears at the beginning of a sentence.
>>
>> The Guile manual seems to follow this convention, with the exception of
>> r5rs.texi, hence the attached patch.
>
> Applied, thanks.  Note that as R5RS is a historical document, we
> probably won't be accepting textual changes to this file, though you
> probably knew that already.

Note that according to the R5RS, identifiers are not case sensitive, so
e.g. 'Let*' is no less correct than 'let*'.  In that context, it does
not make sense to say "the identifier starts with a lowercase letter".
Also, as Andy notes, it is an historical document.

I would advocate reverting this patch.

    Thanks,
      Mark

Message #16 received at 10486 <at> debbugs.gnu.org (full text, mbox):

From: ludo <at> gnu.org (Ludovic Courtès)
To: Mark H Weaver <mhw <at> netris.org>
Cc: Bake Timmons <b3timmons <at> speedymail.org>, 10486 <at> debbugs.gnu.org
Subject: Re: bug#10486: Patch: Fix case in identifiers starting sentences in
	doc/r5rs/r5rs.texi
Date: Thu, 02 Feb 2012 23:43:06 +0100

Hi,

Mark H Weaver <mhw <at> netris.org> skribis:

> Andy Wingo <wingo <at> pobox.com> writes:
>
>> On Thu 12 Jan 2012 17:11, Bake Timmons <b3timmons <at> speedymail.org> writes:
>>
>>> The GNU coding standards advise sticking with proper case for
>>> identifiers, even if the identifier starts with a lowercase letter and
>>> appears at the beginning of a sentence.
>>>
>>> The Guile manual seems to follow this convention, with the exception of
>>> r5rs.texi, hence the attached patch.
>>
>> Applied, thanks.  Note that as R5RS is a historical document, we
>> probably won't be accepting textual changes to this file, though you
>> probably knew that already.
>
> Note that according to the R5RS, identifiers are not case sensitive, so
> e.g. 'Let*' is no less correct than 'let*'.  In that context, it does
> not make sense to say "the identifier starts with a lowercase letter".
> Also, as Andy notes, it is an historical document.
>
> I would advocate reverting this patch.

Agreed.  I would consider r5rs.texi read-only.

Thanks,
Ludo’.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.