commit b3f057670aa104ab985e7c1a422e6cf83c9e3339
parent 215adc59c2ea9f24264102a8cfcb14d8fb71e3fb
Author: Wolfgang Corcoran-Mathe <wcm@sigwinch.xyz>
Date: Mon, 5 Feb 2024 00:34:18 -0500
Environments etc.: Reflow.
Diffstat:
1 file changed, 35 insertions(+), 35 deletions(-)
diff --git a/doc/r7rs-small/procedures/environments-and-evaluation.texinfo b/doc/r7rs-small/procedures/environments-and-evaluation.texinfo
@@ -3,27 +3,27 @@
@deffn {eval library procedure} environment @vari{list}@dots{}
-This procedure returns a specifier for the environment that results by starting with an
-empty environment and then importing each
-@var{list}, considered as an import set, into it. (@xref{Libraries} for a description of import sets.)
-The bindings of the environment represented by the specifier are immutable, as is the
-environment itself.
+This procedure returns a specifier for the environment that results
+by starting with an empty environment and then importing each
+@var{list}, considered as an import set, into it. (@xref{Libraries}
+for a description of import sets.) The bindings of the environment
+represented by the specifier are immutable, as is the environment
+itself.
@end deffn
@deffn {r5rs library procedure} scheme-report-environment version
-If
-@var{version} is equal to @code{5}, corresponding to @rfivers{}, @code{scheme-report-environment} returns a
-specifier for an environment that contains only the bindings defined in the @rfivers{} library.
-Implementations must support this value of
-@var{version}.
+If @var{version} is equal to @code{5}, corresponding to @rfivers{},
+@code{scheme-report-environment} returns a specifier for an environment
+that contains only the bindings defined in the @rfivers{} library.
+Implementations must support this value of @var{version}.
-Implementations may also support other values of
-@var{version}, in which case they return a specifier for an environment containing bindings
-corresponding to the specified version of the report. If
-@var{version} is neither @code{5} nor another value supported by the implementation, an error is
-signaled.
+Implementations may also support other values of @var{version},
+in which case they return a specifier for an environment containing
+bindings corresponding to the specified version of the report. If
+@var{version} is neither @code{5} nor another value supported by the
+implementation, an error is signaled.
The effect of defining or assigning (through the use of @code{eval})
an identifier bound in a @code{scheme-report-environment} (for example
@@ -34,17 +34,17 @@ it contains may be immutable.
@deffn {r5rs library procedure} null-environment version
-If
-@var{version} is equal to @code{5}, corresponding to @rfivers{}, the null-environment procedure returns a
-specifier for an environment that contains only the bindings for all syntactic keywords
-defined in the @rfivers{} library. Implementations must support this value of
-@var{version}.
+If @var{version} is equal to @code{5}, corresponding to @rfivers{},
+the null-environment procedure returns a specifier for an environment
+that contains only the bindings for all syntactic keywords defined
+in the @rfivers{} library. Implementations must support this value
+of @var{version}.
-Implementations may also support other values of
-@var{version}, in which case they return a specifier for an environment containing appropriate
-bindings corresponding to the specified version of the report. If
-@var{version} is neither @code{5} nor another value supported by the implementation, an error is
-signaled.
+Implementations may also support other values of @var{version}, in
+which case they return a specifier for an environment containing
+appropriate bindings corresponding to the specified version of
+the report. If @var{version} is neither @code{5} nor another value
+supported by the implementation, an error is signaled.
The effect of defining or assigning (through the use of @code{eval})
an identifier bound in a @code{scheme-report-environment} (for example
@@ -55,21 +55,21 @@ it contains may be immutable.
@deffn {repl library procedure} interaction-environment
-This procedure returns a specifier for a mutable environment that contains an
-implementation-defined set of bindings, typically a superset of
-those exported by @code{(scheme base)}. The intent is that this procedure
-will return the environment in which the implementation would evaluate
-expressions entered by the user into a REPL.
+This procedure returns a specifier for a mutable environment that
+contains an implementation-defined set of bindings, typically a
+superset of those exported by @code{(scheme base)}. The intent is that
+this procedure will return the environment in which the implementation
+would evaluate expressions entered by the user into a REPL.
@end deffn
@deffn {eval library procedure} eval expr-or-def environment-specifier
-If @var{expr-or-def} is an expression, it is evaluated in the
-specified environment and its values are returned.
-If it is a definition, the specified identifier(s) are defined in the specified
-environment, provided the environment is not immutable.
-Implementations may extend @code{eval} to allow other objects.
+If @var{expr-or-def} is an expression, it is evaluated in the specified
+environment and its values are returned. If it is a definition,
+the specified identifier(s) are defined in the specified environment,
+provided the environment is not immutable. Implementations may extend
+@code{eval} to allow other objects.
@lisp
(eval '(* 7 3) (environment '(scheme base))) @result{} 21
