From: Jonathan Corbet <corbet@lwn•net>
To: Mauro Carvalho Chehab <mchehab@s-opensource•com>
Cc: Andrew Lunn <andrew@lunn•ch>,
alsa-devel@alsa-project•org,
Linux Doc Mailing List <linux-doc@vger•kernel.org>,
Takashi Iwai <tiwai@suse•de>, Jan Kiszka <jan.kiszka@siemens•com>,
"Herton R. Krzesinski" <herton@redhat•com>,
Alexei Starovoitov <ast@kernel•org>,
Takashi Iwai <tiwai@suse•com>,
"J. Bruce Fields" <bfields@fieldses•org>,
linux-ide@vger•kernel.org, Eric Dumazet <edumazet@google•com>,
netdev@vger•kernel.org, Jeff Layton <jlayton@poochiereds•net>,
Jan Kara <jack@suse•com>,
Soheil Hassas Yeganeh <soheil@google•com>,
linux-s390@vger•kernel.org,
Florian Fainelli <f.fainelli@gmail•com>,
"James E.J. Bottomley" <jejb@linux•vnet.ibm.com>,
Herbert Xu <herbert@gondor•apana.org.au>,
linux-scsi@vger•kernel.org,
Ursula Braun <ubraun@linux•vnet.ibm.com>,
"Rafael J. Wysocki" <rafael.j.wysocki@intel•com>,
Peter Zijlstra <peterz@infradead•org>,
Julian Anastasov <ja@ssi•bg>,
Ingo
Subject: Re: [PATCH 00/36] Convert DocBook documents to ReST
Date: Mon, 15 May 2017 11:11:41 -0600 [thread overview]
Message-ID: <20170515111141.0fcd5ee6@lwn.net> (raw)
In-Reply-To: <cover.1494596071.git.mchehab@s-opensource.com>
On Fri, 12 May 2017 10:59:43 -0300
Mauro Carvalho Chehab <mchehab@s-opensource•com> wrote:
> This patch series convert the following books from
> DocBook to ReST:
>
> - filesystems
> - kernel-hacking
> - kernel-locking
> - kgdb
> - libata
> - networking
> - rapidio
> - s390-drivers
> - scsi
> - w1
> - z8530book
>
> It also adjusts some Sphinx-pedantic errors/warnings on
> some kernel-doc markups.
>
> I also added some patches here to add PDF output for all
> existing ReST books.
So I've been through the series (including digging out the parts that
weren't sent to me).
> I did my best to check if what's there is not too outdated, but
> the best is if the subsystem maintainers could check it.
That has been my real concern with those remaining books; many of them
have not been touched in any significant way in at least ten years. Just
shoveling a bunch of stuff into RST doesn't really solve the problem that
Documentation/ is an unorganized jumble of sometimes highly outdated
documentation.
But, then, I guess there's value in having a disorganized jumble that
depends on only one fragile toolchain rather than two :) So maybe we
should just do this.
I only had one real comment with the series beyond the general stuff
here. I see Markus had a few. When the tweaks are done, can you send me
a series for the stuff I can apply, and I'll do it?
Thanks,
jon
next prev parent reply other threads:[~2017-05-15 17:11 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2017-05-12 13:59 [PATCH 00/36] Convert DocBook documents to ReST Mauro Carvalho Chehab
2017-05-12 14:00 ` [PATCH 31/36] net: fix some identation issues at kernel-doc markups Mauro Carvalho Chehab
2017-05-15 17:11 ` Jonathan Corbet [this message]
2017-05-15 17:41 ` [PATCH 00/36] Convert DocBook documents to ReST 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=20170515111141.0fcd5ee6@lwn.net \
--to=corbet@lwn$(echo .)net \
--cc=alsa-devel@alsa-project$(echo .)org \
--cc=andrew@lunn$(echo .)ch \
--cc=ast@kernel$(echo .)org \
--cc=bfields@fieldses$(echo .)org \
--cc=edumazet@google$(echo .)com \
--cc=f.fainelli@gmail$(echo .)com \
--cc=herbert@gondor$(echo .)apana.org.au \
--cc=herton@redhat$(echo .)com \
--cc=ja@ssi$(echo .)bg \
--cc=jack@suse$(echo .)com \
--cc=jan.kiszka@siemens$(echo .)com \
--cc=jejb@linux$(echo .)vnet.ibm.com \
--cc=jlayton@poochiereds$(echo .)net \
--cc=linux-doc@vger$(echo .)kernel.org \
--cc=linux-ide@vger$(echo .)kernel.org \
--cc=linux-s390@vger$(echo .)kernel.org \
--cc=linux-scsi@vger$(echo .)kernel.org \
--cc=mchehab@s-opensource$(echo .)com \
--cc=netdev@vger$(echo .)kernel.org \
--cc=peterz@infradead$(echo .)org \
--cc=rafael.j.wysocki@intel$(echo .)com \
--cc=soheil@google$(echo .)com \
--cc=tiwai@suse$(echo .)com \
--cc=tiwai@suse$(echo .)de \
--cc=ubraun@linux$(echo .)vnet.ibm.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox