--------------------- PatchSet 11928 Date: 2008/01/23 11:59:17 Author: hno Branch: HEAD Tag: (none) Log: Template 2.7 & 2.8 release notes, and fix release notes in HEAD snapshots Members: mkrelease.sh:1.13->1.14 mksnapshot.sh:1.17->1.18 doc/release-notes/Makefile:1.8->1.9 doc/release-notes/release-2.6.html:1.55->1.56(DEAD) doc/release-notes/release-2.7.sgml:INITIAL->1.1 doc/release-notes/release.html:INITIAL->1.1 doc/release-notes/release.sgml:INITIAL->1.1 Index: squid/mkrelease.sh =================================================================== RCS file: /cvsroot/squid/squid/mkrelease.sh,v retrieving revision 1.13 retrieving revision 1.14 diff -u -r1.13 -r1.14 --- squid/mkrelease.sh 3 Nov 2006 16:48:04 -0000 1.13 +++ squid/mkrelease.sh 23 Jan 2008 11:59:17 -0000 1.14 @@ -63,11 +63,11 @@ inst $tmpdir/COPYRIGHT $dst/COPYRIGHT.txt inst $tmpdir/CREDITS $dst/CREDITS.txt inst $tmpdir/ChangeLog $dst/ChangeLog.txt -if [ -f $tmpdir/doc/release-notes/release-$RELEASE.html ]; then - cat $tmpdir/doc/release-notes/release-$RELEASE.html | sed -e ' +if [ -f $tmpdir/doc/release-notes/release.html ]; then + cat $tmpdir/doc/release-notes/release.html | sed -e ' s/"ChangeLog"/"ChangeLog.txt"/g; ' > $tmpdir/RELEASENOTES.html - touch -r $tmpdir/doc/release-notes/release-$RELEASE.html $tmpdir/RELEASENOTES.html + touch -r $tmpdir/doc/release-notes/release.html $tmpdir/RELEASENOTES.html inst $tmpdir/RELEASENOTES.html $dst/${name}-RELEASENOTES.html ln -sf ${name}-RELEASENOTES.html $dst/RELEASENOTES.html fi Index: squid/mksnapshot.sh =================================================================== RCS file: /cvsroot/squid/squid/mksnapshot.sh,v retrieving revision 1.17 retrieving revision 1.18 diff -u -r1.17 -r1.18 --- squid/mksnapshot.sh 19 Sep 2007 21:29:57 -0000 1.17 +++ squid/mksnapshot.sh 23 Jan 2008 11:59:17 -0000 1.18 @@ -63,7 +63,7 @@ echo ${PACKAGE}-${VERSION}-${date}.diff >>${tag}.out fi -relnotes=$tmpdir/doc/release-notes/release-`echo $VERSION | cut -d. -f1,2 | cut -d- -f1`.html +relnotes=$tmpdir/doc/release-notes/release.html if [ -f $relnotes ]; then cp -p $relnotes ${PACKAGE}-${VERSION}-${date}-RELEASENOTES.html echo ${PACKAGE}-${VERSION}-${date}-RELEASENOTES.html >>${tag}.out Index: squid/doc/release-notes/Makefile =================================================================== RCS file: /cvsroot/squid/squid/doc/release-notes/Makefile,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- squid/doc/release-notes/Makefile 3 Mar 2007 21:34:24 -0000 1.8 +++ squid/doc/release-notes/Makefile 23 Jan 2008 11:59:17 -0000 1.9 @@ -1,4 +1,4 @@ -DOC = release-2.6 +DOC = release all: html @@ -16,18 +16,30 @@ # latex $(DOC).tex # + +%.txt: %.sgml + linuxdoc -B txt -T 2 --filter $< + $(DOC).txt: $(DOC).sgml - linuxdoc -B txt -T 2 --filter $(DOC) + linuxdoc -B txt -T 2 --filter $< + +%.html: %.sgml + linuxdoc -B html -T 2 --split=0 $< + perl -i -p -e "s%$@%%" $@ + perl -i -p -e 's%Bug #(\d+)%Bug #$$1%g' $@ $(DOC).html: $(DOC).sgml linuxdoc -B html -T 2 --split=0 $(DOC) perl -i -p -e "s%$(DOC).html%%" $(DOC).html perl -i -p -e 's%Bug #(\d+)%Bug #$$1%g' $(DOC).html +%.man: %.sgml + linuxdoc -B txt -m $< + $(DOC).man: $(DOC).sgml linuxdoc -B txt -m $(DOC) clean: rm -f *.html - rm -f $(DOC).tex $(DOC).ps $(DOC).dvi $(DOC).aux $(DOC).log $(DOC).toc - rm -f $(DOC).txt $(DOC).man + rm -f *.tex *.ps *.dvi *.aux *.log *.toc + rm -f *.txt *.man --- squid/doc/release-notes/release-2.6.html Wed Jan 23 12:53:54 2008 +++ /dev/null Wed Jan 23 12:53:54 2008 @@ -1,783 +0,0 @@ - - - - - Squid 2.6.STABLE17 release notes - - -

Squid 2.6.STABLE17 release notes

- -

Squid Developers

$Id: release-2.6.html,v 1.55 2008/01/09 14:17:25 hno Exp $ -
-This document contains the release notes for version 2.6 of Squid. -Squid is a WWW Cache application developed by the Web Caching community. -
-

-

1. Key changes from squid 2.5

- -

-

2. Changes to squid.conf

- -

-

3. Known issues

- -

-

4. Known limitations

- -

-

5. Other issues

- -

-

6. Windows support

- -

-

7. Key changes squid-2.6.STABLE1 to 2.6.STABLE2

- -

-

8. Key changes squid-2.6.STABLE2 to 2.6.STABLE3

- -

-

9. Key changes squid-2.6.STABLE3 to 2.6.STABLE4

- -

-

10. Key changes squid-2.6.STABLE4 to 2.6.STABLE5

- -

-

11. Key changes squid-2.6.STABLE5 to 2.6.STABLE6

- -

-

12. Key changes squid-2.6.STABLE6 to 2.6.STABLE7

- -

-

13. Key changes squid-2.6.STABLE7 to 2.6.STABLE8

- -

-

14. Key changes squid-2.6.STABLE8 to 2.6.STABLE9

- -

-

15. Key changes squid-2.6.STABLE9 to 2.6.STABLE10

- -

-

16. Key changes squid-2.6.STABLE10 to 2.6.STABLE11

- -

-

17. Key changes squid-2.6.STABLE11 to 2.6.STABLE12

- -

-

18. Key changes squid-2.6.STABLE12 to 2.6.STABLE13

- -

-

19. Key changes squid-2.6.STABLE13 to 2.6.STABLE14

- -

-

20. Key changes squid-2.6.STABLE14 to 2.6.STABLE15

- -

-

21. Key changes squid-2.6.STABLE15 to 2.6.STABLE16

- -

-

22. Key changes squid-2.6.STABLE16 to 2.6.STABLE17

- -

-

23. Key changes squid-2.6.STABLE17 to 2.6.STABLE18

- - -
-

1. Key changes from squid 2.5

- -

-

-

- -

2. Changes to squid.conf

- -

-

-
http_port

Now takes a list of options in addition to the port address, specifying the purpose of this http_port. Default is plain Internet proxy as usual. Also there is no longer a default port and you must include a http_port directive in your squid.conf if you want Squid to listen for http requests.

-
httpd_accel_* for transparent proxy

Now implemented by the "transparent" http_port option

-
httpd_accel_* for accelerator mode

Now implemented by other options and the http_port accel option. See individual directives below.

-
httpd_accel_host

Replaced by defaultsite http_port option and cache_peer originserver option.

-
httpd_accel_port

No longer needed. Server port defined by the cache_peer port.

-
httpd_accel_uses_host_header

Replaced by vhost http_port option

-
https_port

Many new options. Reconstructs URLs as https:// by default.

-
cache_peer

Many new options to support origin servers and SSL encryption

-
ssl_engine

New directive for hardware assisted SSL encryption

-
sslproxy_*

New directives defining how to gateway http->https

-
sslpassword_program

New helper directive to query an external program for SSL key encryption password (if any)

-
no_cache

Renamed to cache to better reflect the functionaliy. no_cache still accepted.

-
cache

New name for the old no_cache directive.

-
cache_vary

New directive to disable caching of Vary:ing responses

-
broken_vary_encoding

New directive to work around known broken compression modules which hasn't understood the meaning of the ETag HTTP header in relation to Accept-Encoding.

-
logformat

New directive for defining custom log formats

-
cache_access_log

Renamed to access_log

-
access_log

Select what requests to log where any by what format. Support for multiple log files and multiple log formats.

-
check_hostnames

New option to disable the hostname validity/sanity checks usually performed by Squid, replacing the similar build time configure option in 2.5.

-
allow_underscore

New option to allow _ in hostnames, replacing the similar build time configure option in 2.5 and earlier.

-
dns_defnames

Allow for domain searches. Now possible even when using the internal DNS client

-
redirect_*

Renamed to url_rewrite_* to better reflect the functionality of this helper (rewriting requested URLs)

-
url_rewrite_concurrency

Activates a new and more efficient helper protocol. Requires changes in the helper.

-
location_rewrite_*

New helper hook for rewriting Location headers

-
auth_param basic blankpassword

New option to allow the use of blank passwords.

-
auth_param basic/digest concurrency

New option enabling a multiplexed helper protocol allowing the same helper to process multiple concurrent requests in an efficient manner. Requires support from the helper. (2.6.STABLE2 and later)

-
auth_param ntlm max_challenge_reuse / max_challenge_lifetime

No longer supported

-
auth_param ntlm use_ntlm_negotiate

Directive no longer supported. Use of NTLM negotiate packet is always on.

-
auth_param ntlm keep_alive

New option to fine-tune the use of HTTP keep-alive in combination with NTLM

-
auth_param negotiate

New Negotiate authentication scheme, the "next generation" scheme in the family of Microsoft authentication.

-
external_acl_type

Many new format options %SRCPORT, %MYADDR, %MYPORT, %PATH, %USER_CERT, %ACL, %DATA and a few variants. Helper protocol defaults to the simpler "3.0" protocol, and there is support for a highly efficient protocol via the concurrency= option if supported by the helper.

-
refresh_pattern

Several new HTTP override/ignore options

-
read_ahead_gap

New directive to set the response buffer size.

-
collapsed_forwarding

New directive to enable an alternative optimized forwarding path when there is very many concurrent requests for the same URL.

-
refresh_stale_hit

New directive similar to collapsed_forwarding and activates an alternative optimized request processing when there is very many concurrent requests for the same recently expired URL.

-
acl urlgroup

New acl class

-
acl user_cert

New acl class matching the user SSL certificate (https_port)

-
acl ca_cert

New acl class matching the CA of the user SSL certificate (https_port)

-
acl ext_user / ext_user_regex

New acl matching usernames returned by external acl

-
follow_x_forwarded_for

New option to enable parsing of X-Forwarded-For headers allowing access controls to be based on the real client IP even if behind secondary proxies

-
http_access2

New http_access type directive but evaluated after url rewrites

-
htcp_access, htcp_clr_access

Access control on HTCP requests

-
log_access

New directive to limit what gets logged.

-
httpd_suppress_version_string

Enable hiding of the Squid version

-
umask

New directive to specify the minimum umask Squid should run under

-
error_map

New directive to allow dynamic rewrites of error pages

-
via

New directive to disable the use of the Via directive

-
wccp2_*

WCCP2 protocol support

-
minimum_expiry_time

tune the magic 60 seconds limit of what is considered cachable when the object doesn't have any cache validators. (2.6.STABLE2)

-
wccp2_rebuild_wait

make Squid delay registering with a WCCP router until store rebuild have finished. Default on. (2.6.STABLE2)

-
wccp2_weight

Cache server load weigth in the cluster. (2.6.STABLE4)

-
check_hostnames

Control if Squid should check the sanity of host names before trying to look them up in DNS

-
allow_underscores

Control if _ is to be considered a valid character in hostnames or not

-
cache_peer carp-load-factor

Option removed. CARP now uses the weight parameter instead.

-
cache_peer login=

Controls how Squid forwards login information to peer caches and servers.

-
-

- -

3. Known issues

- -

There is a few known issues in this version of Squid which we hope to correct in a later release

-

-

-

- -

4. Known limitations

- -

In addition there is a set of limitations in this version of Squid which we hope to correct later

-

-

-

- -

5. Other issues

- -

Ipfilter 4.x compile problem on HP Tru64 -

-

- - -

6. Windows support

- -

This Squid version can run on Windows as a system service using the Cygwin emulation environment, -or can be compiled in Windows native mode using the MinGW + MSYS development environment. Windows NT 4 SP4 and later are supported.
-On Windows 2000 and later the service is configured to use the Windows Service Recovery option -restarting automatically after 60 seconds. -

- -
Usage

Some new command line options was added for the Windows service support:

-

The service installation is made with -i command line switch, it's possible to use -f switch at -the same time for specify a different config-file settings for the Squid Service that will be -stored on the Windows Registry.

-

A new -n switch specify the Windows Service Name, so multiple Squid instance are allowed. -"Squid" is the default when the switch is not used.

-

So, to install the service, the syntax is:

-

-

-squid -i [-f file] [-n name]
-
-

-

Service uninstallation is made with -r command line switch with the appropriate -n switch.

-

The -k switch family must be used with the appropriate -f and -n switches, so the syntax is:

-

-

-squid -k command [-f file] -n service-name
-
- -where service-name is the name specified with -n options at service install time.

-

To use the Squid original command line, the new -O switch must be used ONCE, the syntax is:

-

-

-squid -O cmdline [-n service-name]
-
- -If multiple service command line options must be specified, use quote. The -n switch is -needed only when a non default service name is in use.

-

Don't use the "Start parameters" in the Windows 2000/XP/2003 Service applet: they are -specific to Windows services functionality and Squid is not designed for understand they.

-

In the following example the command line of the "squidsvc" Squid service is set to "-D -u 3130":

-

-

-squid -O "-D -u 3130" -n squidsvc
-
-

-
-

-

-

-
PSAPI.DLL (Process Status Helper) Considerations

The process status helper functions make it easier for you to obtain information about -processes and device drivers running on Microsoft® Windows NT®/Windows® 2000. These -functions are available in PSAPI.DLL, which is distributed in the Microsoft® Platform -Software Development Kit (SDK). The same information is generally available through the -performance data in the registry, but it is more difficult to get to it. PSAPI.DLL is -freely redistributable.

-

PSAPI.DLL is available only on Windows NT, 2000, XP and 2003. The implementation in Squid is -aware of this, and try to use it only on the right platform.

-

On Windows NT PSAPI.DLL can be found as component of many applications, if you need it, -you can find it on Windows NT Resource KIT. If you have problem, it can be -downloaded from here: -http://download.microsoft.com/download/platformsdk/Redist/4.0.1371.1/NT4/EN-US/psinst.EXE

-

On Windows 2000 and later it is available installing the Windows Support Tools, located on the -Support\Tools folder of the installation Windows CD-ROM.

-
-

-

-

-
Registry DNS lookup

On Windows platforms, if no value is specified in the dns_nameservers option on -squid.conf or in the /etc/resolv.conf file, the list of DNS name servers are -taken from the Windows registry, both static and dynamic DHCP configurations -are supported.

-
-

-

-

-
Compatibility Notes

-

-

-
-

-

-

-
Known Limitations:

-

-

-
-

-

-

-
Building Squid on Windows:

A reasonably recent release of -Cygwin or -MinGW is needed.
-The usage of the Cygwin environment is very similar to other Unix/Linux environments, and -devel version of libraries must be installed.
-For the MinGW environment, the packages MSYS, MinGW and msysDTK must be installed. Some additional libraries and tools must be downloaded separately:

-OpenSSL: -Shining Light Productions Win32 OpenSSL
-libcrypt: -MinGW packages repository
-db-1.85: -TinyCOBOL download area
-uudecode: -Native Win32 ports of some GNU utilities

-When running configure, --disable-wccp and --disable-wccpv2 options should always specified to avoid compile errors.
-

-
-Before build Squid with SSL support, some operations are needed (in the following example OpenSSL is installed in C:\OpenSSL and MinGW in C:\MinGW): - -

- -
-

-

-

-
Using cache manager on Windows:

On Windows, cache manager (cachemgr.cgi) can be used with Microsoft IIS or Apache.
-Some specific configuration could be needed:
-

-

-
-

- -

7. Key changes squid-2.6.STABLE1 to 2.6.STABLE2

- -

-

-

- - -

8. Key changes squid-2.6.STABLE2 to 2.6.STABLE3

- -

-

-

- - -

9. Key changes squid-2.6.STABLE3 to 2.6.STABLE4

- -

-

-

- -

10. Key changes squid-2.6.STABLE4 to 2.6.STABLE5

- -

-

-

- -

11. Key changes squid-2.6.STABLE5 to 2.6.STABLE6

- -

-

-

- -

12. Key changes squid-2.6.STABLE6 to 2.6.STABLE7

- -

-

-

- -

13. Key changes squid-2.6.STABLE7 to 2.6.STABLE8

- -

-

-

- -

14. Key changes squid-2.6.STABLE8 to 2.6.STABLE9

- -

-

-

- -

15. Key changes squid-2.6.STABLE9 to 2.6.STABLE10

- -

-

-

- -

16. Key changes squid-2.6.STABLE10 to 2.6.STABLE11

- -

-

-

- -

17. Key changes squid-2.6.STABLE11 to 2.6.STABLE12

- -

-

-

- -

18. Key changes squid-2.6.STABLE12 to 2.6.STABLE13

- -

-

-

- -

19. Key changes squid-2.6.STABLE13 to 2.6.STABLE14

- -

-

-

- - -

20. Key changes squid-2.6.STABLE14 to 2.6.STABLE15

- -

-

-

- -

21. Key changes squid-2.6.STABLE15 to 2.6.STABLE16

- -

-

-

- -

22. Key changes squid-2.6.STABLE16 to 2.6.STABLE17

- -

-

-

- -

23. Key changes squid-2.6.STABLE17 to 2.6.STABLE18

- -

-

-

- - - --- /dev/null Wed Jan 23 12:53:54 2008 +++ squid/doc/release-notes/release-2.7.sgml Wed Jan 23 12:53:54 2008 @@ -0,0 +1,50 @@ + +
+Squid 2.7.STABLE1 release notes +Squid Developers +$Id: release-2.7.sgml,v 1.1 2008/01/23 11:59:17 hno Exp $ + + +This document contains the release notes for version 2.7 of Squid. +Squid is a WWW Cache application developed by the Web Caching community. + + + + +Key changes from squid 2.6 +

+ +TO BE WRITTEN + + +Changes to squid.conf +

+TO BE WRITTENTO BE WRITEN + + +Known issues + +

There is a few known issues in this version of Squid which we hope to correct in a later release + + +Bug #761: Unstable under load when using diskd + + +Known limitations + +

In addition there is a set of limitations in this version of Squid which we hope to correct later + + +Bug #1420: 302 responses with an Expires header is always cached +Bug #1059: mime.conf and referenced icons must be within chroot +Bug #692: tcp_outgoing_address using an ident ACL does not work +Bug #581: acl max_user_ip and multiple authentication schemes +Bug #528: miss_access fails on "slow" acl types such as dst. +Bug #513: squid -F is starting server sockets to early +Bug #457: does not handle swap.state corruption properly +Bug #410: unstable if runs out of disk space +Bug #355: diskd may appear slow on low loads +Bug #219: delay_pools stops working on -k reconfigure + + +

--- /dev/null Wed Jan 23 12:53:54 2008 +++ squid/doc/release-notes/release.html Wed Jan 23 12:53:54 2008 @@ -0,0 +1,73 @@ + + + + + Squid 2.8.DEVEL0 release notes + + +

Squid 2.8.DEVEL0 release notes

+ +

Squid Developers

$Id: release.html,v 1.1 2008/01/23 11:59:17 hno Exp $ +
+This document contains the release notes for version 2.8 of Squid. +Squid is a WWW Cache application developed by the Web Caching community. +
+

+

1. Key changes from squid 2.7

+ +

+

2. Changes to squid.conf

+ +

+

3. Known issues

+ +

+

4. Known limitations

+ + +
+

1. Key changes from squid 2.7

+ +

+

+

+ +

2. Changes to squid.conf

+ +

+

+
TO BE WRITTEN

TO BE WRITEN

+
+

+ +

3. Known issues

+ +

There is a few known issues in this version of Squid which we hope to correct in a later release

+

+

+

+ +

4. Known limitations

+ +

In addition there is a set of limitations in this version of Squid which we hope to correct later

+

+

+

+ + + --- /dev/null Wed Jan 23 12:53:54 2008 +++ squid/doc/release-notes/release.sgml Wed Jan 23 12:53:54 2008 @@ -0,0 +1,50 @@ + +
+Squid 2.8.DEVEL0 release notes +Squid Developers +$Id: release.sgml,v 1.1 2008/01/23 11:59:17 hno Exp $ + + +This document contains the release notes for version 2.8 of Squid. +Squid is a WWW Cache application developed by the Web Caching community. + + + + +Key changes from squid 2.7 +

+ +TO BE WRITTEN + + +Changes to squid.conf +

+TO BE WRITTENTO BE WRITEN + + +Known issues + +

There is a few known issues in this version of Squid which we hope to correct in a later release + + +Bug #761: Unstable under load when using diskd + + +Known limitations + +

In addition there is a set of limitations in this version of Squid which we hope to correct later + + +Bug #1420: 302 responses with an Expires header is always cached +Bug #1059: mime.conf and referenced icons must be within chroot +Bug #692: tcp_outgoing_address using an ident ACL does not work +Bug #581: acl max_user_ip and multiple authentication schemes +Bug #528: miss_access fails on "slow" acl types such as dst. +Bug #513: squid -F is starting server sockets to early +Bug #457: does not handle swap.state corruption properly +Bug #410: unstable if runs out of disk space +Bug #355: diskd may appear slow on low loads +Bug #219: delay_pools stops working on -k reconfigure + + +