Re: Bug#447774: Please mention proposed-updates

[Vincent.McIntyre@csiro.au]

tags 447774 +patch
thanks

this patch may need some tweaking, I'm not so fluent in docbook.
I'm not sure about:
 * the section id names (same in both files I touched)
 * cross-referencing between files

Index: upgrading.dbk
===================================================================
--- upgrading.dbk	(revision 5506)
+++ upgrading.dbk	(working copy)
@@ -326,6 +326,16 @@
 </para>
 </section>
 
+<section id="proposed-updates">
+<title>Proposed-updates section</title>
+<para>
+If you have listed the <literal>proposed-updates</literal> section
+in your <filename>/etc/apt/sources.list</filename> file, you should remove
+it from that file before attempting to upgrade your system.
+This is a precaution to reduce the likelyhood of conflicts.
+</para>
+</section>
+
 <section id="userbackports">
 <title>Unofficial sources and backports</title>
 <para>
Index: whats-new.dbk
===================================================================
--- whats-new.dbk	(revision 5506)
+++ whats-new.dbk	(working copy)
@@ -321,6 +321,31 @@
 
 </section>
 
+<section id="proposed-updates">
+<title>The proposed-updates section</title>
+<para>
+Some users of &debian; &releasename; may wish to help test updates
+to packages before they are formally added to an upcoming point release.
+One can do this by adding the
+<literal>proposed-updates</literal>
+section to their <filename>sources.list</filename>:
+</para>
+<screen>
+deb     &url-debian-mirror-eg;/debian &releasename;-proposed-updates main contrib
+deb-src &url-debian-mirror-eg;/debian &releasename;-proposed-updates main contrib
+</screen>
+<para>
+The next time you run <command>aptitude update</command>, the system
+will become aware of the packages in the
+<literal>proposed-updates</literal> section and will consider them
+when looking for packages to upgrade.
+</para>
+<para>
+This is not strictly a new feature of Debian, but one that has not
+been given much exposure.
+</para>
+</section>
+
 <section id="backports.org" condition="fixme">
 <title>backports.org/backports.debian.org</title>
 <para >TODO: write about probability backports.org becoming official</para>