#16182: doctesting tutorial gives bad advice about doctesting everything
-------------------------------------------------+-------------------------
       Reporter:  darij                          |        Owner:
           Type:  defect                         |       Status:  new
       Priority:  minor                          |    Milestone:  sage-6.2
      Component:  doctest framework              |   Resolution:
       Keywords:  doctest, documentation,        |    Merged in:
  tutorial                                       |    Reviewers:
        Authors:                                 |  Work issues:
Report Upstream:  N/A                            |       Commit:
         Branch:                                 |     Stopgaps:
   Dependencies:                                 |
-------------------------------------------------+-------------------------

Comment (by darij):

 Right; this (from `sage/doctest/control.py`) is probably the correct
 procedure:
 {{{
         if self.options.all:
             self.log("Doctesting entire Sage library.")
             from glob import glob
             self.files.append(opj(SAGE_SRC, 'sage'))
             self.files.append(opj(SAGE_SRC, 'doc', 'common'))
             self.files.extend(glob(opj(SAGE_SRC, 'doc', '[a-z][a-z]')))
             self.options.sagenb = True
 }}}
 But one definitely shouldn't be doctesting the src/build hierarchy...

--
Ticket URL: <http://trac.sagemath.org/ticket/16182#comment:3>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica, 
and MATLAB

-- 
You received this message because you are subscribed to the Google Groups 
"sage-trac" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sage-trac.
For more options, visit https://groups.google.com/d/optout.

Reply via email to