git: e0b22342f52b - main - newsyslog.conf(5): use "rotated" instead of "trimmed"
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Thu, 16 Apr 2026 06:06:28 UTC
The branch main has been updated by imp:
URL: https://cgit.FreeBSD.org/src/commit/?id=e0b22342f52b22b1762b09ab16bbc520cf0f2882
commit e0b22342f52b22b1762b09ab16bbc520cf0f2882
Author: Kit Dallege <xaum.io@gmail.com>
AuthorDate: 2026-03-27 04:25:35 +0000
Commit: Warner Losh <imp@FreeBSD.org>
CommitDate: 2026-04-16 06:05:20 +0000
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
---
usr.sbin/newsyslog/newsyslog.conf.5 | 10 +++++-----
1 file 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