]> git.ipfire.org Git - thirdparty/squid.git/commitdiff
Update Release Notes Sections
authorAmos Jeffries <squid3@treenet.co.nz>
Fri, 24 Oct 2008 07:24:33 +0000 (20:24 +1300)
committerAmos Jeffries <squid3@treenet.co.nz>
Fri, 24 Oct 2008 07:24:33 +0000 (20:24 +1300)
doc/release-notes/release-3.1.html
doc/release-notes/release-3.1.sgml

index 1b441cd4bd30bb96ec96d74d9f89b689c6448e46..2e3329f19b2d6220d693b2f8bcc2d74dbbb6b93f 100644 (file)
@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
 <HTML>
 <HEAD>
- <META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21">
+ <META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.50">
  <TITLE>Squid 3.1.0.1 release notes</TITLE>
 </HEAD>
 <BODY>
@@ -34,10 +34,7 @@ While this release is not deemed ready for production use, we believe it is read
 <P>The 3.1 change history can be 
 <A HREF="http://www.squid-cache.org/Versions/v3/3.1/changesets/">viewed here</A>.</P>
 
-<H2><A NAME="s4">4. Changes since Squid-3.0</A></H2>
-
-<H2><A NAME="ss4.1">4.1 Major new features</A>
-</H2>
+<H2><A NAME="s4">4. Major new features sinceSsquid-3.0</A></H2>
 
 <P>Squid 3.1 represents a new feature release above 3.0.</P>
 <P>The most important of these new features are:</P>
@@ -55,7 +52,8 @@ While this release is not deemed ready for production use, we believe it is read
 </P>
 <P>Most user-facing changes are reflected in squid.conf (see below).</P>
 
-<H3>New Version Numbering System</H3>
+<H2><A NAME="ss4.1">4.1 New Version Numbering System</A>
+</H2>
 
 <P>Begining with 3.1 the Squid Developers are trialling a new release numbering system.</P>
 
@@ -99,7 +97,8 @@ Vastly reducing the number of bugs in all code.
 </P>
 
 
-<H3>Minimal squid.conf improvements</H3>
+<H2><A NAME="ss4.2">4.2 Minimal squid.conf improvements</A>
+</H2>
 
 <P>squid.conf has undergone a facelift.</P>
 
@@ -118,11 +117,11 @@ contains a fully documented set of options previously cluttering up squid.conf i
 config options provided on a clean install.</P>
 
 
-<H3>Internet Protocol version 6 (IPv6)</H3>
-
-<P>Squid 3.1 supports IPv6. To enable IPv6 support, use the ./configure --enable-ipv6 option</P>
+<H2><A NAME="ss4.3">4.3 Internet Protocol version 6 (IPv6)</A>
+</H2>
 
-<P>Details in 
+<P>Squid 3.1 supports IPv6.
+Details in 
 <A HREF="http://wiki.squid-cache.org/Features/IPv6">The Squid wiki</A></P>
 
 <H3>New Features for IPv6</H3>
@@ -177,14 +176,15 @@ A new one will be needed for IPv6 traffic between the helper and server.</P>
 with the RADIUS server. A new helper will be needed for IPv6 RADIUS protocol.</P>
 
 
-<H3>Error Page Localization</H3>
+<H2><A NAME="ss4.4">4.4 Error Page Localization</A>
+</H2>
 
 <P>Details in 
 <A HREF="http://wiki.squid-cache.org/Translations">The Squid wiki</A></P>
 
 <P>The error pages presented by squid may now be localized per-request to match the visitors local preferred language.</P>
 
-<P>Squid needs to be build with the --enable-auto-locale option. And the error_directory option in squid.conf needs to be removed.</P>
+<P>The error_directory option in squid.conf needs to be removed.</P>
 
 <P>For best coverage of languages, using the latest language pack of error files is recommended.
 Updates can be downloaded from 
@@ -194,7 +194,8 @@ Updates can be downloaded from
 Contribution of new languages is encouraged.</P>
 
 
-<H3>Connection Pinning (for NTLM Auth Passthrough)</H3>
+<H2><A NAME="ss4.5">4.5 Connection Pinning (for NTLM Auth Passthrough)</A>
+</H2>
 
 <P>Details in 
 <A HREF="http://wiki.squid-cache.org/Features/ConnPinn">The Squid wiki</A></P>
@@ -205,7 +206,8 @@ Contribution of new languages is encouraged.</P>
 Microsoft NTLM Authentication instead of HTTP standard authentication through a web proxy.</P>
 
 
-<H3>Quality of Service (QoS) Flow support</H3>
+<H2><A NAME="ss4.6">4.6 Quality of Service (QoS) Flow support</A>
+</H2>
 
 <P>Details in 
 <A HREF="http://wiki.squid-cache.org/Features/QualityOfService">The Squid wiki</A></P>
@@ -243,7 +245,8 @@ on the client connection. Requires a kernel patch.</LI>
 </P>
 
 
-<H3>SSL Bump (for HTTPS Filtering and Adaptation)</H3>
+<H2><A NAME="ss4.7">4.7 SSL Bump (for HTTPS Filtering and Adaptation)</A>
+</H2>
 
 <P>Details in 
 <A HREF="http://wiki.squid-cache.org/Features/SslBump">The Squid wiki</A></P>
@@ -253,7 +256,8 @@ using configurable client- and server-side certificates.
 While decrypted, the traffic can be inspected using ICAP.</P>
 
 
-<H3>eCAP Adaptation Module support</H3>
+<H2><A NAME="ss4.8">4.8 eCAP Adaptation Module support</A>
+</H2>
 
 <P>Details in 
 <A HREF="http://wiki.squid-cache.org/Features/eCAP">The Squid wiki</A></P>
@@ -477,8 +481,7 @@ ScriptAlias /squid/cgi-bin/ "c:/squid/libexec/"
 </P>
 
 
-<H2><A NAME="ss5.1">5.1 Changes to squid.conf</A>
-</H2>
+<H2><A NAME="s6">6. Changes to squid.conf since Squid-3.0</A></H2>
 
 <P>There have been changes to Squid's configuration file since Squid-3.0.</P>
 <P>This section gives a thorough account of those changes in three categories:</P>
@@ -496,7 +499,8 @@ ScriptAlias /squid/cgi-bin/ "c:/squid/libexec/"
 
 
 
-<H3><A NAME="newtags"></A> New tags</H3>
+<H2><A NAME="newtags"></A> <A NAME="ss6.1">6.1 New tags</A>
+</H2>
 
 <P>
 <DL>
@@ -881,7 +885,8 @@ DEFAULT: None bypassed.
 </DL>
 </P>
 
-<H3><A NAME="modifiedtags"></A> Changes to existing tags</H3>
+<H2><A NAME="modifiedtags"></A> <A NAME="ss6.2">6.2 Changes to existing tags</A>
+</H2>
 
 <P>
 <DL>
@@ -1142,7 +1147,8 @@ refresh_pattern .              0       20%     4320
 </P>
 
 
-<H3><A NAME="removedtags"></A> Removed tags</H3>
+<H2><A NAME="removedtags"></A> <A NAME="ss6.3">6.3 Removed tags</A>
+</H2>
 
 <P>
 <DL>
@@ -1163,8 +1169,7 @@ refresh_pattern .              0       20%     4320
 </P>
 
 
-<H2><A NAME="ss5.2">5.2 Changes to ./configure Options</A>
-</H2>
+<H2><A NAME="s7">7. Changes to ./configure Options since Squid-3.0</A></H2>
 
 <P>There have been some changes to Squid's build configuration since Squid-3.0.</P>
 <P>This section gives an account of those changes in three categories:</P>
@@ -1175,34 +1180,29 @@ refresh_pattern .              0       20%     4320
 <LI>
 <A HREF="#modifiedoptions">Changes to existing options</A></LI>
 <LI>
-<A HREF="#notportedoptions">Not yet available options</A></LI>
-<LI>
 <A HREF="#removedoptions">Removed options</A></LI>
 </UL>
 </P>
 
 
 
-<H3><A NAME="newoptions"></A> New options</H3>
+<H2><A NAME="newoptions"></A> <A NAME="ss7.1">7.1 New options</A>
+</H2>
 
 <P>
 <DL>
 <DT><B>--enable-ipv6</B><DD>
-<P>Buildwith IPv6 support. The default is to build without.</P>
+<P>Buildwith IPv6 support. The default is to build with IPv6.</P>
 
 <DT><B>--with-localhost-ipv6</B><DD>
 <P>Build support for squid to map all 127.0.0.1 traffic onto ::1.
 The default is to build with 127.0.0.1 and ::1 being considered seperate IP.
-see the IPv6 details above for a better description. </P>
+see the IPv6 details above for a better description.</P>
 
 <DT><B>--with-ipv6-split-stack</B><DD>
 <P>Enable special additions for IPv6 support in Windows XP.
 see the IPv6 details above for a better description.</P>
 
-<DT><B>--with-ipv4-mapped</B><DD>
-<P>Enable special additions for IPv6 support in Windows Vista.
-see the IPv6 details above for a better description.</P>
-
 <DT><B>--with-dns-cname</B><DD>
 <P>Enable CNAME recursion within the Internal DNS resolver stub squid uses.
 This has no effect on the external DNS helper.
@@ -1217,7 +1217,8 @@ but please report the bugs anyway.</P>
 
 </DL>
 </P>
-<H3><A NAME="modifiedoptions"></A> Changes to existing options</H3>
+<H2><A NAME="modifiedoptions"></A> <A NAME="ss7.2">7.2 Changes to existing options</A>
+</H2>
 
 <P>
 <DL>
@@ -1233,10 +1234,44 @@ Older REDIRECT and DNAT targets work as before on HTTP ports marked 'intercept'.
 
 </DL>
 </P>
-<H3><A NAME="notportedoptions"></A> Not yet available options</H3>
+<H2><A NAME="removedoptions"></A> <A NAME="ss7.3">7.3 Removed options</A>
+</H2>
+
+<P>The following configure options have been removed.</P>
+<P>
+<DL>
+<DT><B>--enable-linux-tproxy</B><DD>
+<P>Replaced by --enable-linux-tproxy2 to make way for differences in TPROXY v2 and v4 support.</P>
+<DT><B>--enable-default-err-language</B><DD>
+<P>Replaced by error_default_language squid.conf option</P>
+<DT><B>--enable-err-languages</B><DD>
+<P>Removed.</P>
+</DL>
+</P>
+
+
+<H2><A NAME="s8">8. Regressions since Squid-2.6</A></H2>
+
+<P>Some squid.conf and ./configure options which were available in Squid 2.6 are no longer
+or not yet available in Squid-3.1</P>
+
+<P>Some options are listed as <EM>Not Yet Ported</EM>
+If you need something to do then porting one of these from Squid-2 to Squid-3 is most welcome.</P>
+
+<H2><A NAME="ss8.1">8.1 Missing and Removed squid.conf Options</A>
+</H2>
+
+<P>
+<DL>
+<DT><B></B><DD>
+
+
+</DL>
+</P>
+
+<H2><A NAME="ss8.2">8.2 Missing and Removed ./configure Options</A>
+</H2>
 
-<P>These configure options have not yet been ported to Squid-3. If you need something to do then
-porting one of these from Squid-2 to Squid-3 is most welcome.</P>
 <P>
 <DL>
 <DT><B>--enable-devpoll</B><DD>
@@ -1251,17 +1286,34 @@ client IP address</P>
 </DL>
 </P>
 
-<H3><A NAME="removedoptions"></A> Removed options</H3>
 
-<P>The following configure options have been removed.</P>
+<H2><A NAME="s9">9. Regressions since Squid-2.7</A></H2>
+
+<P>Some squid.conf and ./configure options which were available in Squid 2.7 are no longer
+or not yet available in Squid-3.1</P>
+
+<P>Some options are listed as <EM>Not Yet Ported</EM>
+If you need something to do then porting one of these from Squid-2 to Squid-3 is most welcome.</P>
+
+<H2><A NAME="ss9.1">9.1 Missing and Removed squid.conf Options</A>
+</H2>
+
 <P>
 <DL>
-<DT><B>--enable-linux-tproxy</B><DD>
-<P>Replaced by --enable-linux-tproxy2 to make way for differences in TPROXY v2 and v4 support.</P>
-<DT><B>--enable-default-err-language</B><DD>
-<P>Replaced by error_default_language squid.conf option</P>
-<DT><B>--enable-err-languages</B><DD>
-<P>Removed.</P>
+<DT><B></B><DD>
+
+
+</DL>
+</P>
+
+<H2><A NAME="ss9.2">9.2 Missing and Removed ./configure Options</A>
+</H2>
+
+<P>
+<DL>
+<DT><B></B><DD>
+
+
 </DL>
 </P>
 
index 7b2ea0d3f1ac53723ced37fab3552d70f8196ec6..1311dc0b6f57f263ffed59d4c117680a746f8914 100644 (file)
@@ -30,9 +30,7 @@ Although this release is deemed good enough for use in many setups, please note
 <p>
 The 3.1 change history can be <url url="http://www.squid-cache.org/Versions/v3/3.1/changesets/" name="viewed here">.
 
-<sect>Changes since Squid-3.0
-
-<sect1>Major new features
+<sect>Major new features sinceSsquid-3.0
 <p>
 Squid 3.1 represents a new feature release above 3.0.
 
@@ -51,7 +49,7 @@ The most important of these new features are:
 
 Most user-facing changes are reflected in squid.conf (see below).
 
-<sect2>New Version Numbering System
+<sect1>New Version Numbering System
 
 <p>Begining with 3.1 the Squid Developers are trialling a new release numbering system.
 
@@ -94,7 +92,7 @@ As always we are fully dependent on people testing the previous packages and rep
 </itemize>
 
 
-<sect2>Minimal squid.conf improvements
+<sect1>Minimal squid.conf improvements
 
 <p>squid.conf has undergone a facelift.
 
@@ -113,13 +111,12 @@ contains a fully documented set of options previously cluttering up squid.conf i
 config options provided on a clean install.
 
 
-<sect2>Internet Protocol version 6 (IPv6)
-
-<p>Squid 3.1 supports IPv6. To enable IPv6 support, use the ./configure --enable-ipv6 option
+<sect1>Internet Protocol version 6 (IPv6)
 
-<p>Details in <url url="http://wiki.squid-cache.org/Features/IPv6" name="The Squid wiki">
+<p>Squid 3.1 supports IPv6.
+   Details in <url url="http://wiki.squid-cache.org/Features/IPv6" name="The Squid wiki">
 
-<sect3>New Features for IPv6
+<sect2>New Features for IPv6
 
 <p>Squid handles localhost values seperately. For the purpose of ACLs and also external
  connections ::1 is considered a seperate IP from 127.0.0.1. This means all ACL which
@@ -138,7 +135,7 @@ config options provided on a clean install.
  software which hard coded the MIB paths needs to be upgraded for this Squid release.
 
 
-<sect3>Limitations of IPv6 Support
+<sect2>Limitations of IPv6 Support
 
 <p>Specify a specific tcp_outgoing_address and the clients who match its ACL are limited
  to the IPv4 or IPv6 network that address belongs to. They are not permitted over the
@@ -169,13 +166,13 @@ config options provided on a clean install.
    with the RADIUS server. A new helper will be needed for IPv6 RADIUS protocol.
 
 
-<sect2>Error Page Localization
+<sect1>Error Page Localization
 
 <p>Details in <url url="http://wiki.squid-cache.org/Translations" name="The Squid wiki">
 
 <p>The error pages presented by squid may now be localized per-request to match the visitors local preferred language.
 
-<p>Squid needs to be build with the --enable-auto-locale option. And the error_directory option in squid.conf needs to be removed.
+<p>The error_directory option in squid.conf needs to be removed.
 
 <p>For best coverage of languages, using the latest language pack of error files is recommended.
 Updates can be downloaded from <url url="http://www.squid-cahch.org/Versions/langpack/" name="www.squid-cache.org/Versions/langpack/">
@@ -184,7 +181,7 @@ Updates can be downloaded from <url url="http://www.squid-cahch.org/Versions/lan
    Contribution of new languages is encouraged.
 
 
-<sect2>Connection Pinning (for NTLM Auth Passthrough)
+<sect1>Connection Pinning (for NTLM Auth Passthrough)
 
 <p>Details in <url url="http://wiki.squid-cache.org/Features/ConnPinn" name="The Squid wiki">
 
@@ -194,7 +191,7 @@ Updates can be downloaded from <url url="http://www.squid-cahch.org/Versions/lan
 Microsoft NTLM Authentication instead of HTTP standard authentication through a web proxy.
 
 
-<sect2>Quality of Service (QoS) Flow support
+<sect1>Quality of Service (QoS) Flow support
 
 <p>Details in <url url="http://wiki.squid-cache.org/Features/QualityOfService" name="The Squid wiki">
 
@@ -212,7 +209,7 @@ Microsoft NTLM Authentication instead of HTTP standard authentication through a
                before copying the value to the TOS send towards clients.
 </itemize>
 
-<sect3>Squid Configuration
+<sect2>Squid Configuration
 <p>Squid 3.1 needs to be configured with --enable-zph-qos for the ZPH QoS controls to be available.
 
 <p>The configuration options for 2.7 and 3.1 are based on different ZPH patches.
@@ -227,7 +224,7 @@ The two releases configuration differs and is not at this point directly transla
 </itemize>
 
 
-<sect2>SSL Bump (for HTTPS Filtering and Adaptation)
+<sect1>SSL Bump (for HTTPS Filtering and Adaptation)
 
 <p>Details in <url url="http://wiki.squid-cache.org/Features/SslBump" name="The Squid wiki">
 
@@ -236,7 +233,7 @@ using configurable client- and server-side certificates.
 While decrypted, the traffic can be inspected using ICAP.
 
 
-<sect2>eCAP Adaptation Module support
+<sect1>eCAP Adaptation Module support
 
 <p>Details in <url url="http://wiki.squid-cache.org/Features/eCAP" name="The Squid wiki">
 
@@ -426,7 +423,7 @@ ScriptAlias /squid/cgi-bin/ "c:/squid/libexec/"
 </descrip>
 
 
-<sect1>Changes to squid.conf
+<sect>Changes to squid.conf since Squid-3.0
 <p>
 There have been changes to Squid's configuration file since Squid-3.0.
 
@@ -441,7 +438,7 @@ This section gives a thorough account of those changes in three categories:
 <p>
 
 
-<sect2>New tags<label id="newtags">
+<sect1>New tags<label id="newtags">
 <p>
 <descrip>
        <tag>acl_uses_indirect_client</tag>
@@ -772,7 +769,7 @@ NOCOMMENT_START
 
 </descrip>
 
-<sect2>Changes to existing tags<label id="modifiedtags">
+<sect1>Changes to existing tags<label id="modifiedtags">
 <p>
 <descrip>
        <tag>acl dst ipv6</tag>
@@ -1009,7 +1006,7 @@ refresh_pattern .              0       20%     4320
 </descrip>
 
 
-<sect2>Removed tags<label id="removedtags">
+<sect1>Removed tags<label id="removedtags">
 <p>
 <descrip>
 
@@ -1028,7 +1025,7 @@ refresh_pattern .              0       20%     4320
 </descrip>
 
 
-<sect1>Changes to ./configure Options
+<sect>Changes to ./configure Options since Squid-3.0
 <p>
 There have been some changes to Squid's build configuration since Squid-3.0.
 
@@ -1037,33 +1034,28 @@ 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="notportedoptions" name="Not yet available options">
        <item><ref id="removedoptions" name="Removed options">
 </itemize>
 <p>
 
 
-<sect2>New options<label id="newoptions">
+<sect1>New options<label id="newoptions">
 
 <p>
 <descrip>
        <tag>--enable-ipv6</tag>
-       <p>Buildwith IPv6 support. The default is to build without.</p>
+       <p>Buildwith IPv6 support. The default is to build with IPv6.</p>
 
        <tag>--with-localhost-ipv6</tag>
        <p>Build support for squid to map all 127.0.0.1 traffic onto ::1.
            The default is to build with 127.0.0.1 and ::1 being considered seperate IP.
-           see the IPv6 details above for a better description. 
+           see the IPv6 details above for a better description.
         </p>
 
         <tag>--with-ipv6-split-stack</tag>
         <p>Enable special additions for IPv6 support in Windows XP.
            see the IPv6 details above for a better description.</p>
 
-       <tag>--with-ipv4-mapped</tag>
-       <p>Enable special additions for IPv6 support in Windows Vista.
-           see the IPv6 details above for a better description.</p>
-
         <tag>--with-dns-cname</tag>
         <p>Enable CNAME recursion within the Internal DNS resolver stub squid uses.
            This has no effect on the external DNS helper.
@@ -1080,7 +1072,7 @@ This section gives an account of those changes in three categories:
 </descrip>
 </p>
 
-<sect2>Changes to existing options<label id="modifiedoptions">
+<sect1>Changes to existing options<label id="modifiedoptions">
 
 <p>
 <descrip>
@@ -1098,11 +1090,36 @@ This section gives an account of those changes in three categories:
 </descrip>
 </p>
 
-<sect2>Not yet available options<label id="notportedoptions">
+<sect1>Removed options<label id="removedoptions">
+
+<p>The following configure options have been removed.
+
+<descrip>
+       <tag>--enable-linux-tproxy</tag>
+       <p>Replaced by --enable-linux-tproxy2 to make way for differences in TPROXY v2 and v4 support.</p>
+       <tag>--enable-default-err-language</tag>
+       <p>Replaced by error_default_language squid.conf option</p>
+       <tag>--enable-err-languages</tag>
+       <p>Removed.</p>
+</descrip>
+
+
+<sect>Regressions since Squid-2.6
+
+<p>Some squid.conf and ./configure options which were available in Squid 2.6 are no longer
+   or not yet available in Squid-3.1
 
-<p>These configure options have not yet been ported to Squid-3. If you need something to do then
-porting one of these from Squid-2 to Squid-3 is most welcome.
+<p>Some options are listed as <em>Not Yet Ported</em>
+   If you need something to do then porting one of these from Squid-2 to Squid-3 is most welcome.
 
+<sect1>Missing and Removed squid.conf Options
+<descrip>
+       <tag></tag>
+       <p>
+
+</descrip>
+
+<sect1>Missing and Removed ./configure Options
 <descrip>
        <tag>--enable-devpoll</tag>
        <p>Support for Solaris /dev/poll</p>
@@ -1115,17 +1132,27 @@ porting one of these from Squid-2 to Squid-3 is most welcome.
        client IP address</p>
 </descrip>
 
-<sect2>Removed options<label id="removedoptions">
 
-<p>The following configure options have been removed.
+<sect>Regressions since Squid-2.7
+
+<p>Some squid.conf and ./configure options which were available in Squid 2.7 are no longer
+   or not yet available in Squid-3.1
 
+<p>Some options are listed as <em>Not Yet Ported</em>
+   If you need something to do then porting one of these from Squid-2 to Squid-3 is most welcome.
+
+<sect1>Missing and Removed squid.conf Options
 <descrip>
-       <tag>--enable-linux-tproxy</tag>
-       <p>Replaced by --enable-linux-tproxy2 to make way for differences in TPROXY v2 and v4 support.</p>
-       <tag>--enable-default-err-language</tag>
-       <p>Replaced by error_default_language squid.conf option</p>
-       <tag>--enable-err-languages</tag>
-       <p>Removed.</p>
+       <tag></tag>
+       <p>
+
+</descrip>
+
+<sect1>Missing and Removed ./configure Options
+<descrip>
+       <tag></tag>
+       <p>
+
 </descrip>
 
 </article>