Bug#553306: clarify use of mirror/udeb/suite

[Vincent McIntyre]

Package: installation-guide
Severity: wishlist

Tags: patch

In relation to #552787, I've attempted to improve the relevant text
in the preseeding appendix of the manual. It's a bit wordier (sorry
translators).

Cheers
Vince



[preseed.xml.patch]

---

Index: trunk/manual/en/appendix/preseed.xml
===================================================================
--- trunk/manual/en/appendix/preseed.xml (revision 61122)
+++ trunk/manual/en/appendix/preseed.xml (working copy)
@@ -896,12 +896,14 @@
 </para><para>
 
 The parameter <classname>mirror/udeb/suite</classname> determines the suite
-for additional components for the installer. It is only useful to set this
-if components are actually downloaded over the network and should match the
+for additional components for the <emphasis>installer</emphasis>.
+By default the value for <classname>mirror/udeb/suite</classname> is the
+same as <classname>mirror/suite</classname>.
+<classname>mirror/udeb/suite</classname> may be set to a different value,
+but it is only useful to do this if installer components are going to be
+downloaded over the network. The value should match the
 suite that was used to build the initrd for the installation method used for
 the installation.
-By default the value for <classname>mirror/udeb/suite</classname> is the
-same as <classname>mirror/suite</classname>.
 
 </para>
 

---

[Frans Pop-3]

On Friday 30 October 2009, Vincent McIntyre wrote:
> In relation to #552787, I've attempted to improve the relevant text
> in the preseeding appendix of the manual. It's a bit wordier (sorry
> translators).

 The parameter <classname>mirror/udeb/suite</classname> determines the suite
+for additional components for the <emphasis>installer</emphasis>.
+By default the value for <classname>mirror/udeb/suite</classname> is the
+same as <classname>mirror/suite</classname>.
+<classname>mirror/udeb/suite</classname> may be set to a different value,
+but it is only useful to do this if installer components are going to be
+downloaded over the network. The value should match the
 suite that was used to build the initrd for the installation method used for
 the installation.

Problem is that this is not correct. For daily built images for example,
mirror/udeb/suite gets set to "sid", while mirror/suite is "squeeze".
And for the "etch-and-a-half" images mirror/udeb/suite is "lenny", while
mirror/suite is "etch".

And the fun part is that using a "lenny" mini.iso and booting that with
suite=etch just works. So something is rotten in what you saw in #552787.

I don't think I want to change the manual if the bug is in the installer.

Cheers,
FJP



--
To UNSUBSCRIBE, email to debian-bugs-dist-REQUEST@...
with a subject of "unsubscribe". Trouble? Contact listmaster@...

[Debian Bug Tracking System]

Your message dated Fri, 6 Nov 2009 06:33:00 +0100
with message-id <200911060633.01228.elendil@...>
and subject line Re: Bug#553306: clarify use of mirror/udeb/suite
has caused the Debian Bug report #553306,
regarding clarify use of mirror/udeb/suite
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@...
immediately.)


--
553306: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=553306
Debian Bug Tracking System
Contact owner@... with problems

Package: installation-guide
Severity: wishlist

Tags: patch

In relation to #552787, I've attempted to improve the relevant text
in the preseeding appendix of the manual. It's a bit wordier (sorry
translators).

Cheers
Vince



[preseed.xml.patch]

---

Index: trunk/manual/en/appendix/preseed.xml
===================================================================
--- trunk/manual/en/appendix/preseed.xml (revision 61122)
+++ trunk/manual/en/appendix/preseed.xml (working copy)
@@ -896,12 +896,14 @@
 </para><para>
 
 The parameter <classname>mirror/udeb/suite</classname> determines the suite
-for additional components for the installer. It is only useful to set this
-if components are actually downloaded over the network and should match the
+for additional components for the <emphasis>installer</emphasis>.
+By default the value for <classname>mirror/udeb/suite</classname> is the
+same as <classname>mirror/suite</classname>.
+<classname>mirror/udeb/suite</classname> may be set to a different value,
+but it is only useful to do this if installer components are going to be
+downloaded over the network. The value should match the
 suite that was used to build the initrd for the installation method used for
 the installation.
-By default the value for <classname>mirror/udeb/suite</classname> is the
-same as <classname>mirror/suite</classname>.
 
 </para>
 

---

On Friday 06 November 2009, Frans Pop wrote:
> I don't think I want to change the manual if the bug is in the
> installer.

It wasn't a bug in the installer, but an error in the preseed file. In
general you should not preseed values unless you really need to.

The installation guide already explicitly mentions that "The value should
match the suite that was used to build the initrd for the installation
method used for the installation.".

Your additions are not correct. Instead I've committed this simpler change:

 [...] It is only useful to set this
 if components are actually downloaded over the network and should match the
 suite that was used to build the initrd for the installation method used for
-the installation.
-By default the value for <classname>mirror/udeb/suite</classname> is the
-same as <classname>mirror/suite</classname>.
+the installation. Normally the installer will automatically use the correct
+value and you should not need to set this.

Reason for that change is that the way mirror/udeb/suite and mirror/suite
get set was changed some time ago and the defaults are now a bit more
complex than what it said.

Cheers,
FJP