-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica, and MATLAB
* dependencies: => #12569
-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571#comment:1>
* reviewer: => Florent Hivert
Comment:
 Hi Samuele,
 Good to have you onboard !
 - First of all, if you want a review you should check the {{{needs-
 review}}} button below.
 - when you put some example under the title {{{EXAMPLES::}}}
 there is no need to but them in {{{TESTS::}}}. Both are tested alike.
 - You should add a rubric {{{INPUT::}}} explaining what {{{other}}} can
 be. Here I think it could be a {{{Permutations}}}, a {{{list}}}, a
 {{{tuple}}}
 or any {{{iterable}}}. A few examples demonstrating this should also be
 added
 (see
 [http://www.sagemath.org/doc/developer/conventions.html#documentation-
 strings documentation strings] for the precise syntax).
 - Are you sure that you didn't mixed up the convention for over/under ? To
 break the ambiguity, I'd rather call them {{{shifted_concatenation}}} and
 {{{shifted_anti_concatenation}}}. Or maybe only one function
 {{{shifted_concatenation}}}, with an optional parameter {{{shift}}} which
 can
 be either {{{"left"}}} or {{{"right"}}}. Or even
 {{{shift_right (True by default)}}}...
 What do you think ? Maybe it is worth asking for a vote on
 {{{Sage-combinat-devel}}}.
 - You should add a ".. SEEALSO::" rubric linking the three functions one
 to
 the other (see also #12078 ;-)
 - Finally, You could add some consistency tests checking that for some
 relatively large permutations, the cardinality of the interval in the
 correct
 binomial coefficient.
 Sorry for this long list of requests, once you gets used to Sage, you'll
 do all
 of this without thinking of it.
 And many thanks for taking care of this.
 Florent
-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571#comment:2>
Comment(by nthiery):
 Replying to [comment:2 hivert]:
 > - Are you sure that you didn't mixed up the convention for over/under ?
 To
 > break the ambiguity, I'd rather call them {{{shifted_concatenation}}}
 and
 > {{{shifted_anti_concatenation}}}. Or maybe only one function
 > {{{shifted_concatenation}}}, with an optional parameter {{{shift}}}
 which can
 > be either {{{"left"}}} or {{{"right"}}}. Or even
 > {{{shift_right (True by default)}}}...
 Quite a few functions take an argument side="left"/"right", more often
 than not the default being "right". If
 {{{
     x.shifted_concatenation(y, side="right")
 }}}
 sounds unambiguous enough about the shift being on y (and not the
 concatenation being on the right), I vote for this. Otherwise
 shift="left"/"right"
 Cheers,
                       Nicolas
-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571#comment:3>
* status: new => needs_review
-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571#comment:4>
Comment(by giraudo):
 Hi Florent, hi Nicolas,
 thanks a lot for the suggestions of improvement. I just have updated the
 patch.
 Samuele
-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571#comment:5>
Comment (by elixyre):
 This patch is disappeared? I think the shuffle on words is now efficient.
 This post could be closed?
 Jean-Baptiste
-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571#comment:6>
Comment (by knsam):
 Replying to [comment:6 elixyre]:
 > This patch is disappeared? I think the shuffle on words is now
 efficient.
 Not quite. Sage 5.6 takes 21.93 seconds.
 >
 > This post could be closed?
 So, no I'd think.
 >
 > Jean-Baptiste
-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571#comment:7>
* cc: knsam (added)
-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571#comment:8>
* status: needs_review => needs_work
Comment:
 Helloooooooooooooooooo !!!
 This patch looks ood to go, but it would be nice to add your two new
 methods to the (new) index of methods at the top of permutation.py `:-)`
 Nathann
-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571#comment:9>
  * status:  needs_work => positive_review
  * reviewer:  Florent Hivert => Florent Hivert, Darij Grinberg
  * dependencies:  #12569 => #12569, #14772
Comment:
Methods added to the index. Patch reviewed and rebased upon #14772.
-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571#comment:10>
* cc: tscrim, sage-combinat (added)
-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/12571#comment:11>