From dc9e68ad0187bdfe4781256a6c4751e074e1e2a2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Stefan=20E=C3=9Fer?= Date: Sun, 31 Jul 2022 07:37:05 +0200 Subject: [PATCH] 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 1b4972b70f7..63e43055dde 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 ( characters highlighted by \fB\et\fR sequence):