Re: Proposing help for documentation

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Wed, 02 Nov 2016, Markus Heiser <markus.heiser@xxxxxxxxxxx> wrote:
> Am 02.11.2016 um 11:41 schrieb Jani Nikula <jani.nikula@xxxxxxxxxxxxxxx>:
>
>> On Wed, 02 Nov 2016, Luis de Bethencourt <luisbg@xxxxxxxxxxxxxxx> wrote:
>>> I also offer my help, let me know if you see anything I can do.
>> 
>> Luis, Patrice, anyone else out there willing to help: here's a list of
>> stuff to do, off the top of my head. I'm sure Jon will amend this.
>> 
>> 4) Convert DocBook templates under Documentation/DocBook to Sphinx.
>> 
>> The conversion is actually the easy part; figuring out whether the
>> documentation is still relevant and where to stick it in the Sphinx
>> build is harder. Jon may have some vision on this, but personally I'd
>> like to obliterate DocBook first, and then figure out what to do with
>> the resulting converted rst documents.
>
> Fore those how are interested in converting DocBook, there
> is a *automatic* conversion available, which might be a good
> starting point:
>
> https://github.com/return42/sphkerneldoc/tree/master/Documentation/books_migrated
>
> If you need something newer / special contact me.

And if you need something simple, there's Documentation/sphinx/tmplcvt.
It's nowhere near as complete as what Markus has, but works for simple
stuff (well, worked good enough for GPU documentation).

BR,
Jani.

-- 
Jani Nikula, Intel Open Source Technology Center
--
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



[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux