Updates documentation

Author: sdispater

docs/_docs/attributes_properties.rst

@@ -41,7 +41,7 @@ Pendulum gives access to more attributes and properties than the default ``datet
     dt.int_timestamp
     1346887571
 
-    pendulum.from_date(1975, 5, 21).age
+    pendulum.create(1975, 5, 21).age
     41 # calculated vs now in the same tz
     dt.quarter
     3
@@ -59,9 +59,9 @@ Pendulum gives access to more attributes and properties than the default ``datet
     9.5
 
     # Indicates if day light savings time is on
-    pendulum.from_date(2012, 1, 1, 'America/Toronto').is_dst
+    pendulum.create(2012, 1, 1, tz='America/Toronto').is_dst
     False
-    pendulum.from_date(2012, 9, 1, 'America/Toronto').is_dst
+    pendulum.create(2012, 9, 1, tz='America/Toronto').is_dst
     True
 
     # Indicates if the instance is in the same timezone as the local timezone

docs/_docs/comparison.rst

@@ -114,9 +114,9 @@ the ``now()`` is created in the same timezone as the instance.
     dt.is_leap_year()
     dt.is_same_day(Pendulum.now())
 
-    born = pendulum.from_date(1987, 4, 23)
-    not_birthday = pendulum.from_date(2014, 9, 26)
-    birthday = pendulum.from_date(2014, 2, 23)
+    born = pendulum.create(1987, 4, 23)
+    not_birthday = pendulum.create(2014, 9, 26)
+    birthday = pendulum.create(2014, 2, 23)
     past_birthday = pendulum.now().subtract(years=50)
 
     born.is_birthday(not_birthday)

docs/_docs/difference.rst

@@ -17,8 +17,8 @@ This will default to ``True``, return the absolute value. The comparisons are do
 
     import pendulum
 
-    dt_ottawa = pendulum.from_date(2000, 1, 1, 'America/Toronto')
-    dt_vancouver = pendulum.from_date(200, 1, 1, 'America/Vancouver')
+    dt_ottawa = pendulum.create(2000, 1, 1, tz='America/Toronto')
+    dt_vancouver = pendulum.create(2000, 1, 1, tz='America/Vancouver')
 
     dt_ottawa.diff(dt_vancouver).in_hours()
     3
@@ -89,7 +89,7 @@ You may also pass ``True`` as a 2nd parameter to remove the modifiers `ago`, `fr
     pendulum.now().diff_for_humans(Pendulum.now().subtract(years=1))
     '1 year after'
 
-    dt = pendulum.from_date(2011, 8, 1)
+    dt = pendulum.create(2011, 8, 1)
     dt.diff_for_humans(dt.add(months=1))
     '1 month before'
     dt.diff_for_humans(dt.subtract(months=1))

docs/_docs/instantiation.rst

@@ -61,29 +61,17 @@ besides behaving as expected, all accept a timezone parameter and each has their
     print(yesterday)
     '2016-06-27T00:00:00-05:00'
 
-The next group of static helpers are the ``from_xxx()`` and ``create()`` helpers.
-Most of the static ``create`` functions allow you to provide
+The next helper is ``create()`` which allows you to provide
 as many or as few arguments as you want and will provide default values for all others.
-Generally default values are the current date, time set to ``00:00:00`` and ``UTC`` timezone.
 
 .. code-block:: python
 
-    pendulum.from_date(year, month, day, tz)
-    pendulum.from_time(hour, minute, second, microsecond, tz)
     pendulum.create(year, month, day, hour, minute, second, microsecond, tz)
 
-``from_date()`` will default the time to ``00:00:00``. ``from_time()`` will default the date to today.
 ``create()`` will default any null parameter to the current date for the date part and to ``00:00:00`` for time.
-As before, the ``tz`` defaults to the ``UTC`` timezone and otherwise can be a ``TimezoneInfo`` instance
+As before, the ``tz`` defaults to the ``UTC`` timezone and otherwise can be a ``Timezone`` instance
 or simply a string timezone value.
 
-.. code-block:: python
-
-    xmas_this_year = pendulum.from_date(None, 12, 25)
-    # Year defaults to current year
-    y2k = pendulum.create(2000, 1, 1, 0, 0, 0)
-    noon_london_tz = pendulum.from_time(12, 0, 0, tz='Europe/London')
-
 .. code-block:: python
 
     pendulum.from_format(time, format, tz)

docs/_docs/introduction.rst

@@ -21,8 +21,8 @@ For example all comparisons are done in UTC or in the timezone of the datetime b
 
     import pendulum
 
-    dt_toronto = pendulum.from_date(2012, 1, 1, 'America/Toronto')
-    dt_vancouver = pendulum.from_date(2012, 1, 1, 'America/Vancouver')
+    dt_toronto = pendulum.create(2012, 1, 1, tz='America/Toronto')
+    dt_vancouver = pendulum.create(2012, 1, 1, tz='America/Vancouver')
 
     print(dt_vancouver.diff(dt_toronto).in_hours())
     3