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


Groups > linux.kernel > #1333371 > unrolled thread

Kernel docs: muddying the waters a bit

Started byJonathan Corbet <corbet@lwn.net>
First post2016-02-13 23:00 +0100
Last post2016-02-17 01:10 +0100
Articles 2 on this page of 22 — 7 participants

Back to article view | Back to linux.kernel


Contents

  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

Page 2 of 2 — ← Prev page 1 [2]


#1335764

FromJonathan Corbet <corbet@lwn.net>
Date2016-02-16 21:00 +0100
Message-ID<r2TWX-3TM-17@gated-at.bofh.it>
In reply to#1335736
On Tue, 16 Feb 2016 11:13:29 -0800
Keith Packard <keithp@keithp.com> wrote:

> 	https://github.com/HolgerPeters/sphinxcontrib-docbook
> 
> which appears to provide docbook output for sphinx, but I haven't tested
> this at all.

Yup, that's the one I found, the one that says "Very much work in
progress".  It looks like that work stopped almost a year ago.

> Of course, docbook is just a means to an end -- the question should
> probably be what final output formats are actually required and whether
> the tools generate those in a reasonable fashion.

Indeed, I doubt many people want the DocBook itself.

jon

[toc] | [prev] | [next] | [standalone]


#1335942

FromKeith Packard <keithp@keithp.com>
Date2016-02-17 01:10 +0100
Message-ID<r2XQS-6LN-13@gated-at.bofh.it>
In reply to#1335764

[Multipart message — attachments visible in raw view] — view raw

Jonathan Corbet <corbet@lwn.net> writes:

> Indeed, I doubt many people want the DocBook itself.

Might be nice to actually have a set of requirements before anyone tries
to select a suitable system then :-)

Here's my current set:

        asciidoc        sphinx

html    via docbook     native
        native (kinda)
pdf     via docbook     via rst2pdf
epub    via docbook?    native
man     ?               native?

-- 
-keith

[toc] | [prev] | [standalone]


Page 2 of 2 — ← Prev page 1 [2]

Back to top | Article view | linux.kernel


csiph-web