From: Douglas Bagnall Date: Wed, 28 Jun 2023 04:02:38 +0000 (+1200) Subject: util/charset: disambiguate docs for convert_string twins X-Git-Tag: talloc-2.4.2~1025 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=df8ab7edfa2536c0d567ac7a6016d8d3ef50db91;p=thirdparty%2Fsamba.git util/charset: disambiguate docs for convert_string twins Signed-off-by: Douglas Bagnall Reviewed-by: Andrew Bartlett --- diff --git a/lib/util/charset/convert_string.c b/lib/util/charset/convert_string.c index 7ec6653a592..686b9ab8468 100644 --- a/lib/util/charset/convert_string.c +++ b/lib/util/charset/convert_string.c @@ -493,7 +493,9 @@ bool convert_string_talloc_handle(TALLOC_CTX *ctx, struct smb_iconv_handle *ic, } /** - * Convert string from one encoding to another, making error checking etc + * Convert string from one encoding to another, with error checking. + * This version produces more logging information than + * convert_string_error(), but is otherwise functionally identical. * * @param src pointer to source string (multibyte or singlebyte) * @param srclen length of the source string in bytes @@ -514,7 +516,8 @@ _PUBLIC_ bool convert_string(charset_t from, charset_t to, } /** - * Convert string from one encoding to another, making error checking etc + * Convert string from one encoding to another, with error checking. + * This version is less verbose than convert_string(). * * @param src pointer to source string (multibyte or singlebyte) * @param srclen length of the source string in bytes