Re: [PATCH 1/4] Reorganize manual sections on cryptography and random numbers.

[Rical Jasan <rj at 2c3t dot io>]

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