I think longest_element is fine; long_word indicates that there will be a
word returned instead of an element, which is maybe not what we're after
here.
Wiser minds than mine will have more knowledge of how to handle
deprecation, but here's an example from skew_partition.py:
sage: x.r_quotient??
Type: instancemethod
String Form:<bound method SkewPartition_class.r_quotient of [[12, 6, 5, 3,
1], [6, 5, 3, 1]]>
File:
/home/kaibutsu/sage-5.7/local/lib/python2.7/site-packages/sage/combinat/skew_partition.py
Definition: x.r_quotient(self, length)
Source:
def r_quotient(self, length):
"""
This method is deprecated.
EXAMPLES::
sage: SkewPartition([[3, 3, 2, 1], [2, 1]]).r_quotient(2)
doctest:1: DeprecationWarning: r_quotient is deprecated. Use
quotient instead.
See http://trac.sagemath.org/5790 for details.
[[[3], []], [[], []]]
"""
from sage.misc.superseded import deprecation
deprecation(5790, 'r_quotient is deprecated. Use quotient instead.')
return self.quotient(length)
On Tuesday, March 5, 2013 12:37:17 PM UTC+3, Kannappan Sampath wrote:
>
> Hello friends,
>
> I am writing this mail to ask for your help in a naming decision.
> In the file sage/categories/finite_coxeter_groups.py, there is a function
> called long_element. The docstring asks if this should be renamed and if
> so, to what?
>
> There are two suggestions from the authors: longest_element,
> maximal_element.
>
> Now, I think "longest_element" is pretty common. But, LiE, Marc's Lie
> Group computation software seems to call this `long_word()`.
>
> 1) what should we pick?
>
> 2) I started a ticket to clean up this file on trac:
> http://trac.sagemath.org/sage_trac/ticket/14050
>
> I understand that name changes are to be handled with care. How do we go
> about this one? Deprecate?
>
> With Sincere Regards,
> Kannappan.
>
--
You received this message because you are subscribed to the Google Groups
"sage-combinat-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to sage-combinat-devel+unsubscr...@googlegroups.com.
To post to this group, send email to sage-combinat-devel@googlegroups.com.
Visit this group at http://groups.google.com/group/sage-combinat-devel?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.
