From 688e5cf453129067c98667be0e02650f8f26a060 Mon Sep 17 00:00:00 2001
From: Amos Jeffries <squid3@treenet.co.nz>
Date: Sun, 21 Jul 2013 17:23:13 -0600
Subject: [PATCH] Release Notes: document squid.conf quoting changes

---
 doc/release-notes/release-3.4.html | 13 +++++++++++++
 doc/release-notes/release-3.4.sgml | 12 ++++++++++++
 2 files changed, 25 insertions(+)

diff --git a/doc/release-notes/release-3.4.html b/doc/release-notes/release-3.4.html
index 5401699732..565897fcb4 100644
--- a/doc/release-notes/release-3.4.html
+++ b/doc/release-notes/release-3.4.html
@@ -241,6 +241,15 @@ and the external ACL interface does not yet send annotations to the helper.</P>
 <H2><A NAME="s3">3.</A> <A HREF="#toc3">Changes to squid.conf since Squid-3.3</A></H2>
 
 <P>There have been changes to Squid's configuration file since Squid-3.3.</P>
+
+<P>Squid supports reading configuration option parameters from external
+files using the syntax <EM>parameters(\"/path/filename\")</EM>. For example:
+<PRE>
+    acl whitelist dstdomain parameters("/etc/squid/whitelist.txt")
+</PRE>
+</P>
+
+<P>There hasve also been changes to individual directives in the config file.</P>
 <P>This section gives a thorough account of those changes in three categories:</P>
 <P>
 <UL>
@@ -259,6 +268,10 @@ and the external ACL interface does not yet send annotations to the helper.</P>
 
 <P>
 <DL>
+<DT><B>configuration_includes_quoted_values</B><DD>
+<P>Whether Squid supports directive parameters with spaces, quotes, and other
+special characters. Surround such parameters with "double quotes".</P>
+
 <DT><B>note</B><DD>
 <P>Use ACLs to annotate a transaction with customized annotations
 which can be logged in access.log</P>
diff --git a/doc/release-notes/release-3.4.sgml b/doc/release-notes/release-3.4.sgml
index 10f6b2d9d4..d21e6ae2e1 100644
--- a/doc/release-notes/release-3.4.sgml
+++ b/doc/release-notes/release-3.4.sgml
@@ -179,6 +179,14 @@ Most user-facing changes are reflected in squid.conf (see below).
 <p>
 There have been changes to Squid's configuration file since Squid-3.3.
 
+<p>Squid supports reading configuration option parameters from external
+   files using the syntax <em>parameters(\"/path/filename\")</em>. For example:
+<verb>
+    acl whitelist dstdomain parameters("/etc/squid/whitelist.txt")
+</verb>
+
+<p>There hasve also been changes to individual directives in the config file.
+
 This section gives a thorough account of those changes in three categories:
 
 <itemize>
@@ -191,6 +199,10 @@ This section gives a thorough account of those changes in three categories:
 <sect1>New tags<label id="newtags">
 <p>
 <descrip>
+	<tag>configuration_includes_quoted_values</tag>
+	<p>Whether Squid supports directive parameters with spaces, quotes, and other
+	   special characters. Surround such parameters with "double quotes".
+
 	<tag>note</tag>
 	<p>Use ACLs to annotate a transaction with customized annotations
 	   which can be logged in access.log
-- 
2.47.3