[PATCH] Some fixes to doc/ref/scheme-data.texi

[PATCH] Some fixes to doc/ref/scheme-data.texi

[Stephen Compall]

So I was reading my printed copy of the Guile reference manual from CVS, 
and hit chapter 18 in a desire to be able to do more with Guile data 
than list and vector ops. Got a notebook, made some notes about what I 
thought could be changed in the manual itself. So here are some fixes to 
the first part of that chapter.

My ChangeLog entry:

2002-10-26  Stephen Compall  <rushing@sigecom.net>

	* scheme-data.texi: Addition and change of many Texinfo tags,
	particularly usage of @var and @samp, as well as reformatting of
	some lists into tables and usage of @result.

	Notes about some things I didn't understand, as well as a
	missing section on non-control characters.

I avoided rewrapping paragraphs in some cases so the patch would be 
easier to read, unless the lines became *way* too long.

I imagine that some of the things I changed might have been 
automatically placed there, with sources somewhere else. So forgive me 
for not changing those sources, if this is so.

The diff -u against CVS HEAD is ~28kb, and is currently available at 
http://csserver.evansville.edu/~sc87/scheme-data-1S11.patch

It has been tested against makeinfo 4.2 and TeX.

-- 
Stephen Compall
Also known as S11001001
DotGNU `Contributor' -- http://dotgnu.org

The GNU GPL is not Mr. Nice Guy. It says "no" to some of the things
that people sometimes want to do.
	-- RMS, "Copyleft: Pragmatic Idealism"



_______________________________________________
Bug-guile mailing list
Bug-guile@gnu.org
http://mail.gnu.org/mailman/listinfo/bug-guile

Re: [PATCH] Some fixes to doc/ref/scheme-data.texi

[Thien-Thi Nguyen]

   From: Stephen Compall <rushing@sigecom.net>
   Date: Sat, 26 Oct 2002 16:11:41 -0500

   2002-10-26  Stephen Compall  <rushing@sigecom.net>

	   * scheme-data.texi: Addition and change of many Texinfo tags,
	   particularly usage of @var and @samp, as well as reformatting of
	   some lists into tables and usage of @result.

	   Notes about some things I didn't understand, as well as a
	   missing section on non-control characters.

   http://csserver.evansville.edu/~sc87/scheme-data-1S11.patch

the changelog entry neglects to mention some incorrect replacements of
"iff" w/ "if".  the former is a notational shorthand for "if and only
if" (see node "Manual Conventions").  could you correct these and post
another patch?

thi


_______________________________________________
Bug-guile mailing list
Bug-guile@gnu.org
http://mail.gnu.org/mailman/listinfo/bug-guile

Updated [PATCH] Some fixes to doc/ref/scheme-data.texi

[Stephen Compall]

Thien-Thi Nguyen wrote:
>    http://csserver.evansville.edu/~sc87/scheme-data-1S11.patch
> 
> the changelog entry neglects to mention some incorrect replacements of
> "iff" w/ "if".  the former is a notational shorthand for "if and only
> if" (see node "Manual Conventions").  could you correct these and post
> another patch?

Have done. /me foolishly overlooked (guile)Manual Conventions, and drew 
mental connection to "many typos of if."? :-S

http://csserver.evansville.edu/~sc87/scheme-data-2S11.patch

-- 
Stephen Compall
Also known as S11001001
DotGNU `Contributor' -- http://dotgnu.org

If people don't have to build, they can just snap their fingers and
duplicate them, that's wonderful. But this change in technology
doesn't suit the people who wants to be able to own individual copies
and can get money for individual copies. That's an idea that only fits
conserved objects. So they do their best to render programs like
material objects. Have you wondered why, when you go to the software
store and buy a copy of a program it comes in something that looks
like a book?  They want people to think as if they were getting a
material object, not to realize what they have really got in the form
of digital copyable data.
	-- RMS, Lecture at KTH (Sweden), 30 October 1986



_______________________________________________
Bug-guile mailing list
Bug-guile@gnu.org
http://mail.gnu.org/mailman/listinfo/bug-guile

Re: Updated [PATCH] Some fixes to doc/ref/scheme-data.texi

[Thien-Thi Nguyen]

   From: Stephen Compall <rushing@sigecom.net>
   Date: Sun, 27 Oct 2002 19:48:53 -0600

   Have done. /me foolishly overlooked (guile)Manual Conventions, and
   drew mental connection to "many typos of if."? :-S

no worries.

   http://csserver.evansville.edu/~sc87/scheme-data-2S11.patch

thanks.  looks like it's time for me to re-read the texinfo manual -- i
didn't realize there was @math and @acronym.

thi


_______________________________________________
Bug-guile mailing list
Bug-guile@gnu.org
http://mail.gnu.org/mailman/listinfo/bug-guile

Re: Updated [PATCH] Some fixes to doc/ref/scheme-data.texi

[Neil Jerram]

>>>>> "Stephen" == Stephen Compall <rushing@sigecom.net> writes:

    Stephen> Thien-Thi Nguyen wrote:
    >> http://csserver.evansville.edu/~sc87/scheme-data-1S11.patch
    >> the changelog entry neglects to mention some incorrect replacements
    >> of
    >> "iff" w/ "if".  the former is a notational shorthand for "if and only
    >> if" (see node "Manual Conventions").  could you correct these and post
    >> another patch?

    Stephen> Have done. /me foolishly overlooked (guile)Manual Conventions, and
    Stephen> drew mental connection to "many typos of if."? :-S

    Stephen> http://csserver.evansville.edu/~sc87/scheme-data-2S11.patch

Hi Stephen

Sorry for not replying more quickly...  I plan to apply this to Guile
CVS (unstable and, where applicable, stable) sometime in the next
week.

Does the patch include any chunks of new text that are big enough for
us to need papers from you?

        Neil



_______________________________________________
Bug-guile mailing list
Bug-guile@gnu.org
http://mail.gnu.org/mailman/listinfo/bug-guile

Re: Updated [PATCH] Some fixes to doc/ref/scheme-data.texi

[Stephen Compall]

Neil Jerram wrote:
> Sorry for not replying more quickly...  I plan to apply this to Guile
> CVS (unstable and, where applicable, stable) sometime in the next
> week.
> 
> Does the patch include any chunks of new text that are big enough for
> us to need papers from you?

No. a.k.a., I sure hope they don't give copyright for what I did... :)

It's just a load of new Texinfo tagging, TeX quote fixes, etc. I'm using 
the book to learn Guile/Scheme, so I don't have anything to add at this 
time, other than some notes about things I felt were missing. (Like, 
what are traps anyway? 8-)

Occasionally, when reading a printed free book, I grab a pen & paper and 
write down some fixes. If/when I do this again, I'll pass along the results.

-- 
Stephen Compall
Also known as S11001001
DotGNU `Contributor' -- http://dotgnu.org

Of course, I love the Free Software community and am an active member
of it. However, there was always one aspect of our community that
didn't sit right with me: the idea that you had to "prove your hacker
credentials" to be taken seriously.
	-- Bradley Kuhn



_______________________________________________
Bug-guile mailing list
Bug-guile@gnu.org
http://mail.gnu.org/mailman/listinfo/bug-guile