From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S965551AbcIPUei (ORCPT ); Fri, 16 Sep 2016 16:34:38 -0400 Received: from ec2-52-27-115-49.us-west-2.compute.amazonaws.com ([52.27.115.49]:47849 "EHLO s-opensource.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S965082AbcIPUeb (ORCPT ); Fri, 16 Sep 2016 16:34:31 -0400 Date: Fri, 16 Sep 2016 17:34:26 -0300 From: Mauro Carvalho Chehab To: Jonathan Corbet Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , Markus Heiser , Jani Nikula , LKML Subject: Re: [PATCH v3 07/21] Documentation/CodingStyle: Convert to ReST markup Message-ID: <20160916173426.697d61d4@vento.lan> In-Reply-To: <20160916111314.5baa4f97@lwn.net> References: <20160916111314.5baa4f97@lwn.net> Organization: Samsung X-Mailer: Claws Mail 3.13.2 (GTK+ 2.24.30; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Em Fri, 16 Sep 2016 11:13:14 -0600 Jonathan Corbet escreveu: > On Wed, 14 Sep 2016 08:06:36 -0300 > Mauro Carvalho Chehab wrote: > > > - Fix all chapter identation; > > - add c blocks where needed; > > Here is where I think we need a bit of a philosophical discussion... > > > - Chapter 1: Indentation > > +Indentation > > +----------- > > You're a fan of having sphinx do the numbering, and I have no problem > understanding why. But this will defeat people who say "look in chapter 3 > of Documentation/CodingStyle". We're removing a bit of information from > the plain-text file and reserving it for the formatted version. If we're > really going to do that, we should do it consciously, with the knowledge > that there is a cost involved. > > We'll see this even more with SubmittingPatches, where it is quite common > for people to cite the number of the section they think is being violated > in any given situation. I see your point. However, AFAICT, there's no way to disable automatic numbering for LaTeX and PDF formats: it will always generate an index. It is actually worse than that: the numbering for the LaTeX and PDF versions of the document don't match with the numbering for html and ePub, and Sphinx restricts to just one numbered TOC index for the entire document. Currently, I don't know any way to fix it. So, keeping the current numeration there will produce a very messy PDF output, with the two numerations altogether. Thanks, Mauro