#11284: Document all options of Poset.show and Poset.plot
-------------------------------------+-------------------------------------
       Reporter:  nthiery            |        Owner:  sage-combinat
           Type:  defect             |       Status:  needs_review
       Priority:  major              |    Milestone:  sage-6.4
      Component:  combinatorics      |   Resolution:
       Keywords:  posets,            |    Merged in:
  documentation,days30               |    Reviewers:
        Authors:  Nathann Cohen      |  Work issues:
Report Upstream:  N/A                |       Commit:
         Branch:  public/11284       |  329de0c33099d582cede2d26c307cf3da4d7ae16
   Dependencies:                     |     Stopgaps:
-------------------------------------+-------------------------------------

Comment (by ncohen):

 Yo !

 > I still don't see how the user can find `figsize`-option. And IMO it is
 one of most important

 True. Actually, it can be found in the doc of Poset.show which mentions
 the doc of Graphics.show, where it appears. Not exactly as trivial as it
 should.

 > `cover_labels` put labels over the line, not near the line --- but this
 is place for another ticket.

 For this kind of stuff, I would say that people will try and see for
 themselves. The drawing is better than a long explanation `:-P`

 > Maybe `element_labels` could have explanation saying that it must be
 injective. And that `cover_labels` may be non-injective.

 Of changing the code to support non-injective labellings ! That is the
 most proper way to solve it.

 > Hmm... how about some nice example of colors? Poset with top element and
 color by möbius function from top to element? Or a lattice where deleting
 some elements would make it non-lattice and those drawn as red? But there
 is no easy way to make graphics in documentation, so maybe no.

 You can still add an example, even if the code figure does not appear...
 It may change someday `:-)`

 Nathann

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