Point docs: clarify `parse_degrees` and `from_sequence`
@@ -99,7 +99,7 @@ class Point(object):
>>> p1 = Point(41.5, -81, 0)
>>> p2 = Point(latitude=41.5, longitude=-81)
- With a sequence of 0 to 3 values (latitude, longitude, altitude)::
+ With a sequence of 2 to 3 values (latitude, longitude, altitude)::
>>> p1 = Point([41.5, -81, 0])
>>> p2 = Point((41.5, -81))
@@ -308,7 +308,10 @@ class Point(object):
@classmethod
def parse_degrees(cls, degrees, arcminutes, arcseconds, direction=None):
"""
- Parse degrees minutes seconds including direction (N, S, E, W)
+ Convert degrees, minutes, seconds and direction (N, S, E, W)
+ to a single degrees number.
+
+ :rtype: float
"""
degrees = float(degrees)
negative = degrees < 0
@@ -442,7 +445,7 @@ class Point(object):
@classmethod
def from_sequence(cls, seq):
"""
- Create and return a new ``Point`` instance from any iterable with 0 to
+ Create and return a new ``Point`` instance from any iterable with 2 to
3 elements. The elements, if present, must be latitude, longitude,
and altitude, respectively.
"""
