linux-kernel - Re: [PATCH v2 00/20] Add memberof(), split headers, and simplify code

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Date:   Mon, 22 Nov 2021 13:07:41 +0100
From:   "Alejandro Colomar (man-pages)" <alx.manpages@...il.com>
To:     Andy Shevchenko <andriy.shevchenko@...ux.intel.com>
Cc:     LKML <linux-kernel@...r.kernel.org>, Arnd Bergmann <arnd@...db.de>,
        Alexey Dobriyan <adobriyan@...il.com>,
        Jani Nikula <jani.nikula@...ux.intel.com>,
        Rasmus Villemoes <linux@...musvillemoes.dk>,
        Kees Cook <keescook@...omium.org>,
        Joe Perches <joe@...ches.com>
Subject: Re: [PATCH v2 00/20] Add memberof(), split headers, and simplify code



On 11/22/21 12:17, Andy Shevchenko wrote:
> 
> What happens to the indentation in your emails?!
> It looks like a bad poem :-)

Ahh, hehe!

It's a habit of writing manual pages source code.  It makes it easier to 
edit the ideas while writing.

Recently, I learned that this goes back to Kernighan:

     Brian W. Kernighan, 1974 [UNIX For Beginners]:

     [
     Hints for Preparing Documents

     Most documents go through several versions
     (always more than you expected)
     before they are finally finished.
     Accordingly,
     you should do whatever possible
     to make the job of changing them easy.

     First,
     when you do the purely mechanical operations of typing,
     type so subsequent editing will be easy.
     Start each sentence on a new line.
     Make lines short,
     and break lines at natural places,
     such as after commas and semicolons,
     rather than randomly.
     Since most people change documents
     by rewriting phrases and
     adding, deleting and rearranging sentences,
     these precautions simplify any editing you have to do later.
     ]

See <https://rhodesmill.org/brandon/2012/one-sentence-per-line/>.

> 
> On top of that, never start a new thread inside the previous one.
> 

ACK.

Thanks,
Alex

-- 
Alejandro Colomar
Linux man-pages comaintainer; http://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/