When should one use "optional" versus "default" in docstrings?  I've 
noticed a lot of variation in the files in /src/sage/.  Often, "optional" 
is used if the argument in question defaults to "None", but I also see 
"(default: None)" or "(default: ``None``)".  On the other hand, I also see 
examples of "optional" being used when the argument defaults to something 
other than None, e.g., -1.


-- 
You received this message because you are subscribed to the Google Groups 
"sage-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sage-devel+unsubscr...@googlegroups.com.
To post to this group, send email to sage-devel@googlegroups.com.
Visit this group at http://groups.google.com/group/sage-devel.
For more options, visit https://groups.google.com/d/optout.

Reply via email to