Add .info extension to @setfilename commands in doc/

[bpt/emacs.git] / doc / misc / emacs-gnutls.texi

diff --git a/doc/misc/emacs-gnutls.texi b/doc/misc/emacs-gnutls.texi
index b1c4c13..8eb5298 100644 (file)
--- a/doc/misc/emacs-gnutls.texi
+++ b/doc/misc/emacs-gnutls.texi
@@ -2,19 +2,20 @@
 
 @set VERSION 0.3
 
-@setfilename ../../info/emacs-gnutls
+@setfilename ../../info/emacs-gnutls.info
 @settitle Emacs GnuTLS Integration @value{VERSION}
+@documentencoding UTF-8
 
 @copying
 This file describes the Emacs GnuTLS integration.
 
-Copyright @copyright{} 2012--2013 Free Software Foundation, Inc.
+Copyright @copyright{} 2012--2014 Free Software Foundation, Inc.
 
 @quotation
 Permission is granted to copy, distribute and/or modify this document
 under the terms of the GNU Free Documentation License, Version 1.3 or
 any later version published by the Free Software Foundation; with no
-Invariant Sections, with the Front-Cover texts being ``A GNU Manual,''
+Invariant Sections, with the Front-Cover Texts being ``A GNU Manual,''
 and with the Back-Cover Texts as in (a) below.  A copy of the license
 is included in the section entitled ``GNU Free Documentation License''.
 
@@ -93,7 +94,7 @@ There's one way to find out if GnuTLS is available, by calling
 Zaretskii) in the same directory as Emacs, you should be OK.
 
 @defun gnutls-available-p
-This function returns t if GnuTLS is available in this instance of Emacs.
+This function returns @code{t} if GnuTLS is available in this instance of Emacs.
 @end defun
 
 Oh, but sometimes things go wrong.  Budgets aren't balanced,
@@ -103,7 +104,7 @@ properly.  Well, there's something to be done in the last case.
 @defvar gnutls-log-level
 The @code{gnutls-log-level} variable sets the log level.  1 is
 verbose.  2 is very verbose.  5 is crazy.  Crazy!  Set it to 1 or 2
-and look in the @code{*Messages*} buffer for the debugging
+and look in the @file{*Messages*} buffer for the debugging
 information.
 @end defvar
 
@@ -132,6 +133,24 @@ know if you do, so we can make the change to benefit the other users
 of that platform.
 @end defvar
 
+@defvar gnutls-verify-error
+The @code{gnutls-verify-error} variable allows you to verify SSL/TLS
+server certificates for all connections or by host name.  It defaults
+to @code{nil} for now but will likely be changed to @code{t} later,
+meaning that all certificates will be verified.
+
+There are two checks available currently, that the certificate has
+been issued by a trusted authority as defined by
+@code{gnutls-trustfiles}, and that the hostname matches the
+certificate.  @code{t} enables both checks, but you can enable them
+individually as well with @code{:trustfiles} and @code{:hostname}
+instead.
+
+Because of the low-level interactions with the GnuTLS library, there
+is no way currently to ask if a certificate can be accepted.  You have
+to look in the @file{*Messages*} buffer.
+@end defvar
+
 @defvar gnutls-min-prime-bits
 The @code{gnutls-min-prime-bits} variable is a pretty exotic
 customization for cases where you want to refuse handshakes with keys