From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 68611 invoked by alias); 9 May 2018 11:36:30 -0000 Mailing-List: contact libc-alpha-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: libc-alpha-owner@sourceware.org Received: (qmail 68601 invoked by uid 89); 9 May 2018 11:36:30 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-3.3 required=5.0 tests=AWL,BAYES_00,SPF_HELO_PASS,SPF_PASS autolearn=ham version=3.3.2 spammy=controlling, largely X-HELO: smtp.707.technology Subject: Re: [PATCH 1/4] Reorganize manual sections on cryptography and random numbers. To: Zack Weinberg Cc: libc-alpha@sourceware.org, carlos@redhat.com, fweimer@redhat.com References: <20180506175153.22629-1-zackw@panix.com> <20180506175153.22629-2-zackw@panix.com> From: Rical Jasan Message-ID: <9ac245bd-0862-9ee8-0c66-aa5af416d4fc@2c3t.io> Date: Wed, 09 May 2018 11:36:00 -0000 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.7.0 MIME-Version: 1.0 In-Reply-To: <20180506175153.22629-2-zackw@panix.com> Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-SW-Source: 2018-05/txt/msg00392.txt.bz2 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