On Mon, 15 Apr 2013 10:49:31 -0500
Terry Brown <[email protected]> wrote:

> On Mon, 15 Apr 2013 08:21:04 -0700 (PDT)
> "Edward K. Ream" <[email protected]> wrote:
> 
> > On Saturday, April 13, 2013 7:23:50 PM UTC-5, lewis wrote:
> > >
> > > Edward 
> > >
> > > In build 5695 the Apropos commands do not work. 
> > 
> > 
> > Hmm.   Leo's help command are virtually unreadable if docutils is not 
> > installed.  I'm having difficulty installing docutils for Python 3.x on 
> > Windows.  We certainly should not assume that a newbie has installed 
> > docutils!
> > 
> > The solution will be to use html markup rather than rST markup for 
> > essential docs.  The viewrendered plugins will render any text as html if 
> > it starts with '<' but not '<<', so this should work.  This should work as 
> > well as docutils.  Time to reformat...
> 
> Surely rst docs. should be readable is they're displayed in <pre>
> format.  Wouldn't it be better to have vr test for docutils and display
> docs in <pre> formatted plain text if docutils isn't available?
> Perhaps with a line at the top like
> 
>   (for better looking docs install the docutils python package)
> 
> Cheers -Terry
> 
> > Also, the help-for-command command assumes docstrings contain rST markup.  
> > Enclosing the docstrings in a <pre> block instead of feeding the result to 
> > docutils should be good enough.

Um, I guess I could have read the whole message first :-)  I'd argue
that plain text rst is ok for all docs - nothing needs to have html
format.

Cheers -Terry

> > Edward
> > 
> > P.S.  The 'apropos-x' commands have been renamed 'help-for-x'.  You 
> > probably knew that :-)
> > 
> > EKR
> > 
> 

-- 
You received this message because you are subscribed to the Google Groups 
"leo-editor" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/leo-editor?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.


Reply via email to