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 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 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 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 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 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 that the Guile process is running as. Don't use @option{--listen} on
multi-user machines. Of course, if there is no @option{--listen} multi-user machines. Of course, if you don't pass @option{--listen} to
argument, no port will be opened. Guile, no port will be opened.
That said, @code{--listen} is great for interactive debugging and That said, @code{--listen} is great for interactive debugging and
development. 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) scheme@@(guile-user)> (activate-readline)
@end lisp @end lisp
It's a good idea to put these two lines (without the ``scheme@@(guile-user)>'' It's a good idea to put these two lines (without the
prompts) in your @file{.guile} file. Guile reads this file when it @code{scheme@@(guile-user)>} prompts) in your @file{.guile} file. Guile
starts up interactively, so anything in this file has the same effect reads this file when it starts up interactively, so anything in this
as if you type it in by hand at the ``scheme@@(guile-user)>'' prompt. file has the same effect as if you type it in by hand at the
@code{scheme@@(guile-user)>} prompt.
@node Value History @node Value History
@subsection Value History @subsection Value History
Just as Readline helps you to reuse a previous input line, @dfn{value 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 history} allows you to use the @emph{result} of a previous evaluation in
in a new expression. When value history is enabled, each evaluation a new expression. When value history is enabled, each evaluation result
result is automatically assigned to the next in the sequence of is automatically assigned to the next in the sequence of variables
variables @code{$1}, @code{$2}, @dots{}, and you can then use these @code{$1}, @code{$2}, @dots{}. You can then use these variables in
variables in subsequent expressions. subsequent expressions.
@lisp @lisp
scheme@@(guile-user)> (iota 10) 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 particularly useful one, as it allows the user to discover the rest of
the commands. the commands.
@deffn {REPL Command} help [@samp{all} | group | @samp{[-c]} command] @deffn {REPL Command} help [@code{all} | group | @code{[-c]} command]
Show help. Show help.
With one argument, tries to look up the argument as a group name, giving 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 the beginning which tells the operating system how to invoke Guile, and
then tells Guile how to handle the Scheme code. 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 @example
#!/usr/local/bin/guile -s #!/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 users of your program. You can also link your library into Guile and
make its functionality available to all users of Guile. make its functionality available to all users of Guile.
A library that is linked into Guile is called an @dfn{extensions}, but A library that is linked into Guile is called an @dfn{extension}, but it
it really just is an ordinary object library. really just is an ordinary object library.
The following example shows how to write a simple extension for Guile The following example shows how to write a simple extension for Guile
that makes the @code{j0} function available to Scheme code. 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 @example
$ ./config.status --config $ ./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 @end example
@item @item