lkml.org 
[lkml]   [2018]   [Mar]   [2]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
Date
From
SubjectRe: [PATCH] Documentation/sphinx: Fix Directive import error
On Fri, 02 Mar 2018 15:50:55 +0100,
Matthew Wilcox wrote:
>
> On Fri, Mar 02, 2018 at 12:49:03PM +0100, Takashi Iwai wrote:
> > I'm no expert of sphinx nor python, so something might be wrong.
> > Please check it.
>
> I'm also not a pythonista, but ...
>
> > --- a/Documentation/sphinx/kerneldoc.py
> > +++ b/Documentation/sphinx/kerneldoc.py
> > @@ -37,7 +37,10 @@ import glob
> > from docutils import nodes, statemachine
> > from docutils.statemachine import ViewList
> > from docutils.parsers.rst import directives
> > -from sphinx.util.compat import Directive
> > +try:
> > + from sphinx.util.compat import Directive
> > +except ImportError:
> > + from docutils.parsers.rst import directives, Directive
>
> It seems to me the previous line already imported
> docutils.parsers.rst.directives, and we should probably prefer the newer
> parser even with Sphinx 1.6, so I would think this would work better:
>
> -from sphinx.util.compat import Directive
> +try:
> + from docutils.parsers.rst import Directive
> +except ImportError:
> + from sphinx.util.compat import Directive
>
> (it works on Debian with Sphinx 1.6.7)

Makes more sense, yes.

Jon, would you like me resending the patch? Or it's trivial enough as
you can fix in place.


thanks,

Takashi

\
 
 \ /
  Last update: 2018-03-02 15:55    [W:0.053 / U:1.528 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site