From: Mauro Carvalho Chehab <mchehab+samsung@kernel.org> To: Heiko Carstens <heiko.carstens@de.ibm.com> Cc: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>, Linux Doc Mailing List <linux-doc@vger.kernel.org>, linux-kernel@vger.kernel.org, Jonathan Corbet <corbet@lwn.net>, Palmer Dabbelt <palmer@sifive.com>, Albert Ou <aou@eecs.berkeley.edu>, Alexei Starovoitov <ast@kernel.org>, Daniel Borkmann <daniel@iogearbox.net>, Martin KaFai Lau <kafai@fb.com>, Song Liu <songliubraving@fb.com>, Yonghong Song <yhs@fb.com>, Greentime Hu <green.hu@gmail.com>, Vincent Chen <deanbo422@gmail.com>, linux-riscv@lists.infradead.org, netdev@vger.kernel.org, bpf@vger.kernel.org Subject: Re: [PATCH v3 00/33] Convert files to ReST - part 1 Date: Sun, 9 Jun 2019 09:29:40 -0300 [thread overview] Message-ID: <20190609092940.5e34e3b0@recife.lan> (raw) In-Reply-To: <20190609091642.GA3705@osiris> Em Sun, 9 Jun 2019 11:16:43 +0200 Heiko Carstens <heiko.carstens@de.ibm.com> escreveu: > On Sat, Jun 08, 2019 at 11:26:50PM -0300, Mauro Carvalho Chehab wrote: > > This is the first part of a series I wrote sometime ago where I manually > > convert lots of files to be properly parsed by Sphinx as ReST files. > > > > As it touches on lot of stuff, this series is based on today's docs-next > > + linux-next, at tag next-20190607. > > > > I have right now about 85 patches with this undergoing work. That's > > because I opted to do ~1 patch per converted directory. > > > > That sounds too much to be send on a single round. So, I'm opting to split > > it on 3 parts. Those patches should probably be good to be merged > > either by subsystem maintainers or via the docs tree. > > > > I opted to mark new files not included yet to the main index.rst (directly or > > indirectly ) with the :orphan: tag, in order to avoid adding warnings to the > > build system. This should be removed after we find a "home" for all > > the converted files within the new document tree arrangement. > > > > Both this series and the next parts are on my devel git tree, > > at: > > > > https://git.linuxtv.org/mchehab/experimental.git/log/?h=convert_rst_renames_v4 > > > > The final output in html (after all patches I currently have, including > > the upcoming series) can be seen at: > > > > https://www.infradead.org/~mchehab/rst_conversion/ > > Will there be a web page (e.g. kernel.org), which contains always the > latest upstream version? Yes: https://www.kernel.org/doc/html/latest/ I guess this one is based on Linus tree. Jon also maintains a version at: https://static.lwn.net/kerneldoc/ I guess that one is based on docs-next branch from the Docs tree. Btw, if you want to build it for yourself, you could use: make htmldocs If your system doesn't have all dependencies, it will give the hints about how to install them. > > > docs: Debugging390.txt: convert table to ascii artwork > > docs: s390: convert docs to ReST and rename to *.rst > > s390: include/asm/debug.h add kerneldoc markups > > I can pick these up for s390. Or do you want to send the whole series > in one go upstream? Yeah, feel free to pick them via the s390 tree. Regards, Mauro Thanks, Mauro Thanks, Mauro
WARNING: multiple messages have this Message-ID (diff)
From: Mauro Carvalho Chehab <mchehab+samsung@kernel.org> To: Heiko Carstens <heiko.carstens@de.ibm.com> Cc: Song Liu <songliubraving@fb.com>, Albert Ou <aou@eecs.berkeley.edu>, bpf@vger.kernel.org, Daniel Borkmann <daniel@iogearbox.net>, Jonathan Corbet <corbet@lwn.net>, netdev@vger.kernel.org, Palmer Dabbelt <palmer@sifive.com>, Linux Doc Mailing List <linux-doc@vger.kernel.org>, linux-kernel@vger.kernel.org, Alexei Starovoitov <ast@kernel.org>, Greentime Hu <green.hu@gmail.com>, Mauro Carvalho Chehab <mchehab+samsung@kernel.org>, Yonghong Song <yhs@fb.com>, linux-riscv@lists.infradead.org, Vincent Chen <deanbo422@gmail.com>, Martin KaFai Lau <kafai@fb.com> Subject: Re: [PATCH v3 00/33] Convert files to ReST - part 1 Date: Sun, 9 Jun 2019 09:29:40 -0300 [thread overview] Message-ID: <20190609092940.5e34e3b0@recife.lan> (raw) In-Reply-To: <20190609091642.GA3705@osiris> Em Sun, 9 Jun 2019 11:16:43 +0200 Heiko Carstens <heiko.carstens@de.ibm.com> escreveu: > On Sat, Jun 08, 2019 at 11:26:50PM -0300, Mauro Carvalho Chehab wrote: > > This is the first part of a series I wrote sometime ago where I manually > > convert lots of files to be properly parsed by Sphinx as ReST files. > > > > As it touches on lot of stuff, this series is based on today's docs-next > > + linux-next, at tag next-20190607. > > > > I have right now about 85 patches with this undergoing work. That's > > because I opted to do ~1 patch per converted directory. > > > > That sounds too much to be send on a single round. So, I'm opting to split > > it on 3 parts. Those patches should probably be good to be merged > > either by subsystem maintainers or via the docs tree. > > > > I opted to mark new files not included yet to the main index.rst (directly or > > indirectly ) with the :orphan: tag, in order to avoid adding warnings to the > > build system. This should be removed after we find a "home" for all > > the converted files within the new document tree arrangement. > > > > Both this series and the next parts are on my devel git tree, > > at: > > > > https://git.linuxtv.org/mchehab/experimental.git/log/?h=convert_rst_renames_v4 > > > > The final output in html (after all patches I currently have, including > > the upcoming series) can be seen at: > > > > https://www.infradead.org/~mchehab/rst_conversion/ > > Will there be a web page (e.g. kernel.org), which contains always the > latest upstream version? Yes: https://www.kernel.org/doc/html/latest/ I guess this one is based on Linus tree. Jon also maintains a version at: https://static.lwn.net/kerneldoc/ I guess that one is based on docs-next branch from the Docs tree. Btw, if you want to build it for yourself, you could use: make htmldocs If your system doesn't have all dependencies, it will give the hints about how to install them. > > > docs: Debugging390.txt: convert table to ascii artwork > > docs: s390: convert docs to ReST and rename to *.rst > > s390: include/asm/debug.h add kerneldoc markups > > I can pick these up for s390. Or do you want to send the whole series > in one go upstream? Yeah, feel free to pick them via the s390 tree. Regards, Mauro Thanks, Mauro Thanks, Mauro _______________________________________________ linux-riscv mailing list linux-riscv@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-riscv
next prev parent reply other threads:[~2019-06-09 12:29 UTC|newest] Thread overview: 99+ messages / expand[flat|nested] mbox.gz Atom feed top 2019-06-09 2:26 [PATCH v3 00/33] Convert files to ReST - part 1 Mauro Carvalho Chehab 2019-06-09 2:26 ` Mauro Carvalho Chehab 2019-06-09 2:26 ` [PATCH v3 01/33] docs: aoe: convert docs to ReST and rename to *.rst Mauro Carvalho Chehab 2019-06-09 2:26 ` [PATCH v3 02/33] docs: arm64: convert docs to ReST and rename to .rst Mauro Carvalho Chehab 2019-06-09 2:26 ` Mauro Carvalho Chehab 2019-06-09 2:26 ` [PATCH v3 03/33] docs: cdrom-standard.tex: convert from LaTeX to ReST Mauro Carvalho Chehab 2019-06-09 2:26 ` [PATCH v3 04/33] docs: cdrom: convert docs to ReST and rename to *.rst Mauro Carvalho Chehab 2019-06-09 2:26 ` [PATCH v3 05/33] docs: cgroup-v1: " Mauro Carvalho Chehab 2019-06-09 2:26 ` Mauro Carvalho Chehab 2019-06-11 19:03 ` Tejun Heo 2019-06-11 19:03 ` Tejun Heo 2019-06-09 2:26 ` [PATCH v3 06/33] docs: cgroup-v1/blkio-controller.rst: add a note about CFQ scheduler Mauro Carvalho Chehab 2019-06-09 2:26 ` [PATCH v3 07/33] docs: cpu-freq: convert docs to ReST and rename to *.rst Mauro Carvalho Chehab 2019-06-09 21:38 ` Rafael J. Wysocki 2019-06-10 0:27 ` Mauro Carvalho Chehab 2019-06-09 2:26 ` [PATCH v3 08/33] docs: " Mauro Carvalho Chehab 2019-06-09 2:26 ` Mauro Carvalho Chehab 2019-06-09 2:26 ` [PATCH v3 09/33] docs: fault-injection: " Mauro Carvalho Chehab 2019-06-10 16:24 ` Federico Vaga 2019-06-09 2:27 ` [PATCH v3 10/33] docs: fb: " Mauro Carvalho Chehab 2019-06-09 7:54 ` Geert Uytterhoeven 2019-06-09 7:54 ` Geert Uytterhoeven 2019-06-09 7:54 ` Geert Uytterhoeven 2019-06-09 2:27 ` [PATCH v3 11/33] docs: fpga: " Mauro Carvalho Chehab 2019-06-09 2:27 ` [PATCH v3 12/33] docs: ide: " Mauro Carvalho Chehab 2019-06-09 7:50 ` Geert Uytterhoeven 2019-06-09 2:27 ` [PATCH v3 13/33] docs: infiniband: " Mauro Carvalho Chehab 2019-06-10 17:27 ` Jason Gunthorpe 2019-06-10 17:35 ` Jonathan Corbet 2019-06-25 13:24 ` Jason Gunthorpe 2019-06-09 2:27 ` [PATCH v3 14/33] docs: kbuild: " Mauro Carvalho Chehab 2019-06-09 2:27 ` [Bridge] " Mauro Carvalho Chehab 2019-06-09 2:27 ` [OpenRISC] " Mauro Carvalho Chehab 2019-06-09 2:27 ` Mauro Carvalho Chehab 2019-06-09 2:27 ` Mauro Carvalho Chehab 2019-06-09 2:27 ` Mauro Carvalho Chehab 2019-06-09 2:27 ` Mauro Carvalho Chehab 2019-06-10 16:25 ` Federico Vaga 2019-06-10 16:25 ` [Bridge] " Federico Vaga 2019-06-10 16:25 ` [OpenRISC] " Federico Vaga 2019-06-10 16:25 ` Federico Vaga 2019-06-10 16:48 ` Federico Vaga 2019-06-10 16:48 ` [Bridge] " Federico Vaga 2019-06-10 16:48 ` [OpenRISC] " Federico Vaga 2019-06-10 16:48 ` Federico Vaga 2019-06-09 2:27 ` [PATCH v3 15/33] docs: kdump: " Mauro Carvalho Chehab 2019-06-09 2:27 ` Mauro Carvalho Chehab 2019-06-09 2:27 ` Mauro Carvalho Chehab 2019-06-09 2:27 ` Mauro Carvalho Chehab 2019-06-09 2:27 ` Mauro Carvalho Chehab 2019-06-09 2:27 ` [PATCH v3 16/33] docs: locking: " Mauro Carvalho Chehab 2019-06-09 2:27 ` Mauro Carvalho Chehab 2019-06-10 16:26 ` Federico Vaga 2019-06-09 2:27 ` [PATCH v3 17/33] docs: mic: " Mauro Carvalho Chehab 2019-06-09 2:27 ` [PATCH v3 18/33] docs: netlabel: " Mauro Carvalho Chehab 2019-06-12 14:48 ` Paul Moore 2019-06-09 2:27 ` [PATCH v3 19/33] docs: pcmcia: " Mauro Carvalho Chehab 2019-06-09 6:59 ` Dominik Brodowski 2019-06-09 2:27 ` [PATCH v3 20/33] docs: " Mauro Carvalho Chehab 2019-06-09 2:27 ` Mauro Carvalho Chehab 2019-06-09 2:27 ` [PATCH v3 21/33] docs: powerpc: " Mauro Carvalho Chehab 2019-06-09 2:27 ` Mauro Carvalho Chehab 2019-06-09 2:27 ` Mauro Carvalho Chehab 2019-06-09 2:27 ` Mauro Carvalho Chehab 2019-06-09 2:27 ` [PATCH v3 22/33] docs: pps.txt: convert to ReST and rename to pps.rst Mauro Carvalho Chehab 2019-06-09 9:20 ` Rodolfo Giometti 2019-06-09 2:27 ` [PATCH v3 23/33] docs: ptp.txt: convert to ReST and move to driver-api Mauro Carvalho Chehab 2019-06-09 13:45 ` Richard Cochran 2019-06-09 2:27 ` [PATCH v3 24/33] docs: riscv: convert docs to ReST and rename to *.rst Mauro Carvalho Chehab 2019-06-09 2:27 ` Mauro Carvalho Chehab 2019-06-09 2:27 ` [PATCH v3 25/33] docs: Debugging390.txt: convert table to ascii artwork Mauro Carvalho Chehab 2019-06-09 2:27 ` [PATCH v3 26/33] docs: s390: convert docs to ReST and rename to *.rst Mauro Carvalho Chehab 2019-06-09 2:27 ` [PATCH v3 27/33] s390: include/asm/debug.h add kerneldoc markups Mauro Carvalho Chehab 2019-06-09 2:27 ` [PATCH v3 28/33] docs: target: convert docs to ReST and rename to *.rst Mauro Carvalho Chehab 2019-06-09 2:27 ` Mauro Carvalho Chehab 2019-06-09 2:27 ` [PATCH v3 29/33] docs: timers: " Mauro Carvalho Chehab 2019-06-09 2:27 ` [PATCH v3 30/33] docs: watchdog: " Mauro Carvalho Chehab 2019-06-09 20:51 ` Guenter Roeck 2019-06-09 2:27 ` [PATCH v3 31/33] docs: xilinx: convert eemi.txt to eemi.rst Mauro Carvalho Chehab 2019-06-09 2:27 ` Mauro Carvalho Chehab 2019-06-09 2:27 ` [PATCH v3 32/33] docs: scheduler: convert docs to ReST and rename to *.rst Mauro Carvalho Chehab 2019-06-09 2:27 ` [PATCH v3 33/33] docs: EDID/HOWTO.txt: convert it and rename to howto.rst Mauro Carvalho Chehab 2019-06-09 2:27 ` Mauro Carvalho Chehab 2019-06-11 8:37 ` Daniel Vetter 2019-06-11 9:02 ` Mauro Carvalho Chehab 2019-06-11 9:40 ` Daniel Vetter 2019-06-11 15:37 ` Jonathan Corbet 2019-06-12 17:40 ` Mauro Carvalho Chehab 2019-06-12 19:45 ` Daniel Vetter 2019-06-09 9:16 ` [PATCH v3 00/33] Convert files to ReST - part 1 Heiko Carstens 2019-06-09 9:16 ` Heiko Carstens 2019-06-09 9:22 ` Markus Heiser 2019-06-09 9:22 ` Markus Heiser 2019-06-09 9:27 ` Heiko Carstens 2019-06-09 9:27 ` Heiko Carstens 2019-06-09 12:29 ` Mauro Carvalho Chehab [this message] 2019-06-09 12:29 ` Mauro Carvalho Chehab 2019-06-10 15:55 ` Heiko Carstens 2019-06-10 15:55 ` Heiko Carstens
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=20190609092940.5e34e3b0@recife.lan \ --to=mchehab+samsung@kernel.org \ --cc=aou@eecs.berkeley.edu \ --cc=ast@kernel.org \ --cc=bpf@vger.kernel.org \ --cc=corbet@lwn.net \ --cc=daniel@iogearbox.net \ --cc=deanbo422@gmail.com \ --cc=green.hu@gmail.com \ --cc=heiko.carstens@de.ibm.com \ --cc=kafai@fb.com \ --cc=linux-doc@vger.kernel.org \ --cc=linux-kernel@vger.kernel.org \ --cc=linux-riscv@lists.infradead.org \ --cc=netdev@vger.kernel.org \ --cc=palmer@sifive.com \ --cc=songliubraving@fb.com \ --cc=yhs@fb.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: linkBe 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.