Re: [PATCH 18/57] docs: kbuild: convert it to ReST output

Mauro Carvalho Chehab
2019-04-18T10:26:53Z

Em Thu, 18 Apr 2019 18:25:45 +0900
Masahiro Yamada <yamada.masahiro@socionext.com> escreveu:

> On Tue, Apr 16, 2019 at 12:01 PM Mauro Carvalho Chehab
> <mchehab+samsung@kernel.org> wrote:
> >
> > The kbuild documentation clearly shows that the documents
> > there are written at different times: some use markdown,
> > some use their own peculiar logic to split sections.
> >
> > Convert everything to ReST without affecting too much
> > the author's style and avoiding adding uneeded markups.
>
> Sorry for my ignorance, but shouldn't ReST use
> the extension '.rst' instead of '.txt' ?

Yes. I have a patch with the rename step, but the problem is that doing
such renames on 57 different subdirs and then adding all of them to the
existing index.rst files (in order to add into a bookset) would cause
huge merge conflicts - and keeping them renamed without adding into
an index would cause a *lot* new warnings when building them.

So, IMO, the best would be to have the fixup stuff merged first, and
then do the renames/merges at once, after subsystem maintainers
pick the patches from this rst fixup series.

If you want to see the renaming patch, it is at:
https://git.linuxtv.org/mchehab/experimental.git/commit/?h=all_with_indexes-v3&id=9cfeb3eb6d48d1aeff9d2ddd84880ab1dc782b00

(I'll probably split it later into per-subdir renames)

The results of this patch, plus the rename one, is at:

https://www.infradead.org/~mchehab/rst_conversion/kbuild/index.html

>
>
>
> > Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
> > ---
> > Documentation/kbuild/headers_install.txt | 5 +-
> > Documentation/kbuild/kbuild.txt | 119 ++--
> > Documentation/kbuild/kconfig-language.txt | 232 ++++----
> > .../kbuild/kconfig-macro-language.txt | 37 +-
> > Documentation/kbuild/kconfig.txt | 136 +++--
> > Documentation/kbuild/makefiles.txt | 518 +++++++++++-------
> > Documentation/kbuild/modules.txt | 166 +++---
> > 7 files changed, 720 insertions(+), 493 deletions(-)
> >
>

Thanks,
Mauro