Clarify the effect of uc_canonical_decomposition.

Prompted by a report by DaeHyun Sung <sungdh86@gmail.com>.

* doc/uninorm.texi (Decomposition of characters): Clarify.
* doc/libunistring.texi: Bump copyright year.

2 files changed, 7 insertions, 2 deletions

diff --git a/doc/libunistring.texi b/doc/libunistring.texi
index 43a6ba5..a9c7e0f 100644
--- a/doc/libunistring.texi
+++ b/doc/libunistring.texi
@@ -86,7 +86,7 @@ This manual is for GNU libunistring.
 
 @ignore
 @c This was: @copying but it triggers a makeinfo 4.13 bug
-Copyright (C) 2001-2016 Free Software Foundation, Inc.
+Copyright (C) 2001-2017 Free Software Foundation, Inc.
 
 This manual is free documentation.  It is dually licensed under the
 GNU FDL and the GNU GPL.  This means that you can redistribute this
@@ -118,7 +118,7 @@ A copy of the license is included in @ref{GNU GPL}.
 @page
 @vskip 0pt plus 1filll
 @c @insertcopying
-Copyright (C) 2001-2016 Free Software Foundation, Inc.
+Copyright (C) 2001-2017 Free Software Foundation, Inc.
 
 This manual is free documentation.  It is dually licensed under the
 GNU FDL and the GNU GPL.  This means that you can redistribute this
diff --git a/doc/uninorm.texi b/doc/uninorm.texi
index 6797fe8..5cad859 100644
--- a/doc/uninorm.texi
+++ b/doc/uninorm.texi
@@ -133,6 +133,11 @@ Returns the canonical character decomposition mapping of the Unicode character
 
 When a decomposition exists, @code{@var{decomposition}[0..@var{n}-1]} is filled
 and @var{n} is returned.  Otherwise -1 is returned.
+
+Note: This function returns the (simple) ``canonical decomposition'' of
+@var{uc}.  If you want the ``full canonical decomposition'' of @var{uc},
+that is, the recursive application of ``canonical decomposition'', use the
+function @code{u*_normalize} with argument @code{UNINORM_NFD} instead.
 @end deftypefun
 
 @node Composition of characters