newsyslog.conf(5): use "rotated" instead of "trimmed"

The man page used "trimmed" to describe log rotation, which is
misleading as it suggests the file is truncated to a specific
size rather than being rotated (renamed and a new file created).
Replace all instances of "trimmed" with "rotated" to match the
actual behavior and the terminology used elsewhere in the page.

PR: 278671
Signed-off-by: Kit Dallege <xaum.io@gmail.com>
Reviewed by: imp,ziaee
Pull Request: https://github.com/freebsd/freebsd-src/pull/2099
This commit is contained in:
Kit Dallege
2026-03-27 05:25:35 +01:00
committed by Warner Losh
parent 75e7709f4f
commit e0b22342f5
+5 -5
View File
@@ -18,7 +18,7 @@
.\" the suitability of this software for any purpose. It is
.\" provided "as is" without express or implied warranty.
.\"
.Dd March 8, 2026
.Dd April 15, 2026
.Dt NEWSYSLOG.CONF 5
.Os
.Sh NAME
@@ -155,10 +155,10 @@ When the size of the log file reaches
.Ar size ,
in kilobytes by default, or with suffixes like k, M, G, ... as supported by
.Xr expand_number 3 ,
the log file will be trimmed as described above.
the log file will be rotated.
If this field contains an asterisk
.Pq Ql * ,
the log file will not be trimmed based on size.
the log file will not be rotated based on size.
.It Ar when
The
.Ar when
@@ -183,10 +183,10 @@ Additionally, the format may also be constructed with a
sign along with a rotation time specification of once
a day, once a week, or once a month.
.Pp
Time based trimming happens only if
Time based rotation happens only if
.Xr newsyslog 8
is run within one hour of the specified time.
If an interval is specified, the log file will be trimmed if that many
If an interval is specified, the log file will be rotated if that many
hours have passed since the last rotation.
When both a time and an interval are
specified then both conditions must be satisfied for the rotation to