From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Ethan Stefan Day Newsgroups: gmane.lisp.guile.bugs Subject: bug#22889: small fixes to guile manual Date: Wed, 2 Mar 2016 21:43:27 -0500 Message-ID: <56D7A4CF.4050209@ethan-stefan.net> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="r1I8cVqCjSU2iFNDH0RBuB2hwEkXXbUhP" X-Trace: ger.gmane.org 1456973370 18229 80.91.229.3 (3 Mar 2016 02:49:30 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 3 Mar 2016 02:49:30 +0000 (UTC) To: 22889@debbugs.gnu.org Original-X-From: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Thu Mar 03 03:49:18 2016 Return-path: Envelope-to: guile-bugs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1abJKE-0001lB-GO for guile-bugs@m.gmane.org; Thu, 03 Mar 2016 03:49:14 +0100 Original-Received: from localhost ([::1]:60154 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1abJKA-0005xc-RI for guile-bugs@m.gmane.org; Wed, 02 Mar 2016 21:49:10 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56302) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1abJK6-0005wS-4d for bug-guile@gnu.org; Wed, 02 Mar 2016 21:49:07 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1abJK2-0000P3-U0 for bug-guile@gnu.org; Wed, 02 Mar 2016 21:49:06 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:33032) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1abJK2-0000Oz-Q7 for bug-guile@gnu.org; Wed, 02 Mar 2016 21:49:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84) (envelope-from ) id 1abJK2-0003no-GI for bug-guile@gnu.org; Wed, 02 Mar 2016 21:49:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Ethan Stefan Day Original-Sender: "Debbugs-submit" Resent-CC: bug-guile@gnu.org Resent-Date: Thu, 03 Mar 2016 02:49:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 22889 X-GNU-PR-Package: guile X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-guile@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.145697330414567 (code B ref -1); Thu, 03 Mar 2016 02:49:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 3 Mar 2016 02:48:24 +0000 Original-Received: from localhost ([127.0.0.1]:58392 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1abJJQ-0003mt-2Y for submit@debbugs.gnu.org; Wed, 02 Mar 2016 21:48:24 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:36521) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1abJFc-0003gV-MT for submit@debbugs.gnu.org; Wed, 02 Mar 2016 21:44:29 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1abJFW-0007Rv-8L for submit@debbugs.gnu.org; Wed, 02 Mar 2016 21:44:23 -0500 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:50414) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1abJFW-0007Rq-4p for submit@debbugs.gnu.org; Wed, 02 Mar 2016 21:44:22 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:55725) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1abJFU-0005aW-Kh for bug-guile@gnu.org; Wed, 02 Mar 2016 21:44:22 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1abJFR-0007PD-C2 for bug-guile@gnu.org; Wed, 02 Mar 2016 21:44:20 -0500 Original-Received: from relay2-d.mail.gandi.net ([217.70.183.194]:37791) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1abJFR-0007P3-19 for bug-guile@gnu.org; Wed, 02 Mar 2016 21:44:17 -0500 Original-Received: from mfilter25-d.gandi.net (mfilter25-d.gandi.net [217.70.178.153]) by relay2-d.mail.gandi.net (Postfix) with ESMTP id 57370C5A4E for ; Thu, 3 Mar 2016 03:44:15 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at mfilter25-d.gandi.net Original-Received: from relay2-d.mail.gandi.net ([IPv6:::ffff:217.70.183.194]) by mfilter25-d.gandi.net (mfilter25-d.gandi.net [::ffff:10.0.15.180]) (amavisd-new, port 10024) with ESMTP id CJc8U68B-eKi for ; Thu, 3 Mar 2016 03:44:13 +0100 (CET) X-Originating-IP: 76.100.207.8 Original-Received: from [192.168.2.5] (c-76-100-207-8.hsd1.md.comcast.net [76.100.207.8]) (Authenticated sender: esday@ethan-stefan.net) by relay2-d.mail.gandi.net (Postfix) with ESMTPSA id 3660EC5A46 for ; Thu, 3 Mar 2016 03:44:12 +0100 (CET) X-Enigmail-Draft-Status: N1210 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101 Icedove/38.5.0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Mailman-Approved-At: Wed, 02 Mar 2016 21:48:23 -0500 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-guile@gnu.org List-Id: "Bug reports for GUILE, GNU's Ubiquitous Extension Language" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Original-Sender: bug-guile-bounces+guile-bugs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.lisp.guile.bugs:7971 Archived-At: This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --r1I8cVqCjSU2iFNDH0RBuB2hwEkXXbUhP Content-Type: multipart/mixed; boundary="------------010207020104050300020707" This is a multi-part message in MIME format. --------------010207020104050300020707 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable I fixed a few small problems I found in the Guile manual as I was reading it. I edited against the version I found here https://www.gnu.org/software/guile/manual/guile.texi.tar.gz at about 7pm EST on March 2, 2016. Most of the fixes are very small, but the thing with car in api-data.texi could really confuse someone learning scheme as one of their first programming languages. -Ethan Day --------------010207020104050300020707 Content-Type: text/x-patch; name="api-compound.texi.diff" Content-Transfer-Encoding: quoted-printable Content-Disposition: attachment; filename="api-compound.texi.diff" *** guile.texi/api-compound.texi 2014-03-16 18:43:13.000000000 -0400 --- modded-guile.texi/api-compound.texi 2016-03-02 20:49:47.324141170 -05= 00 *************** *** 1258,1271 **** is an ordinary array of rank 1 with lower bound 2 in dimension 0. =20 @item #2((1 2 3) (4 5 6)) ! is a non-uniform array of rank 2; a 3@cross{}3 matrix with index ranges= 0..2 and 0..2. =20 @item #u32(0 1 2) is a uniform u8 array of rank 1. =20 @item #2u32@@2@@3((1 2) (2 3)) ! is a uniform u8 array of rank 2 with index ranges 2..3 and 3..4. =20 @item #2() is a two-dimensional array with index ranges 0..-1 and 0..-1, i.e.@: --- 1258,1271 ---- is an ordinary array of rank 1 with lower bound 2 in dimension 0. =20 @item #2((1 2 3) (4 5 6)) ! is a non-uniform array of rank 2; a 2@cross{}3 matrix with index ranges= 0..1 and 0..2. =20 @item #u32(0 1 2) is a uniform u8 array of rank 1. =20 @item #2u32@@2@@3((1 2) (2 3)) ! is a uniform u32 array of rank 2 with index ranges 2..3 and 3..4. =20 @item #2() is a two-dimensional array with index ranges 0..-1 and 0..-1, i.e.@: *************** *** 2877,2883 **** @code{standard-vtable-fields}. =20 @defvr {Scheme Variable} standard-vtable-fields ! A string containing the orderedq set of fields that a vtable must have.= @end defvr =20 @defvr {Scheme Variable} vtable-offset-user --- 2877,2883 ---- @code{standard-vtable-fields}. =20 @defvr {Scheme Variable} standard-vtable-fields ! A string containing the ordered set of fields that a vtable must have. @end defvr =20 @defvr {Scheme Variable} vtable-offset-user --------------010207020104050300020707 Content-Type: text/x-patch; name="api-control.texi.diff" Content-Transfer-Encoding: quoted-printable Content-Disposition: attachment; filename="api-control.texi.diff" *** guile.texi/api-control.texi 2014-01-21 16:10:04.000000000 -0500 --- modded-guile.texi/api-control.texi 2016-03-02 21:03:46.840159015 -050= 0 *************** *** 168,174 **** (@var{test} @var{expression} @dots{}) @end lisp =20 ! where @var{test} and @var{expression} are arbitrary expression, or like= this =20 @lisp --- 168,174 ---- (@var{test} @var{expression} @dots{}) @end lisp =20 ! where @var{test} and @var{expression} are arbitrary expressions, or lik= e this =20 @lisp *************** *** 178,184 **** where @var{expression} must evaluate to a procedure. =20 The @var{test}s of the clauses are evaluated in order and as soon as on= e ! of them evaluates to a true values, the corresponding @var{expression}s= are evaluated in order and the last value is returned as the value of the @code{cond}-expression. For the @code{=3D>} clause type, @var{expression} is evaluated and the resulting procedure is applied to= --- 178,184 ---- where @var{expression} must evaluate to a procedure. =20 The @var{test}s of the clauses are evaluated in order and as soon as on= e ! of them evaluates to a true value, the corresponding @var{expression}s are evaluated in order and the last value is returned as the value of the @code{cond}-expression. For the @code{=3D>} clause type, @var{expression} is evaluated and the resulting procedure is applied to= *************** *** 893,899 **** @var{base}. =20 Currently this creates a list and passes it to @code{scm_values}, but w= e ! expect that in the future we will be able to use more a efficient representation. @end deftypefn =20 --- 893,899 ---- @var{base}. =20 Currently this creates a list and passes it to @code{scm_values}, but w= e ! expect that in the future we will be able to use a more efficient representation. @end deftypefn =20 --------------010207020104050300020707 Content-Type: text/x-patch; name="api-data.texi.diff" Content-Transfer-Encoding: quoted-printable Content-Disposition: attachment; filename="api-data.texi.diff" *** guile.texi/api-data.texi 2014-03-17 16:33:37.000000000 -0400 --- modded-guile.texi/api-data.texi 2016-03-02 21:07:44.900164075 -0500 *************** *** 1708,1714 **** =20 @deffn {Scheme Procedure} ash n count @deffnx {C Function} scm_ash (n, count) ! Return @math{floor(n * 2^count)}. @var{n} and @var{count} must be exact integers. =20 With @var{n} viewed as an infinite-precision twos-complement --- 1708,1714 ---- =20 @deffn {Scheme Procedure} ash n count @deffnx {C Function} scm_ash (n, count) ! Return @math{floor(n * 2^{count})}. @var{n} and @var{count} must be exact integers. =20 With @var{n} viewed as an infinite-precision twos-complement *************** *** 5096,5102 **** @lisp ;; 1=3Dred, 2=3Dgreen, 3=3Dpurple =20 ! (if (eq? (colour-of car) 1) ...) @end lisp =20 --- 5096,5102 ---- @lisp ;; 1=3Dred, 2=3Dgreen, 3=3Dpurple =20 ! (if (eq? (colour-of vehicle) 1) ...) @end lisp =20 *************** *** 5109,5115 **** (define green 2) (define purple 3) =20 ! (if (eq? (colour-of car) red) ...) @end lisp =20 --- 5109,5115 ---- (define green 2) (define purple 3) =20 ! (if (eq? (colour-of vehicle) red) ...) @end lisp =20 *************** *** 5118,5124 **** symbols whose names specify the colours that they refer to: =20 @lisp ! (if (eq? (colour-of car) 'red) ...) @end lisp =20 --- 5118,5124 ---- symbols whose names specify the colours that they refer to: =20 @lisp ! (if (eq? (colour-of vehicle) 'red) ...) @end lisp =20 *************** *** 5140,5154 **** manipulated as a list of symbols: =20 @lisp ! (properties-of car1) @result{} (red manual unleaded power-steering) =20 ! (if (memq 'power-steering (properties-of car1)) ! (display "Unfit people can drive this car.\n") ! (display "You'll need strong arms to drive this car!\n")) @print{} ! Unfit people can drive this car. @end lisp =20 Remember, the fundamental property of symbols that we are relying on --- 5140,5154 ---- manipulated as a list of symbols: =20 @lisp ! (properties-of vehicle1) @result{} (red manual unleaded power-steering) =20 ! (if (memq 'power-steering (properties-of vehicle1)) ! (display "Unfit people can drive this vehicle.\n") ! (display "You'll need strong arms to drive this vehicle!\n")) @print{} ! Unfit people can drive this vehicle. @end lisp =20 Remember, the fundamental property of symbols that we are relying on --------------010207020104050300020707-- --r1I8cVqCjSU2iFNDH0RBuB2hwEkXXbUhP Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 iQIcBAEBCAAGBQJW16T2AAoJEDSQ1AzyoFAjiAYP/jSXqd04+Wlm/z7ewZduzi3h +TXh9gtkVRJVh3YRSmErPeVxIVV5YDgi8IxKtoPV7ZEMrq+RgewwDDkdgiMDM411 K6EamP+xPZpZCtz/kUBJIrv/kZwSiXx5/DyhNpt/wQZ8vYb1uhUNYjGJ3IdnpfZi YP6P8N7C+7/C5zqseHBZykfQvQ42+KyWFSmeC8v6U6TpkJ39FxAbpfzNYHb8FQPL 0T2vFwN3oKTwWIgUjaKoERwTAbXF4QQydbfuF00RmChbV46C4VbjhuoqiGYeavx+ V8tVgDa/leZn//5OGAifxfNCsmmWOZHwxY2U9RLatHdW0H/496vAeXZX1rQDFdhJ IXYwBQeAO1EdaeH7DUY0aqyChyis+NvSgF+fRVHER1UMFmVXYELY/Jh5bkQtablr PGxjfHvjvoUN4d7nRTU0NKiwHbCoW4U5+eJsMchr3sFVoVR+YNo75WkKMWQbeE3H S8pemiBbXD8dHzM5k6P0ajwq5NFbQCojKoK0T59ErnGz6fUbM/GRsQWSeseJSFox O62gSZBTzgSSQ7fWGd6w3vguriouKqylP67MxkVBfFHwdvvD+FdTo+vuuMcudxCq YBmUoPsjN6bOSJ/zKrNmafG7Fo7yrUvQbd2jkCokAmCveWcJ/DkMsjHd/yX8tatk eB/mJnVk9OsMyyJqstWN =/q3T -----END PGP SIGNATURE----- --r1I8cVqCjSU2iFNDH0RBuB2hwEkXXbUhP--