#9128: Sphinx should be aware of all.py to find its links
------------------------------+---------------------------------------------
   Reporter:  hivert          |       Owner:  mvngu       
       Type:  enhancement     |      Status:  new         
   Priority:  major           |   Milestone:  sage-4.4.3  
  Component:  documentation   |    Keywords:  Sphinx links
     Author:  Florent Hivert  |    Upstream:  N/A         
   Reviewer:                  |      Merged:              
Work_issues:                  |  
------------------------------+---------------------------------------------
 Though sphinx is perfectly working with target in the local module he
 isn't
 able to find reference target from other modules even if they are exported
 in
 all.py. For example, if I want to link Parent from anywhere but
 parent.pyx, I
 have to write the full path (ie.
 {{{:class:`~sage.structure.parent.Parent}}}`)
 even if it is imported in my module. I find this extremely annoying since,
 in
 the task of improving the category doc, I'm setting up a lot of huge cross
 references such as:
 {{{
     :meth:`Algebras.ParentMethods.algebra_generators()
     <sage.categories.algebras.Algebras.ParentMethods.algebra_generators>`.
 }}}
 I would be very happy if I had to write only
 {{{
     :meth:`Algebras.ParentMethods.algebra_generators`
 }}}
 The following patch should solve this issue

-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/9128>
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