Bug#775944: Please, document changes between Apache 2.2 and 2.4
On 2015-01-23 14:35, David Prévot wrote:
> Le 22/01/2015 12:35, Niels Thykier a écrit :
>> On 2015-01-21 20:21, David Prévot wrote:
>> I have made the following draft for documenting this issue.
> Thanks Niels!
>> If there are any things on the packaging side (i.e. Debian-specific
>> changes since 2.2) that users should be aware of, please do let me know
>> as I am currently not aware of issues there.
> From /usr/share/doc/apache2/NEWS.Debian.gz:
>> Moreover, the configuration mechanism in Debian has changed. All
>> configurations in sites-enabled and conf-enabled need a ".conf" suffix now.
>> Note this means all existing sites are ignored until they get a ".conf"
>> suffix and are re-enabled by the use of a2ensite.
> There are other Debian-specific bits in NEWS.Debian, but at least this
> one may deserve a mention in the release notes since it’s likely to bite
> a lot of administrators (and when the NEWS changes shows up, it’s too
> late since Apache 2.4 is already there, it will probably be long anyway).
Thanks for the review. :)
I have attached an updated patch and also briefly touches on the
".conf"-suffix issue and adds a reference to the NEWS file. A second
review is appreciated. :)
diff --git a/en/issues.dbk b/en/issues.dbk
index bef2995..97741f0 100644
@@ -209,6 +209,50 @@ $ echo 'openssh-server openssh-server/permit-root-login boolean true' | debconf-
+ <!-- Wheezy to Jessie -->
+ <title>Incompatible changes in Apache HTTPD 2.4</title>
+ This section only applies to systems, which have installed an
+ Apache HTTPD server and configured it manually.
+ There has been a number of changes to the configuration of the
+ Apache HTTPD server in version 2.4. On the upstream side, the
+ syntax has changed. Notably, the access control directives have
+ changed considerably and will need manual migration to the
+ The managing of configuration files have also been changed in the
+ Debian packaging. In particular, all configuration files and
+ sites must now end with ".conf" to be parsed. This change also
+ replaces the existing use of
+ For more information and the full list of changes, please refer to:
+ to 2.4 from 2.2</ulink> document provided by Apache for the upstream
+ The <filename>/usr/share/doc/apache2/NEWS.Debian.gz</filename>
+ file provided by the <systemitem
+ role="package">apache2</systemitem> package.
<!-- Wheezy to Jessie -->
<title>Upgrading installs the new default init system for Jessie</title>