calendar: clarify comment syntax in man page

The single line comment indicator '//' is only detected at the
beginning of a line or when following white space to allow URLs
in calendar entries.

MFC after: 3 days