]> git.ipfire.org Git - thirdparty/squid.git/commitdiff
Release Notes for 3.4
authorAmos Jeffries <squid3@treenet.co.nz>
Mon, 21 Jan 2013 10:57:02 +0000 (03:57 -0700)
committerAmos Jeffries <squid3@treenet.co.nz>
Mon, 21 Jan 2013 10:57:02 +0000 (03:57 -0700)
doc/release-notes/Makefile
doc/release-notes/release-3.4.html [new file with mode: 0644]
doc/release-notes/release-3.4.sgml [new file with mode: 0644]

index fd4a06dda9f89e9c715deefb939c659c1f9ecc0c..e96e81dfced8e71c534315e319988cd61c4223b0 100644 (file)
@@ -1,6 +1,6 @@
-all: release-3.3.html
+all: release-3.4.html
 
-DOC= release-3.3
+DOC= release-3.4
 
 $(DOC).ps: $(DOC).sgml
        linuxdoc -B latex -o ps $(DOC)
diff --git a/doc/release-notes/release-3.4.html b/doc/release-notes/release-3.4.html
new file mode 100644 (file)
index 0000000..2f55445
--- /dev/null
@@ -0,0 +1,373 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
+<HTML>
+<HEAD>
+ <META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.66">
+ <TITLE>Squid 3.4.0.0 release notes</TITLE>
+</HEAD>
+<BODY>
+<H1>Squid 3.4.0.0 release notes</H1>
+
+<H2>Squid Developers</H2>
+<HR>
+<EM>This document contains the release notes for version 3.4 of Squid.
+Squid is a WWW Cache application developed by the National Laboratory
+for Applied Network Research and members of the Web Caching community.</EM>
+<HR>
+<P>
+<H2><A NAME="toc1">1.</A> <A HREF="#s1">Notice</A></H2>
+
+<UL>
+<LI><A NAME="toc1.1">1.1</A> <A HREF="#ss1.1">Known issues</A>
+<LI><A NAME="toc1.2">1.2</A> <A HREF="#ss1.2">Changes since earlier releases of Squid-3.4</A>
+</UL>
+<P>
+<H2><A NAME="toc2">2.</A> <A HREF="#s2">Major new features since Squid-3.3</A></H2>
+
+<UL>
+<LI><A NAME="toc2.1">2.1</A> <A HREF="#ss2.1">Helper protocol extensions</A>
+<LI><A NAME="toc2.2">2.2</A> <A HREF="#ss2.2">SSL Server Certificate Validator</A>
+</UL>
+<P>
+<H2><A NAME="toc3">3.</A> <A HREF="#s3">Changes to squid.conf since Squid-3.3</A></H2>
+
+<UL>
+<LI><A NAME="toc3.1">3.1</A> <A HREF="#ss3.1">New tags</A>
+<LI><A NAME="toc3.2">3.2</A> <A HREF="#ss3.2">Changes to existing tags</A>
+<LI><A NAME="toc3.3">3.3</A> <A HREF="#ss3.3">Removed tags</A>
+</UL>
+<P>
+<H2><A NAME="toc4">4.</A> <A HREF="#s4">Changes to ./configure options since Squid-3.3</A></H2>
+
+<UL>
+<LI><A NAME="toc4.1">4.1</A> <A HREF="#ss4.1">New options</A>
+<LI><A NAME="toc4.2">4.2</A> <A HREF="#ss4.2">Changes to existing options</A>
+<LI><A NAME="toc4.3">4.3</A> <A HREF="#ss4.3">Removed options</A>
+</UL>
+<P>
+<H2><A NAME="toc5">5.</A> <A HREF="#s5">Regressions since Squid-2.7</A></H2>
+
+<UL>
+<LI><A NAME="toc5.1">5.1</A> <A HREF="#ss5.1">Missing squid.conf options available in Squid-2.7</A>
+</UL>
+
+<HR>
+<H2><A NAME="s1">1.</A> <A HREF="#toc1">Notice</A></H2>
+
+<P>The Squid Team are pleased to announce the release of Squid-3.4.0.0 for testing.</P>
+<P>This new release is available for download from 
+<A HREF="http://www.squid-cache.org/Versions/v3/3.HEAD/">http://www.squid-cache.org/Versions/v3/3.HEAD/</A> or the 
+<A HREF="http://www.squid-cache.org/Mirrors/http-mirrors.html">mirrors</A>.</P>
+<P>While this release is not deemed ready for production use, we believe it is ready for wider testing by the community.</P>
+<P>We welcome feedback and bug reports. If you find a bug, please see 
+<A HREF="http://wiki.squid-cache.org/SquidFaq/TroubleShooting#head-7067fc0034ce967e67911becaabb8c95a34d576d">http://wiki.squid-cache.org/SquidFaq/TroubleShooting#head-7067fc0034ce967e67911becaabb8c95a34d576d</A> for how to submit a report with a stack trace.</P>
+
+<H2><A NAME="ss1.1">1.1</A> <A HREF="#toc1.1">Known issues</A>
+</H2>
+
+<P>Although this release is deemed good enough for use in many setups, please note the existence of 
+<A HREF="http://www.squid-cache.org/bugs/buglist.cgi?query_format=advanced&amp;short_desc_type=allwordssubstr&amp;short_desc=&amp;target_milestone=3.4&amp;long_desc_type=allwordssubstr&amp;long_desc=&amp;bug_file_loc_type=allwordssubstr&amp;bug_file_loc=&amp;status_whiteboard_type=allwordssubstr&amp;status_whiteboard=&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;emailtype1=substring&amp;email1=&amp;emailtype2=substring&amp;email2=&amp;bugidtype=include&amp;bug_id=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;cmdtype=doit&amp;order=bugs.bug_severity&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=">open bugs against Squid-3.4</A>.</P>
+
+<H2><A NAME="ss1.2">1.2</A> <A HREF="#toc1.2">Changes since earlier releases of Squid-3.4</A>
+</H2>
+
+<P>The 3.4 change history can be 
+<A HREF="http://www.squid-cache.org/Versions/v3/3.HEAD/changesets/">viewed here</A>.</P>
+
+<H2><A NAME="s2">2.</A> <A HREF="#toc2">Major new features since Squid-3.3</A></H2>
+
+<P>Squid 3.4 represents a new feature release above 3.3.</P>
+
+<P>The most important of these new features are:
+<UL>
+<LI>Helper protocol extensions</LI>
+<LI>SSL Server Certificate Validator</LI>
+</UL>
+</P>
+<P>Most user-facing changes are reflected in squid.conf (see below).</P>
+
+
+<H2><A NAME="ss2.1">2.1</A> <A HREF="#toc2.1">Helper protocol extensions</A>
+</H2>
+
+<P>Details at 
+<A HREF="http://wiki.squid-cache.org/Features/AddonHelpers">http://wiki.squid-cache.org/Features/AddonHelpers</A>.</P>
+
+<P>The Squid helper protocol used to communicate with authenticators,
+URL-rewriters, Redirectors, and External ACL helpers has been updated
+and extended.</P>
+
+<P><EM>BH</EM> status code is now accepted from all helpers to report
+internal error events separate from <EM>ERR</EM> rejection code.
+Permitting Squid to perform recovery operations specific to
+helper failure instead of a blanket client rejection.</P>
+
+<P>Arbitrary key-value pairs can be returned from any helper.
+Allowing future helpers to be forward- and backward- compatible
+with this and future version of Squid.</P>
+
+
+<H2><A NAME="ss2.2">2.2</A> <A HREF="#toc2.2">SSL Server Certificate Validator</A>
+</H2>
+
+<P>Details at 
+<A HREF="http://wiki.squid-cache.org/Features/SslServerCertValidator">http://wiki.squid-cache.org/Features/SslServerCertValidator</A>.</P>
+
+<P>The helper consulted after the internal OpenSSL validation, regardless of the
+validation results. The helper will receive:</P>
+<P>
+<UL>
+<LI>the origin server certificate (chain),</LI>
+<LI>the intended domain name, and</LI>
+<LI>a list of OpenSSL validation errors (if any).</LI>
+</UL>
+</P>
+
+<P>If the helper decides to honor an OpenSSL error or report another validation 
+error(s), the helper will return:</P>
+<P>
+<UL>
+<LI>A list of certificates.</LI>
+<LI>A list of items consists the the validation error name (see <EM>%err_name</EM>
+error page macro and <EM>%err_details</EM> code for <EM>logformat</EM>), error reason
+(<EM>%ssl_lib_error macro</EM>), and the offending certificate.</LI>
+</UL>
+</P>
+
+<P>The returned information mimics what the internal OpenSSL-based validation code
+collects now. Returned errors, if any, are fed to <EM>sslproxy_cert_error</EM>,
+triggering the existing SSL error processing code.</P>
+
+<P>The helper invocation controlled by the <EM>sslcrtvalidator_program</EM> and
+<EM>sslcrtvalidator_children</EM> configurations options which are similar to the
+<EM>ssl_crtd</EM> related options. </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>This section gives a thorough account of those changes in three categories:</P>
+<P>
+<UL>
+<LI>
+<A HREF="#newtags">New tags</A></LI>
+<LI>
+<A HREF="#modifiedtags">Changes to existing tags</A></LI>
+<LI>
+<A HREF="#removedtags">Removed tags</A></LI>
+</UL>
+</P>
+
+
+<H2><A NAME="newtags"></A> <A NAME="ss3.1">3.1</A> <A HREF="#toc3.1">New tags</A>
+</H2>
+
+<P>
+<DL>
+<DT><B>note</B><DD>
+<P>Use ACLs to annotate a transaction with customized annotations
+which can be logged in access.log</P>
+
+<DT><B>sslcrtvalidator_children</B><DD>
+<P>Specifies the settings for how many SSL server certificate
+validator helpers are run and when they are started.</P>
+
+<DT><B>sslcrtvalidator_program</B><DD>
+<P>Specifies the location of a SSL server certificate validator helper.</P>
+
+</DL>
+</P>
+
+<H2><A NAME="modifiedtags"></A> <A NAME="ss3.2">3.2</A> <A HREF="#toc3.2">Changes to existing tags</A>
+</H2>
+
+<P>
+<DL>
+<DT><B>acl</B><DD>
+<P>New test type <EM>server_cert_fingerprint</EM> to match against 
+server SSL certificate fingerprint.</P>
+
+<DT><B>auth_param</B><DD>
+<P>New result code <EM>BH</EM> to signal helper internal errors
+available in all authentication schemes.</P>
+<P>New key <EM>message=</EM> for error message details in all authentication schemes.</P>
+<P>New result code <EM>OK</EM> and key <EM>ha1=</EM> in Digest authentication.</P>
+<P>New result codes <EM>OK</EM>, <EM>ERR</EM> replace result codes <EM>AF</EM>,
+and <EM>NA</EM> in NTLM and Negotiate authentication.</P>
+<P>New key <EM>token=</EM> for NTLM and Negotiate authentication <EM>OK</EM> responses.</P>
+<P>Details at 
+<A HREF="http://wiki.squid-cache.org/Features/AddonHelpers">http://wiki.squid-cache.org/Features/AddonHelpers</A>.</P>
+
+<DT><B>external_acl_type</B><DD>
+<P>Deprecated <EM>protocol=3.0</EM> option. No longer necessary.</P>
+<P>New result code <EM>BH</EM> to signal helper internal errors</P>
+<P>Details at 
+<A HREF="http://wiki.squid-cache.org/Features/AddonHelpers">http://wiki.squid-cache.org/Features/AddonHelpers</A>.</P>
+
+<DT><B>logformat</B><DD>
+<P>New format code <EM>%note</EM> to log a transaction annotation linked to the
+transaction by ICAP, eCAP, a helper, or the <EM>note</EM> squid.conf directive.</P>
+
+<DT><B>unlinkd_program</B><DD>
+<P>New helper response format utilizing result codes <EM>OK</EM> and <EM>BH</EM>,
+to signal helper lookup results. Also, key-value response values to return
+multiple values to Squid.</P>
+<P>Details at 
+<A HREF="http://wiki.squid-cache.org/Features/AddonHelpers">http://wiki.squid-cache.org/Features/AddonHelpers</A>.</P>
+
+<DT><B>url_rewrite_program</B><DD>
+<P>New helper response format utilizing result codes <EM>OK</EM>, <EM>ERR</EM>,
+and <EM>BH</EM> to signal helper lookup results. Also, key-value response
+values to return multiple values to Squid.</P>
+<P>Details at 
+<A HREF="http://wiki.squid-cache.org/Features/AddonHelpers">http://wiki.squid-cache.org/Features/AddonHelpers</A>.</P>
+
+</DL>
+</P>
+
+<H2><A NAME="removedtags"></A> <A NAME="ss3.3">3.3</A> <A HREF="#toc3.3">Removed tags</A>
+</H2>
+
+<P>
+<DL>
+<P><EM>There are no removed squid.conf tags in Squid-3.4.</EM></P>
+
+</DL>
+</P>
+
+
+<H2><A NAME="s4">4.</A> <A HREF="#toc4">Changes to ./configure options since Squid-3.3</A></H2>
+
+<P>There have been some changes to Squid's build configuration since Squid-3.3.</P>
+<P>This section gives an account of those changes in three categories:</P>
+<P>
+<UL>
+<LI>
+<A HREF="#newoptions">New options</A></LI>
+<LI>
+<A HREF="#modifiedoptions">Changes to existing options</A></LI>
+<LI>
+<A HREF="#removedoptions">Removed options</A></LI>
+</UL>
+</P>
+
+
+<H2><A NAME="newoptions"></A> <A NAME="ss4.1">4.1</A> <A HREF="#toc4.1">New options</A>
+</H2>
+
+<P>
+<DL>
+<P><EM>There are no new ./configure options in Squid-3.4.</EM></P>
+
+</DL>
+</P>
+
+<H2><A NAME="modifiedoptions"></A> <A NAME="ss4.2">4.2</A> <A HREF="#toc4.2">Changes to existing options</A>
+</H2>
+
+<P>
+<DL>
+<P><EM>There are no changed ./configure options in Squid-3.4.</EM></P>
+
+</DL>
+</P>
+<H2><A NAME="removedoptions"></A> <A NAME="ss4.3">4.3</A> <A HREF="#toc4.3">Removed options</A>
+</H2>
+
+<P>
+<DL>
+<P><EM>There are no removed ./configure options in Squid-3.4.</EM></P>
+
+</DL>
+</P>
+
+
+<H2><A NAME="s5">5.</A> <A HREF="#toc5">Regressions since Squid-2.7</A></H2>
+
+<P>Some squid.conf and ./configure options which were available in Squid-2.7 are not yet available in Squid-3.3</P>
+
+<P>If you need something to do then porting one of these from Squid-2 to Squid-3 is most welcome.</P>
+
+<H2><A NAME="ss5.1">5.1</A> <A HREF="#toc5.1">Missing squid.conf options available in Squid-2.7</A>
+</H2>
+
+<P>
+<DL>
+<DT><B>broken_vary_encoding</B><DD>
+<P>Not yet ported from 2.6</P>
+
+<DT><B>cache_dir</B><DD>
+<P><EM>COSS</EM> storage type is lacking stability fixes from 2.6</P>
+<P>COSS <EM>overwrite-percent=</EM> option not yet ported from 2.6</P>
+<P>COSS <EM>max-stripe-waste=</EM> option not yet ported from 2.6</P>
+<P>COSS <EM>membufs=</EM> option not yet ported from 2.6</P>
+<P>COSS <EM>maxfullbufs=</EM> option not yet ported from 2.6</P>
+
+<DT><B>cache_peer</B><DD>
+<P><EM>idle=</EM> not yet ported from 2.7</P>
+<P><EM>monitorinterval=</EM> not yet ported from 2.6</P>
+<P><EM>monitorsize=</EM> not yet ported from 2.6</P>
+<P><EM>monitortimeout=</EM> not yet ported from 2.6</P>
+<P><EM>monitorurl=</EM> not yet ported from 2.6</P>
+
+<DT><B>cache_vary</B><DD>
+<P>Not yet ported from 2.6</P>
+
+<DT><B>collapsed_forwarding</B><DD>
+<P>Not yet ported from 2.6</P>
+
+<DT><B>error_map</B><DD>
+<P>Not yet ported from 2.6</P>
+
+<DT><B>external_acl_type</B><DD>
+<P><EM>%ACL</EM> format tag not yet ported from 2.6</P>
+<P><EM>%DATA</EM> format tag not yet ported from 2.6</P>
+
+<DT><B>external_refresh_check</B><DD>
+<P>Not yet ported from 2.7</P>
+
+<DT><B>http_port</B><DD>
+<P><EM>act-as-origin</EM> not yet ported from 2.7</P>
+
+<DT><B>ignore_ims_on_miss</B><DD>
+<P>Not yet ported from 2.7</P>
+
+<DT><B>location_rewrite_access</B><DD>
+<P>Not yet ported from 2.6</P>
+
+<DT><B>location_rewrite_children</B><DD>
+<P>Not yet ported from 2.6</P>
+
+<DT><B>location_rewrite_concurrency</B><DD>
+<P>Not yet ported from 2.6</P>
+
+<DT><B>location_rewrite_program</B><DD>
+<P>Not yet ported from 2.6</P>
+
+<DT><B>refresh_pattern</B><DD>
+<P><EM>stale-while-revalidate=</EM> not yet ported from 2.7</P>
+<P><EM>ignore-stale-while-revalidate=</EM> not yet ported from 2.7</P>
+<P><EM>negative-ttl=</EM> not yet ported from 2.7</P>
+
+<DT><B>refresh_stale_hit</B><DD>
+<P>Not yet ported from 2.7</P>
+
+<DT><B>storeurl_access</B><DD>
+<P>Not yet ported from 2.7</P>
+
+<DT><B>storeurl_rewrite_children</B><DD>
+<P>Not yet ported from 2.7</P>
+
+<DT><B>storeurl_rewrite_concurrency</B><DD>
+<P>Not yet ported from 2.7</P>
+
+<DT><B>storeurl_rewrite_program</B><DD>
+<P>Not yet ported from 2.7</P>
+
+<DT><B>update_headers</B><DD>
+<P>Not yet ported from 2.7</P>
+
+</DL>
+</P>
+
+</BODY>
+</HTML>
diff --git a/doc/release-notes/release-3.4.sgml b/doc/release-notes/release-3.4.sgml
new file mode 100644 (file)
index 0000000..357916f
--- /dev/null
@@ -0,0 +1,290 @@
+<!doctype linuxdoc system>
+<article>
+<title>Squid 3.4.0.0 release notes</title>
+<author>Squid Developers</author>
+
+<abstract>
+This document contains the release notes for version 3.4 of Squid.
+Squid is a WWW Cache application developed by the National Laboratory
+for Applied Network Research and members of the Web Caching community.
+</abstract>
+
+<toc>
+
+<sect>Notice
+<p>
+The Squid Team are pleased to announce the release of Squid-3.4.0.0 for testing.
+
+This new release is available for download from <url url="http://www.squid-cache.org/Versions/v3/3.HEAD/"> or the <url url="http://www.squid-cache.org/Mirrors/http-mirrors.html" name="mirrors">.
+
+While this release is not deemed ready for production use, we believe it is ready for wider testing by the community.
+
+We welcome feedback and bug reports. If you find a bug, please see <url url="http://wiki.squid-cache.org/SquidFaq/TroubleShooting#head-7067fc0034ce967e67911becaabb8c95a34d576d"> for how to submit a report with a stack trace.
+
+<sect1>Known issues
+<p>
+Although this release is deemed good enough for use in many setups, please note the existence of <url url="http://www.squid-cache.org/bugs/buglist.cgi?query_format=advanced&amp;short_desc_type=allwordssubstr&amp;short_desc=&amp;target_milestone=3.4&amp;long_desc_type=allwordssubstr&amp;long_desc=&amp;bug_file_loc_type=allwordssubstr&amp;bug_file_loc=&amp;status_whiteboard_type=allwordssubstr&amp;status_whiteboard=&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;emailtype1=substring&amp;email1=&amp;emailtype2=substring&amp;email2=&amp;bugidtype=include&amp;bug_id=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;cmdtype=doit&amp;order=bugs.bug_severity&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=" name="open bugs against Squid-3.4">.
+
+<sect1>Changes since earlier releases of Squid-3.4
+<p>
+The 3.4 change history can be <url url="http://www.squid-cache.org/Versions/v3/3.HEAD/changesets/" name="viewed here">.
+
+<sect>Major new features since Squid-3.3
+<p>Squid 3.4 represents a new feature release above 3.3.
+
+<p>The most important of these new features are:
+<itemize>
+       <item>Helper protocol extensions
+       <item>SSL Server Certificate Validator
+</itemize>
+
+Most user-facing changes are reflected in squid.conf (see below).
+
+
+<sect1>Helper protocol extensions
+<p>Details at <url url="http://wiki.squid-cache.org/Features/AddonHelpers">.
+
+<p>The Squid helper protocol used to communicate with authenticators,
+   URL-rewriters, Redirectors, and External ACL helpers has been updated
+   and extended.
+
+<p><em>BH</em> status code is now accepted from all helpers to report
+   internal error events separate from <em>ERR</em> rejection code.
+   Permitting Squid to perform recovery operations specific to
+   helper failure instead of a blanket client rejection.
+
+<p>Arbitrary key-value pairs can be returned from any helper.
+   Allowing future helpers to be forward- and backward- compatible
+   with this and future version of Squid.
+
+
+<sect1>SSL Server Certificate Validator
+<p>Details at <url url="http://wiki.squid-cache.org/Features/SslServerCertValidator">.
+
+<p>The helper consulted after the internal OpenSSL validation, regardless of the
+   validation results. The helper will receive:
+
+<itemize>
+       <item>the origin server certificate (chain),
+       <item>the intended domain name, and
+       <item>a list of OpenSSL validation errors (if any).
+</itemize>
+
+<p>If the helper decides to honor an OpenSSL error or report another validation 
+   error(s), the helper will return:
+
+<itemize>
+       <item>A list of certificates.
+       <item>A list of items consists the the validation error name (see <em>%err_name</em>
+        error page macro and <em>%err_details</em> code for <em>logformat</em>), error reason
+        (<em>%ssl_lib_error macro</em>), and the offending certificate.
+</itemize>
+
+<p>The returned information mimics what the internal OpenSSL-based validation code
+   collects now. Returned errors, if any, are fed to <em>sslproxy_cert_error</em>,
+   triggering the existing SSL error processing code.
+
+<p>The helper invocation controlled by the <em>sslcrtvalidator_program</em> and
+   <em>sslcrtvalidator_children</em> configurations options which are similar to the
+   <em>ssl_crtd</em> related options. 
+
+
+<sect>Changes to squid.conf since Squid-3.3
+<p>
+There have been changes to Squid's configuration file since Squid-3.3.
+
+This section gives a thorough account of those changes in three categories:
+
+<itemize>
+       <item><ref id="newtags" name="New tags">
+       <item><ref id="modifiedtags" name="Changes to existing tags">
+       <item><ref id="removedtags" name="Removed tags">
+</itemize>
+<p>
+
+<sect1>New tags<label id="newtags">
+<p>
+<descrip>
+       <tag>note</tag>
+       <p>Use ACLs to annotate a transaction with customized annotations
+          which can be logged in access.log
+
+       <tag>sslcrtvalidator_children</tag>
+       <p>Specifies the settings for how many SSL server certificate
+          validator helpers are run and when they are started.
+
+       <tag>sslcrtvalidator_program</tag>
+       <p>Specifies the location of a SSL server certificate validator helper.
+
+</descrip>
+
+<sect1>Changes to existing tags<label id="modifiedtags">
+<p>
+<descrip>
+       <tag>acl</tag>
+       <p>New test type <em>server_cert_fingerprint</em> to match against 
+          server SSL certificate fingerprint.
+
+       <tag>auth_param</tag>
+       <p>New result code <em>BH</em> to signal helper internal errors
+          available in all authentication schemes.
+       <p>New key <em>message=</em> for error message details in all authentication schemes.
+       <p>New result code <em>OK</em> and key <em>ha1=</em> in Digest authentication.
+       <p>New result codes <em>OK</em>, <em>ERR</em> replace result codes <em>AF</em>,
+          and <em>NA</em> in NTLM and Negotiate authentication.
+       <p>New key <em>token=</em> for NTLM and Negotiate authentication <em>OK</em> responses.
+       <p>Details at <url url="http://wiki.squid-cache.org/Features/AddonHelpers">.
+
+       <tag>external_acl_type</tag>
+       <p>Deprecated <em>protocol=3.0</em> option. No longer necessary.
+       <p>New result code <em>BH</em> to signal helper internal errors
+       <p>Details at <url url="http://wiki.squid-cache.org/Features/AddonHelpers">.
+
+       <tag>logformat</tag>
+       <p>New format code <em>%note</em> to log a transaction annotation linked to the
+          transaction by ICAP, eCAP, a helper, or the <em>note</em> squid.conf directive.
+
+       <tag>unlinkd_program</tag>
+       <p>New helper response format utilizing result codes <em>OK</em> and <em>BH</em>,
+          to signal helper lookup results. Also, key-value response values to return
+          multiple values to Squid.
+       <p>Details at <url url="http://wiki.squid-cache.org/Features/AddonHelpers">.
+
+       <tag>url_rewrite_program</tag>
+       <p>New helper response format utilizing result codes <em>OK</em>, <em>ERR</em>,
+          and <em>BH</em> to signal helper lookup results. Also, key-value response
+          values to return multiple values to Squid.
+       <p>Details at <url url="http://wiki.squid-cache.org/Features/AddonHelpers">.
+
+</descrip>
+
+<sect1>Removed tags<label id="removedtags">
+<p>
+<descrip>
+       <p><em>There are no removed squid.conf tags in Squid-3.4.</em>
+
+</descrip>
+
+
+<sect>Changes to ./configure options since Squid-3.3
+<p>
+There have been some changes to Squid's build configuration since Squid-3.3.
+
+This section gives an account of those changes in three categories:
+
+<itemize>
+       <item><ref id="newoptions" name="New options">
+       <item><ref id="modifiedoptions" name="Changes to existing options">
+       <item><ref id="removedoptions" name="Removed options">
+</itemize>
+
+
+<sect1>New options<label id="newoptions">
+<p>
+<descrip>
+       <p><em>There are no new ./configure options in Squid-3.4.</em>
+
+</descrip>
+
+<sect1>Changes to existing options<label id="modifiedoptions">
+<p>
+<descrip>
+       <p><em>There are no changed ./configure options in Squid-3.4.</em>
+
+</descrip>
+</p>
+
+<sect1>Removed options<label id="removedoptions">
+<p>
+<descrip>
+       <p><em>There are no removed ./configure options in Squid-3.4.</em>
+
+</descrip>
+
+
+<sect>Regressions since Squid-2.7
+
+<p>Some squid.conf and ./configure options which were available in Squid-2.7 are not yet available in Squid-3.3
+
+<p>If you need something to do then porting one of these from Squid-2 to Squid-3 is most welcome.
+
+<sect1>Missing squid.conf options available in Squid-2.7
+<p>
+<descrip>
+       <tag>broken_vary_encoding</tag>
+       <p>Not yet ported from 2.6
+
+       <tag>cache_dir</tag>
+       <p><em>COSS</em> storage type is lacking stability fixes from 2.6
+       <p>COSS <em>overwrite-percent=</em> option not yet ported from 2.6
+       <p>COSS <em>max-stripe-waste=</em> option not yet ported from 2.6
+       <p>COSS <em>membufs=</em> option not yet ported from 2.6
+       <p>COSS <em>maxfullbufs=</em> option not yet ported from 2.6
+
+       <tag>cache_peer</tag>
+       <p><em>idle=</em> not yet ported from 2.7
+       <p><em>monitorinterval=</em> not yet ported from 2.6
+       <p><em>monitorsize=</em> not yet ported from 2.6
+       <p><em>monitortimeout=</em> not yet ported from 2.6
+       <p><em>monitorurl=</em> not yet ported from 2.6
+
+       <tag>cache_vary</tag>
+       <p>Not yet ported from 2.6
+
+       <tag>collapsed_forwarding</tag>
+       <p>Not yet ported from 2.6
+
+       <tag>error_map</tag>
+       <p>Not yet ported from 2.6
+
+       <tag>external_acl_type</tag>
+       <p><em>%ACL</em> format tag not yet ported from 2.6
+       <p><em>%DATA</em> format tag not yet ported from 2.6
+
+       <tag>external_refresh_check</tag>
+       <p>Not yet ported from 2.7
+
+       <tag>http_port</tag>
+       <p><em>act-as-origin</em> not yet ported from 2.7
+
+       <tag>ignore_ims_on_miss</tag>
+       <p>Not yet ported from 2.7
+
+       <tag>location_rewrite_access</tag>
+       <p>Not yet ported from 2.6
+
+       <tag>location_rewrite_children</tag>
+       <p>Not yet ported from 2.6
+
+       <tag>location_rewrite_concurrency</tag>
+       <p>Not yet ported from 2.6
+
+       <tag>location_rewrite_program</tag>
+       <p>Not yet ported from 2.6
+
+       <tag>refresh_pattern</tag>
+       <p><em>stale-while-revalidate=</em> not yet ported from 2.7
+       <p><em>ignore-stale-while-revalidate=</em> not yet ported from 2.7
+       <p><em>negative-ttl=</em> not yet ported from 2.7
+
+       <tag>refresh_stale_hit</tag>
+       <p>Not yet ported from 2.7
+
+       <tag>storeurl_access</tag>
+       <p>Not yet ported from 2.7
+
+       <tag>storeurl_rewrite_children</tag>
+       <p>Not yet ported from 2.7
+
+       <tag>storeurl_rewrite_concurrency</tag>
+       <p>Not yet ported from 2.7
+
+       <tag>storeurl_rewrite_program</tag>
+       <p>Not yet ported from 2.7
+       
+       <tag>update_headers</tag>
+       <p>Not yet ported from 2.7
+
+</descrip>
+
+</article>