On Nov 6, 2015, at 08:39 , John H Palmieri wrote: > At http://trac.sagemath.org/ticket/19503, we have a branch which implements > the omission of 'TESTS:' blocks in docstrings when you do 'foo?' (and > optionally, but this is not the default behavior, it can omit them in the > reference manual). There are pros and cons to this: for some time, our > documentation has said that TESTS blocks contain 'tests that are not > relevant to users', so it makes sense to hide them. On the other hand, some > of our docstrings may not follow this guideline and may contain TESTS > blocks that are actually useful. So do we hide them all, knowing that we > may be hiding some relevant information, or do we always display them? > > Please vote: > > [X ] 'foo?' should NOT display TESTS blocks. > > [ ] 'foo?' should display TESTS block.
-- Justin C. Walker Curmudgeon-at-large Director Institute for the Absorption of Federal Funds ---- 186,000 Miles per Second Not just a good idea: it's the law! ---- -- 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.
