On Thursday, October 29, 2015 at 8:59:04 AM UTC-7, Nathann Cohen wrote: > > > How important is it that the user see any of these? Should our > documentation > > build hide these labels altogether? Should it hide "TESTS" blocks? Same > > questions when you ask for interactive help via "foo?". > > This has been asked in different forms on this forum. I don't think > that there was any of us who disagreed with either hiding the "TEST" > blocks or folding them somehow in the HTML doc. > > I think that it is more of a technical issue: who knows how to tweak > Sphinx to do that? Or is there any other way to do it outside of > sphinx? > > Nathann >
Since we can already detect doctests, and among those we can already detect the various doctest flags, we should be able to hide those flags. The TESTS blocks are a different situation. If we insist that TESTS blocks are always the last thing in the docstring, I can imagine it working. -- John -- You received this message because you are subscribed to the Google Groups "sage-devel" group. To unsubscribe from this group and stop receiving emails from it, send an email to sage-devel+unsubscr...@googlegroups.com. To post to this group, send email to sage-devel@googlegroups.com. Visit this group at http://groups.google.com/group/sage-devel. For more options, visit https://groups.google.com/d/optout.
