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.

  John

--~--~---------~--~----~------------~-------~--~----~
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
-~----------~----~----~----~------~----~------~--~---

Reply via email to