From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jonathan Corbet Subject: Re: [PATCH 1/2] Documentation/core-api/device_link: Add initial documentation Date: Mon, 5 Dec 2016 06:05:07 -0700 Message-ID: <20161205060507.6bd6e944@lwn.net> References: <20161205100720.5156a4d2@vento.lan> Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Return-path: In-Reply-To: <20161205100720.5156a4d2@vento.lan> Sender: linux-pm-owner@vger.kernel.org To: Mauro Carvalho Chehab Cc: Lukas Wunner , "Rafael J. Wysocki" , Greg Kroah-Hartman , Silvio Fricke , "Luis R. Rodriguez" , Marek Szyprowski , Bartlomiej Zolnierkiewicz , Andrzej Hajda , Inki Dae , Joerg Roedel , Kukjin Kim , Krzysztof Kozlowski , Mark Brown , Tomeu Vizoso , Kevin Hilman , Ulf Hansson , Geert Uytterhoeven , Tobias Jakobi , Tomasz Figa G List-Id: iommu@lists.linux-foundation.org On Mon, 5 Dec 2016 10:07:39 -0200 Mauro Carvalho Chehab wrote: > > +Usage > > +===== > > You should be using, instead: > > Usage > ----- > > (and the same '-' symbol for all sections of this chapter) > > The way you did, in thesis, ReST should be putting all tags at the > same level as the first one, as they're all using '='. Actually, he did exactly what the documentation guide says to do. Since it only has the markers below the heading, it will still be at a lower level than the top heading, which has markers both above and below. jon