Re: [squid-users] Discrepancies between Squid and its docs

On Wed, 29 Oct 2003, Eric Geater 10/23/03 wrote:

> 9.1, docs are in /usr/share/doc/squid-2.5.stable1) refer to 2.5, but I
> have wholly been using the ACL instructions found at
> http://squid-docs.sourceforge.net/latest/html/x1455.html (and found
> under the "Using the NCSA authentication module" section).

The (unfinished) Squid Users Guide was written long time ago, long before
Squid-2.5 was released. The syntax shown in it's examples are using the
syntax which was correct at the time, but Squid-2.5 uses a slightly
different syntax. The principles are the same however.

You can find details on the Squid-2.5 syntax in

 a) squid.conf.default
 b) Squid-2.5 release notes
 b) the Squid FAQ
 c) list archives since Squid-2.5 was released

The squid.conf.default file is THE authoritative reference to squid.conf
syntax and is always up to date with the version of Squid you have
installed.

The Squid-2.5 release noted do document these squid.conf syntax changes,
giving some guidelines in how to translate Squid-2.4 and earlier
configurations to Squid-2.5 syntax

The Squid FAQ is slightly more up to date than the (incomplete) Squid
Users Guide or the Squid-2.4 Configuration Guide, but seriously needs
someone maintaining it a little more actively..

volunteers for updating the Squid FAQ is highly welcome.. For this task
the requirements is:

 * knowledge in how to use a text editor (required)
 * some understanding of Squid-2.5 (required)
 * follows discussions on Squid-users (required)
 * not being scared by SGML (desired, not required)
 * and reasonably good English writing skills (desired, not required)

Regards
Henrik
Received on Wed Oct 29 2003 - 14:53:50 MST