- a Gregorian calendar date in (*Y,*M,*D). Dates both before
- and after the epoch are supported. */
+ a Gregorian calendar date in (*Y,*M,*D). Also stores the
+ year-relative day number into *YD. Dates both before and
+ after the epoch are supported. */