From k-horik@yk.rim.or.jp  Thu Jan 21 08:09:19 1999
Received: from mail.yk.rim.or.jp (mail.yk.rim.or.jp [202.247.130.37])
          by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id IAA20545
          for <FreeBSD-gnats-submit@freebsd.org>; Thu, 21 Jan 1999 08:09:17 -0800 (PST)
          (envelope-from k-horik@yk.rim.or.jp)
Received: from localhost (ppp442.yk.rim.or.jp [202.247.165.142])
	by mail.yk.rim.or.jp (8.8.5/3.6W-RIMNET-98-06-09) with ESMTP id BAA03929
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 22 Jan 1999 01:08:50 +0900 (JST)
Message-Id: <19990122010815N.k-horik@yk.rim.or.jp>
Date: Fri, 22 Jan 1999 01:08:15 +0900
From: horikawa@jp.freebsd.org
Sender: Kazuo Horikawa <k-horik@yk.rim.or.jp>
Reply-To: horikawa@jp.freebsd.org
To: FreeBSD-gnats-submit@freebsd.org
Subject: newsyslog.8 typo.
X-Send-Pr-Version: 3.2

>Number:         9602
>Category:       docs
>Synopsis:       newsyslog.8 typo.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Jan 21 08:10:01 PST 1999
>Closed-Date:    Tue Jan 26 20:29:38 PST 1999
>Last-Modified:  Tue Jan 26 20:30:16 PST 1999
>Originator:     Kazuo Horikawa
>Release:        FreeBSD 2.2.7-RELEASE i386
>Organization:
jpman project, Japan FreeBSD Users Group
>Environment:

	src/usr.sbin/newsyslog/newsyslog.8 revision 1.14 (RELENG_3, HEAD)

>Description:

	newsyslog.8 describes /etc/newsyslog.conf as follows:

	"Each line has five mandatory fields and three optional fields,"
	                                         ^^^^^
	But, I believe /etc/newsyslog.conf has five mandatory fields
	and four optional fields as follows:
	    ^^^^
	o mandatory fields: logfile_name, mode, count, size, interval
	o optional fields: owner.group, flags, path_to_pid_file,
	                   signal_number

	
	And, I think that newsyslog.8 should say "owner.group" field
	is optional, because default /etc/newsyslog.conf does not have
	owner.group field, as follows:

# configuration file for newsyslog
# $Id: newsyslog.conf,v 1.16 1998/06/09 18:26:16 ache Exp $
#
# logfilename           owner.group     mode count size time [ZB] [/pid_file] [sig_num]
/var/cron/log                           600  3     100  *     Z
[snip]

>How-To-Repeat:

	% man 8 newsyslog.8
	

>Fix:

	Apply following patch to src/usr.sbin/newsyslog/newsyslog.8
	revision 1.14 (RELENG_3, HEAD).
	
--- newsyslog.8.bak	Thu Jan 21 23:57:44 1999
+++ newsyslog.8	Fri Jan 22 00:01:16 1999
@@ -57,7 +57,7 @@
 Each line of the file contains information about a particular log file
 that should be handled by
 .Nm newsyslog .
-Each line has five mandatory fields and three optional fields, with a
+Each line has five mandatory fields and four optional fields, with a
 whitespace separating each field.  Blank lines or lines beginning with
 ``#'' are ignored.  The fields of the configuration file are as
 follows: 
@@ -66,7 +66,7 @@
 .It Ar logfile_name
 Name of the system log file to be archived.
 .It Ar owner.group
-Specify the owner and group for the archive file.
+This optional field specifes the owner and group for the archive file.
 The "." is essential, even if the
 .Ar owner
 or


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: jkoshy 
State-Changed-When: Tue Jan 26 20:29:38 PST 1999 
State-Changed-Why:  
Patch applied to rev 1.16 of "src/usr.sbin/newsyslog/newsyslog.8", thanks! 
>Unformatted:
