diff --git a/lib/modules/Calendar.pmod/Event.pmod b/lib/modules/Calendar.pmod/Event.pmod
index d0ff0030a22d60b95c21af1c630ab7885728289a..d8d00e7447f277400353aad917c869bf75e02402 100644
--- a/lib/modules/Calendar.pmod/Event.pmod
+++ b/lib/modules/Calendar.pmod/Event.pmod
@@ -720,9 +720,9 @@ class Monthday_Weekday
 //!	"monday", "tuesday", "wednesday", "thursday", 
 //!	"friday", "saturday" and "sunday".
 //! 
-//! method void create(int month_day,int weekday)
-//!	The event is created by a given month day,
-//!	and a weekday number (1=Monday, 7=Sunday).
+//! method void create(int weekday)
+//!	The event is created by a given 
+//!	weekday number (1=Monday, 7=Sunday).
 //!
 //! note:
 //!	The week day numbers used
diff --git a/lib/modules/Calendar.pmod/TZnames.pmod b/lib/modules/Calendar.pmod/TZnames.pmod
index e32c30f972beb394f4d73c9da748ec9671058e10..9a51bf48790da6b9fdebaff50bf3abd299a8bf81 100644
--- a/lib/modules/Calendar.pmod/TZnames.pmod
+++ b/lib/modules/Calendar.pmod/TZnames.pmod
@@ -21,9 +21,8 @@
 //!        <i>[...]</i> }),
 //!	</pre>
 //!
-//! note: 
-//!	Loading all the timezones can take some time, since
-//!	they are generated and compiled on the fly.
+//!	Please note that loading all the timezones can take some 
+//!	time, since they are generated and compiled on the fly.
 
 mapping zones=
 ([
@@ -117,8 +116,7 @@ mapping zones=
 //!        <i>[...]</i> }),
 //!	</pre>
 //!
-//! note:
-//!	Just because it's noted "CST" doesn't mean it's a
+//!	Note this: Just because it's noted "CST" doesn't mean it's a
 //!	unique timezone. There is about 7 *different* timezones that
 //!	uses "CST" as abbreviation; not at the same time,
 //!	though, so the DWIM routines checks this before
@@ -127,6 +125,9 @@ mapping zones=
 //!     For most timezones, there is a number of region timezones that for the
 //!     given time are equal. This is because region timezones include rules
 //!     about local summer time shifts and possible historic shifts.
+//!
+//!	The <ref>YMD.parse</ref> functions can handle timezone abbreviations
+//!	by guessing.
 
 mapping abbr2zones=
 ([
diff --git a/lib/modules/Calendar.pmod/YMD.pmod b/lib/modules/Calendar.pmod/YMD.pmod
index ac8dafb1c22c5cf704fb758081a63ad5739f5d6c..2dc500c44dd79bfe9a541268532973bc44886f05 100644
--- a/lib/modules/Calendar.pmod/YMD.pmod
+++ b/lib/modules/Calendar.pmod/YMD.pmod
@@ -2314,8 +2314,8 @@ class cSuperTimeRange
 //!	WST          Australia/Perth      [UTC+8]
 //!	</pre>
 //!
-//!	This mapping is modifiable in the ruleset, 
-//!	see <ref>Ruleset.set_abbr2zone</ref>.
+//!	This mapping is modifiable in the ruleset, see 
+//!	<ref>Ruleset.set_abbr2zone</ref>.
 
 
 // this API may change without further notice