DOC: pd.Period and pd.period_range should document that they accept d…

…atetime, date and pd.Timestamp (#53632)

* Update docstrings for pandas.Period and period_range

* Fix Period docstring comment

* Fix Period value docstring

pandas/_libs/tslibs/period.pyx

@@ -2675,6 +2675,7 @@ class Period(_Period):
         One of pandas period strings or corresponding objects. Accepted
         strings are listed in the
         :ref:`offset alias section <timeseries.offset_aliases>` in the user docs.
+        If value is datetime, freq is required.
     ordinal : int, default None
         The period offset from the proleptic Gregorian epoch.
     year : int, default None

pandas/core/indexes/period.py

@@ -478,7 +478,7 @@ def period_range(
     ----------
     start : str, datetime, date, pandas.Timestamp, or period-like, default None
         Left bound for generating periods.
-    end : str or period-like, default None
+    end : str, datetime, date, pandas.Timestamp, or period-like, default None
         Right bound for generating periods.
     periods : int, default None
         Number of periods to generate.