From debbugs-submit-bounces@debbugs.gnu.org Thu Jan 12 11:13:09 2012 Received: (at submit) by debbugs.gnu.org; 12 Jan 2012 16:13:09 +0000 Received: from localhost ([127.0.0.1]:55266 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RlNH1-0005aF-Jh for submit@debbugs.gnu.org; Thu, 12 Jan 2012 11:13:09 -0500 Received: from eggs.gnu.org ([140.186.70.92]:34488) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from <42toes@gmail.com>) id 1RlNGx-0005a5-HX for submit@debbugs.gnu.org; Thu, 12 Jan 2012 11:13:06 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from <42toes@gmail.com>) id 1RlNGK-0004n2-9U for submit@debbugs.gnu.org; Thu, 12 Jan 2012 11:12:31 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-2.6 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_LOW,T_DKIM_INVALID autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([140.186.70.17]:58485) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <42toes@gmail.com>) id 1RlNGK-0004my-7e for submit@debbugs.gnu.org; Thu, 12 Jan 2012 11:12:24 -0500 Received: from eggs.gnu.org ([140.186.70.92]:50630) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from <42toes@gmail.com>) id 1RlNGB-0005GJ-M3 for bug-guile@gnu.org; Thu, 12 Jan 2012 11:12:24 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from <42toes@gmail.com>) id 1RlNG0-0004kd-EX for bug-guile@gnu.org; Thu, 12 Jan 2012 11:12:15 -0500 Received: from mail-qy0-f169.google.com ([209.85.216.169]:55945) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <42toes@gmail.com>) id 1RlNG0-0004kU-7V for bug-guile@gnu.org; Thu, 12 Jan 2012 11:12:04 -0500 Received: by qcsd17 with SMTP id d17so1320532qcs.0 for ; Thu, 12 Jan 2012 08:12:04 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=sender:from:to:subject:reply-to:date:message-id:user-agent :mime-version:content-type; bh=pEPjxIAsRinJjOADvVmrNJSGK3wXpzXbJWAlOtm2kuY=; b=EjplylcyGrvd9ZiL+T7nvt7S2HZ0JbRZP64zdd847C8aZxdOP6I9giDUC/wNsoeiYa d4r20HZQAomRg/JyG5Clk8o3d1s7GHNyL9C47DdZC9LCziFqNMcfbERrrjP6ab1E3mDH QHozRelR5SdBh4y0zRznSy6XJIdmsZfzI8S0Y= Received: by 10.224.109.7 with SMTP id h7mr6715503qap.9.1326384723951; Thu, 12 Jan 2012 08:12:03 -0800 (PST) Received: from goof.localdomain (dialup-4.248.33.82.Dial1.Washington2.Level3.net. [4.248.33.82]) by mx.google.com with ESMTPS id eb5sm10832458qab.10.2012.01.12.08.11.54 (version=TLSv1/SSLv3 cipher=OTHER); Thu, 12 Jan 2012 08:12:03 -0800 (PST) Received: by goof.localdomain (Postfix, from userid 1000) id D59E5800E0; Thu, 12 Jan 2012 11:11:50 -0500 (EST) From: Bake Timmons To: bug-guile@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-ID: <87pqeoj3y1.fsf@goof.localdomain> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.92 (gnu/linux) MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.17 X-Spam-Score: -3.4 (---) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list Reply-To: b3timmons@speedymail.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -3.4 (---) --=-=-= Content-Type: text/plain 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. --=-=-= Content-Type: text/x-diff Content-Disposition: attachment; filename=0001-Fix-case-in-identifiers-starting-sentences-in-doc-r5.patch Content-Description: Fix case in identifiers starting sentences in doc/r5rs/r5rs.texi >From 811ad499dee562bc2fe89fa930ad412102bd5a90 Mon Sep 17 00:00:00 2001 From: Bake Timmons Date: Thu, 12 Jan 2012 10:45:28 -0500 Subject: [PATCH] Fix case in identifiers starting sentences in doc/r5rs/r5rs.texi * doc/r5rs/r5rs.texi: Use proper case of characters in identifiers starting sentences. --- doc/r5rs/r5rs.texi | 124 ++++++++++++++++++++++++++-------------------------- 1 files changed, 62 insertions(+), 62 deletions(-) diff --git a/doc/r5rs/r5rs.texi b/doc/r5rs/r5rs.texi index a71755b..336ce0a 100644 --- a/doc/r5rs/r5rs.texi +++ b/doc/r5rs/r5rs.texi @@ -2155,7 +2155,7 @@ and @r{} should be a sequence of one or more expressions. @emph{Semantics:} -@samp{Let*} is similar to @samp{let}, but the bindings are performed +@samp{let*} is similar to @samp{let}, but the bindings are performed sequentially from left to right, and the region of a binding indicated @cindex @w{region} by @samp{(@r{} @r{})} is that part of the @samp{let*} @@ -2271,12 +2271,12 @@ output. @deffn {library syntax} do ((@r{} @r{} @r{}) @dots{}) (@r{} @r{} @dots{}) @r{} @dots{} @cindex @w{do} -@samp{Do} is an iteration construct. It specifies a set of variables to +@samp{do} is an iteration construct. It specifies a set of variables to be bound, how they are to be initialized at the start, and how they are to be updated on each iteration. When a termination condition is met, the loop exits after evaluating the @r{}s. -@samp{Do} expressions are evaluated as follows: +@samp{do} expressions are evaluated as follows: The @r{} expressions are evaluated (in some unspecified order), the @r{}s are bound to fresh locations, the results of the @r{} expressions are stored in the bindings of the @@ -2595,7 +2595,7 @@ bindings that may surround the use of the macro. -@samp{Let-syntax} and @samp{letrec-syntax} are +@samp{let-syntax} and @samp{letrec-syntax} are analogous to @samp{let} and @samp{letrec}, but they bind syntactic keywords to macro transformers instead of binding variables to locations that contain values. Syntactic keywords may also be @@ -3254,7 +3254,7 @@ value (@t{#t} or @t{#f}). An @dfn{equivalence predicate} is the computational analogue of a mathematical equivalence relation (it is symmetric, reflexive, and transitive). Of the equivalence predicates described in this section, @samp{eq?} is the finest or most -discriminating, and @samp{equal?} is the coarsest. @samp{Eqv?} is +discriminating, and @samp{equal?} is the coarsest. @samp{eqv?} is slightly less discriminating than @samp{eq?}. @ignore todo Pitman doesn't like @@ -3419,9 +3419,9 @@ boolean. The next set of examples shows the use of @samp{eqv?} with procedures -that have local state. @samp{Gen-counter} must return a distinct +that have local state. @samp{gen-counter} must return a distinct procedure every time, since each procedure has its own internal counter. -@samp{Gen-loser}, however, returns equivalent procedures each time, since +@samp{gen-loser}, however, returns equivalent procedures each time, since the local state does not affect the value or side effects of the procedures. @@ -3500,17 +3500,17 @@ bit pattern to represent both. @deffn {procedure} eq? obj1 obj2 -@samp{Eq?} is similar to @samp{eqv?} except that in some cases it is +@samp{eq?} is similar to @samp{eqv?} except that in some cases it is capable of discerning distinctions finer than those detectable by @samp{eqv?}. -@samp{Eq?} and @samp{eqv?} are guaranteed to have the same +@samp{eq?} and @samp{eqv?} are guaranteed to have the same behavior on symbols, booleans, the empty list, pairs, procedures, and non-empty -strings and vectors. @samp{Eq?}'s behavior on numbers and characters is +strings and vectors. @samp{eq?}'s behavior on numbers and characters is implementation-dependent, but it will always return either true or false, and will return true only when @samp{eqv?} would also return -true. @samp{Eq?} may also behave differently from @samp{eqv?} on empty +true. @samp{eq?} may also behave differently from @samp{eqv?} on empty vectors and empty strings. @@ -3549,7 +3549,7 @@ more efficiently than @samp{eqv?}, for example, as a simple pointer comparison instead of as some more complicated operation. One reason is that it may not be possible to compute @samp{eqv?} of two numbers in constant time, whereas @samp{eq?} implemented as pointer comparison will -always finish in constant time. @samp{Eq?} may be used like @samp{eqv?} +always finish in constant time. @samp{eq?} may be used like @samp{eqv?} in applications using procedures to implement objects with state since it obeys the same constraints as @samp{eqv?}. @end quotation @@ -3561,10 +3561,10 @@ it obeys the same constraints as @samp{eqv?}. @deffn {library procedure} equal? obj1 obj2 -@samp{Equal?} recursively compares the contents of pairs, vectors, and +@samp{equal?} recursively compares the contents of pairs, vectors, and strings, applying @samp{eqv?} on other objects such as numbers and symbols. A rule of thumb is that objects are generally @samp{equal?} if they print -the same. @samp{Equal?} may fail to terminate if its arguments are +the same. @samp{equal?} may fail to terminate if its arguments are circular data structures. @@ -4211,7 +4211,7 @@ however, they return the additive or multiplicative inverse of their argument. @deffn {library procedure} abs x -@samp{Abs} returns the absolute value of its argument. +@samp{abs} returns the absolute value of its argument. @c - {\cf Abs} is exactness preserving when its argument is real. @format @@ -4344,17 +4344,17 @@ More description and examples needed. These procedures return integers. -@samp{Floor} returns the largest integer not larger than @var{x}. -@samp{Ceiling} returns the smallest integer not smaller than @var{x}. -@samp{Truncate} returns the integer closest to @var{x} whose absolute -value is not larger than the absolute value of @var{x}. @samp{Round} returns the +@samp{floor} returns the largest integer not larger than @var{x}. +@samp{ceiling} returns the smallest integer not smaller than @var{x}. +@samp{truncate} returns the integer closest to @var{x} whose absolute +value is not larger than the absolute value of @var{x}. @samp{tound} returns the closest integer to @var{x}, rounding to even when @var{x} is halfway between two integers. @quotation @emph{Rationale:} -@samp{Round} rounds to even for consistency with the default rounding +@samp{round} rounds to even for consistency with the default rounding mode specified by the IEEE floating point standard. @end quotation @@ -4393,7 +4393,7 @@ result should be passed to the @samp{inexact->exact} procedure. @c - \proto{rationalize}{ x}{procedure} -@samp{Rationalize} returns the @emph{simplest} rational number +@samp{rationalize} returns the @emph{simplest} rational number differing from @var{x} by no more than @var{y}. A rational number r_1 is @emph{simpler} than another rational number @cindex @w{simplest rational} @@ -4556,7 +4556,7 @@ for some integer n. @quotation @emph{Rationale:} -@samp{Magnitude} is the same as @code{abs} for a real argument, +@samp{magnitude} is the same as @code{abs} for a real argument, @vindex @w{abs} but @samp{abs} must be present in all implementations, whereas @samp{magnitude} need only be present in implementations that support @@ -4571,7 +4571,7 @@ general complex numbers. @deffn {procedure} exact->inexact @var{z} @deffnx {procedure} inexact->exact @var{z} -@samp{Exact->inexact} returns an @r{inexact} representation of @var{z}. +@samp{exact->inexact} returns an @r{inexact} representation of @var{z}. The value returned is the @r{inexact} number that is numerically closest to the argument. @c %R4%%For @@ -4580,7 +4580,7 @@ The value returned is the If an @r{exact} argument has no reasonably close @r{inexact} equivalent, then a violation of an implementation restriction may be reported. -@samp{Inexact->exact} returns an @r{exact} representation of +@samp{inexact->exact} returns an @r{exact} representation of @var{z}. The value returned is the @r{exact} number that is numerically closest to the argument. @c %R4%% For \tupe{inexact} arguments which have no @@ -4695,7 +4695,7 @@ returns @t{#f}. @quotation @emph{Note:} The domain of @samp{string->number} may be restricted by implementations -in the following ways. @samp{String->number} is permitted to return +in the following ways. @samp{string->number} is permitted to return @t{#f} whenever @var{string} contains an explicit radix prefix. If all numbers supported by an implementation are real, then @samp{string->number} is permitted to return @t{#f} whenever @@ -4802,7 +4802,7 @@ in programs. @deffn {library procedure} not obj -@samp{Not} returns @t{#t} if @var{obj} is false, and returns +@samp{not} returns @t{#t} if @var{obj} is false, and returns @t{#f} otherwise. @@ -4824,7 +4824,7 @@ in programs. @deffn {library procedure} boolean? obj -@samp{Boolean?} returns @t{#t} if @var{obj} is either @t{#t} or +@samp{boolean?} returns @t{#t} if @var{obj} is either @t{#t} or @t{#f} and returns @t{#f} otherwise. @@ -5011,7 +5011,7 @@ parse Scheme programs. See section @ref{External representations}. @deffn {procedure} pair? obj -@samp{Pair?} returns @t{#t} if @var{obj} is a pair, and otherwise +@samp{pair?} returns @t{#t} if @var{obj} is a pair, and otherwise returns @t{#f}. @@ -5295,7 +5295,7 @@ in reverse order. Returns the sublist of @var{list} obtained by omitting the first @var{k} elements. It is an error if @var{list} has fewer than @var{k} elements. -@samp{List-tail} could be defined by +@samp{list-tail} could be defined by @format @@ -5356,7 +5356,7 @@ These procedures return the first sublist of @var{list} whose car is returned by @t{(list-tail @var{list} @var{k})} for @var{k} less than the length of @var{list}. If @var{obj} does not occur in @var{list}, then @t{#f} (not the empty list) is -returned. @samp{Memq} uses @samp{eq?} to compare @var{obj} with the elements of +returned. @samp{memq} uses @samp{eq?} to compare @var{obj} with the elements of @var{list}, while @samp{memv} uses @samp{eqv?} and @samp{member} uses @samp{equal?}. @@ -5384,7 +5384,7 @@ returned. @samp{Memq} uses @samp{eq?} to compare @var{obj} with the elements of @var{alist} (for ``association list'') must be a list of pairs. These procedures find the first pair in @var{alist} whose car field is @var{obj}, and returns that pair. If no pair in @var{alist} has @var{obj} as its -car, then @t{#f} (not the empty list) is returned. @samp{Assq} uses +car, then @t{#f} (not the empty list) is returned. @samp{assq} uses @samp{eq?} to compare @var{obj} with the car fields of the pairs in @var{alist}, while @samp{assv} uses @samp{eqv?} and @samp{assoc} uses @samp{equal?}. @@ -5830,7 +5830,7 @@ Returns @t{#t} if @var{obj} is a string, otherwise returns @t{#f}. @c \domain{\vr{k} must be a non-negative integer, and \var{char} must be @c a character.} -@samp{Make-string} returns a newly allocated string of length @var{k}. +@samp{make-string} returns a newly allocated string of length @var{k}. If @var{char} is given, then all elements of the string are initialized to @var{char}, otherwise the contents of the string are unspecified. @@ -5854,7 +5854,7 @@ Returns the number of characters in the given @var{string}. @deffn {procedure} string-ref string @var{k} @var{k} must be a valid index of @var{string}. -@samp{String-ref} returns character @var{k} of @var{string} using zero-origin indexing. +@samp{string-ref} returns character @var{k} of @var{string} using zero-origin indexing. @end deffn @@ -5866,7 +5866,7 @@ Returns the number of characters in the given @var{string}. @var{k} must be a valid index of @var{string} @c , and \var{char} must be a character . -@samp{String-set!} stores @var{char} in element @var{k} of @var{string} +@samp{string-set!} stores @var{char} in element @var{k} of @var{string} and returns an unspecified value. @c @@ -5892,7 +5892,7 @@ and returns an unspecified value. Returns @t{#t} if the two strings are the same length and contain the same characters in the same positions, otherwise returns @t{#f}. -@samp{String-ci=?} treats +@samp{string-ci=?} treats upper and lower case letters as though they were the same character, but @samp{string=?} treats upper and lower case as distinct characters. @@ -5932,7 +5932,7 @@ must be exact integers satisfying @center 0 <= @var{start} <= @var{end} <= @w{@t{(string-length @var{string})@r{.}}} -@samp{Substring} returns a newly allocated string formed from the characters of +@samp{substring} returns a newly allocated string formed from the characters of @var{string} beginning with index @var{start} (inclusive) and ending with index @var{end} (exclusive). @end deffn @@ -5951,10 +5951,10 @@ given strings. @deffn {library procedure} string->list string @deffnx {library procedure} list->string list -@samp{String->list} returns a newly allocated list of the -characters that make up the given string. @samp{List->string} +@samp{string->list} returns a newly allocated list of the +characters that make up the given string. @samp{list->string} returns a newly allocated string formed from the characters in the list -@var{list}, which must be a list of characters. @samp{String->list} +@var{list}, which must be a list of characters. @samp{string->list} and @samp{list->string} are inverses so far as @samp{equal?} is concerned. @c Implementations that provide @@ -6077,7 +6077,7 @@ Returns the number of elements in @var{vector} as an exact integer. @deffn {procedure} vector-ref vector k @var{k} must be a valid index of @var{vector}. -@samp{Vector-ref} returns the contents of element @var{k} of +@samp{vector-ref} returns the contents of element @var{k} of @var{vector}. @@ -6101,7 +6101,7 @@ Returns the number of elements in @var{vector} as an exact integer. @deffn {procedure} vector-set! vector k obj @var{k} must be a valid index of @var{vector}. -@samp{Vector-set!} stores @var{obj} in element @var{k} of @var{vector}. +@samp{vector-set!} stores @var{obj} in element @var{k} of @var{vector}. The value returned by @samp{vector-set!} is unspecified. @c @@ -6124,8 +6124,8 @@ The value returned by @samp{vector-set!} is unspecified. @deffn {library procedure} vector->list vector @deffnx {library procedure} list->vector list -@samp{Vector->list} returns a newly allocated list of the objects contained -in the elements of @var{vector}. @samp{List->vector} returns a newly +@samp{vector->list} returns a newly allocated list of the objects contained +in the elements of @var{vector}. @samp{list->vector} returns a newly created vector initialized to the elements of the list @var{list}. @@ -6215,13 +6215,13 @@ arguments. -@deffn {library procedure} map proc list1 list2 @dots{}, +@deffn {library procedure} map proc list1 list2 @dots{} The @var{list}s must be lists, and @var{proc} must be a procedure taking as many arguments as there are @i{list}s and returning a single value. If more than one @var{list} is given, then they must all be the same length. -@samp{Map} applies @var{proc} element-wise to the elements of the +@samp{map} applies @var{proc} element-wise to the elements of the @var{list}s and returns a list of the results, in order. The dynamic order in which @var{proc} is applied to the elements of the @var{list}s is unspecified. @@ -6308,7 +6308,7 @@ time, the previously computed value is returned. @end format -@samp{Force} and @samp{delay} are mainly intended for programs written in +@samp{force} and @samp{delay} are mainly intended for programs written in functional style. The following examples should not be considered to illustrate good programming style, but they illustrate the property that only one value is computed for a promise, no matter how many times it is @@ -6545,7 +6545,7 @@ the answer to the top level continuation to be printed. Normally these ubiquitous continuations are hidden behind the scenes and programmers do not think much about them. On rare occasions, however, a programmer may need to deal with continuations explicitly. -@samp{Call-with-current-continuation} allows Scheme programmers to do +@samp{call-with-current-continuation} allows Scheme programmers to do that by creating a procedure that acts just like the current continuation. @@ -6733,10 +6733,10 @@ allowed to create new bindings in the environments associated with @var{version} must be the exact integer @samp{5}, corresponding to this revision of the Scheme report (the Revised^5 Report on Scheme). -@samp{Scheme-report-environment} returns a specifier for an +@samp{scheme-report-environment} returns a specifier for an environment that is empty except for all bindings defined in this report that are either required or both optional and -supported by the implementation. @samp{Null-environment} returns +supported by the implementation. @samp{null-environment} returns a specifier for an environment that is empty except for the (syntactic) bindings for all syntactic keywords defined in this report that are either required or both optional and @@ -6875,7 +6875,7 @@ connected to it is made the default value returned by and the @var{thunk} is called with no arguments. When the @var{thunk} returns, the port is closed and the previous default is restored. -@samp{With-input-from-file} and @samp{with-output-to-file} return(s) the +@samp{with-input-from-file} and @samp{with-output-to-file} return(s) the value(s) yielded by @var{thunk}. If an escape procedure is used to escape from the continuation of these procedures, their @@ -6968,10 +6968,10 @@ The input routines have some things in common, maybe explain here. @deffn {library procedure} read @deffnx {library procedure} read port -@samp{Read} converts external representations of Scheme objects into the +@samp{read} converts external representations of Scheme objects into the objects themselves. That is, it is a parser for the nonterminal (see sections @pxref{External representation} and -@pxref{Pairs and lists}). @samp{Read} returns the next +@pxref{Pairs and lists}). @samp{read} returns the next object parsable from the given input @var{port}, updating @var{port} to point to the first character past the end of the external representation of the object. @@ -7055,7 +7055,7 @@ the value returned by @samp{current-input-port}. @quotation @emph{Rationale:} -@samp{Char-ready?} exists to make it possible for a program to +@samp{char-ready?} exists to make it possible for a program to accept characters from interactive ports without getting stuck waiting for input. Any input editors associated with such ports must ensure that characters whose existence has been asserted by @samp{char-ready?} cannot @@ -7087,7 +7087,7 @@ that appear in the written representation are enclosed in doublequotes, and within those strings backslash and doublequote characters are escaped by backslashes. Character objects are written using the @samp{#\} notation. -@samp{Write} returns an unspecified value. The +@samp{write} returns an unspecified value. The @var{port} argument may be omitted, in which case it defaults to the value returned by @samp{current-output-port}. @@ -7102,14 +7102,14 @@ Writes a representation of @var{obj} to the given @var{port}. Strings that appear in the written representation are not enclosed in doublequotes, and no characters are escaped within those strings. Character objects appear in the representation as if written by @samp{write-char} -instead of by @samp{write}. @samp{Display} returns an unspecified value. +instead of by @samp{write}. @samp{display} returns an unspecified value. The @var{port} argument may be omitted, in which case it defaults to the value returned by @samp{current-output-port}. @quotation @emph{Rationale:} -@samp{Write} is intended +@samp{write} is intended for producing mach@-ine-readable output and @samp{display} is for producing human-readable output. Implementations that allow ``slashification'' within symbols will probably want @samp{write} but not @samp{display} to @@ -7168,7 +7168,7 @@ expressions and definitions from the file and evaluates them sequentially. It is unspecified whether the results of the expressions are printed. The @samp{load} procedure does not affect the values returned by @samp{current-input-port} and @samp{current-output-port}. -@samp{Load} returns an unspecified value. +@samp{load} returns an unspecified value. @quotation @@ -7959,7 +7959,7 @@ of the main body of the report. The rewrite rules for derived expressions have been replaced with macro definitions. There are no reserved identifiers. @item -@samp{Syntax-rules} now allows vector patterns. +@samp{syntax-rules} now allows vector patterns. @item Multiple-value returns, @samp{eval}, and @samp{dynamic-wind} have @@ -8073,7 +8073,7 @@ programs, implementations, and other material related to Scheme. @c -*- Mode: Lisp; Package: SCHEME; Syntax: Common-lisp -*- -@samp{Integrate-system} integrates the system +@samp{integrate-system} integrates the system @center y_k^^ = f_k(y_1, y_2, @dots{}, y_n), k = 1, @dots{}, n @@ -8104,8 +8104,8 @@ system states. @end example -@samp{Runge-Kutta-4} takes a function, @t{f}, that produces a -system derivative from a system state. @samp{Runge-Kutta-4} +@samp{runge-kutta-4} takes a function, @t{f}, that produces a +system derivative from a system state. @samp{runge-kutta-4} produces a function that takes a system state and produces a new system state. @@ -8162,7 +8162,7 @@ produces a new system state. @end example -@samp{Map-streams} is analogous to @samp{map}: it applies its first +@samp{map-streams} is analogous to @samp{map}: it applies its first argument (a procedure) to all the elements of its second argument (a stream). -- 1.7.8.3 --=-=-=-- From debbugs-submit-bounces@debbugs.gnu.org Thu Feb 02 08:49:46 2012 Received: (at 10486-done) by debbugs.gnu.org; 2 Feb 2012 13:49:46 +0000 Received: from localhost ([127.0.0.1]:50163 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Rsx2n-00053i-65 for submit@debbugs.gnu.org; Thu, 02 Feb 2012 08:49:45 -0500 Received: from a-pb-sasl-sd.pobox.com ([74.115.168.62]:46617 helo=sasl.smtp.pobox.com) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Rsx2l-00053b-E9 for 10486-done@debbugs.gnu.org; Thu, 02 Feb 2012 08:49:44 -0500 Received: from sasl.smtp.pobox.com (unknown [127.0.0.1]) by a-pb-sasl-sd.pobox.com (Postfix) with ESMTP id 28BFB8D4B; Thu, 2 Feb 2012 08:49:16 -0500 (EST) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=pobox.com; h=from:to:cc :subject:references:date:in-reply-to:message-id:mime-version :content-type; s=sasl; bh=WKdkO+hvBzxmp34drAJ5eyvOW3k=; b=B4V7bW 4IQGAGknp2B/SldHlqMH2ynpJsZcH1d1ez1cevyoqiaba8hjDWLWZswnehSt2GH3 8Qza16450jre5i8RD0rl6O839fk6XvEgVMexujK/R6LWTBDLHbhdX4v+NGCjVHk8 XrDgKwER9bR90P5mnYdwVzUYAsEs/SVvYwsso= DomainKey-Signature: a=rsa-sha1; c=nofws; d=pobox.com; h=from:to:cc :subject:references:date:in-reply-to:message-id:mime-version :content-type; q=dns; s=sasl; b=u/Ds06xtT/Pl1a4RpaxHvnVIgHkjjh3e SosM/Tb4kTHJWoqpz2+i3X2plIFdMZcEV6p12CC9jk71MVHystSVSZV70pFR3e0n FLF7KvCzT71f9jv7GhLJCrntcZHh+SjDfUE0Pv9VRS5tzMznapEeEVbbdiCGQdSB 7kAv7LdYxbU= Received: from a-pb-sasl-sd.pobox.com (unknown [127.0.0.1]) by a-pb-sasl-sd.pobox.com (Postfix) with ESMTP id 22C7F8D4A; Thu, 2 Feb 2012 08:49:16 -0500 (EST) Received: from badger (unknown [90.164.198.39]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by a-pb-sasl-sd.pobox.com (Postfix) with ESMTPSA id 7FA798D49; Thu, 2 Feb 2012 08:49:15 -0500 (EST) From: Andy Wingo To: b3timmons@speedymail.org Subject: Re: bug#10486: Patch: Fix case in identifiers starting sentences in doc/r5rs/r5rs.texi References: <87pqeoj3y1.fsf@goof.localdomain> Date: Thu, 02 Feb 2012 12:29:44 +0100 In-Reply-To: <87pqeoj3y1.fsf@goof.localdomain> (Bake Timmons's message of "Thu, 12 Jan 2012 11:11:50 -0500") Message-ID: <87aa51o4lz.fsf@pobox.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.3 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Pobox-Relay-ID: B22739D6-4DA4-11E1-B62E-65B1DE995924-02397024!a-pb-sasl-sd.pobox.com X-Spam-Score: -1.9 (-) X-Debbugs-Envelope-To: 10486-done Cc: 10486-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -1.9 (-) On Thu 12 Jan 2012 17:11, Bake Timmons 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/ From debbugs-submit-bounces@debbugs.gnu.org Thu Feb 02 09:32:52 2012 Received: (at 10486) by debbugs.gnu.org; 2 Feb 2012 14:32:53 +0000 Received: from localhost ([127.0.0.1]:50215 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RsxiW-00063n-2V for submit@debbugs.gnu.org; Thu, 02 Feb 2012 09:32:52 -0500 Received: from world.peace.net ([96.39.62.75]:33914 ident=hope5) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RsxiT-00063f-Gr for 10486@debbugs.gnu.org; Thu, 02 Feb 2012 09:32:50 -0500 Received: from 209-6-91-212.c3-0.smr-ubr1.sbo-smr.ma.cable.rcn.com ([209.6.91.212] helo=yeeloong) by world.peace.net with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.69) (envelope-from ) id 1Rsxhw-0002Qg-Kz; Thu, 02 Feb 2012 09:32:16 -0500 From: Mark H Weaver To: Bake Timmons Subject: Re: bug#10486: Patch: Fix case in identifiers starting sentences in doc/r5rs/r5rs.texi References: <87pqeoj3y1.fsf@goof.localdomain> <87aa51o4lz.fsf@pobox.com> Date: Thu, 02 Feb 2012 09:30:42 -0500 In-Reply-To: <87aa51o4lz.fsf@pobox.com> (Andy Wingo's message of "Thu, 02 Feb 2012 12:29:44 +0100") Message-ID: <87k445cnot.fsf@netris.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.92 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -1.9 (-) X-Debbugs-Envelope-To: 10486 Cc: wingo@pobox.com, 10486@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -1.9 (-) Andy Wingo writes: > On Thu 12 Jan 2012 17:11, Bake Timmons 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 From debbugs-submit-bounces@debbugs.gnu.org Thu Feb 02 17:43:40 2012 Received: (at 10486) by debbugs.gnu.org; 2 Feb 2012 22:43:40 +0000 Received: from localhost ([127.0.0.1]:51422 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Rt5NT-0003K3-LW for submit@debbugs.gnu.org; Thu, 02 Feb 2012 17:43:40 -0500 Received: from xanadu.aquilenet.fr ([88.191.123.111]:45122) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Rt5NR-0003Jr-PO for 10486@debbugs.gnu.org; Thu, 02 Feb 2012 17:43:38 -0500 Received: from localhost (xanadu.aquilenet.fr [127.0.0.1]) by xanadu.aquilenet.fr (Postfix) with ESMTP id D43DD242D; Thu, 2 Feb 2012 23:43:07 +0100 (CET) Received: from xanadu.aquilenet.fr ([127.0.0.1]) by localhost (xanadu.aquilenet.fr [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id wIAcZUknFYqt; Thu, 2 Feb 2012 23:43:07 +0100 (CET) Received: from pluto (reverse-83.fdn.fr [80.67.176.83]) by xanadu.aquilenet.fr (Postfix) with ESMTPSA id 18CAE7B3; Thu, 2 Feb 2012 23:43:06 +0100 (CET) From: ludo@gnu.org (Ludovic =?iso-8859-1?Q?Court=E8s?=) To: Mark H Weaver Subject: Re: bug#10486: Patch: Fix case in identifiers starting sentences in doc/r5rs/r5rs.texi References: <87pqeoj3y1.fsf@goof.localdomain> <87aa51o4lz.fsf@pobox.com> <87k445cnot.fsf@netris.org> X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 14 =?iso-8859-1?Q?Pluvi=F4se?= an 220 de la =?iso-8859-1?Q?R=E9volution?= X-PGP-Key-ID: 0xEA52ECF4 X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc X-PGP-Fingerprint: 83C4 F8E5 10A3 3B4C 5BEA D15D 77DD 95E2 EA52 ECF4 X-OS: x86_64-unknown-linux-gnu Date: Thu, 02 Feb 2012 23:43:06 +0100 In-Reply-To: <87k445cnot.fsf@netris.org> (Mark H. Weaver's message of "Thu, 02 Feb 2012 09:30:42 -0500") Message-ID: <878vkkrh51.fsf@gnu.org> User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.93 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -1.2 (-) X-Debbugs-Envelope-To: 10486 Cc: Bake Timmons , 10486@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -1.2 (-) Hi, Mark H Weaver skribis: > Andy Wingo writes: > >> On Thu 12 Jan 2012 17:11, Bake Timmons 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=E2=80=99. From unknown Mon Aug 18 02:38:49 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Fri, 02 Mar 2012 12:24:04 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator