From 9c7337903a55ba66a93dfc3d43f469c7506b9dcb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Fernando=20Apestegu=C3=ADa?= <fernape@FreeBSD.org>
Date: Thu, 25 Jun 2020 16:46:27 +0000
Subject: [PATCH] limits(1): Add EXAMPLES section

 * Add four examples showing flags -e, -b, -d, -s
 * Remove extra space at the end of the line reported by igor

Approved by:	bcr@
Differential Revision:	https://reviews.freebsd.org/D25426
---
 usr.bin/limits/limits.1 | 42 +++++++++++++++++++++++++++++++++++++++--
 1 file changed, 40 insertions(+), 2 deletions(-)

diff --git a/usr.bin/limits/limits.1 b/usr.bin/limits/limits.1
index 3601a9e49137..6000aa4bd759 100644
--- a/usr.bin/limits/limits.1
+++ b/usr.bin/limits/limits.1
@@ -19,7 +19,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd May 26, 2020
+.Dd June 25, 2020
 .Dt LIMITS 1
 .Os
 .Sh NAME
@@ -376,6 +376,44 @@ exits with a status of
 .Dv EXIT_SUCCESS .
 When run in command mode and execution of the command succeeds, the exit status
 will be whatever the executed program returns.
+.Sh EXAMPLES
+Show current stack size limit:
+.Bd -literal -offset indent
+$ limits -s
+Resource limits (current):
+	  stacksize              524288 kB
+.Ed
+.Pp
+Try to run
+.Xr ls 1
+with 1 byte of
+.Va datasize
+limit:
+.Bd -literal -offset indent
+$ limits -d 1b ls
+Data segment size exceeds process limit
+Abort trap
+.Ed
+.Pp
+Produce
+.Ql eval mode
+output to limit
+.Va sbsize
+to 1 byte.
+Output obtained when command is run from
+.Xr sh 1 :
+.Bd -literal -offset indent
+$ limits -e -b 1b
+ulimit -b 512;
+.Ed
+.Pp
+Same as above from
+.Xr csh 1
+.Bd -literal -offset indent
+% limits -e -b 1b
+limit -h sbsize 512;
+limit sbsize 512;
+.Ed
 .Sh SEE ALSO
 .Xr csh 1 ,
 .Xr env 1 ,
@@ -396,7 +434,7 @@ utility first appeared in
 The
 .Nm
 utility was written by
-.An David Nugent Aq Mt davidn@FreeBSD.org . 
+.An David Nugent Aq Mt davidn@FreeBSD.org .
 .Sh BUGS
 The
 .Nm