git: 91ad27bcfc49 - main - truncate.1: Polish title and examples

The branch main has been updated by ziaee:

URL: https://cgit.FreeBSD.org/src/commit/?id=91ad27bcfc496393ba88f39ca13cdf1c59a7f487

commit 91ad27bcfc496393ba88f39ca13cdf1c59a7f487
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2024-12-30 06:11:15 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2025-07-09 17:52:01 +0000

    truncate.1: Polish title and examples
    
    + describe better
    + switch examples to human readable sizes, with consistent spacing
    + `Downsize ... in 5 Megabytes` >> `Downsize ... by 5 Megabytes`
    + remove prompt from lone example with prompt for consistency
    + remove x permissions from kernel example
    + examples now fit on standard console without wrapping
    
    While here:
    + fold a line to eliminate linter warning + tag spdx
    + add -nosplit to AUTHORS to eliminate a rendering glitch
    
    MFC after:      3 days
    Discussed with: asomers, jhb, maxim
    Reviewed by:    imp (previous version)
    Closes:         https://github.com/freebsd/freebsd-src/pull/1568
---
 usr.bin/truncate/truncate.1 | 30 +++++++++++++++++-------------
 1 file changed, 17 insertions(+), 13 deletions(-)

diff --git a/usr.bin/truncate/truncate.1 b/usr.bin/truncate/truncate.1
index f6b8b0cc37c9..aa70943b889f 100644
--- a/usr.bin/truncate/truncate.1
+++ b/usr.bin/truncate/truncate.1
@@ -1,4 +1,6 @@
 .\"
+.\" SPDX-License-Identifier: BSD-2-Clause
+.\"
 .\" Copyright (c) 2000 Sheldon Hearn <sheldonh@FreeBSD.org>.
 .\" All rights reserved.
 .\" Copyright (c) 2021 The FreeBSD Foundation
@@ -27,12 +29,12 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd March 6, 2025
+.Dd July 9, 2025
 .Dt TRUNCATE 1
 .Os
 .Sh NAME
 .Nm truncate
-.Nd truncate, extend the length of files, or perform space management in files
+.Nd resize files or manage file space
 .Sh SYNOPSIS
 .Nm
 .Op Fl c
@@ -132,7 +134,8 @@ file system space deallocation may be performed in the operation region.
 The space management operation is performed at the given
 .Ar offset
 bytes in the file.
-If this option is not specified, the operation is performed at the beginning of the file.
+If this option is not specified,
+the operation is performed at the beginning of the file.
 .It Fl l Ar length
 The length of the operation range in bytes.
 This option must always be specified if option
@@ -195,9 +198,9 @@ truncate -c -s 10M test_file
 .Pp
 Same as above but create the file if it does not exist:
 .Bd -literal -offset indent
-truncate -s 10M test_file
-ls -l test_file
--rw-r--r--  1 root  wheel  10485760 Jul 22 18:48 test_file
+truncate -s +10M test_file
+ls -lh test_file
+-rw-r--r--  1 root  wheel    10M Jul 22 18:48 test_file
 .Ed
 .Pp
 Adjust the size of
@@ -207,10 +210,10 @@ to the size of the kernel and create another file
 with the same size:
 .Bd -literal -offset indent
 truncate -r /boot/kernel/kernel test_file test_file2
-ls -l /boot/kernel/kernel test_file*
--r-xr-xr-x  1 root  wheel    31352552 May 15 14:18 /boot/kernel/kernel
--rw-r--r--  1 root  wheel    31352552 Jul 22 19:15 test_file
--rw-r--r--  1 root  wheel    31352552 Jul 22 19:15 test_file2
+ls -lh /boot/kernel/kernel test_file*
+-r--r--r--  1 root  wheel    30M May 15 14:18 /boot/kernel/kernel
+-rw-r--r--  1 root  wheel    30M Jul 22 19:15 test_file
+-rw-r--r--  1 root  wheel    30M Jul 22 19:15 test_file2
 .Ed
 .Pp
 Increase the size of the file
@@ -228,9 +231,9 @@ Reduce the size of the file
 by 5 megabytes:
 .Bd -literal -offset indent
 truncate -s -5M test_file
-ls -l test_file*
--rw-r--r--  1 root  wheel    31352552 Jul 22 19:19 test_file
--rw-r--r--  1 root  wheel    31352552 Jul 22 19:15 test_file2
+ls -lh test_file*
+-rw-r--r--  1 root  wheel    25M Jul 22 19:17 test_file
+-rw-r--r--  1 root  wheel    30M Jul 22 19:15 test_file2
 .Ed
 .Sh SEE ALSO
 .Xr dd 1 ,
@@ -247,6 +250,7 @@ The
 utility first appeared in
 .Fx 4.2 .
 .Sh AUTHORS
+.An -nosplit
 The
 .Nm
 utility was written by