On Fri, Oct 28, 2016 at 10:20:57AM -0200, Mauro Carvalho Chehab wrote: > Em Fri, 28 Oct 2016 06:28:23 -0400 > Greg Kroah-Hartman <gregkh@xxxxxxxxxxxxxxxxxxx> escreveu: > > > On Fri, Oct 28, 2016 at 08:14:21AM -0200, Mauro Carvalho Chehab wrote: > > > Em Fri, 28 Oct 2016 02:54:33 -0400 > > > Greg Kroah-Hartman <gregkh@xxxxxxxxxxxxxxxxxxx> escreveu: > > > > > > > On Thu, Oct 27, 2016 at 10:34:05PM -0200, Mauro Carvalho Chehab wrote: > > > > > As defined at Documentation/ABI/README, this is actually a database > > > > > with those fields: > > > > > > > > > > What, Date, KernelVersion, Contact, Description and Users. > > > > > > > > > > An user-face documentation would probably require only a few of those > > > > > fields (like What and Description), but the entries should be > > > > > probably sorted by the What field. > > > > > > > > > > So, I suspect it wouldn't be hard to write a perl script to parse it > > > > > and generate an ABI guide. On the other hand, we might need to fix > > > > > some documents, if the parser fails due to some typo. > > > > > > > > That sounds like a good plan to me, and patches to fix up typos to keep > > > > things being able to be parsed properly should be fine. > > > > > > I started coding a parse script and already got some syntax issues ;) > > > > > > See enclosed. Do you want me to break it per file? > > > > Nothing was attached :( > > Sorry. Just sent it, together with another fixup patch, and the parser > utility. Please let me know if you prefer if I break the first patch > on per file (or per subsystem) ones. Nope, it's good as-is. Thanks for doing this, it's great to see this type of thing possible with these documentation tool changes. greg k-h -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
