Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 16 Apr 2026 06:06:28 +0000
From:      Warner Losh <imp@FreeBSD.org>
To:        src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org
Cc:        Kit Dallege <xaum.io@gmail.com>
Subject:   git: e0b22342f52b - main - newsyslog.conf(5): use "rotated" instead of "trimmed"
Message-ID:  <69e07c64.3b0f5.28715640@gitrepo.freebsd.org>

index | next in thread | raw e-mail

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


home | help

Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?69e07c64.3b0f5.28715640>