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

Groups > linux.kernel > #1335591

Re: Kernel docs: muddying the waters a bit

Show all headers | View raw

On Tue, 16 Feb 2016 10:25:49 +0200
Jani Nikula <jani.nikula@intel.com> wrote:

> However I didn't think Sphinx could produce docbook, and a quick search
> doesn't convince me otherwise. Do you have some links to back this up?

Somehow I was really sure of it, but I'm not finding it now.  There is an
extension out there, but it warns about being a "work in progress," so
I'm not sure we can count it.

Whether this is a show-stopper is indeed a good question.  I doubt many
people wanted the DocBook for its own sake, it's a matter of where you
can go from there.  But yes, it would be good to be sure on this point.

> Sphinx might offer a way to drop docproc through the extension
> mechanism, without resorting to the "separate-file approach". It might
> be a more sensible approach as a whole.

There's a certain elegance to it that I like, but it is an idea that
needs to actually be demonstrated.  It could also come later on, though,
with the docproc or include mechanisms used for now.

Thanks,

jon

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

Thread

Kernel docs: muddying the waters a bit Jonathan Corbet <corbet@lwn.net> - 2016-02-13 23:00 +0100
  Re: Kernel docs: muddying the waters a bit Keith Packard <keithp@keithp.com> - 2016-02-14 02:00 +0100
    Re: Kernel docs: muddying the waters a bit Daniel Vetter <daniel.vetter@ffwll.ch> - 2016-02-14 13:30 +0100
      Re: Kernel docs: muddying the waters a bit Keith Packard <keithp@keithp.com> - 2016-02-14 17:30 +0100
      Re: Kernel docs: muddying the waters a bit Jonathan Corbet <corbet@lwn.net> - 2016-02-17 23:20 +0100
        Re: Kernel docs: muddying the waters a bit Daniel Vetter <daniel.vetter@ffwll.ch> - 2016-02-17 23:30 +0100
          Re: Kernel docs: muddying the waters a bit Jani Nikula <jani.nikula@intel.com> - 2016-02-18 10:20 +0100
            Re: Kernel docs: muddying the waters a bit Daniel Vetter <daniel.vetter@ffwll.ch> - 2016-02-18 10:30 +0100
              Re: Kernel docs: muddying the waters a bit Mauro Carvalho Chehab <mchehab@osg.samsung.com> - 2016-02-18 11:30 +0100
                Re: Kernel docs: muddying the waters a bit Jani Nikula <jani.nikula@intel.com> - 2016-02-18 12:30 +0100
                Re: Kernel docs: muddying the waters a bit Hans Verkuil <hverkuil@xs4all.nl> - 2016-02-18 13:10 +0100
                Re: Kernel docs: muddying the waters a bit Mauro Carvalho Chehab <mchehab@osg.samsung.com> - 2016-02-18 13:50 +0100
                Re: Kernel docs: muddying the waters a bit Patrick Boettcher <patrick.boettcher@posteo.de> - 2016-02-18 14:40 +0100
                Re: Kernel docs: muddying the waters a bit Mauro Carvalho Chehab <mchehab@osg.samsung.com> - 2016-02-18 13:10 +0100
              Re: Kernel docs: muddying the waters a bit Jonathan Corbet <corbet@lwn.net> - 2016-02-18 14:10 +0100
                Re: Kernel docs: muddying the waters a bit Daniel Vetter <daniel.vetter@ffwll.ch> - 2016-02-18 15:50 +0100
  Re: Kernel docs: muddying the waters a bit Jani Nikula <jani.nikula@intel.com> - 2016-02-16 09:30 +0100
    Re: Kernel docs: muddying the waters a bit Jonathan Corbet <corbet@lwn.net> - 2016-02-16 17:10 +0100
      Re: Kernel docs: muddying the waters a bit Jani Nikula <jani.nikula@intel.com> - 2016-02-16 18:20 +0100
    Re: Kernel docs: muddying the waters a bit Keith Packard <keithp@keithp.com> - 2016-02-16 20:20 +0100
      Re: Kernel docs: muddying the waters a bit Jonathan Corbet <corbet@lwn.net> - 2016-02-16 21:00 +0100
        Re: Kernel docs: muddying the waters a bit Keith Packard <keithp@keithp.com> - 2016-02-17 01:10 +0100

csiph-web