bin/48460: Minor man page enhancement for newsyslog(8)

[dhgutteridge%sympatico.ca@localhost]

>Number:         48460
>Category:       bin
>Synopsis:       Minor man page enhancement for newsyslog(8)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    bin-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Fri Dec 20 00:05:01 +0000 2013
>Originator:     David H. Gutteridge
>Release:        6.99.28
>Organization:
>Environment:
N/A
>Description:
The newsyslog(8) man page doesn't note that a value of 0 in the ngen
field disables the deletion of archived log files for that entry. I
thought that should be clarified given there's more than one possible
behaviour one could guess could happen (i.e., it could not keep any
archived log files instead).

(From looking at the code, any negative value supplied for that field
would have the same effect, though it would fall through the initial
check for zero and simply fail to unlink any files.)

>How-To-Repeat:
Read the man page and wonder what an ngen value of 0 would do.
>Fix:
--- newsyslog.8.orig    2013-12-19 18:50:47.000000000 -0500
+++ newsyslog.8 2013-12-19 18:58:53.000000000 -0500
@@ -133,7 +133,8 @@
 Specify the mode of the log file and archives.
 .It Ar ngen
 Specify the number of archive files to be kept
-besides the log file itself.
+besides the log file itself. A value of 0 disables the deletion of
+any archive files during log rotation.
 .It Ar size
 When the size of the log file reaches
 .Ar size