From 740a1bf5033fd765a8aabde75ae40bf14a847524 Mon Sep 17 00:00:00 2001 From: Alex Rousskov Date: Wed, 25 Jun 2025 18:38:40 +0000 Subject: [PATCH] Docs: Describe cf.data.depend purpose (#2102) --- src/cf.data.depend | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/src/cf.data.depend b/src/cf.data.depend index 8a7ecec7ec..913b81e8ac 100644 --- a/src/cf.data.depend +++ b/src/cf.data.depend @@ -4,8 +4,24 @@ ## contributions from numerous individuals and organizations. ## Please see the COPYING and CONTRIBUTORS files for details. ## + +# The statements in this file enforce a partial order of directive definitions +# in cf.data.pre. When adding a new directive TYPE to cf.data.pre, update this +# file to list which directives (if any) must be defined before (i.e. above) +# any directive of that new TYPE. For example, it is customary to define new +# directives that use ACLs after (i.e. below) the "acl" directive definition. # -# type dependencies +# See checkDepend() in cf_gen.cc for code that checks whether cf.data.pre +# directive definition order complies with the partial order declared here. +# +# The order of directive definitions in cf.data.pre correspond to the order of +# directive descriptions in generated cf.data.documented. +# +# This file does not affect Squid configuration parsing code and, hence, does +# not restrict the order of directives in squid.conf. + +# +# Directive TYPE Dependencies (directive names) # access_log acl logformat acl external_acl_type auth_param -- 2.47.2