Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > linux.kernel > #1645521

Re: [PATCH 08/29] rfkill.txt: standardize document format

From Johannes Berg <johannes@sipsolutions.net>
Newsgroups linux.kernel
Subject Re: [PATCH 08/29] rfkill.txt: standardize document format
Date 2017-05-19 13:20 +0200
Message-ID <tIO6R-1nG-9@gated-at.bofh.it> (permalink)
References <tIETU-39a-9@gated-at.bofh.it> <tIETV-39a-63@gated-at.bofh.it> <tINaN-JU-5@gated-at.bofh.it> <tIO6R-1nG-11@gated-at.bofh.it>
Organization linux.* mail to news gateway

Show all headers | View raw


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

Back to linux.kernel | Previous | NextPrevious in thread | Next in thread | Find similar | Unroll thread


Thread

[PATCH 08/29] rfkill.txt: standardize document format Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2017-05-19 03:30 +0200
  Re: [PATCH 08/29] rfkill.txt: standardize document format Johannes Berg <johannes@sipsolutions.net> - 2017-05-19 12:20 +0200
    Re: [PATCH 08/29] rfkill.txt: standardize document format Johannes Berg <johannes@sipsolutions.net> - 2017-05-19 13:20 +0200
    Re: [PATCH 08/29] rfkill.txt: standardize document format Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2017-05-19 13:20 +0200

csiph-web