 
   # Converts polar coordinates in cartesian coordinates.
   #
-  #     Point.polar 90, 10 # [Point(x=0,y=10)]
+  # ```coffeescript
+  # Point.polar 90, 10 # [Point(x=0,y=10)]
+  # ```
+  #
+  # angle - A {Number} of the angle in radians.
+  # length - A {Number} of the vector length in pixels.
+  #
+  # Returns a [Point]{agt.geom.Point} instance.
   @polar: (angle, length=1) -> new Point Math.sin(angle) * length,
                                          Math.cos(angle) * length
 

  # return the angle in degrees formed by the two vectors at
  # the origin.
  #
  #     point1 = new Point 10, 0
  #     point2 = new Point 10, 10
  #     angle = point1.angleWith point2
  #     # angle = 45
  angleWith: (x, y) ->
    @noPoint 'dot' if not x? and not y?
    isPoint = @isPoint x

  # ```coffeescript
  # translate = (xOrPt, y) ->
  #   point = Point.pointFrom xOrPt, y
  # ```
  #
  # The first argument can be either an {Object} or a {Number}.
