Re: [gnutls-dev] Preparing for the next stable release

[Ludovic Courtès]

Hi!

Attached are a few fixes for the Guile section of the manual.

Also, I think all section names should be in "title case", for instance:

  * Introduction to TLS::    (this one is OK)
  * Authentication Methods::
  * More on Certificate Authentication::
  * How to Use TLS in Application Protocols::
  * How to Use GnuTLS in Applications::

But maybe it's already too late to change node names?

Thanks,
Ludovic.


>From a285b31c9892fab7d07b74f92c78fb2cd578e558 Mon Sep 17 00:00:00 2001
From: =?utf-8?q?Ludovic=20Court=C3=A8s?= <address@hidden>
Date: Mon, 2 Jul 2007 21:57:22 +0200
Subject: [PATCH] Manual: Small Guile fixes.

* doc/guile.texi: Fixed typos, added cross-refs to the Guile manual.
---
 doc/guile.texi |   20 +++++++++++---------
 1 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/doc/guile.texi b/doc/guile.texi
index 8d4d075..53c0e50 100644
--- a/doc/guile.texi
+++ b/doc/guile.texi
@@ -6,7 +6,7 @@
 This chapter describes the @uref{http://www.gnu.org/software/guile/,
 GNU Guile} Scheme programming interface to GnuTLS.  The reader is
 assumed to have basic knowledge of the protocol and library.  Details
-missing from this document may be found in @ref{Function reference,
+missing from this chapter may be found in @ref{Function reference,
 the C API reference}.
 
 At this stage, not all the C functions are available from Scheme, but
@@ -70,20 +70,25 @@ need to instruct Guile so that it finds the GnuTLS Guile 
bindings.
 Either use the @code{GUILE_LOAD_PATH} environment variable as follows:
 
 @example
-$ GUILE_LOAD_PATH=/usr/local/share/guile/site guile
+$ GUILE_LOAD_PATH="/usr/local/share/guile/site:$GUILE_LOAD_PATH" guile
 guile> (use-modules (gnutls))
 guile>
 @end example
 
-If you get an error regarding @file{libguile-gnutls-v-0} similar to:
+Alternatively, you can modify Guile's @code{%load-path} variable
+(@pxref{Build Config, Guile's run-time options,, guile, The GNU Guile
+Reference Manual}).
+
+At this point, you might get an error regarding
address@hidden similar to:
 
 @example
 gnutls.scm:361:1: In procedure dynamic-link in expression (load-extension 
"libguile-gnutls-v-0" "scm_init_gnutls"):
 gnutls.scm:361:1: file: "libguile-gnutls-v-0", message: 
"libguile-gnutls-v-0.so: cannot open shared object file: No such file or 
directory"
 @end example
 
-You will need to modify the run-time linker path, for example as
-follows.
+In this case, you will need to modify the run-time linker path, for
+example as follows:
 
 @example
 $ LD_LIBRARY_PATH=/usr/local/lib GUILE_LOAD_PATH=/usr/local/share/guile/site 
guile
@@ -91,9 +96,6 @@ guile> (use-modules (gnutls))
 guile>
 @end example
 
-As another solution, it may be possible to modify the
address@hidden variable.
-
 
 @c *********************************************************************
 @node Guile API Conventions
@@ -368,7 +370,7 @@ as in this example.
 @node Guile Examples
 @section Guile Examples
 
-This chapter lists examples that illustrate common use cases.
+This chapter provides examples that illustrate common use cases.
 
 @menu
 * Anonymous Authentication Guile Example::    Simplest client and server.
-- 
1.5.2.1