mirror/guile
mirror/guile
1
Fork 0
mirror of https://git.savannah.gnu.org/git/guile.git synced 2025-04-30 03:40:34 +02:00
Code Activity

minor doc fixups

Browse source 
* doc/ref/scheme-scripts.texi (Invoking Guile): Some typos.
* doc/ref/tour.texi (Running Guile Scripts): More typos and PDF
  improvements.
* doc/ref/scheme-using.texi (Readline, Value History): Minor rewording.
  (Help Commands): Minor fixup.
This commit is contained in:
Andy Wingo 2010-10-12 12:58:36 +02:00
parent f88dae81fe
commit ced9917e12
3 changed files with 18 additions and 17 deletions
Download patch file Download diff file Expand all files Collapse all files

6
doc/ref/scheme-scripts.texi
View file

@ -199,13 +199,13 @@ If @var{p} is not given, the default is local port 37146. If you look
at it upside down, it almost spells ``Guile''. If you have netcat
installed, you should be able to @kbd{nc localhost 37146} and get a
Guile prompt. Alternately you can fire up Emacs and connect to the
procedure; see @ref{Using Guile in Emacs} for more details.
process; see @ref{Using Guile in Emacs} for more details.
Note that opening a port allows anyone who can connect to that port---in
the TCP case, any local user---to do anything Guile can do, as the user
that the Guile process is running as. Don't use @option{--listen} on
multi-user machines. Of course, if there is no @option{--listen}
argument, no port will be opened.
multi-user machines. Of course, if you don't pass @option{--listen} to
Guile, no port will be opened.
That said, @code{--listen} is great for interactive debugging and
development.

21
doc/ref/scheme-using.texi
View file

@ -57,21 +57,22 @@ scheme@@(guile-user)> (use-modules (ice-9 readline))
scheme@@(guile-user)> (activate-readline)
@end lisp
It's a good idea to put these two lines (without the ``scheme@@(guile-user)>''
prompts) in your @file{.guile} file. Guile reads this file when it
starts up interactively, so anything in this file has the same effect
as if you type it in by hand at the ``scheme@@(guile-user)>'' prompt.
It's a good idea to put these two lines (without the
@code{scheme@@(guile-user)>} prompts) in your @file{.guile} file. Guile
reads this file when it starts up interactively, so anything in this
file has the same effect as if you type it in by hand at the
@code{scheme@@(guile-user)>} prompt.
@node Value History
@subsection Value History
Just as Readline helps you to reuse a previous input line, @dfn{value
history} allows you to use the @emph{result} of a previous evaluation
in a new expression. When value history is enabled, each evaluation
result is automatically assigned to the next in the sequence of
variables @code{$1}, @code{$2}, @dots{}, and you can then use these
variables in subsequent expressions.
history} allows you to use the @emph{result} of a previous evaluation in
a new expression. When value history is enabled, each evaluation result
is automatically assigned to the next in the sequence of variables
@code{$1}, @code{$2}, @dots{}. You can then use these variables in
subsequent expressions.
@lisp
scheme@@(guile-user)> (iota 10)
@ -175,7 +176,7 @@ had by typing @samp{,help}. Indeed, @code{help} is a command, and a
particularly useful one, as it allows the user to discover the rest of
the commands.
@deffn {REPL Command} help [@samp{all} | group | @samp{[-c]} command]
@deffn {REPL Command} help [@code{all} | group | @code{[-c]} command]
Show help.
With one argument, tries to look up the argument as a group name, giving

8
doc/ref/tour.texi
View file

@ -59,7 +59,7 @@ script is simply a file of Scheme code with some extra information at
the beginning which tells the operating system how to invoke Guile, and
then tells Guile how to handle the Scheme code.
Here is a trivial Guile script, for more details @xref{Guile Scripting}.
Here is a trivial Guile script. @xref{Guile Scripting}, for more details.
@example
#!/usr/local/bin/guile -s
@ -136,8 +136,8 @@ You can link Guile into your program and make Scheme available to the
users of your program. You can also link your library into Guile and
make its functionality available to all users of Guile.
A library that is linked into Guile is called an @dfn{extensions}, but
it really just is an ordinary object library.
A library that is linked into Guile is called an @dfn{extension}, but it
really just is an ordinary object library.
The following example shows how to write a simple extension for Guile
that makes the @code{j0} function available to Scheme code.
@ -357,7 +357,7 @@ If you built Guile yourself, the build configuration that you used:
@example
$ ./config.status --config
'--enable-error-on-warning' '--disable-deprecated' '--prefix=/opt/guile' '--libdir=/opt/guile/lib64' 'CC=ccache gcc'
'--enable-error-on-warning' '--disable-deprecated'...
@end example
@item