All of lore.kernel.org
 help / color / mirror / Atom feed
From: Jonathan Corbet <corbet@lwn.net>
To: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Cc: "Linux Doc Mailing List" <linux-doc@vger.kernel.org>,
	"Mauro Carvalho Chehab" <mchehab@infradead.org>,
	linux-kernel@vger.kernel.org,
	"Catalin Marinas" <catalin.marinas@arm.com>,
	"Will Deacon" <will.deacon@arm.com>,
	"Harry Wei" <harryxiyou@gmail.com>,
	"Alex Shi" <alex.shi@linux.alibaba.com>,
	"Paolo Bonzini" <pbonzini@redhat.com>,
	"Radim Krčmář" <rkrcmar@redhat.com>,
	"Ard Biesheuvel" <ard.biesheuvel@linaro.org>,
	linux-arm-kernel@lists.infradead.org, kvm@vger.kernel.org,
	linux-efi@vger.kernel.org
Subject: Re: [PATCH v4 02/28] docs: arm64: convert docs to ReST and rename to .rst
Date: Fri, 14 Jun 2019 14:34:29 -0600	[thread overview]
Message-ID: <20190614143429.640226ec@lwn.net> (raw)
In-Reply-To: <20190614141041.335a76e5@lwn.net>

On Fri, 14 Jun 2019 14:10:41 -0600
Jonathan Corbet <corbet@lwn.net> wrote:

> On Wed, 12 Jun 2019 14:52:38 -0300
> Mauro Carvalho Chehab <mchehab+samsung@kernel.org> wrote:
> 
> > The documentation is in a format that is very close to ReST format.
> > 
> > The conversion is actually:
> >   - add blank lines in order to identify paragraphs;
> >   - fixing tables markups;
> >   - adding some lists markups;
> >   - marking literal blocks;
> >   - adjust some title markups.
> > 
> > At its new index.rst, let's add a :orphan: while this is not linked to
> > the main index.rst file, in order to avoid build warnings.  
> 
> This one doesn't apply to docs-next, since there's a bunch of stuff in
> linux-next that I don't have.  I'd suggest that it either go by way of an
> ARM tree or send it my way again after the ARM changes go upstream.

Actually, nevermind.  Pulling my tree forward to 5.2-rc4 resolved the
issues here.

Thanks,

jon

WARNING: multiple messages have this Message-ID (diff)
From: Jonathan Corbet <corbet@lwn.net>
To: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Cc: "Ard Biesheuvel" <ard.biesheuvel@linaro.org>,
	kvm@vger.kernel.org,
	"Linux Doc Mailing List" <linux-doc@vger.kernel.org>,
	linux-efi@vger.kernel.org,
	"Catalin Marinas" <catalin.marinas@arm.com>,
	"Radim Krčmář" <rkrcmar@redhat.com>,
	"Will Deacon" <will.deacon@arm.com>,
	linux-kernel@vger.kernel.org,
	"Mauro Carvalho Chehab" <mchehab@infradead.org>,
	"Harry Wei" <harryxiyou@gmail.com>,
	"Paolo Bonzini" <pbonzini@redhat.com>,
	"Alex Shi" <alex.shi@linux.alibaba.com>,
	linux-arm-kernel@lists.infradead.org
Subject: Re: [PATCH v4 02/28] docs: arm64: convert docs to ReST and rename to .rst
Date: Fri, 14 Jun 2019 14:34:29 -0600	[thread overview]
Message-ID: <20190614143429.640226ec@lwn.net> (raw)
In-Reply-To: <20190614141041.335a76e5@lwn.net>

On Fri, 14 Jun 2019 14:10:41 -0600
Jonathan Corbet <corbet@lwn.net> wrote:

> On Wed, 12 Jun 2019 14:52:38 -0300
> Mauro Carvalho Chehab <mchehab+samsung@kernel.org> wrote:
> 
> > The documentation is in a format that is very close to ReST format.
> > 
> > The conversion is actually:
> >   - add blank lines in order to identify paragraphs;
> >   - fixing tables markups;
> >   - adding some lists markups;
> >   - marking literal blocks;
> >   - adjust some title markups.
> > 
> > At its new index.rst, let's add a :orphan: while this is not linked to
> > the main index.rst file, in order to avoid build warnings.  
> 
> This one doesn't apply to docs-next, since there's a bunch of stuff in
> linux-next that I don't have.  I'd suggest that it either go by way of an
> ARM tree or send it my way again after the ARM changes go upstream.

Actually, nevermind.  Pulling my tree forward to 5.2-rc4 resolved the
issues here.

Thanks,

jon

_______________________________________________
linux-arm-kernel mailing list
linux-arm-kernel@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/linux-arm-kernel

  reply	other threads:[~2019-06-14 20:34 UTC|newest]

Thread overview: 96+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2019-06-12 17:52 [PATCH v4 00/28] Convert files to ReST - part 1 Mauro Carvalho Chehab
2019-06-12 17:52 ` Mauro Carvalho Chehab
2019-06-12 17:52 ` [PATCH v4 01/28] docs: aoe: convert docs to ReST and rename to *.rst Mauro Carvalho Chehab
2019-06-12 17:52 ` [PATCH v4 02/28] docs: arm64: convert docs to ReST and rename to .rst Mauro Carvalho Chehab
2019-06-12 17:52   ` Mauro Carvalho Chehab
2019-06-14 20:10   ` Jonathan Corbet
2019-06-14 20:10     ` Jonathan Corbet
2019-06-14 20:34     ` Jonathan Corbet [this message]
2019-06-14 20:34       ` Jonathan Corbet
2019-06-12 17:52 ` [PATCH v4 03/28] docs: cdrom-standard.tex: convert from LaTeX to ReST Mauro Carvalho Chehab
2019-06-12 17:52 ` [PATCH v4 04/28] docs: cdrom: convert docs to ReST and rename to *.rst Mauro Carvalho Chehab
2019-06-12 17:52 ` [PATCH v4 05/28] docs: cgroup-v1: " Mauro Carvalho Chehab
2019-06-12 17:52   ` Mauro Carvalho Chehab
2019-06-14 20:14   ` Jonathan Corbet
2019-06-14 20:14     ` Jonathan Corbet
2019-06-14 20:30     ` Tejun Heo
2019-06-14 20:30       ` Tejun Heo
2019-06-12 17:52 ` [PATCH v4 06/28] docs: cgroup-v1/blkio-controller.rst: add a note about CFQ scheduler Mauro Carvalho Chehab
2019-06-12 17:52 ` [PATCH v4 07/28] docs: convert docs to ReST and rename to *.rst Mauro Carvalho Chehab
2019-06-12 17:52 ` [PATCH v4 08/28] docs: fault-injection: " Mauro Carvalho Chehab
2019-06-12 17:52 ` [PATCH v4 09/28] docs: fb: " Mauro Carvalho Chehab
2019-06-12 17:52 ` [PATCH v4 10/28] docs: fpga: " Mauro Carvalho Chehab
2019-06-12 17:52 ` [PATCH v4 11/28] docs: ide: " Mauro Carvalho Chehab
2019-06-12 17:52 ` [PATCH v4 12/28] docs: kbuild: " Mauro Carvalho Chehab
2019-06-12 17:52   ` [Bridge] " Mauro Carvalho Chehab
2019-06-12 17:52   ` [OpenRISC] " Mauro Carvalho Chehab
2019-06-12 17:52   ` Mauro Carvalho Chehab
2019-06-12 17:52   ` Mauro Carvalho Chehab
2019-06-12 17:52   ` Mauro Carvalho Chehab
2019-06-12 17:52   ` Mauro Carvalho Chehab
2019-06-12 17:52 ` [PATCH v4 13/28] docs: kdump: " Mauro Carvalho Chehab
2019-06-12 17:52   ` Mauro Carvalho Chehab
2019-06-12 17:52   ` Mauro Carvalho Chehab
2019-06-12 17:52   ` Mauro Carvalho Chehab
2019-06-12 17:52   ` Mauro Carvalho Chehab
2019-06-12 17:52 ` [PATCH v4 14/28] docs: locking: " Mauro Carvalho Chehab
2019-06-12 17:52   ` Mauro Carvalho Chehab
2019-06-14 20:36   ` Jonathan Corbet
2019-06-12 17:52 ` [PATCH v4 15/28] docs: mic: " Mauro Carvalho Chehab
2019-06-12 17:52 ` [PATCH v4 16/28] docs: netlabel: " Mauro Carvalho Chehab
2019-06-12 17:52 ` [PATCH v4 17/28] docs: pcmcia: " Mauro Carvalho Chehab
2019-06-12 17:52 ` [PATCH v4 18/28] docs: " Mauro Carvalho Chehab
2019-06-12 17:52   ` Mauro Carvalho Chehab
2019-06-13  0:25   ` Srivatsa S. Bhat
2019-06-13  0:25     ` Srivatsa S. Bhat
2019-06-13  0:25     ` Srivatsa S. Bhat
2019-06-13  9:58     ` Mauro Carvalho Chehab
2019-06-13  9:58       ` Mauro Carvalho Chehab
2019-06-13  9:58       ` Mauro Carvalho Chehab
2019-06-13 10:10     ` [PATCH v5] docs: power: " Mauro Carvalho Chehab
2019-06-13 10:10       ` Mauro Carvalho Chehab
2019-06-14 20:36       ` Jonathan Corbet
2019-06-14 20:36         ` Jonathan Corbet
2019-06-14 20:36         ` Jonathan Corbet
2019-06-14 21:14         ` Bjorn Helgaas
2019-06-14 21:14           ` Bjorn Helgaas
2019-06-14 21:14           ` Bjorn Helgaas
2019-06-13 15:58   ` [PATCH v4 18/28] docs: " Mathieu Poirier
2019-06-13 15:58     ` Mathieu Poirier
2019-06-12 17:52 ` [PATCH v4 19/28] docs: powerpc: " Mauro Carvalho Chehab
2019-06-12 17:52   ` Mauro Carvalho Chehab
2019-06-12 17:52   ` Mauro Carvalho Chehab
2019-06-12 17:52   ` Mauro Carvalho Chehab
2019-06-14 20:36   ` Jonathan Corbet
2019-06-14 20:36     ` Jonathan Corbet
2019-06-14 20:36     ` Jonathan Corbet
2019-06-14 20:36     ` Jonathan Corbet
2019-06-14 21:30     ` Bjorn Helgaas
2019-06-14 21:30       ` Bjorn Helgaas
2019-06-14 21:30       ` Bjorn Helgaas
2019-06-14 21:30       ` Bjorn Helgaas
2019-06-18 12:39     ` Michael Ellerman
2019-06-18 12:39       ` Michael Ellerman
2019-06-18 12:39       ` Michael Ellerman
2019-06-18 12:39       ` Michael Ellerman
2019-06-12 17:52 ` [PATCH v4 20/28] docs: pps.txt: convert to ReST and rename to pps.rst Mauro Carvalho Chehab
2019-06-12 17:52 ` [PATCH v4 21/28] docs: ptp.txt: convert to ReST and move to driver-api Mauro Carvalho Chehab
2019-06-12 17:52 ` [PATCH v4 22/28] docs: riscv: convert docs to ReST and rename to *.rst Mauro Carvalho Chehab
2019-06-12 17:52   ` Mauro Carvalho Chehab
2019-06-12 17:52 ` [PATCH v4 23/28] docs: target: " Mauro Carvalho Chehab
2019-06-12 17:52   ` Mauro Carvalho Chehab
2019-06-19  3:38   ` Martin K. Petersen
2019-06-19  3:38     ` Martin K. Petersen
2019-06-12 17:53 ` [PATCH v4 24/28] docs: timers: " Mauro Carvalho Chehab
2019-06-12 17:53   ` Mauro Carvalho Chehab
2019-06-12 18:25   ` Mark Brown
2019-06-12 17:53 ` [PATCH v4 25/28] docs: watchdog: " Mauro Carvalho Chehab
2019-06-12 17:53 ` [PATCH v4 26/28] docs: xilinx: convert eemi.txt to eemi.rst Mauro Carvalho Chehab
2019-06-12 17:53   ` Mauro Carvalho Chehab
2019-06-12 17:53 ` [PATCH v4 27/28] docs: scheduler: convert docs to ReST and rename to *.rst Mauro Carvalho Chehab
2019-06-12 17:53 ` [PATCH v4 28/28] docs: EDID/HOWTO.txt: convert it and rename to howto.rst Mauro Carvalho Chehab
2019-06-12 17:53   ` Mauro Carvalho Chehab
2019-06-14 20:36 ` [PATCH v4 00/28] Convert files to ReST - part 1 Jonathan Corbet
2019-06-14 20:36   ` Jonathan Corbet
2019-06-18 14:14   ` Mauro Carvalho Chehab
2019-06-18 14:14     ` Mauro Carvalho Chehab

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20190614143429.640226ec@lwn.net \
    --to=corbet@lwn.net \
    --cc=alex.shi@linux.alibaba.com \
    --cc=ard.biesheuvel@linaro.org \
    --cc=catalin.marinas@arm.com \
    --cc=harryxiyou@gmail.com \
    --cc=kvm@vger.kernel.org \
    --cc=linux-arm-kernel@lists.infradead.org \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-efi@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=mchehab+samsung@kernel.org \
    --cc=mchehab@infradead.org \
    --cc=pbonzini@redhat.com \
    --cc=rkrcmar@redhat.com \
    --cc=will.deacon@arm.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.