Re: [bug-libunistring] string normalization API

[Bruno Haible]

Nikos Mavrogiannopoulos wrote on 2016-11-08
in <https://lists.gnu.org/archive/html/bug-libunistring/2016-11/msg00000.html>:
>  I have been trying to understand the normalize API, and in the
> process I have written down some text for the function description. I
> am not sure if my understanding of the API is right, but here is some
> proposed documentation patch for u*_normalize().
> 
> The conventions [0] section seem to cover some of this text.

Thanks for the patch. I see what you mean: The doc in [0] is answering the
question "what does the function do?". Whereas you want three other questions
answered:
  - "which value should I assign to resultbuf?"
  - "how do I interpret the return value?"
  - "is the return value NUL-terminated?"

I'm therefore adding a bit of doc, to answer these questions.
https://git.savannah.gnu.org/gitweb/?p=libunistring.git;a=commitdiff;h=d679843bd9581109ae5e7ca70b263d4c549b0dec

Bruno