Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > linux.kernel > #1485364

Re: [PATCH v3 11/21] Documentation/kernel-docs.txt: convert it to ReST markup

Show all headers | View raw

Em Fri, 16 Sep 2016 11:15:31 -0600
Jonathan Corbet <corbet@lwn.net> escreveu:

> On Wed, 14 Sep 2016 08:06:40 -0300
> Mauro Carvalho Chehab <mchehab@s-opensource.com> wrote:
> 
> > This one required lots of manual work, for it to be properly
> > displayed.  
> 
> And, honestly, I wonder if it was worth it.  This document contains no
> entries for any recent documents, 

Not sure about that. There are a number of patches from 2016 made by
Luis de Bethencourt updating several stuff.

> many of the links in it are long since
> dead, and I honestly doubt it has been helpful to anybody.

I tested: all links there point to an existing documentation.

Yet, it lacks pointers to more recent printed Kernel books.

> If we keep it
> should definitely be marked as historical cruft, but I wonder if it's
> worth even that much effort?

That's a good question. I don't know the answer.

At the media book, we keep a bibliography updated as we add new stuff
there. I found it to be useful, specially since it mentions some ITU-T
specs that the media framework needs, but this is somewhat different
than what's there.

Maybe we could keep it there for a while and see if people update
it. If not, move it to an "historical" archive or remove it as
a hole.

Thanks,
Mauro

Back to linux.kernel | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread

Thread

[PATCH v3 00/21] Create a book for Kernel development Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-09-14 13:20 +0200
  [PATCH v3 03/21] docs-rst: create a book for the development process Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-09-14 13:20 +0200
  [PATCH v3 12/21] Documentation/ManagementStyle: convert it to ReST markup Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-09-14 13:20 +0200
  [PATCH v3 07/21] Documentation/CodingStyle: Convert to ReST markup Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-09-14 13:20 +0200
    Re: [PATCH v3 07/21] Documentation/CodingStyle: Convert to ReST  markup Jonathan Corbet <corbet@lwn.net> - 2016-09-16 19:20 +0200
      Re: [PATCH v3 07/21] Documentation/CodingStyle: Convert to ReST  markup Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-09-16 22:40 +0200
        Re: [PATCH v3 07/21] Documentation/CodingStyle: Convert to ReST  markup Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-09-17 12:00 +0200
  [PATCH v3 14/21] Documentation/stable_api_nonsense.txt: convert it to ReST markup Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-09-14 13:20 +0200
  [PATCH v3 06/21] Documentation/Changes: convert it to ReST markup Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-09-14 13:20 +0200
  Re: [PATCH v3 11/21] Documentation/kernel-docs.txt: convert it to  ReST markup Jonathan Corbet <corbet@lwn.net> - 2016-09-16 19:20 +0200
    Re: [PATCH v3 11/21] Documentation/kernel-docs.txt: convert it to  ReST markup Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-09-16 22:50 +0200
      Re: [PATCH v3 11/21] Documentation/kernel-docs.txt: convert it to  ReST markup Jonathan Corbet <corbet@lwn.net> - 2016-09-16 23:10 +0200
        Re: [PATCH v3 11/21] Documentation/kernel-docs.txt: convert it to  ReST markup Mauro Carvalho Chehab <mchehab@s-opensource.com> - 2016-09-16 23:30 +0200

csiph-web