doc/release-notes/release-7.sgml.in

   1 <!doctype linuxdoc system>
   2 <article>
   3 <title>Squid @SQUID_VERSION@ release notes</title>
   4 <author>Squid Developers</author>
   5
   6 <toc>
   7
   8 <sect>Notice
   9 <p>The Squid Team are pleased to announce the release of Squid-@PACKAGE_VERSION@ for testing.
  10
  11 This new release is available for download from <url url="http://www.squid-cache.org/Versions/v@SQUID_RELEASE@/"> or the
  12  <url url="http://www.squid-cache.org/Download/http-mirrors.html" name="mirrors">.
  13
  14 <p>While this release is not deemed ready for production use, we believe it is ready for wider testing by the community.
  15
  16 <p>We welcome feedback and bug reports. If you find a bug, please see <url url="https://wiki.squid-cache.org/SquidFaq/BugReporting">
  17    for how to submit a report with a stack trace.
  18
  19 <sect1>Known issues
  20 <p>Although this release is deemed good enough for use in many setups, please note the existence of
  21 <url url="https://bugs.squid-cache.org/buglist.cgi?query_format=advanced&amp;product=Squid&amp;bug_status=UNCONFIRMED&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;version=@SQUID_RELEASE@" name="open bugs against Squid-@SQUID_RELEASE@">.
  22
  23 <sect1>Changes since earlier releases of Squid-@SQUID_RELEASE@
  24 <p>
  25 The Squid-@SQUID_RELEASE@ change history can be <url url="https://github.com/squid-cache/squid/commits/v@SQUID_RELEASE@" name="viewed here">.
  26
  27
  28 <sect>Major new features since Squid-@SQUID_RELEASE_OLD@
  29 <p>Squid-@SQUID_RELEASE@ represents a new feature release above Squid-@SQUID_RELEASE_OLD@.
  30
  31 <p>The most important of these new features are:
  32 <itemize>
  33         <item>Cache Manager changes
  34 </itemize>
  35
  36 <p>Most user-facing changes are reflected in squid.conf (see further below).
  37
  38 <sect1>Cache Manager changes<label id="mgr">
  39 <p>For more information about the Cache Manager feature, see <url url="https://wiki.squid-cache.org/Features/CacheManager/Index" name="wiki">.
  40
  41 <p>
  42 <descrip>
  43         <tag>non_peers</tag>
  44         <p>Removed the <em>mgr:non_peers</em> report. Squid still ignores
  45         unexpected ICP responses but no longer remembers the details that comprised
  46         the removed report. The senders of these ICP messages are still reported to
  47         cache.log at debugging level 1 (with an exponential backoff).
  48
  49 </descrip>
  50
  51 <sect>Changes to squid.conf since Squid-@SQUID_RELEASE_OLD@
  52 <p>
  53 This section gives an account of those changes in three categories:
  54
  55 <itemize>
  56         <item><ref id="newdirectives" name="New directives">
  57         <item><ref id="modifieddirectives" name="Changes to existing directives">
  58         <item><ref id="removeddirectives" name="Removed directives">
  59 </itemize>
  60 <p>
  61
  62 <sect1>New directives<label id="newdirectives">
  63 <p>
  64 <descrip>
  65         <p>No new directives in this version.
  66
  67 </descrip>
  68
  69 <sect1>Changes to existing directives<label id="modifieddirectives">
  70 <p>
  71 <descrip>
  72         <tag>buffered_logs</tag>
  73         <p>Honor the <em>off</em> setting in 'udp' access_log module.
  74
  75         <tag>cachemgr_passwd</tag>
  76         <p>Removed the <em>non_peers</em> action. See the Cache Manager
  77         <ref id="mgr" name="section"> for details.
  78
  79 </descrip>
  80
  81 <sect1>Removed directives<label id="removeddirectives">
  82 <p>
  83 <descrip>
  84         <tag>mcast_miss_addr</tag>
  85         <p>The corresponding code has not built for many years, indicating that the
  86         feature is unused.
  87
  88         <tag>mcast_miss_ttl</tag>
  89         <p>The corresponding code has not built for many years, indicating that the
  90         feature is unused.
  91
  92         <tag>mcast_miss_port</tag>
  93         <p>The corresponding code has not built for many years, indicating that the
  94         feature is unused.
  95
  96         <tag>mcast_miss_encode_key</tag>
  97         <p>The corresponding code has not built for many years, indicating that the
  98         feature is unused.
  99
 100 </descrip>
 101
 102
 103 <sect>Changes to ./configure options since Squid-@SQUID_RELEASE_OLD@
 104 <p>
 105 This section gives an account of those changes in three categories:
 106
 107 <itemize>
 108         <item><ref id="newoptions" name="New options">
 109         <item><ref id="modifiedoptions" name="Changes to existing options">
 110         <item><ref id="removedoptions" name="Removed options">
 111 </itemize>
 112
 113 <sect1>New options<label id="newoptions">
 114 <p>
 115 <descrip>
 116         <tag>--without-psapi</tag>
 117         <p>Disable auto-detection of Windows PSAPI library.
 118
 119 </descrip>
 120
 121 <sect1>Changes to existing options<label id="modifiedoptions">
 122 <p>
 123 <descrip>
 124         <p>No changed options in this version.
 125
 126 </descrip>
 127 </p>
 128
 129 <sect1>Removed options<label id="removedoptions">
 130 <p>
 131 <descrip>
 132         <tag>CPPFLAGS=-DHEADERS_LOG</tag>
 133         <p>The code enabled by this preprocessor macro has not built for many
 134            years, indicating that the feature is unused.
 135
 136         <tag>CPPFLAGS=-DMULTICAST_MISS_STREAM</tag>
 137         <p>The code enabled by this preprocessor macro has not built for many
 138            years, indicating that the feature is unused.
 139
 140 </descrip>
 141
 142 <sect>Copyright
 143 <p>
 144 Copyright (C) 1996-2023 The Squid Software Foundation and contributors
 145 <p>
 146 Squid software is distributed under GPLv2+ license and includes
 147 contributions from numerous individuals and organizations.
 148 Please see the COPYING and CONTRIBUTORS files for details.
 149
 150 </article>