From: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
To: Petr Mladek <pmladek@suse.com>
Cc: Linux Doc Mailing List <linux-doc@vger.kernel.org>,
Mauro Carvalho Chehab <mchehab@infradead.org>,
linux-kernel@vger.kernel.org, Jonathan Corbet <corbet@lwn.net>,
Josh Poimboeuf <jpoimboe@redhat.com>,
Jiri Kosina <jikos@kernel.org>, Miroslav Benes <mbenes@suse.cz>,
Joe Lawrence <joe.lawrence@redhat.com>,
live-patching@vger.kernel.org
Subject: Re: [PATCH 20/57] docs: livepatch: convert it to ReST format
Date: Tue, 16 Apr 2019 08:47:19 -0300 [thread overview]
Message-ID: <20190416084719.4284d31d@coco.lan> (raw)
In-Reply-To: <20190416084354.ol7umvh2lmii6jbk@pathway.suse.cz>
Em Tue, 16 Apr 2019 10:43:54 +0200
Petr Mladek <pmladek@suse.com> escreveu:
> On Mon 2019-04-15 23:55:45, Mauro Carvalho Chehab wrote:
> > Convert livepatch documentation to ReST format. The changes
> > are mostly trivial, as the documents are already on a good
> > shape. Just a few markup changes are needed for Sphinx to
> > properly parse the docs.
> >
> > Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
>
> Thanks a lot for the conversion. I tried html output and
> it looks very well.
>
> Just a question. This patch does only the formatting.
> The documentation is not really generated because the file
> is not renamed to .rst. Also it is not referenced from
> any top level documents. Is it by intention?
Yes. The rationale is simple: renaming to .rst would require
to add them on an index file (or otherwise build would produce lots
of warnings). As this series is doing a lot of such conversions,
assuming that some of those patches will go through different
trees, that would cause lots of conflicts at the main index files.
So, it sounds better to apply the conversion first and then,
on a better moment (maybe late during the merge window), do the
rename and add to the index files.
>
>
> I am happy even for the conversion, so:
>
> Reviewed-by: Petr Mladek <pmladek@suse.com>
>
> Best Regards,
> Petr
Thanks,
Mauro
next prev parent reply other threads:[~2019-04-16 11:47 UTC|newest]
Thread overview: 121+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-04-16 2:55 [PATCH 00/57] Convert files to ReST Mauro Carvalho Chehab
2019-04-16 2:55 ` Mauro Carvalho Chehab
2019-04-16 2:55 ` Mauro Carvalho Chehab
2019-04-16 2:55 ` Mauro Carvalho Chehab
2019-04-16 2:55 ` Mauro Carvalho Chehab
2019-04-16 2:55 ` Mauro Carvalho Chehab
2019-04-16 2:55 ` Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 01/57] docs: trace: fix some Sphinx warnings Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 02/57] docs: acpi: convert text files to ReST Mauro Carvalho Chehab
2019-04-16 8:17 ` Rafael J. Wysocki
2019-04-16 9:54 ` Mauro Carvalho Chehab
2019-04-16 10:17 ` Rafael J. Wysocki
2019-04-16 14:55 ` Changbin Du
2019-04-22 13:31 ` Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 03/57] docs: aoe: " Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 04/57] docs: arm64: convert documentation to ReST format Mauro Carvalho Chehab
2019-04-16 2:55 ` Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 05/57] docs: cdrom/cdrom-standard.tex: convert from LaTeX to ReST Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 06/57] docs: cdrom: convert remaining files " Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 07/57] docs: cgroup-v1: convert to ReST file format Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 08/57] docs: cgroup-v1/blkio-controller.rst: add a note about CFQ scheduler Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 09/57] docs: cpu-freq: convert files to ReST Mauro Carvalho Chehab
2019-04-16 8:21 ` Rafael J. Wysocki
2019-04-16 9:58 ` Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 10/57] docs: device-mapper: convert it to ReST format Mauro Carvalho Chehab
2019-04-16 13:28 ` Mike Snitzer
2019-04-16 14:00 ` Jonathan Corbet
2019-04-16 14:33 ` Mauro Carvalho Chehab
2019-04-16 15:48 ` Mike Snitzer
2019-04-16 17:27 ` Jonathan Corbet
2019-04-16 18:14 ` Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 11/57] docs: extcon: move it to acpi dir and convert it to ReST Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 12/57] docs: fault-injection: convert it to ReST format Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 13/57] docs: fb: convert documentation " Mauro Carvalho Chehab
2019-04-16 2:55 ` Mauro Carvalho Chehab
2019-05-06 13:36 ` Bartlomiej Zolnierkiewicz
2019-05-06 13:36 ` Bartlomiej Zolnierkiewicz
2019-04-16 2:55 ` [PATCH 14/57] docs: fpga: convert it to ReST Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 15/57] docs: gpio: " Mauro Carvalho Chehab
2019-04-23 10:52 ` Linus Walleij
2019-04-23 12:38 ` Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 16/57] docs: ide: convert it to ReST format Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 17/57] docs: infiniband: " Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 18/57] docs: kbuild: convert it to ReST output Mauro Carvalho Chehab
2019-04-18 9:25 ` Masahiro Yamada
2019-04-18 10:26 ` Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 19/57] docs: kdump: convert it to ReST Mauro Carvalho Chehab
2019-04-16 2:55 ` Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 20/57] docs: livepatch: convert it to ReST format Mauro Carvalho Chehab
2019-04-16 8:43 ` Petr Mladek
2019-04-16 11:47 ` Mauro Carvalho Chehab [this message]
2019-04-16 2:55 ` [PATCH 21/57] docs: locking: convert docs " Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 22/57] docs: mic: convert it " Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 23/57] docs: netlabel: convert it to ReST Mauro Carvalho Chehab
2019-04-17 14:36 ` Paul Moore
2019-04-16 2:55 ` [PATCH 24/57] docs: pcmcia: convert it to ReST format Mauro Carvalho Chehab
2019-04-16 4:58 ` Dominik Brodowski
2019-04-16 2:55 ` [PATCH 25/57] docs: power: convert docs to ReST Mauro Carvalho Chehab
2019-04-16 7:20 ` Pavel Machek
2019-04-16 8:59 ` Rafael J. Wysocki
2019-04-16 10:41 ` Mauro Carvalho Chehab
2019-04-16 10:47 ` Rafael J. Wysocki
2019-04-16 2:55 ` [PATCH 26/57] docs: powerpc: " Mauro Carvalho Chehab
2019-04-16 2:55 ` Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 27/57] docs: pps/pps.txt convert it to ReST and move to API book Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 28/57] docs: ptp.txt: convert to ReST and move to driver-api Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 29/57] docs: riscv: convert it to ReST format Mauro Carvalho Chehab
2019-04-16 2:55 ` Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 30/57] docs: s390: Debugging390.txt: convert table to ascii artwork Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 31/57] docs: s390: convert text files to ReST format Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 32/57] s390: include/asm/debug.h add kerneldoc markups Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 33/57] docs: serial: convert it to ReST format Mauro Carvalho Chehab
2019-04-16 2:55 ` [PATCH 34/57] docs: target: " Mauro Carvalho Chehab
2019-04-16 2:55 ` Mauro Carvalho Chehab
2019-04-16 2:56 ` [PATCH 35/57] docs: timers: convert documentation to ReST Mauro Carvalho Chehab
2019-04-16 2:56 ` [PATCH 36/57] docs: usb: convert documents " Mauro Carvalho Chehab
2019-04-16 2:56 ` [36/57] " Mauro Carvalho Chehab
2019-04-16 6:12 ` [PATCH 36/57] " Felipe Balbi
2019-04-16 6:12 ` [36/57] " Felipe Balbi
2019-04-16 11:43 ` [PATCH 36/57] " Mauro Carvalho Chehab
2019-04-16 11:43 ` [36/57] " Mauro Carvalho Chehab
2019-04-16 2:56 ` [PATCH 37/57] docs: watchdog: convert documents to ReST format Mauro Carvalho Chehab
2019-04-17 17:53 ` Guenter Roeck
2019-04-16 2:56 ` [PATCH 38/57] docs: x86: convert text files to ReST Mauro Carvalho Chehab
2019-04-16 2:56 ` [PATCH 39/57] docs: xilinx: convert eemi.txt " Mauro Carvalho Chehab
2019-04-16 2:56 ` Mauro Carvalho Chehab
2019-04-16 2:56 ` [PATCH 40/57] docs: scheduler: convert files " Mauro Carvalho Chehab
2019-04-16 2:56 ` [PATCH 41/57] docs: EDID/HOWTO.txt: convert to ReST and move to kernel-API Mauro Carvalho Chehab
2019-04-16 2:56 ` [PATCH 42/57] docs: connector.txt: convert to ReST Mauro Carvalho Chehab
2019-04-16 2:56 ` [PATCH 43/57] docs: lcd-panel-cgram.txt convert it to ReST and move to admin-guide Mauro Carvalho Chehab
2019-04-16 2:56 ` [PATCH 44/57] docs: lp855x-driver.txt: convert to ReST and move to kernel-api Mauro Carvalho Chehab
2019-04-16 2:56 ` [PATCH 45/57] docs: m68k: convert it to ReST file format and add to arch bookset Mauro Carvalho Chehab
2019-04-16 2:56 ` [PATCH 46/57] docs: cma/debugfs.txt: convert to ReST and move to admin-guide/mm Mauro Carvalho Chehab
2019-04-16 5:21 ` Mike Rapoport
2019-04-16 11:35 ` Mauro Carvalho Chehab
2019-04-16 2:56 ` [PATCH 47/57] docs: console.txt: convert to ReST format Mauro Carvalho Chehab
2019-04-16 2:56 ` [PATCH 48/57] docs: pti_intel_mid.txt: convert to ReST Mauro Carvalho Chehab
2019-04-16 2:56 ` [PATCH 49/57] docs: early-userspace: convert docs " Mauro Carvalho Chehab
2019-04-16 2:56 ` [PATCH 50/57] docs: driver-model: convert it to ReST format Mauro Carvalho Chehab
2019-04-16 2:56 ` [PATCH 51/57] docs: arm: convert text files " Mauro Carvalho Chehab
2019-04-16 2:56 ` Mauro Carvalho Chehab
2019-04-16 2:56 ` [PATCH 52/57] docs: memory-devices: convert ti-emif.txt " Mauro Carvalho Chehab
2019-04-16 2:56 ` [PATCH 53/57] docs: xen-tpmfront.txt: convert the file " Mauro Carvalho Chehab
2019-04-16 2:56 ` [PATCH 54/57] docs: bus-devices: ti-gpmc.txt: convert it to ReST Mauro Carvalho Chehab
2019-04-16 2:56 ` [PATCH 55/57] docs: nvmem: convert file to ReST format Mauro Carvalho Chehab
2019-04-16 2:56 ` [PATCH 56/57] docs: phy: convert samsung-usb2.txt " Mauro Carvalho Chehab
2019-04-16 2:56 ` [PATCH 57/57] docs: Prepare files to be renamed to *.rst Mauro Carvalho Chehab
2019-04-18 12:42 ` Avoiding merge conflicts while adding new docs - Was: Re: [PATCH 00/57] Convert files to ReST Mauro Carvalho Chehab
2019-04-18 12:42 ` Mauro Carvalho Chehab
2019-04-18 12:42 ` Mauro Carvalho Chehab
2019-04-18 12:42 ` Mauro Carvalho Chehab
2019-04-18 12:42 ` Mauro Carvalho Chehab
2019-04-18 12:42 ` Mauro Carvalho Chehab
2019-04-18 12:42 ` Mauro Carvalho Chehab
2019-04-19 22:10 ` Jonathan Corbet
2019-04-19 22:10 ` Jonathan Corbet
2019-04-19 22:10 ` Jonathan Corbet
2019-04-19 22:10 ` Jonathan Corbet
2019-04-19 22:10 ` Jonathan Corbet
2019-04-19 22:10 ` Jonathan Corbet
2019-04-19 22:10 ` Jonathan Corbet
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=20190416084719.4284d31d@coco.lan \
--to=mchehab+samsung@kernel.org \
--cc=corbet@lwn.net \
--cc=jikos@kernel.org \
--cc=joe.lawrence@redhat.com \
--cc=jpoimboe@redhat.com \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=live-patching@vger.kernel.org \
--cc=mbenes@suse.cz \
--cc=mchehab@infradead.org \
--cc=pmladek@suse.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.