Re: Bug#864166: release-notes: proofreading sweep - issues.dbk
Niels Thykier wrote on Monday:
>> (It would be nice if the releasenotes *also* mentioned that things
>> have stopped depending on ifupdown, with the result that it runs the
>> risk of being automatically uninstalled by aptitude - a nasty
>> potential upgrade glitch not related to the one that keeps disabling
>> my wifi. But that's a content change, so it should go in a separate
>> bugreport, and maybe not for this page.)
>
> I have added a warning in the section about net-tools being deprecated
> and how to use iproute2.
A warning about ifupdown? I don't see anything in the version in SVN.
I would suggest adding an extra section immediately after the one
about net-tools, saying something like:
<section id="ifupdown">
<!-- jessie to stretch -->
<title>Reduced dependencies on <systemitem
role="package">ifupdown</systemitem></title>
<para>
The package <systemitem role="package">netbase</systemitem> no
longer recommends <systemitem role="package">ifupdown</systemitem>,
which may therefore be identified as unneeded after the upgrade to
stretch. This may be appropriate if your system uses
<systemitem role="package">network-manager</systemitem>, but if
interfaces are still defined in
<filename>/etc/network/interfaces</filename> then <systemitem
role="package">ifupdown</systemitem> will need to be marked as
manually installed, for instance by running:
<screen>apt-mark manual ifupdown</screen>
</para>
</section>
I do see an added warning about evdev being deprecated in favour of
libinput, but it isn't accurate. It claims "This section is only
relevant if you have tweaked or need to change the default Xorg input
configuration", which just isn't true: the change caught me even on a
vanilla lightdm setup with ordinary keyboard and mouse. Until I
discovered and installed xserver-xorg-input-libinput (new in stretch)
my system was crippled. Advice on how to tweak libinput to support
fancy features does nothing to help users avoid this fate! (Also, the
title "Desktops will migrate..." is wrong; this has nothing to do with
desktops.)
Meanwhile my attempts to track down the bugs in networking.service and
startx have come to a dead end, so I'll just have to hope they were
problems with my setup and won't hit everyone else. The networking
one at least was easily fixed by the pending reboot.
However, the new version in SVN does have some new material, with some
new language errors:
Index: issues.dbk
===================================================================
--- issues.dbk (revision 11588)
+++ issues.dbk (working copy)
@@ -906,9 +914,10 @@
</para>
</section>
<section id="harmless-perl-warnings-during-upgrade">
+ <!-- jessie to stretch -->
And come to think of it there should be lots more of these throughout
this section. Added in the attached patch.
- <title>Harmeless <quote>Unespaced ... in regex is deprecated, ...</quote> warnings during upgrade</title>
+ <title>Harmless <quote>Unescaped ... in regex is deprecated, ...</quote> warnings during upgrade</title>
<para>
Smelling pistakes.
- During the upgrade, you may see some warning like:
+ During the upgrade, you may see some warnings like:
Number agreement.
<screen>
Unescaped left brace in regex is deprecated, passed through in regex; marked by <-- HERE in m/^(.*?)(\\)?\${ <-- HERE ([^{}]+)}(.*)$/ at /usr/share/perl5/Debconf/Question.pm line 72.
Unescaped left brace in regex is deprecated, passed through in regex; marked by <-- HERE in m/\${ ≶-- HERE ([^}]+)}/ at /usr/share/perl5/Debconf/Config.pm line 30.
@@ -915,7 +924,7 @@
</screen>
</para>
<para>
- These are harmless and happens if <systemitem
+ These are harmless, and happen if <systemitem
role="package">perl-base</systemitem> is upgraded before the
<systemitem role="package">debconf</systemitem> package.
</para>
Number agreement.
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
Index: issues.dbk
===================================================================
--- issues.dbk (revision 11588)
+++ issues.dbk (working copy)
@@ -192,6 +192,7 @@
</para>
<section id="pie-admin-issues">
+ <!-- jessie to stretch -->
<title>Behavior changes of PIE for system administrators and developers</title>
<note>
<para>
@@ -529,6 +530,7 @@
</section>
<section id="x11-changes">
+ <!-- jessie to stretch -->
<title>Changes to the Xorg graphical environment</title>
<para>
This section describes some of the major changes related to the
@@ -622,6 +624,7 @@
</section><!-- Xorg section -->
<section id="upstart-removed">
+ <!-- jessie to stretch -->
<title>Upstart removed</title>
<para>Due to the lack of upstream maintainers,
the Upstart init system has been removed from stretch.
@@ -676,6 +679,7 @@
<section id="debhelper">
+ <!-- jessie to stretch -->
<title>The debhelper tool now generates <literal>dbgsym</literal> packages by default</title>
<note>
<para>
@@ -707,6 +711,7 @@
</section>
<section id="openssl-issues">
+ <!-- jessie to stretch -->
<title>OpenSSL related changes</title>
<para>
The <command>openssl</command> application expects option arguments before
@@ -743,6 +748,7 @@
</section>
<section id="perl">
+ <!-- jessie to stretch -->
<title>Perl changes that may break third-party software</title>
<note>
<para>
@@ -802,6 +808,7 @@
</section>
<section id="plperl">
+ <!-- jessie to stretch -->
<title>PostgreSQL PL/Perl incompatibility</title>
<para>
The PostgreSQL PL/Perl procedural language package in jessie is
@@ -817,6 +824,7 @@
</section>
<section id="iproute2">
+ <!-- jessie to stretch -->
<title><systemitem role="package">net-tools</systemitem> will be
deprecated in favor of <systemitem
role="package">iproute2</systemitem></title>
@@ -906,9 +914,10 @@
</para>
</section>
<section id="harmless-perl-warnings-during-upgrade">
- <title>Harmeless <quote>Unespaced ... in regex is deprecated, ...</quote> warnings during upgrade</title>
+ <!-- jessie to stretch -->
+ <title>Harmless <quote>Unescaped ... in regex is deprecated, ...</quote> warnings during upgrade</title>
<para>
- During the upgrade, you may see some warning like:
+ During the upgrade, you may see some warnings like:
<screen>
Unescaped left brace in regex is deprecated, passed through in regex; marked by <-- HERE in m/^(.*?)(\\)?\${ <-- HERE ([^{}]+)}(.*)$/ at /usr/share/perl5/Debconf/Question.pm line 72.
Unescaped left brace in regex is deprecated, passed through in regex; marked by <-- HERE in m/\${ ≶-- HERE ([^}]+)}/ at /usr/share/perl5/Debconf/Config.pm line 30.
@@ -915,7 +924,7 @@
</screen>
</para>
<para>
- These are harmless and happens if <systemitem
+ These are harmless, and happen if <systemitem
role="package">perl-base</systemitem> is upgraded before the
<systemitem role="package">debconf</systemitem> package.
</para>
Reply to: