#18926: Auto-generated index of functions
-------------------------+-------------------------------------------------
       Reporter:         |        Owner:
  ncohen                 |       Status:  needs_review
           Type:         |    Milestone:  sage-6.8
  enhancement            |   Resolution:
       Priority:  major  |    Merged in:
      Component:         |    Reviewers:
  documentation          |  Work issues:
       Keywords:         |       Commit:
        Authors:         |  3a9e3b5cbb00db4ffa5f97542ce3d027b19ee006
  Nathann Cohen          |     Stopgaps:
Report Upstream:  N/A    |
         Branch:         |
  public/18926           |
   Dependencies:         |
-------------------------+-------------------------------------------------

Comment (by ncohen):

 Helloooooooo,

 > Yes, it's slightly bizarre. Say you have a catalog module that you wish
 to have
 > an index for. Then you import `gen_rest_table_index` and you call it
 with
 > `only_local=False`: you want all the non-local functions, **except
 > `gen_rest_table_index` itself**. The funny test is then simply to see
 that this
 > is filtered out, without having to rely on another module.

 Oh okay, it is true that somehow this function has a 'special behaviour'.
 Would you see anything wrong in filtering it out with {{{f is not
 gen_rest_table_index}}} instead of checking its module?

 > The function only extracts methods of a class which have been decorated
 with
 > `@staticmethod`.

 Whaaaaat? `O_o`

 None of the methods of `IncidenceStructure` are decorated like that. And
 they appear in the list `O_o`

 > This line was just to clarify the semantics of the function wrt.
 classes, since
 > this surprised me when I first reviewed the ticket. I never intended
 > `only_local` to have any effect when the function is called on classes.

 Oh. What about renaming it to 'only_local_function` to make it plain(er)
 that it does not apply to methods?

 Nathann

--
Ticket URL: <http://trac.sagemath.org/ticket/18926#comment:19>
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