#19542: Exception strings to Developer manual
-------------------------------------+-------------------------------------
Reporter: jmantysalo | Owner:
Type: enhancement | Status: new
Priority: minor | Milestone: sage-6.10
Component: documentation | Resolution:
Keywords: | Merged in:
Authors: Jori Mäntysalo | Reviewers:
Report Upstream: N/A | Work issues:
Branch: | Commit:
u/jmantysalo/raises | 57130a2b849c0f2ff0823e1c3135a09ee740445f
Dependencies: | Stopgaps:
-------------------------------------+-------------------------------------
Comment (by jmantysalo):
Replying to [comment:3 ncohen]:
> Do you mean that you want this standard to be applied even when several
sentences occur?
I did not change
{{{
raise ValueError("element_labels should be a dict or a list if "+
"different from None. (Did you intend data to be "+
"equal to a pair ?)")
}}}
And as I have said before: Whole developer manual should be seen as a
default values. "Do like this, or think (and maybe say out) why you did
not."
Personally I would like to see whole sentences always, but it is against
Python conventions. Can we say "If exception string is one sentence, start
it with lowercase and do not end to comma. In other words, follow Python
convention::"
In any case the error reporting is not that good for beginner. Example:
{{{
P = Posets.PentagonPoset()
p1 = P.chain_polynomial()
p2 = P.characteristic_polynomial()
p3 = P.h_polynomial()
}}}
says
{{{
Traceback (click to the left of this block for traceback)
...
TypeError: the poset should be graded
}}}
and clicking says something strange like `exec
compile(u'open("___code___.py","w").write("# -*- coding: utf-8 -*-\\n" +
_support_.preparse`... It takes a while to see what function failed.
--
Ticket URL: <http://trac.sagemath.org/ticket/19542#comment:4>
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.
