]> git.ipfire.org Git - thirdparty/nftables.git/commitdiff
doc: describe include’s collation order to be that of the C locale
authorChristoph Anton Mitterer <mail@christoph.anton.mitterer.name>
Mon, 20 Oct 2025 23:49:04 +0000 (01:49 +0200)
committerFlorian Westphal <fw@strlen.de>
Wed, 22 Oct 2025 14:27:18 +0000 (16:27 +0200)
Currently, `nft` doesn’t call `setlocale(3)` and thus `glob(3)` uses the `C`
locale.

Document this as it’s possibly relevant to the ordering of included rules.

This also makes the collation order “official” so any future localisation would
need to adhere to that.

Signed-off-by: Christoph Anton Mitterer <mail@christoph.anton.mitterer.name>
Signed-off-by: Florian Westphal <fw@strlen.de>
doc/nft.txt

index 2ca601b16800e4ea93dcf3fe24062ad2f64aefc8..e0a3d173667f73e995a1f92cdc63176c6fa1d1b8 100644 (file)
@@ -165,8 +165,8 @@ Include statements support the usual shell wildcard symbols (*,?,[]). Having no
 matches for an include statement is not an error, if wildcard symbols are used
 in the include statement. This allows having potentially empty include
 directories for statements like **include "/etc/firewall/rules/*"**. The wildcard
-matches are loaded in alphabetical order. Files beginning with dot (.) are not
-matched by include statements.
+matches are loaded in the collation order of the C locale. Files beginning with
+dot (.) are not matched by include statements.
 
 SYMBOLIC VARIABLES
 ~~~~~~~~~~~~~~~~~~