On Fri, Apr 17, 2009 at 3:49 PM, John H Palmieri <jhpalmier...@gmail.com> wrote:
> Since (I believe) it passes doctests without the link directive,
> removing it *is* the right thing: these verbatim environments are
> linked during doctesting as is, apparently.
>
> It would be good to understand how ".. link::" works, or whether it
> does, and change the warning accordingly. Maybe it's more for use in
> actual ReST files, like the tutorial, and not something we need to
> worry about in the docstrings in library code?

It is indeed for documents like the tutorial where the verbatim
environments need to be explicitly joined.  They are just ReST
comments.  When it appears above a verbatim environment, the code that
extracts the doctests just joins that one with the one above it.

--Mike

--~--~---------~--~----~------------~-------~--~----~
To post to this group, send email to sage-devel@googlegroups.com
To unsubscribe from this group, send email to 
sage-devel-unsubscr...@googlegroups.com
For more options, visit this group at http://groups.google.com/group/sage-devel
URLs: http://www.sagemath.org
-~----------~----~----~----~------~----~------~--~---

Reply via email to