#15567: Fix Alphabet and improvements to Family
-------------------------+-------------------------------------------------
       Reporter:         |        Owner:  sage-combinat
  tscrim                 |       Status:  needs_work
           Type:         |    Milestone:  sage-6.1
  defect                 |   Resolution:
       Priority:  major  |    Merged in:
      Component:         |    Reviewers:
  combinatorics          |  Work issues:
       Keywords:         |       Commit:
  alphabet               |  03b3045881fbff482768e4d3efee772c83d58da8
        Authors:         |     Stopgaps:
  Travis Scrimshaw       |
Report Upstream:  N/A    |
         Branch:         |
  public/15567           |
   Dependencies:         |
-------------------------+-------------------------------------------------
Changes (by ncohen):

 * status:  needs_review => needs_work


Comment:

 Hello.

 I'm sorry but this doc has to be rewritten. What the hell does that even
 mean ?

 {{{
 Definition: Alphabet(data=None, names=None, name=None)
 Docstring:
    Return an object representing an ordered alphabet.

    INPUT:

    * "data" -- the data to build the alphabet

    * "names" -- the letters, names, or prefix

    * "name" -- the name of a specific named alphabet
 }}}

 Two arguments, one named 'name' and the other one 'names'. 'data' is "the
 data to build the alphabet". And the explanation of what 'names' is (i.e.
 : the letters) makes one think that the 'data to build the alphabet is NOT
 the letters. What the hell does it all mean ?

 Plus none of the examples of Alphabet? actually use Alphabet. Because that
 is called `build_alphabet`.

 {{{
 sage: build_alphabet(5,['a','b', 'c '])
 ...
 ValueError: not possible
 }}}

 Plus it would really help to have an explanation of what 'hidden' means in
 the definition of `hidden_keys` and `hidden_functIon` (the 'i' is
 missing).

 Nathann

--
Ticket URL: <http://trac.sagemath.org/ticket/15567#comment:13>
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/groups/opt_out.

Reply via email to