doc update

diff --git a/doc/cha-gtls-app.texi b/doc/cha-gtls-app.texi
index 911d0183ff68d220d649605fa39485a717aa8d2a..d4f7451dca15091ac65964a64c1cdda4ac1cf3ca 100644 (file)
--- a/doc/cha-gtls-app.texi
+++ b/doc/cha-gtls-app.texi
@@ -879,11 +879,14 @@ are listed in @ref{The Alert Protocol}.
 @section Priority strings
 @cindex Priority strings
 
-The GnuTLS priority string specifies the TLS session's handshake
+The GnuTLS priority strings specify the TLS session's handshake
 algorithms and options in a compact, easy-to-use format.  That string
 may contain a single initial keyword such as in
 @ref{tab:prio-keywords} and may be followed by additional algorithm or
-special keywords.
+special keywords. Note that their description is intentionally avoiding
+specific algorithm details, as the priority strings are not constant between
+gnutls versions (they are periodically updated to account for cryptographic
+advances while providing compatibility with old clients and servers).
 
 @showfuncB{gnutls_priority_set_direct,gnutls_priority_set}