git: df4729f3c0 - main - handbook/jails: Add clarification about jail configuration

From: Danilo G. Baio <dbaio_at_FreeBSD.org>
Date: Tue, 27 Feb 2024 00:02:59 UTC
The branch main has been updated by dbaio:

URL: https://cgit.FreeBSD.org/doc/commit/?id=df4729f3c0e9dcc0660c1ae81baeb40b1cb46566

commit df4729f3c0e9dcc0660c1ae81baeb40b1cb46566
Author:     Oliver Epper <oliver.epper@gmail.com>
AuthorDate: 2024-02-07 16:38:11 +0000
Commit:     Danilo G. Baio <dbaio@FreeBSD.org>
CommitDate: 2024-02-26 23:55:24 +0000

    handbook/jails: Add clarification about jail configuration
    
    Reviewed by:    Pau Amma <pauamma@gundo.com> (earlier version), dbaio
    Pull Request:   https://github.com/freebsd/freebsd-doc/pull/336
---
 documentation/content/en/books/handbook/jails/_index.adoc | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/documentation/content/en/books/handbook/jails/_index.adoc b/documentation/content/en/books/handbook/jails/_index.adoc
index 7d928583b2..e6905fc162 100644
--- a/documentation/content/en/books/handbook/jails/_index.adoc
+++ b/documentation/content/en/books/handbook/jails/_index.adoc
@@ -250,11 +250,15 @@ There are two ways to configure jails.
 The first one is to add an entry for each jail to the file [.filename]#/etc/jail.conf#.
 The other option is to create a file for each jail in the directory [.filename]#/etc/jail.conf.d/#.
 
-There is no right or wrong option.
-Each administrator must choose the one that best suits their needs.
-
 In case a host system has few jails, an entry for each jail can be added in the file [.filename]#/etc/jail.conf#.
-If the host system has many jails, it is good idea to have one configuration file for each jail in the [.filename]#/etc/jail.conf.d/# directory.
+If the host system has many jails, it is a good idea to have one configuration file for each jail in the [.filename]#/etc/jail.conf.d/# directory.
+
+The files in [.filename]#/etc/jail.conf.d/# must have `.conf` as their extension and have to be included in [.filename]#/etc/jail.conf#:
+
+[.programmlisting]
+....
+.include "/etc/jail.conf.d/*.conf";
+....
 
 A typical jail entry would look like this: