aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKit Dallege <xaum.io@gmail.com>2026-03-27 04:25:35 +0000
committerWarner Losh <imp@FreeBSD.org>2026-04-16 06:05:20 +0000
commite0b22342f52b22b1762b09ab16bbc520cf0f2882 (patch)
tree1413d92d749eb8389a972dd670869f18b47f5602
parent75e7709f4f3c9e1576af45715730c286c1ec3b24 (diff)
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
-rw-r--r--usr.sbin/newsyslog/newsyslog.conf.510
1 files changed, 5 insertions, 5 deletions
diff --git a/usr.sbin/newsyslog/newsyslog.conf.5 b/usr.sbin/newsyslog/newsyslog.conf.5
index 1683a1018f9e..b26df4bb1a61 100644
--- a/usr.sbin/newsyslog/newsyslog.conf.5
+++ b/usr.sbin/newsyslog/newsyslog.conf.5
@@ -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