From owner-freebsd-doc@FreeBSD.ORG Tue May 20 21:28:01 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3ED2637B401; Tue, 20 May 2003 21:28:01 -0700 (PDT) Received: from builder.freebsdmall.com (builder.freebsdmall.com [65.86.180.18]) by mx1.FreeBSD.org (Postfix) with ESMTP id AE0F743FB1; Tue, 20 May 2003 21:28:00 -0700 (PDT) (envelope-from murray@builder.freebsdmall.com) Received: (from root@localhost) by builder.freebsdmall.com (8.12.9/8.11.6) id h4L4S0HZ062903; Tue, 20 May 2003 21:28:00 -0700 (PDT) (envelope-from murray) Date: Tue, 20 May 2003 21:28:00 -0700 From: Murray Stokely To: Tom Rhodes Message-ID: <20030520212800.U8403@freebsdmall.com> References: <200305210121.h4L1LfLI066670@repoman.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <200305210121.h4L1LfLI066670@repoman.freebsd.org>; from trhodes@FreeBSD.org on Tue, May 20, 2003 at 06:21:41PM -0700 X-GPG-Key-ID: 1024D/0E451F7D X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B 3CB5 B4D7 10A2 0E45 1F7D cc: freebsd-doc@FreeBSD.org Subject: Re: cvs commit: www/en/docproj handbook3.sgml X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 21 May 2003 04:28:01 -0000 On Tue, May 20, 2003 at 06:21:41PM -0700, Tom Rhodes wrote: > Log: > The cron(8) documentation task is complete. Ok, I think this section would be clearer if you maybe start with a simpler example than the system crontab file. There is a lot of junk in there (/etc/crontab) and I think it is confusing. Maybe if you just examine one line at a time. Maybe list one line, then talk about it (with a callout list to point to each field), then list another line, showing off a different aspect of cron's functionality, and then talk about that example line. See the ppp chapter for an example of a callout list describing the fields in a text file (/etc/ttys). I just don't think we need to list the whole crontab file. (and of course, someone will submit a PR the moment that /etc/crontab gets updated reminding us to update this chapter!) Also, I think you should just tell new users to edit their own crontab file with 'crontab -e'. This invokes the editor and I think is easier than telling them to create a file then install that file. crontab -e is one less step and makes it easier for new users. Thanks for writing this. We've needed a crontab section for a long time! - Murray