git: d39b1d6932dc - main - ulimit(3): Improve UL_{GET,SET}FSIZE wording

From: Aymeric Wibo <obiwac_at_FreeBSD.org>
Date: Fri, 09 Oct 2026 11:08:15 UTC
The branch main has been updated by obiwac:

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

commit d39b1d6932dcc16b7c8a399d196fd81d038ca261
Author:     Aymeric Wibo <obiwac@FreeBSD.org>
AuthorDate: 2026-10-08 14:17:22 +0000
Commit:     Aymeric Wibo <obiwac@FreeBSD.org>
CommitDate: 2026-10-09 11:07:35 +0000

    ulimit(3): Improve UL_{GET,SET}FSIZE wording
    
    Reword the UL_GETFSIZE and UL_SETFSIZE descriptions to say 512-byte
    blocks and make the setter's argument clearer.
    
    While here, improve mdoc markup and pull in other small improvements.
    
    Reviewed by:    des
    MFC after:      3 days
    Obtained from:  https://github.com/apple-oss-distributions/libc
    Sponsored by:   Klara, Inc.
    Differential Revision:  https://reviews.freebsd.org/D60467
---
 lib/libc/gen/ulimit.3 | 22 ++++++++++------------
 1 file changed, 10 insertions(+), 12 deletions(-)

diff --git a/lib/libc/gen/ulimit.3 b/lib/libc/gen/ulimit.3
index 771c40126944..880d3735574e 100644
--- a/lib/libc/gen/ulimit.3
+++ b/lib/libc/gen/ulimit.3
@@ -21,7 +21,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd January 4, 2003
+.Dd October 8, 2026
 .Dt ULIMIT 3
 .Os
 .Sh NAME
@@ -32,30 +32,28 @@
 .Sh SYNOPSIS
 .In ulimit.h
 .Ft long
-.Fn ulimit "int cmd" "..."
+.Fo ulimit
+.Fa "int cmd"
+.Fa "..."
+.Fc
 .Sh DESCRIPTION
 The
 .Fn ulimit
 function will get and set process limits.
-Currently this is limited to the maximum file size.
+Currently, this is limited to the maximum file size.
 The
 .Fa cmd
 argument is one of the following:
 .Bl -tag -width ".Dv UL_GETFSIZE"
 .It Dv UL_GETFSIZE
-will return the maximum file size in units of 512 blocks of
-the current process.
+will return the maximum file size of the current process,
+in units of 512-byte blocks.
 .It Dv UL_SETFSIZE
 will attempt to set the maximum file size of the current
-process and its children with the second argument expressed as a long.
+process and its children, using the second argument (expressed as a long).
 .El
 .Sh RETURN VALUES
-Upon successful completion,
-.Fn ulimit
-returns the value requested;
-otherwise the value \-1 is returned and the global variable
-.Va errno
-is set to indicate the error.
+.Rv -std
 .Sh ERRORS
 The
 .Fn ulimit