Allow size as an argument for point2d

[slabbe]

For 3d points, one must use the argument size :

sage: point((2,3,4), size=100)

But for 2d points, one must use the argument pointsize :

sage: point((2,3), size=100)
verbose 0 (136: primitive.py, options) WARNING: Ignoring option 'size'=100
verbose 0 (136: primitive.py, options) 
The allowed options for Point set defined by 1 point(s) are:
    alpha          How transparent the line is.                                
    faceted        If True color the edge of the point.                        
    hue            The color given as a hue.                                   
    pointsize      How big the point is.                                       
    rgbcolor       The color as an RGB tuple.                                  
    zorder         The layer level in which to draw                            


sage: point((2,3), pointsize=100)

I think pointsize is kind of redundant and size would not be ambiguous. At least, if we keep pointsize for backward compatibility reasons, I would like

sage: point((2,3), size=100)

to work.

[slabbe]

I improved a comment about pointsize vs size and just uploaded the patch.

[jason]

Positive review on slabbe's patch.

I enhanced the documentation for pointsize, added a deprecation functionality for the rename decorator, and then deprecated the pointsize keyword in my patch. My patch needs to be reviewed now.

[jason]

apply on top of previous patch

[jason]

Okay, I moved the deprecation code over to #8607, since William requested that we don't deprecate the pointsize option (for mma compatibility). I've instead posted a new patch which just contains a few documentation enhancements and fixes. Sebastien, can you review my patch? If it's a positive review, then set this to positive review.

[slabbe]

Positive review for Jason's doc fixes.

#8607 = great!

[jhpalmieri]

Merged in 4.4.alpha0:

• trac_8599_pointsize-sl.patch
• trac-8599-fix-docs.patch