Richard Stallman <rms@gnu.org> writes:
>   The docstrings of the functions
>
>   > calendar-extract-year
>   > calendar-extract-month
>   > calendar-extract-day
>
>   > are where the (MONTH DAY YEAR) format is mentioned.
>
> Would someoe like to add some comments at the start of the file
> documenging this data structure?

Attached is a patch which adds such a comment, based on my previous
message; let me know if I should open a bug report for this.

For now I take it that it's better not to touch the calendar code? I
don't think there is any constructor function for dates, or at least, I
see that throughout the calendar code, there are many uses of "(list
month day year)" to construct dates, so there might be a lot of code to
fix if we change the representation, and it might be hard to be sure
we've made all the necessary changes. Anyway, this is more work than I
want to do at the moment, though I'm willing to take a stab at it
eventually if others here think it would be worthwhile.

Best,
Richard