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


Groups > linux.kernel > #1423000 > unrolled thread

Re: [PATCH 0/7] add reST/sphinx-doc to linux documentation

Started byMarkus Heiser <markus.heiser@darmarit.de>
First post2016-06-15 15:10 +0200
Last post2016-06-15 15:10 +0200
Articles 1 — 1 participant

Back to article view | Back to linux.kernel

This discussion starts older than the indexed window; earlier articles aren't shown. The article labeled Started by below is the oldest one visible, not the original post.


Contents

  Re: [PATCH 0/7] add reST/sphinx-doc to linux documentation Markus Heiser <markus.heiser@darmarit.de> - 2016-06-15 15:10 +0200

#1423000 — Re: [PATCH 0/7] add reST/sphinx-doc to linux documentation

FromMarkus Heiser <markus.heiser@darmarit.de>
Date2016-06-15 15:10 +0200
SubjectRe: [PATCH 0/7] add reST/sphinx-doc to linux documentation
Message-ID<rKiJY-2Ya-23@gated-at.bofh.it>
FYI

Am 07.06.2016 um 09:54 schrieb Daniel Vetter <daniel.vetter@ffwll.ch>:

> On Mon, Jun 6, 2016 at 6:32 PM, Markus Heiser <markus.heiser@darmarit.de> wrote:
>> From: "Heiser, Markus" <markus.heiser@darmarIT.de>
>> 
> I'm still not sold on the vintage-kerneldoc idea. At least in my
> experience (after first converting to asciidoc and now to sphinx) this
> is a non-issue. Yes, there's the oddball misrendering, but that's no
> worse than the oddball typo.

Since *vintage* and reST mode is an option of the ".. kernel-doc:" 
directive it is compareabel. E.g 80211.html produce markup errors:

* 230 in "reST" mode
* 6 in *vintage* "kernel-doc" mode

95% of the errors caused by:

    Emphasis “*”: like *emphasis* or **emphasis strong**
    Leading “_” : is a anchor in reST markup (_foo).
    Trailing “_: is a reference in reST markup (foo_).
    interpreted text: “`”
    inline literals: “``”
    substitution references: “|”

which qouted when the parser runs in vintage "kernel-doc" mode.

--Markus--
 

[toc] | [standalone]


Back to top | Article view | linux.kernel


csiph-web