Re: [PATCH 08/29] rfkill.txt: standardize document format
From: Johannes Berg
Date: Fri May 19 2017 - 07:17:26 EST
On Fri, 2017-05-19 at 08:11 -0300, Mauro Carvalho Chehab wrote:
>
> Yes, it should work. Actually, you would need to use :depth: 2 to
> produce this output:
>
>
> Contents
>
> ÂÂÂÂ. rfkill - RF kill switch support
> ÂÂÂÂÂÂÂÂ. Introduction
> ÂÂÂÂÂÂÂÂ. Implementation details
> ÂÂÂÂÂÂÂÂ. Kernel API
> ÂÂÂÂÂÂÂÂ. Userspace support
Sounds good to me.
> I opted to keep the contents as a comment just because, in the past,
> some maintainers complained about TOC removal, arguing that it makes
> harder for the ones that would be reading the file in ascii.
Ok. I don't really care much either way, I guess. The file is short
enough that the TOC isn't all that important to start with.
johannes