git: dc9e68ad0187 - main - calendar: clarify comment syntax in man page

From: Stefan Eßer <se_at_FreeBSD.org>
Date: Sun, 31 Jul 2022 05:39:33 UTC
The branch main has been updated by se:

URL: https://cgit.FreeBSD.org/src/commit/?id=dc9e68ad0187bdfe4781256a6c4751e074e1e2a2

commit dc9e68ad0187bdfe4781256a6c4751e074e1e2a2
Author:     Stefan Eßer <se@FreeBSD.org>
AuthorDate: 2022-07-31 05:37:05 +0000
Commit:     Stefan Eßer <se@FreeBSD.org>
CommitDate: 2022-07-31 05:37:05 +0000

    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
---
 usr.bin/calendar/calendar.1 | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/usr.bin/calendar/calendar.1 b/usr.bin/calendar/calendar.1
index 1b4972b70f78..63e43055dde4 100644
--- a/usr.bin/calendar/calendar.1
+++ b/usr.bin/calendar/calendar.1
@@ -28,7 +28,7 @@
 .\"     @(#)calendar.1  8.1 (Berkeley) 6/29/93
 .\" $FreeBSD$
 .\"
-.Dd November 5, 2020
+.Dd July 31, 2022
 .Dt CALENDAR 1
 .Os
 .Sh NAME
@@ -219,11 +219,13 @@ If the shared file is not referenced by a full pathname,
 searches in the current (or home) directory first, and then in the
 directory
 .Pa /usr/share/calendar .
-Empty lines and text protected by the C commenting syntax
-.Pq Li /* ... */
+.Pp
+Blank lines and text protected by the C comment syntax
+.Ql /* ... */
 or
-.Pq Li //
-are ignored.
+.Ql //
+are ignored, but the latter only at the beginning of a line or after
+white space to allow for URLs in calendar entries.
 .Pp
 Some possible calendar entries (<tab> characters highlighted by
 \fB\et\fR sequence):