GNU bug report logs - #10481
Simple patches to Texinfo docs

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Andy Wingo <wingo <at> pobox.com>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#10481: closed (Simple patches to Texinfo docs)
Date: Thu, 02 Feb 2012 13:50:02 +0000

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

Your message dated Thu, 02 Feb 2012 12:17:25 +0100
with message-id <87ipjpo56i.fsf <at> pobox.com>
and subject line Re: bug#10481: Simple patches to Texinfo docs
has caused the debbugs.gnu.org bug report #10481,
regarding Simple patches to Texinfo docs
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
10481: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=10481
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Bake Timmons <b3timmons <at> speedymail.org>
To: bug-guile <at> gnu.org
Subject: Simple patches to Texinfo docs
Date: Wed, 11 Jan 2012 13:08:14 -0500

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

Hi,

Months ago I proposed some improvements to the manual.  With a gentle
reminder from Andy Wingo, I have finally started breaking up my original
giant patch into some manageable patches.  The first patch is nearly
trivial, and the second is simple changes to many files.

The second patch tries to make the usage of variable names more
consistent and goes after simple, blatant cases.  A hypothetical
example is

@deffn {Scheme Procedure} bitvector-ref vec idx
@deffnx {C Function} scm_bitvector_ref (vec, idx)
Return the element at index @var{idx} of the bit vector
@var{vector}.
@end deffn

We change "vector" to "vec" or vice versa.  There are a few cases where
names that are consistently used *within* a definition are still changed
to conform with usage in surrounding function definitions.

One way I plan to shorten patches is based on the kind of files to be
patched, .texinfo, .scm, .c, etc.  Thus, the next patches I will send
will be similar changes for docstrings in .scm and .c files.

Thanks for any comments!

Bake

[0001-Fix-unbalanced-parentheses-in-docs.patch (text/x-diff, attachment)]

[0001-Make-consistent-the-usage-of-variable-names-in-the.patch (text/x-diff, attachment)]

[Message part 6 (message/rfc822, inline)]

From: Andy Wingo <wingo <at> pobox.com>
To: b3timmons <at> speedymail.org
Cc: 10481-done <at> debbugs.gnu.org
Subject: Re: bug#10481: Simple patches to Texinfo docs
Date: Thu, 02 Feb 2012 12:17:25 +0100

On Wed 11 Jan 2012 19:08, Bake Timmons <b3timmons <at> speedymail.org> writes:

> Months ago I proposed some improvements to the manual.  With a gentle
> reminder from Andy Wingo, I have finally started breaking up my original
> giant patch into some manageable patches.

Thank you!  I applied both of these patches.  Sorry we didn't get around
to it until after the release; things were a bit hectic.

Cheers,

Andy
-- 
http://wingolog.org/

Previous Next

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