git: d737efcc1c25 - releng/14.0 - MFS jail.conf(5): Fix and expand description of ".include".

From: Jamie Gritton <jamie_at_FreeBSD.org>
Date: Thu, 14 Sep 2023 17:16:14 UTC
The branch releng/14.0 has been updated by jamie:

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

commit d737efcc1c2582c793be202ed337de2589ff5301
Author:     Jamie Gritton <jamie@FreeBSD.org>
AuthorDate: 2023-09-05 20:35:54 +0000
Commit:     Jamie Gritton <jamie@FreeBSD.org>
CommitDate: 2023-09-14 17:15:44 +0000

    MFS jail.conf(5): Fix and expand description of ".include".
    
    Escape a period that caused a line not to be includesd.  Also mention
    that glob(3) patterns may be included, and a consequence of that.
    
    Approved by:    re (gjb)
    PR:             273561
    Reported by:    crest@rlwinm.de
    Reviewed by:    emaste
    MFC after:      3 days
    Differential Revision:  https://reviews.freebsd.org/D41723
    
    (cherry picked from commit 165234d5527440b7755b01554ff7633e33c0d285)
    (cherry picked from commit 402d5960cb82eaccc33177aac821dbad1b42db1c)
---
 usr.sbin/jail/jail.conf.5 | 19 +++++++++++++++----
 1 file changed, 15 insertions(+), 4 deletions(-)

diff --git a/usr.sbin/jail/jail.conf.5 b/usr.sbin/jail/jail.conf.5
index 33a66c85e7ea..0b82a972020c 100644
--- a/usr.sbin/jail/jail.conf.5
+++ b/usr.sbin/jail/jail.conf.5
@@ -22,7 +22,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd Jun 3, 2023
+.Dd September 5, 2023
 .Dt JAIL.CONF 5
 .Os
 .Sh NAME
@@ -164,11 +164,22 @@ and
 .Ss Includes
 A line of the form
 .Bd -literal -offset ident
-.include "filename";
+\&.include "filename";
 .Ed
 .Pp
-will include another file in the configuration.  The filename must be
-a literal string, and cannot contain variable expansions.
+will include another file (or files) in the configuration.
+The filename should be either absolute, or relative to the
+configuration file's directory.  It cannot contain variable
+expansions, but may contain
+.Xr glob 3
+patterns.
+.Pp
+The included file must exist, though a filename glob may match zero or
+more files.  This allows inclusion of any/all files in a directory,
+such as
+.Dq /etc/jail.conf.d/*.conf ,
+or conditional inclusion of a single file, such as
+.Dq jail.foo[.]conf .
 .Ss Comments
 The configuration file may contain comments in the common C, C++, and
 shell formats: