From d2fc0d01c49ba3668d06cb9a7161afe20fc3a8de Mon Sep 17 00:00:00 2001 From: Amos Jeffries Date: Fri, 24 Oct 2008 20:24:33 +1300 Subject: [PATCH] Update Release Notes Sections --- doc/release-notes/release-3.1.html | 142 ++++++++++++++++++++--------- doc/release-notes/release-3.1.sgml | 113 ++++++++++++++--------- 2 files changed, 167 insertions(+), 88 deletions(-) diff --git a/doc/release-notes/release-3.1.html b/doc/release-notes/release-3.1.html index 1b441cd4bd..2e3329f19b 100644 --- a/doc/release-notes/release-3.1.html +++ b/doc/release-notes/release-3.1.html @@ -1,7 +1,7 @@ - + Squid 3.1.0.1 release notes @@ -34,10 +34,7 @@ While this release is not deemed ready for production use, we believe it is read

The 3.1 change history can be viewed here.

-

4. Changes since Squid-3.0

- -

4.1 Major new features -

+

4. Major new features sinceSsquid-3.0

Squid 3.1 represents a new feature release above 3.0.

The most important of these new features are:

@@ -55,7 +52,8 @@ While this release is not deemed ready for production use, we believe it is read

Most user-facing changes are reflected in squid.conf (see below).

-

New Version Numbering System

+

4.1 New Version Numbering System +

Begining with 3.1 the Squid Developers are trialling a new release numbering system.

@@ -99,7 +97,8 @@ Vastly reducing the number of bugs in all code.

-

Minimal squid.conf improvements

+

4.2 Minimal squid.conf improvements +

squid.conf has undergone a facelift.

@@ -118,11 +117,11 @@ contains a fully documented set of options previously cluttering up squid.conf i config options provided on a clean install.

-

Internet Protocol version 6 (IPv6)

- -

Squid 3.1 supports IPv6. To enable IPv6 support, use the ./configure --enable-ipv6 option

+

4.3 Internet Protocol version 6 (IPv6) +

-

Details in +

Squid 3.1 supports IPv6. +Details in The Squid wiki

New Features for IPv6

@@ -177,14 +176,15 @@ A new one will be needed for IPv6 traffic between the helper and server.

with the RADIUS server. A new helper will be needed for IPv6 RADIUS protocol.

-

Error Page Localization

+

4.4 Error Page Localization +

Details in The Squid wiki

The error pages presented by squid may now be localized per-request to match the visitors local preferred language.

-

Squid needs to be build with the --enable-auto-locale option. And the error_directory option in squid.conf needs to be removed.

+

The error_directory option in squid.conf needs to be removed.

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.

-

Connection Pinning (for NTLM Auth Passthrough)

+

4.5 Connection Pinning (for NTLM Auth Passthrough) +

Details in The Squid wiki

@@ -205,7 +206,8 @@ Contribution of new languages is encouraged.

Microsoft NTLM Authentication instead of HTTP standard authentication through a web proxy.

-

Quality of Service (QoS) Flow support

+

4.6 Quality of Service (QoS) Flow support +

Details in The Squid wiki

@@ -243,7 +245,8 @@ on the client connection. Requires a kernel patch.

-

SSL Bump (for HTTPS Filtering and Adaptation)

+

4.7 SSL Bump (for HTTPS Filtering and Adaptation) +

Details in The Squid wiki

@@ -253,7 +256,8 @@ using configurable client- and server-side certificates. While decrypted, the traffic can be inspected using ICAP.

-

eCAP Adaptation Module support

+

4.8 eCAP Adaptation Module support +

Details in The Squid wiki

@@ -477,8 +481,7 @@ ScriptAlias /squid/cgi-bin/ "c:/squid/libexec/"

-

5.1 Changes to squid.conf -

+

6. Changes to squid.conf since Squid-3.0

There have been changes to Squid's configuration file since Squid-3.0.

This section gives a thorough account of those changes in three categories:

@@ -496,7 +499,8 @@ ScriptAlias /squid/cgi-bin/ "c:/squid/libexec/" -

New tags

+

6.1 New tags +

@@ -881,7 +885,8 @@ DEFAULT: None bypassed.

-

Changes to existing tags

+

6.2 Changes to existing tags +

@@ -1142,7 +1147,8 @@ refresh_pattern . 0 20% 4320

-

Removed tags

+

6.3 Removed tags +

@@ -1163,8 +1169,7 @@ refresh_pattern . 0 20% 4320

-

5.2 Changes to ./configure Options -

+

7. Changes to ./configure Options since Squid-3.0

There have been some changes to Squid's build configuration since Squid-3.0.

This section gives an account of those changes in three categories:

@@ -1175,34 +1180,29 @@ refresh_pattern . 0 20% 4320
  • Changes to existing options
  • -Not yet available options
    • -
  • Removed options

    • -

    New options

    +

    7.1 New options +

    --enable-ipv6
    -

    Buildwith IPv6 support. The default is to build without.

    +

    Buildwith IPv6 support. The default is to build with IPv6.

    --with-localhost-ipv6

    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.

    --with-ipv6-split-stack

    Enable special additions for IPv6 support in Windows XP. see the IPv6 details above for a better description.

    -
    --with-ipv4-mapped
    -

    Enable special additions for IPv6 support in Windows Vista. -see the IPv6 details above for a better description.

    -
    --with-dns-cname

    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.

    -

    Changes to existing options

    +

    7.2 Changes to existing options +

    @@ -1233,10 +1234,44 @@ Older REDIRECT and DNAT targets work as before on HTTP ports marked 'intercept'.

    -

    Not yet available options

    +

    7.3 Removed options +

    + +

    The following configure options have been removed.

    +

    +

    +
    --enable-linux-tproxy
    +

    Replaced by --enable-linux-tproxy2 to make way for differences in TPROXY v2 and v4 support.

    +
    --enable-default-err-language
    +

    Replaced by error_default_language squid.conf option

    +
    --enable-err-languages
    +

    Removed.

    +
    +

    + + +

    8. Regressions since Squid-2.6

    + +

    Some squid.conf and ./configure options which were available in Squid 2.6 are no longer +or not yet available in Squid-3.1

    + +

    Some options are listed as Not Yet Ported +If you need something to do then porting one of these from Squid-2 to Squid-3 is most welcome.

    + +

    8.1 Missing and Removed squid.conf Options +

    + +

    +

    +
    + + +
    +

    + +

    8.2 Missing and Removed ./configure Options +

    -

    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.

    --enable-devpoll
    @@ -1251,17 +1286,34 @@ client IP address

    -

    Removed options

    -

    The following configure options have been removed.

    +

    9. Regressions since Squid-2.7

    + +

    Some squid.conf and ./configure options which were available in Squid 2.7 are no longer +or not yet available in Squid-3.1

    + +

    Some options are listed as Not Yet Ported +If you need something to do then porting one of these from Squid-2 to Squid-3 is most welcome.

    + +

    9.1 Missing and Removed squid.conf Options +

    +

    -
    --enable-linux-tproxy
    -

    Replaced by --enable-linux-tproxy2 to make way for differences in TPROXY v2 and v4 support.

    -
    --enable-default-err-language
    -

    Replaced by error_default_language squid.conf option

    -
    --enable-err-languages
    -

    Removed.

    +
    + + +
    +

    + +

    9.2 Missing and Removed ./configure Options +

    + +

    +

    +
    + +

    diff --git a/doc/release-notes/release-3.1.sgml b/doc/release-notes/release-3.1.sgml index 7b2ea0d3f1..1311dc0b6f 100644 --- a/doc/release-notes/release-3.1.sgml +++ b/doc/release-notes/release-3.1.sgml @@ -30,9 +30,7 @@ Although this release is deemed good enough for use in many setups, please note

    The 3.1 change history can be . -Changes since Squid-3.0 - -Major new features +Major new features sinceSsquid-3.0

    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). -New Version Numbering System +New Version Numbering System

    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 -Minimal squid.conf improvements +Minimal squid.conf improvements

    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. -Internet Protocol version 6 (IPv6) - -

    Squid 3.1 supports IPv6. To enable IPv6 support, use the ./configure --enable-ipv6 option +Internet Protocol version 6 (IPv6) -

    Details in +

    Squid 3.1 supports IPv6. + Details in -New Features for IPv6 +New Features for IPv6

    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. -Limitations of IPv6 Support +Limitations of IPv6 Support

    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. -Error Page Localization +Error Page Localization

    Details in

    The error pages presented by squid may now be localized per-request to match the visitors local preferred language. -

    Squid needs to be build with the --enable-auto-locale option. And the error_directory option in squid.conf needs to be removed. +

    The error_directory option in squid.conf needs to be removed.

    For best coverage of languages, using the latest language pack of error files is recommended. Updates can be downloaded from @@ -184,7 +181,7 @@ Updates can be downloaded from @@ -194,7 +191,7 @@ Updates can be downloaded from @@ -212,7 +209,7 @@ Microsoft NTLM Authentication instead of HTTP standard authentication through a before copying the value to the TOS send towards clients. -Squid Configuration +Squid Configuration

    Squid 3.1 needs to be configured with --enable-zph-qos for the ZPH QoS controls to be available.

    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 -SSL Bump (for HTTPS Filtering and Adaptation) +SSL Bump (for HTTPS Filtering and Adaptation)

    Details in @@ -236,7 +233,7 @@ using configurable client- and server-side certificates. While decrypted, the traffic can be inspected using ICAP. -eCAP Adaptation Module support +eCAP Adaptation Module support

    Details in @@ -426,7 +423,7 @@ ScriptAlias /squid/cgi-bin/ "c:/squid/libexec/" -Changes to squid.conf +Changes to squid.conf since Squid-3.0

    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:

    -New tags

    acl_uses_indirect_client @@ -772,7 +769,7 @@ NOCOMMENT_START -Changes to existing tags

    acl dst ipv6 @@ -1009,7 +1006,7 @@ refresh_pattern . 0 20% 4320 -Removed tags

    @@ -1028,7 +1025,7 @@ refresh_pattern . 0 20% 4320 -Changes to ./configure Options +Changes to ./configure Options since Squid-3.0

    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: -

    -New options

    --enable-ipv6 -

    Buildwith IPv6 support. The default is to build without.

    +

    Buildwith IPv6 support. The default is to build with IPv6.

    --with-localhost-ipv6

    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.

    --with-ipv6-split-stack

    Enable special additions for IPv6 support in Windows XP. see the IPv6 details above for a better description.

    - --with-ipv4-mapped -

    Enable special additions for IPv6 support in Windows Vista. - see the IPv6 details above for a better description.

    - --with-dns-cname

    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:

    -Changes to existing options