On Mon, Oct 12, 2009 at 6:24 PM, John H Palmieri <jhpalmier...@gmail.com> wrote: > > On Oct 12, 5:08 pm, William Stein <wst...@gmail.com> wrote: >> On Mon, Oct 12, 2009 at 4:45 PM, Kwankyu <ekwan...@gmail.com> wrote: >> >> > Hi Minh, >> >> > I still have a problem on this issue. >> >> > 1. "TESTS:" section is not documented in the developer manual as of >> > Sage 4.1.1 >> > 2. Examples in "TESTS:" section are still included in the Sage >> > reference manual. If they are intended for test purpose only, then >> > they should not be included in the reference manual, which is for the >> > users. >> >> > Do I misunderstand something? >> >> No, we just have not got around to actually implementing 2 yet. Want to >> help? > > I would point out that in the code, some examples in the TESTS section > can be quite helpful to users. So if someone wants to implement 2, > they had better check whether each such example is worth including in > the reference manual (and so should be moved to the EXAMPLES block) or > not. Including too many examples is better than including too few.
Maybe we should not bother implementing 2? Nobody has pushed to do it, and your remark above just made it a difficult task. It will also be potentially be difficult to maintain, since it means potentially tricky and bug-prone patches to how we use Sphinx *and* IPython *and* the Notebook. -- William --~--~---------~--~----~------------~-------~--~----~ To post to this group, send an email to sage-devel@googlegroups.com To unsubscribe from this group, send an email to sage-devel-unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/sage-devel URL: http://www.sagemath.org -~----------~----~----~----~------~----~------~--~---