[PATCH 1/4] Reorganize manual sections on cryptography and random numbers.
Rical Jasan
rj@2c3t.io
Wed May 9 11:36:00 GMT 2018
On 05/06/2018 10:51 AM, Zack Weinberg wrote:
> In preparation for improvements to the discussion of cryptography,
> password handling, and random number generation, reorganize the
> sections of the manual that deal with these topics. This patch
> neither deletes any old text nor introduces any new text; it only
> moves text around. The description of 'getpass' moves to
> terminal.texi, since all it does is read a password from the
> controlling terminal with echo disabled. The pseudo-random number
> generator sections from math.texi and the "Unpredictable Bytes"
> section of crypt.texi are moved to a new file random.texi. Also, it
> is no longer true that crypt.texi's top @node needs to have no pointers.
>
> * manual/crypt.texi: Move most of the introductory text to the
> 'crypt' section. Move the example programs below the
> @deftypefun for 'crypt_r'. Move the DESERR_* table and
> DES_FAILED deftypefun below cbc_crypt. Move the entire
> 'getpass' section...
> * manual/terminal.texi: ...here.
>
> * manual/random.texi: New file consolidating all discussion of
> random number generation.
> * manual/crypt.texi: 'Unpredictable Bytes' section moved to random.texi.
> * manual/math.texi: 'Pseudo-Random Numbers' section moved to
> random.texi.
> * manual/Makefile (chapters): Add 'random' after 'arith'.
> * manual/arith.texi, manual/time.texi: Update chapter-level node
> pointers.
This is a great high-level overview of a largely mechanical change.
Other than minor, necessary changes to keep the manual somewhat
cohesive, this appears to be a copy/paste to me (yes, I took the time).
Thank you,
Rical
More information about the Libc-alpha
mailing list