git: 5f922bd20d81 - main - freebsd-base.7: Break examples into subsections

From: Alexander Ziaee <ziaee_at_FreeBSD.org>
Date: Tue, 14 Apr 2026 13:21:20 UTC
The branch main has been updated by ziaee:

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

commit 5f922bd20d81af4b5759b8f104d5c22ee3e5cd1b
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2026-04-14 13:20:38 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2026-04-14 13:21:05 +0000

    freebsd-base.7: Break examples into subsections
    
    Break the examples into subsections, so that we can have multi-step
    examples.
    
    MFC after:              3 days (to 15 only)
    Discussed with:         ivy
    Differential Revision:  https://reviews.freebsd.org/D55526
---
 share/man/man7/freebsd-base.7 | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/share/man/man7/freebsd-base.7 b/share/man/man7/freebsd-base.7
index 383808579487..aaa5a875df71 100644
--- a/share/man/man7/freebsd-base.7
+++ b/share/man/man7/freebsd-base.7
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd December 4, 2025
+.Dd February 26, 2026
 .Dt FREEBSD-BASE 7
 .Os
 .Sh NAME
@@ -183,13 +183,14 @@ The system test suite, installed in
 All available system kernels.
 .El
 .Sh EXAMPLES
+.Ss Install a single piece of userland
 Install the
 .Xr vi 1
 text editor on the running system:
 .Bd -literal -offset indent
 pkg install FreeBSD-vi
 .Ed
-.Pp
+.Ss Install userland to a jail
 Install a new
 .Xr jail 8
 system using the
@@ -198,17 +199,17 @@ package set:
 .Bd -literal -offset indent
 pkg -r /jails/myjail install FreeBSD-set-minimal-jail
 .Ed
-.Pp
+.Ss Install native compilers
 Install C/C++ compilers on the running system:
 .Bd -literal -offset indent
 pkg install FreeBSD-set-devel
 .Ed
-.Pp
+.Ss Update the currently running system
 Apply available updates to the running system:
 .Bd -literal -offset indent
 pkg upgrade -r FreeBSD-base
 .Ed
-.Pp
+.Ss Install cross compilers
 Install the development toolchain for FreeBSD/powerpc64le in an
 alternate root (for example, to support cross-compiling software
 for a different target than the host system):