lib/util: fix function header comment to strhex_to_str()
authorMichael Adam <obnox@samba.org>
Tue, 18 Oct 2011 16:07:54 +0000 (18:07 +0200)
committerMichael Adam <obnox@samba.org>
Tue, 18 Oct 2011 18:58:26 +0000 (20:58 +0200)
The description did not match the function's behaviour.

lib/util/util.c

index c5ed6fd0c797bb35a411769625d569a92acd6a3e..67ac6938a4ccd00f60fcf62492e1d383852c9a58 100644 (file)
@@ -689,15 +689,14 @@ _PUBLIC_ _PURE_ size_t count_chars(const char *s, char c)
 }
 
 /**
- Routine to get hex characters and turn them into a 16 byte array.
- the array can be variable length, and any non-hex-numeric
- characters are skipped.  "0xnn" or "0Xnn" is specially catered
- for.
-
- valid examples: "0A5D15"; "0x15, 0x49, 0xa2"; "59\ta9\te3\n"
-
-
-**/
+ * Routine to get hex characters and turn them into a byte array.
+ * the array can be variable length.
+ * -  "0xnn" or "0Xnn" is specially catered for.
+ * - The first non-hex-digit character (apart from possibly leading "0x"
+ *   finishes the conversion and skips the rest of the input.
+ *
+ * valid examples: "0A5D15"; "0x123456"
+ */
 _PUBLIC_ size_t strhex_to_str(char *p, size_t p_len, const char *strhex, size_t strhex_len)
 {
        size_t i = 0;