Message-ID: <45e55a35-759b-fcb7-40cb-f29a27ed3693@gmail.com>
Date:   Mon, 22 Nov 2021 13:07:41 +0100
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101
 Thunderbird/91.3.0
Subject: Re: [PATCH v2 00/20] Add memberof(), split headers, and simplify code
Content-Language: en-US
To:     Andy Shevchenko <andriy.shevchenko@linux.intel.com>
Cc:     LKML <linux-kernel@vger.kernel.org>, Arnd Bergmann <arnd@arndb.de>,
        Alexey Dobriyan <adobriyan@gmail.com>,
        Jani Nikula <jani.nikula@linux.intel.com>,
        Rasmus Villemoes <linux@rasmusvillemoes.dk>,
        Kees Cook <keescook@chromium.org>,
        Joe Perches <joe@perches.com>
References: <20211119113644.1600-1-alx.manpages@gmail.com>
 <20211120130104.185699-1-alx.manpages@gmail.com>
 <YZt8PdBH5JcWTurH@smile.fi.intel.com>
From:   "Alejandro Colomar (man-pages)" <alx.manpages@gmail.com>
In-Reply-To: <YZt8PdBH5JcWTurH@smile.fi.intel.com>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
Precedence: bulk


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/