From owner-freebsd-bugs  Tue Nov 19 22:40: 6 2002
Delivered-To: freebsd-bugs@hub.freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 53A7837B406
	for <freebsd-bugs@hub.freebsd.org>; Tue, 19 Nov 2002 22:40:04 -0800 (PST)
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 0DF3443E42
	for <freebsd-bugs@hub.freebsd.org>; Tue, 19 Nov 2002 22:40:04 -0800 (PST)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.12.6/8.12.6) with ESMTP id gAK6e3x3064713
	for <freebsd-bugs@freefall.freebsd.org>; Tue, 19 Nov 2002 22:40:03 -0800 (PST)
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.12.6/8.12.6/Submit) id gAK6e3NS064712;
	Tue, 19 Nov 2002 22:40:03 -0800 (PST)
Date: Tue, 19 Nov 2002 22:40:03 -0800 (PST)
Message-Id: <200211200640.gAK6e3NS064712@freefall.freebsd.org>
To: freebsd-bugs@FreeBSD.org
Cc: 
From: Bruce Evans <bde@zeta.org.au>
Subject: Re: misc/45493: Confusing comment in /etc/crontab
Reply-To: Bruce Evans <bde@zeta.org.au>
Sender: owner-freebsd-bugs@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-bugs.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-bugs>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-bugs>
X-Loop: FreeBSD.org

The following reply was made to PR misc/45493; it has been noted by GNATS.

From: Bruce Evans <bde@zeta.org.au>
To: Kevin Oberman <oberman@es.net>
Cc: FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: misc/45493: Confusing comment in /etc/crontab
Date: Wed, 20 Nov 2002 17:47:26 +1100 (EST)

 On Tue, 19 Nov 2002, Kevin Oberman wrote:
 
 > >Description:
 > 	The comment for the adjkerntz entry in /etc/crontab is not
 > clear. The comma usage makes it unclear which cadse is the accepted
 > and which is rejected.
 > >How-To-Repeat:
 > 	Not applicable.
 > >Fix:
 >
 > --- crontab	Mon Jun 10 21:20:09 2002
 > +++ crontab.new	Tue Nov 19 13:14:47 2002
 > @@ -19,6 +19,6 @@
 >  30	5	1	*	*	root	periodic monthly
 >  #
 >  # time zone change adjustment for wall cmos clock,
 > -# does nothing, if you have UTC cmos clock.
 > +# does nothing if you have UTC cmos clock.
 >  # See adjkerntz(8) for details.
 >  1,31	0-5	*	*	*	root	adjkerntz -a
 
 Something should be done about the first comma too.  crontab is apparently
 supposed to be written in non-English with all "sentences" in comments not
 beginning with a capital letter and not ending with a period, but the
 comment about adjkerntz violates this by using bad English (a comma splice)
 in its first line, the stray comma and a period in its second line, and
 actual English in its last line.
 
 Bruce
 

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-bugs" in the body of the message