Hi,
The double ?? is fine to me : it prints the documentation as in the
file :
sage: Partition??
...
Sage follows the usual python conventions when dealing with
partitions,
so that the first part of the partition ``mu=Partition([4,3,2,2])
`` is
``mu[0]``, the second part is ``mu[1]`` and so on. As is usual,
Sage ignores
trailing zeros at the end of partitions.
...
But, the single ? adds a tabulation (4 spaces) to the left, which is
not nice to me :
sage: Partition?
...
Sage follows the usual python conventions when dealing with
partitions,
``mu[0]``, the second part is ``mu[1]`` and so on. As is
usual, Sage ign
ores
trailing zeros at the end of partitions.
...
Where can I see the code of the single '?' printing-doc function? Was
there a reason for adding those 4 spaces? Do you agree with me for
removing those 4 spaces? I know I can enlarge my terminal horizontaly,
but I think it would be nice if it would behave nicely for the
standard 80.
Nothing is said about that in the
http://sagemath.org/doc/developer/conventions.html
but every lines in the given examples contains at most 70 characters,
which suggests that sage is actually suggesting something but what!? I
think some developer are already aware of the 4 added spaces (or maybe
is it for other esthetical reasons?) and now write lines of at most 76
(or even at most 70) characters so that no lines get broken uglyly in
both ways :
sage: sage.graphs.graph?
Graph Theory
This module implements many graph theoretic operations and
concepts.
AUTHORS:
- Robert L. Miller (2006-10-22): initial version
- William Stein (2006-12-05): Editing
- Robert L. Miller (2007-01-13): refactoring, adjusting for
NetworkX-0.33, fixed plotting bugs (2007-01-23): basic
tutorial,
edge labels, loops, multiple edges and arcs (2007-02-07):
graph6
and sparse6 formats, matrix input
- Emily Kirkmann (2007-02-11): added graph_border option to plot
and show
- Robert L. Miller (2007-02-12): vertex color-maps, graph
boundaries, graph6 helper functions in Cython
- Robert L. Miller Sage Days 3 (2007-02-17-21): 3d plotting in
Tachyon
...
What do you think about that?
Sébastien Labbé
PhD Student
UQAM - Montellier 2
--~--~---------~--~----~------------~-------~--~----~
To post to this group, send an email to sage-devel@googlegroups.com
To unsubscribe from this group, send an email to
sage-devel-unsubscr...@googlegroups.com
For more options, visit this group at http://groups.google.com/group/sage-devel
URL: http://www.sagemath.org
-~----------~----~----~----~------~----~------~--~---
