#12991: Don't doctest autogenerated rst files
---------------------------+------------------------------------------------
   Reporter:  jhpalmieri   |             Owner:  mvngu   
       Type:  enhancement  |            Status:  new     
   Priority:  minor        |         Milestone:  sage-5.1
  Component:  doctest      |          Keywords:          
Work issues:               |   Report Upstream:  N/A     
  Reviewers:               |           Authors:          
  Merged in:               |      Dependencies:          
   Stopgaps:               |  
---------------------------+------------------------------------------------
 When we build the Sage documentation, we create lots of files which look
 like the following
 
(`SAGE_ROOT/devel/sage/doc/en/reference/sage/algebras/free_algebra_quotient_element.rst`):
 {{{
 .. _sage.algebras.free_algebra_quotient_element:

 Free algebra quotient elements
 ==============================

 .. This file has been autogenerated.


 .. automodule:: sage.algebras.free_algebra_quotient_element
    :members:
    :undoc-members:
    :show-inheritance:
 }}}
 When we run `make ptestlong`, these files get doctested. I don't think
 there is a good reason for this: we should skip these files when
 doctesting. There are two ways of doing this: patch the doctesting scripts
 to skip files containing `\n.. This file has been autogenerated.\n', or
 write `.. nodoctest` as the first line of each of these files. The
 attached patch does the second of these (a patch to do the first is given
 in a comment below).

-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12991>
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 post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/sage-trac?hl=en.

Reply via email to