git: 342fa740cbc6 - stable/14 - intro.5: Add local to files, minor maintenence

From: Alexander Ziaee <ziaee_at_FreeBSD.org>
Date: Sat, 29 Mar 2025 01:33:47 UTC
The branch stable/14 has been updated by ziaee:

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

commit 342fa740cbc653909e7bc4197453b0da74d2f2ba
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2024-11-17 17:07:34 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2025-03-29 01:31:48 +0000

    intro.5: Add local to files, minor maintenence
    
    New users are sometimes confused about the difference between /etc/ and
    /usr/local/etc. Explain this in the manual as we did in intro(1). Link
    hier(7) which now lists base system configuration files in /etc/. Add a
    section number to HISTORY for clarity.
    
    PR:             248562
    MFC after:      3 days
    Approved by:    mhorne (mentor)
    Reviewed by:    imp, mhorne, Lexi Winter <lexi@le-fay.org>
    Pull Request:   https://github.com/freebsd/freebsd-src/pull/1534
    
    (cherry picked from commit 8d65152cbfc8861f6920846dea6f540c673ab7b6)
---
 share/man/man5/intro.5 | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/share/man/man5/intro.5 b/share/man/man5/intro.5
index 78e147975e81..1c746f37a399 100644
--- a/share/man/man5/intro.5
+++ b/share/man/man5/intro.5
@@ -1,3 +1,6 @@
+.\"
+.\" SPDX-License-Identifier: BSD-3-Clause
+.\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
 .\"
@@ -25,25 +28,28 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd February 16, 1997
+.Dd November 17, 2024
 .Dt INTRO 5
 .Os
 .Sh NAME
 .Nm intro
-.Nd "introduction to file formats"
+.Nd introduction to file formats
 .Sh DESCRIPTION
 This section contains information about file formats.
 .Sh FILES
-.Bl -tag -width /etc/shells -compact
-.It Pa /etc
-location of most system configuration files
+.Bl -tag -width "/usr/local/etc/" -compact
+.It Pa /etc/
+base system software configuration files
+.It Pa /usr/local/etc/
+locally installed software configuration files
 .El
 .Sh SEE ALSO
 .Xr apropos 1 ,
 .Xr intro 1 ,
+.Xr hier 7 ,
 .Xr intro 8
 .Sh HISTORY
 The
-.Nm
-section manual page appeared in
+.Nm Ns Pq 5
+manual page first appeared in
 .Fx 2.2 .