manual: fix compilation errors and warnings

diff --git a/doc/cffi-manual.texinfo b/doc/cffi-manual.texinfo
index 3d0c366..1ee2b46 100644 (file)
--- a/doc/cffi-manual.texinfo
+++ b/doc/cffi-manual.texinfo
@@ -4735,21 +4735,21 @@ CFFI> (let ((*default-foreign-encoding* :utf-16))
 
 @subheading Arguments and Values
 
-@table @var
-@item string
+@table @emph
+@item @var{string}
 A Lisp string.
 
-@item encoding
+@item @var{encoding}
 Foreign encoding. Defaults to @code{*default-foreign-encoding*}.
 
-@item null-terminated-p
+@item @var{null-terminated-p}
 Boolean, defaults to true.
 
-@item start, end
+@item @var{start}, @var{end}
 Bounding index designators of @var{string}. 0 and @code{nil}, by
 default.
 
-@item pointer
+@item @var{pointer}
 A pointer to the newly allocated foreign string.
 @end table
 
@@ -4879,24 +4879,24 @@ CFFI> (foreign-string-to-lisp *)
 
 @subheading Arguments and Values
 
-@table @var
-@item string
+@table @emph
+@item @var{string}
 A Lisp string.
 
-@item buffer
+@item @var{buffer}
 A foreign pointer.
 
-@item bufsize
+@item @var{bufsize}
 An integer.
 
-@item start, end
+@item @var{start}, @var{end}
 Bounding index designators of @var{string}. 0 and @code{nil}, by
 default.
 
-@item offset
+@item @var{offset}
 An integer greater than or equal to 0. Defauls to 0.
 
-@item encoding
+@item @var{encoding}
 Foreign encoding. Defaults to @code{*default-foreign-encoding*}.
 @end table
 
@@ -4941,14 +4941,14 @@ bindings ::= @{(var-or-vars string &rest args)@}*
 
 @subheading Arguments and Values
 
-@table @var
-@item var, byte-size-var
+@table @emph
+@item @var{var}, @var{byte-size-var}
 A symbol.
 
-@item string
+@item @var{string}
 A Lisp string.
 
-@item body
+@item @var{body}
 A list of forms to be executed.
 @end table
 
@@ -5554,12 +5554,12 @@ The Lisp symbol to be used a function name.
 @end table
 
 @subheading Description
-@code{translate-name-from-foreign} is used by @code{@seealso{defcfun}}
-to handle the conversion of foreign names to lisp names. By default,
-it translates using
-@code{@seealso{translate-underscore-separated-name}}. However, you can
-create specialized methods on this function to make translating more
-closely match the foreign library's naming conventions.
+@code{translate-name-from-foreign} is used by @ref{defcfun} to handle
+the conversion of foreign names to lisp names. By default, it
+translates using @ref{translate-underscore-separated-name}. However,
+you can create specialized methods on this function to make
+translating more closely match the foreign library's naming
+conventions.
 
 Specialize @var{package} on some package. This allows other packages
 to load libraries with different naming conventions.
@@ -5612,12 +5612,12 @@ The string representing the foreign function name.
 @end table
 
 @subheading Description
-@code{translate-name-to-foreign} is used by @code{@seealso{defcfun}}
-to handle the conversion of lisp names to foreign names. By default,
-it translates using
-@code{@seealso{translate-underscore-separated-name}}. However, you can
-create specialized methods on this function to make translating more
-closely match the foreign library's naming conventions.
+@code{translate-name-to-foreign} is used by @ref{defcfun} to handle
+the conversion of lisp names to foreign names. By default, it
+translates using @ref{translate-underscore-separated-name}. However,
+you can create specialized methods on this function to make
+translating more closely match the foreign library's naming
+conventions.
 
 Specialize @var{package} on some package. This allows other packages
 to load libraries with different naming conventions.
@@ -5665,11 +5665,9 @@ If @var{name} is a symbol, this is a string, and vice versa.
 
 @subheading Description
 @code{translate-underscore-separated-name} is a helper function for
-specializations of
-@code{@seealso{translate-name-from-foreign}} and
-@code{@seealso{translate-name-to-foreign}}. It handles the common
-case of converting between foreign underscore_separated names and lisp
-names.
+specializations of @ref{translate-name-from-foreign} and
+@ref{translate-name-to-foreign}. It handles the common case of
+converting between foreign underscore_separated names and lisp names.
 
 @subheading Examples