Corentin Labbe <[email protected]> writes:
> Does this is what you want ?
> --- a/nettle.texinfo
> +++ b/nettle.texinfo
> @@ -929,6 +929,13 @@ This function also resets the context in the same way as
> @code{md5_init}.
> @end deftypefun
>
> +@deftypefun void md5_compress (uint32_t *@var{state}, uint8_t *@var{input})
> +Perform a raw MD5 compress on MD5_BLOCK_SIZE bytes from @var{input}
> using @var{state} as IV (which should be at
> +least MD5_BLOCK_SIZE long). The output is stored in @var{state}.
> +This function is usefull only if you need to use different IV from standard
> MD5
> +or want to do MD5 at hand.
> +@end deftypefun
Looks pretty good, I see a few things to improve:
Size of @var{state} isn't quite right. It should be an array of 4
uint32_t for md5. (There's a constant _MD5_DIGEST_LENGTH for this in the
md5.h header file, but it's not a very good name, so I think it's best
to not refer to it in the docs and just say 4).
The @var{input} should be documented as const (similar to the input for
md5_update).
Spelling "useful" (single "l").
And you probably mean "by hand" not "at hand" in the final sentence. Not
sure if you can say something more specific, but still concise, about
usecases? Or you could write that something like "provides access to the
underlying compression function, for the rare applications that need
that".
Regards,
/Niels
--
Niels Möller. PGP key CB4962D070D77D7FCB8BA36271D8F1FF368C6677.
Internet email is subject to wholesale government surveillance.
_______________________________________________
nettle-bugs mailing list -- [email protected]
To unsubscribe send an email to [email protected]
