1
Fork 0
mirror of https://git.savannah.gnu.org/git/guile.git synced 2025-04-30 20:00:19 +02:00

Assorted minor manual changes

* doc/ref/guile.texi (Programming in Scheme): Remove "awful" and add
  "as opposed to having to dive into C code", to explain what we
  really mean here.  Remove incorrect para about the `Hello Scheme!'
  material.

* doc/ref/intro.texi (Interactive Programming): Change "allows" to "is
  designed for" - sounds less accidental!

* doc/ref/scheme-ideas.texi (Hello Scheme!): Remove unnecessary
  "reference", and inappropriate "randomness".
This commit is contained in:
Neil Jerram 2010-04-26 04:27:01 +01:00
parent 5bcaf46b75
commit 1d84577c6a
3 changed files with 17 additions and 20 deletions

View file

@ -216,16 +216,11 @@ Indices
@node Programming in Scheme @node Programming in Scheme
@chapter Programming in Scheme @chapter Programming in Scheme
Guile's core language is Scheme, and an awful lot can be achieved simply Guile's core language is Scheme, and a lot can be achieved simply by using Guile
by using Guile to write and run Scheme programs. In this part of the to write and run Scheme programs --- as opposed to having to dive into C code.
manual, we explain how to use Guile in this mode, and describe the tools In this part of the manual, we explain how to use Guile in this mode, and
that Guile provides to help you with script writing, debugging and describe the tools that Guile provides to help you with script writing,
packaging your programs for distribution. debugging and packaging your programs for distribution.
For readers who are not yet familiar with the Scheme language, this part
includes a chapter that presents the basic concepts of the language, and
gives references to freely available Scheme tutorial material on the
web.
For detailed reference information on the variables, functions For detailed reference information on the variables, functions
etc. that make up Guile's application programming interface (API), etc. that make up Guile's application programming interface (API),

View file

@ -169,12 +169,13 @@ Then, for bonus points and maximising the ability for the user to experiment
quickly with code changes, the system should allow parts of the source code to quickly with code changes, the system should allow parts of the source code to
be modified and reloaded into the running program, to take immediate effect. be modified and reloaded into the running program, to take immediate effect.
Guile allows this kind of interactive programming, and this distinguishes it Guile is designed for this kind of interactive programming, and this
from many Scheme implementations that instead prioritise running a fixed Scheme distinguishes it from many Scheme implementations that instead prioritise
program as fast as possible --- because there are tradeoffs between performance running a fixed Scheme program as fast as possible --- because there are
and the ability to modify parts of an already running program. There are faster tradeoffs between performance and the ability to modify parts of an already
Schemes than Guile, but Guile is a GNU project and so prioritises the GNU vision running program. There are faster Schemes than Guile, but Guile is a GNU
of programming freedom and experimentation. project and so prioritises the GNU vision of programming freedom and
experimentation.
@node Supporting Multiple Languages @node Supporting Multiple Languages
@section Supporting Multiple Languages @section Supporting Multiple Languages

View file

@ -14,11 +14,12 @@ Readers who already possess a background knowledge of Scheme may happily
skip this chapter. For the reader who is new to the language, however, skip this chapter. For the reader who is new to the language, however,
the following discussions on data, procedures, expressions and closure the following discussions on data, procedures, expressions and closure
are designed to provide a minimum level of Scheme understanding that is are designed to provide a minimum level of Scheme understanding that is
more or less assumed by the reference chapters that follow. more or less assumed by the chapters that follow.
The style of this introductory material aims about halfway between the The style of this introductory material aims about halfway between the terse
terse precision of R5RS and the discursive randomness of a Scheme precision of R5RS and the discursiveness of existing Scheme tutorials. For
tutorial. pointers to useful Scheme resources on the web, please see @ref{Further
Reading}.
@menu @menu
* About Data:: Latent typing, types, values and variables. * About Data:: Latent typing, types, values and variables.