The man page source: .Ss Includes A line of the form .Bd -literal -offset ident .include "filename"; .Ed .Pp does not render the `.include "filename";` line. The dot as first character on a line has to be quoted.
The .include has to be quoted as \&.include.
The man page also doesn't document the glob(3) expansion performed on the file name even though the examples contain glob patterns triggering the expansion. It would also be useful to document that "foo[.]conf" can be used as try include matching either "foo.conf" or nothing.
Take a look at https://reviews.freebsd.org/D41723 That covers the fix, and also adds a bit about filename globbing (and about relative pathnames).
A commit in branch main references this bug: URL: https://cgit.FreeBSD.org/src/commit/?id=165234d5527440b7755b01554ff7633e33c0d285 commit 165234d5527440b7755b01554ff7633e33c0d285 Author: Jamie Gritton <jamie@FreeBSD.org> AuthorDate: 2023-09-05 20:35:54 +0000 Commit: Jamie Gritton <jamie@FreeBSD.org> CommitDate: 2023-09-05 20:35:54 +0000 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. PR: 273561 Reported by: crest@rlwinm.de Reviewed by: emaste MFC after: 3 days Differential Revision: https://reviews.freebsd.org/D41723 usr.sbin/jail/jail.conf.5 | 19 +++++++++++++++---- 1 file changed, 15 insertions(+), 4 deletions(-)
A commit in branch stable/14 references this bug: URL: https://cgit.FreeBSD.org/src/commit/?id=402d5960cb82eaccc33177aac821dbad1b42db1c commit 402d5960cb82eaccc33177aac821dbad1b42db1c Author: Jamie Gritton <jamie@FreeBSD.org> AuthorDate: 2023-09-05 20:35:54 +0000 Commit: Jamie Gritton <jamie@FreeBSD.org> CommitDate: 2023-09-09 16:57:33 +0000 MFC 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. 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) usr.sbin/jail/jail.conf.5 | 19 +++++++++++++++---- 1 file changed, 15 insertions(+), 4 deletions(-)
A commit in branch releng/14.0 references this bug: 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(-)