Am 19.10.2016 um 11:33 schrieb Mauro Carvalho Chehab <mche...@s-opensource.com>:

> Em Wed, 19 Oct 2016 06:58:12 +0200
> Markus Heiser <markus.hei...@darmarit.de> escreveu:
> 
>> just a small suggestion of mine ....
>> 
>> .. CONTENTS
>> 
>>  - Overview.
>>  - Configuring module signing.
>>  - Generating signing keys.
>>  - Public keys in the kernel.
>>  - Manually signing modules.
>>  - Signed modules and stripping.
>>  - Loading signed modules.
>>  - Non-valid signatures and unsigned modules.
>>  - Administering/protecting the private key.
>> 
>> should be enough.
> 
> True, but it sounds counter-intuitive to my C-language-training mind to 
> see a multi-line comment block with no end tag, like the above.

Ah, OK .. I didn't know if you aware about comment blocks and I thought
about readability in pure ASCII. IMO Both is OK.

--M--

> For my mental parser, this is a way more obvious that the entire block
> is commented:
> 
>       .. CONTENTS
>       ..
>       .. - Overview.
>       .. - Configuring module signing.
> 
> With resembles C99 comments, with '//'.
> 
> Thanks,
> Mauro

--
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Reply via email to