Re: [PATCH v2 16/37] Documentation/module-signing.txt: convert to ReST markup

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Em Wed, 19 Oct 2016 06:58:12 +0200
Markus Heiser <markus.heiser@xxxxxxxxxxx> 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.

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 majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux