Messages in this thread | | | Date | Fri, 14 Jun 2019 10:58:06 -0300 | From | Mauro Carvalho Chehab <> | Subject | Re: [PATCH 05/14] scripts: add an script to parse the ABI files |
| |
Em Fri, 14 Jun 2019 15:39:33 +0200 Greg Kroah-Hartman <gregkh@linuxfoundation.org> escreveu:
> On Fri, Jun 14, 2019 at 04:31:56PM +0300, Jani Nikula wrote: > > On Thu, 13 Jun 2019, Mauro Carvalho Chehab <mchehab+samsung@kernel.org> wrote: > > > From: Mauro Carvalho Chehab <mchehab@s-opensource.com> > > > > > > Add a script to parse the Documentation/ABI files and produce > > > an output with all entries inside an ABI (sub)directory. > > > > > > Right now, it outputs its contents on ReST format. It shouldn't > > > be hard to make it produce other kind of outputs, since the ABI > > > file parser is implemented in separate than the output generator. > > > > Hum, or just convert the ABI files to rst directly.
Converting ABI files to rst could be easily done using a modified version of my script (plus the produced files will likely need some manual review).
There is a drawback though: we'll lose the capability of being able to parse ABI files via an script, as people would be freed to use a different syntax.
We could minimize it by using things like:
:What: :Kernel Version: ...
> And what would that look like?
That's the big question :-)
If you prefer something like that, I can write the patches.
Thanks, Mauro
| |