Re: releasenotes
A patch for all these copy-editing issues. Mostly I've just assumed
that the appropriate solution is to snip out the troublesome bits.
--
JBR - and today's single word in West Greenlandic is:
Uqarituukasippungaasiit
"Silly me, I went and spoke out of turn as usual!"
diff -ru release-notes.pristine//en/issues.dbk release-notes/en/issues.dbk
--- release-notes.pristine//en/issues.dbk 2011-02-01 17:35:20.496916343 +0000
+++ release-notes/en/issues.dbk 2011-02-01 17:56:42.841258893 +0000
@@ -75,9 +75,9 @@
Versions of <systemitem role="package">grub-pc</systemitem> older than
1.98+20100720-1 will not be able to boot directly off
a <acronym>RAID</acronym> with the 1.x metadata formats (the new default is
-1.2). To ensure a bootable system, please make sure to use <systemitem
-role="package">grub-pc</systemitem>
-1.98+20100720-1 or later, which is provided by Debian &releasename;. An
+1.2). To ensure a bootable system, please make sure that the new
+version of <systemitem role="package">grub-pc</systemitem> provided by Debian
+&releasename; has installed its bootloader code to the disk. An
unbootable system may be rescued with <ulink
url="http://www.supergrubdisk.org/super-grub2-disk/";>Super Grub2 Disk</ulink>
or <ulink url="http://grml.org";>grml</ulink>.
@@ -87,7 +87,8 @@
<section id="pam_userdb">
<title>pam_userdb.so breakage with newer libdb</title>
<para>
-Some Berkeley Database version 7 files created with libdb3 cannot be read by
+If you authenticate users against a Berkeley DB database, you should
+be aware that some db version 7 files created with libdb3 cannot be read by
newer libdb versions (see bug <ulink url="&url-bts;521860">#521860</ulink>).
As a workaround, the files can be recreated with <command>db4.8_load</command>,
from the <systemitem role="package">db4.8-util</systemitem> package.
@@ -444,10 +445,9 @@
url="http://www.iana.org/assignments/port-numbers";>the IANA registry</ulink>.
</para>
<para>
-Starting with the version 4.38 of the Debian <systemitem
-role="package">netbase</systemitem> package, the <literal>sieve</literal>
-service will be moved from port 2000 to port 4190 in the
-<filename>/etc/services</filename> file.
+In the version of <systemitem role="package">netbase</systemitem> in
+&releasename, the <literal>sieve</literal> service has been moved from port
+2000 to port 4190 in the <filename>/etc/services</filename> file.
</para>
<para>
Any installs which used the <literal>sieve</literal> service name instead of a
@@ -639,8 +639,7 @@
granted automatically to the user currently logged on physically to the
system: video and audio devices, network roaming, power management,
device mounting. The cdrom, floppy, audio, video, plugdev and powerdev
-groups are no longer useful. See the <systemitem
-role="package">consolekit</systemitem> documentation for more information.
+groups are no longer useful.
</para>
<para>
Most graphical programs requiring root permissions now rely on <ulink
@@ -721,11 +720,11 @@
</section>
<section>
- <title>Kernel mode setting</title>
+ <title>Kernel mode-setting</title>
<para>
Kernel drivers for Intel (starting from i830), ATI/AMD (from the
original Radeon to the Radeon HD 5xxx <quote>Evergreen</quote> series)
- and for NVIDIA graphics chipsets now support native mode setting.
+ and for NVIDIA graphics chipsets now support native video mode setting.
</para>
<para arch="i386;amd64">
Support for old-style userspace mode setting is discontinued in the
diff -ru release-notes.pristine//en/upgrading.dbk release-notes/en/upgrading.dbk
--- release-notes.pristine//en/upgrading.dbk 2011-02-01 17:35:20.493027527 +0000
+++ release-notes/en/upgrading.dbk 2011-02-01 17:45:33.093263258 +0000
@@ -293,7 +293,7 @@
linkend="old-sources"/>.
</para>
<para>
-To perform this review, launch <command>aptitude</command> in <quote>visual mode</quote> and
+To perform this review, launch <command>aptitude</command> in full-screen mode and
press <keycap>g</keycap> (<quote>Go</quote>). If it shows any actions, you should review them and either fix
them or implement the suggested actions. If no actions are suggested you will
be presented with a message saying <quote>No packages are scheduled to be installed,
@@ -1251,8 +1251,7 @@
you can also use the kernel sources, provided in the <systemitem
role="package">linux-source-2.6</systemitem> package. You can make use of the
<literal>deb-pkg</literal> target available in the sources' makefile for
-building a binary package. There are some differences in these two approaches,
-please consult the respective package's documentation.
+building a binary package.
</para>
<para>
If possible, it is to your advantage to upgrade the kernel package separately
@@ -1921,28 +1920,13 @@
<command>apt-get</command> to manually install packages in &oldreleasename;
it will have kept track of those packages you manually installed and will be
able to mark as obsolete those packages pulled in by dependencies alone which
-are no longer needed if a package has been removed.
-<command>aptitude</command> and <systemitem role="package">apt</systemitem>,
-unlike <command>deborphan</command>, will not mark for removal packages that
-you manually installed, as opposed to those that were automatically
-installed through dependencies. To remove automatically installed packages
-that are no longer used, run:
+are no longer needed if a package has been removed. To remove
+automatically installed packages that are no longer used, run:
</para>
<screen>
# apt-get autoremove
</screen>
<para>
-There are additional tools you can use to find obsolete packages such as
-<command>deborphan</command>, <command>debfoster</command> or
-<command>cruft</command>. <command>deborphan</command> is highly recommended,
-although it will (in default mode) only report obsolete libraries: packages in
-the <quote><literal>libs</literal></quote> or <quote><literal>oldlibs</literal></quote> sections that are not used by any other packages. Do not
-blindly remove the packages these tools present, especially if you are using
-aggressive non-default options that are prone to produce false positives. It
-is highly recommended that you manually review the packages suggested for
-removal (i.e. their contents, size and description) before you remove them.
-</para>
-<para>
The <ulink url="&url-bts;">Debian Bug Tracking System</ulink>
often provides additional information on why the package was removed. You
should review both the archived bug reports for the package itself and the
@@ -2017,13 +2001,11 @@
<listitem>
<para>
<systemitem role="package">apt-proxy</systemitem> is no longer
- provided, alternatives to this tool include
+ provided; although no automatic upgrade path exists, users can
+ switch to alternatives such as
<systemitem role="package">apt-cacher-ng</systemitem>,
- <systemitem role="package">apt-cacher</systemitem> and
- <systemitem role="package">approx</systemitem>. Although no
- automatic upgrade path exists, user of <systemitem
- role="package">apt-proxy</systemitem> can switch to these alternatives
- by manually installing any of these packages.
+ <systemitem role="package">apt-cacher</systemitem>, or
+ <systemitem role="package">approx</systemitem>.
</para>
</listitem>
<listitem>
diff -ru release-notes.pristine//en/whats-new.dbk release-notes/en/whats-new.dbk
--- release-notes.pristine//en/whats-new.dbk 2011-02-01 17:35:20.496916343 +0000
+++ release-notes/en/whats-new.dbk 2011-02-01 17:39:11.828925631 +0000
@@ -386,25 +386,15 @@
<section id="pkgmgmt">
<title>Package management</title>
<para>
-The preferred program for interactive package management from a terminal is
-<command>aptitude</command>. For a non-interactive command line interface
-for package management, it is recommended to use <command>apt-get</command>.
-<command>apt-get</command> is also the preferred tool for upgrades
-between major releases.
-If you are still using <command>dselect</command>, you should switch to
+For users familiar with <command>aptitude</command>'s full-screen mode, this
+is the preferred interface for normal package management. However, the
+recommended command line tool for the &oldreleasename; to &releasename;
+upgrade is <command>apt-get</command>. If you are still using
+<command>dselect</command>, you should switch to
<systemitem role="package">aptitude</systemitem> as the official front-end
for package management.
</para>
-<para>
-For &releasename; APT automatically installs recommended packages by default<footnote><para>This change implies that disk requirements for tasks selected through the debian installer have increased too. For more information please
-see the <quote>Disk Space Needed for Tasks</quote> chapter in the
-<ulink url="&url-install-manual;">Installation Guide</ulink>.</para></footnote>.
-This can be changed by adding the following line in
-<filename>/etc/apt/apt.conf</filename>:
-<programlisting>APT::Install-Recommends "false";</programlisting>
-</para>
-
<programlisting condition="fixme">
TODO: Do we have to mention dpkg triggers here or elsewhere?
</programlisting>
Reply to: