Re: installation guide [Was: Re: Change templates: CD -> installation medium - proposal #2 ]
Hi,
I have applied nearly all of your suggestions, as in the patch attached.
Only one case remains open, see below.
Justin B Rye <justin.byam.rye@gmail.com> wrote:
> Justin B Rye wrote:
> > I was planning to carry on and find all the other places where fixes
> > are needed, but I'll have to come back to it.
>
> I had got as far as:
> (en/using-d-i/modules/apt-setup.xml:)
> - If you do scan multiple CDs or DVDs, the installer will prompt you to
> - exchange them when it needs packages from another CD/DVD than the one
> - currently in the drive. Note that only CDs or DVDs that belong to the
> + If you do scan multiple installation media, the installer will prompt you to
> + exchange them when it needs packages from another media than the one
> + currently in the drive. Note that only discs that belong to the
>
> No, "another media than [this] one" is the singular usage that doesn't
> work. But most of this is redundant anyway - just say
>
> If you do scan multiple installation media, the installer will prompt you
> to exchange them when it needs packages from one that isn't
> currently in the drive. Note that only discs that belong to the
>
> (en/using-d-i/modules/apt-setup.xml:)
> If you are <emphasis>not</emphasis> installing from a full CD or DVD or
> - using a full CD/DVD image, you really should use a network mirror as
> + a corresponding image, you really should use a network mirror as
>
> Here and later, what's the point of distinguishing these two cases?
> If you're installing from a "full" CD or DVD, doesn't that
> automatically mean you're using "a full CD/DVD image"? If so, that's
> the only case that needs to be mentioned - it could be just
>
> If you are <emphasis>not</emphasis> installing from a full CD/DVD
> image, you really should use a network mirror as
>
> [...]
> - If you are installing from a DVD or using a DVD image, any packages needed
> - during the installation should be present on the first DVD. The same is true
> - if you have scanned multiple CDs as explained in the previous section. Use
> + If you are installing from a DVD or the corresponding image, any packages needed
> + during the installation should be present on the first DVD (image). The same is true
> + if you have scanned multiple CD (images) as explained in the previous section. Use
> of a network mirror is optional.
>
> This seems incoherent. If you're installing from *a* DVD, singular,
> those packages had better be on the first DVD, because there isn't a
> second one! For this to make any sense it has to be talking about DVD
> images, plural. And then the phrasing "multiple CD (images)" doesn't
> work; but why is it repeating itself like this anyway? Why isn't this
> whole paragraph just:
>
> If you are using CD/DVD images, the packages needed during installation
> should be on the first one. Use of a network mirror is optional.
No, there are some differences:
- case 1: Installing from _one_ full CD image
- case 2: Installing from _more_than_one_ full CD image
- case 3: Installing from _one_ DVD image
- case 4: Installing from _more_than_one DVD image
Case 1: currently debian-cd only produces one full CD image, that's
named "xfce-CD-1". You can install a system with the XFCE desktop via this
CD, without needing a mirror. So, you cannot install GNOME or KDE with
this CD without a mirrror!
Case 2: in the past, we had multiple full CD images, so you had the possibility
to scan up to 10 or 20 CD images, and had all needed packages available without
a mirror. However, debian-cd does not produce such images anymore.
So, we don't need to reflect this case in the manual anymore.
Case 3: similar to case 1, however many more packages included, so all the
desktop environments mentioned above can be installed from DVD 1 without a
mirror.
Case 4: currently there are also DVD-2 and DVD-3 for Buster, so there is
the possibility to scan up to three DVD images. However, the packages from
DVD-2 and DVD-3 are rarely needed.
Thus we could change that to:
"If you are installing from DVD, any packages needed
during the installation should be present on the first DVD image. Use
of a network mirror is optional."
> (en/using-d-i/modules/network-console.xml:)
> otherwise invoke the main installation menu and choose <guimenuitem>Load
> - installer components from CD</guimenuitem> and from the list of
> + installer components from installation media</guimenuitem> and from the list of
>
> I hope you've checked that the menu will offer this changed phrasing...
Sure :-)
> (en/using-d-i/using-d-i.xml:)
> Anna's Not Nearly APT. Installs packages which have been retrieved
> - from the chosen mirror or CD.
> + from the chosen mirror or installation medium.
>
> If by "CD" it means "individual chunk of storage space" then that
> isn't "medium", it's "item of media". Could it be in fact be "media",
> plural, or would it be simpler to move in the direction of vagueness:
>
> from the chosen source,
>
>
>
> Don't forget if all this gets dealt with you can close bug #794936,
> leaving only #795944 and #796662 in the set of major problems to be
> got out of the way first before it's worth thinking about doing a
> general proofreading sweep...
Holger
--
Holger Wansing <hwansing@mailbox.org>
PGP-Fingerprint: 496A C6E8 1442 4B34 8508 3529 59F1 87CA 156E B076
diff --git a/en/using-d-i/modules/apt-setup.xml b/en/using-d-i/modules/apt-setup.xml
index e7829cd3e..85c7aecc7 100644
--- a/en/using-d-i/modules/apt-setup.xml
+++ b/en/using-d-i/modules/apt-setup.xml
@@ -91,7 +91,7 @@ will cover most needs.
<para>
If you do scan multiple installation media, the installer will prompt you to
-exchange them when it needs packages from another media than the one
+exchange them when it needs packages from one that isn't
currently in the drive. Note that only discs that belong to the
same set should be scanned. The order in which they are scanned does not
really matter, but scanning them in ascending order will reduce the chance
@@ -111,8 +111,8 @@ answer should be fine, but there are some exceptions.
</para><para>
-If you are <emphasis>not</emphasis> installing from a full CD or DVD or
-a corresponding image, you really should use a network mirror as
+If you are <emphasis>not</emphasis> installing from a full CD/DVD
+image, you really should use a network mirror as
otherwise you will end up with only a very minimal system. However, if you
have a limited Internet connection it is best <emphasis>not</emphasis>
to select the <literal>desktop</literal> task in the next step of the
@@ -120,7 +120,7 @@ installation.
</para><para>
-If you are installing from a single full CD or the corresponding image, using
+If you are installing from a single full CD image, using
a network mirror is not required, but is still strongly recommended because
a single CD image contains only a fairly limited number of packages.
If you have a limited Internet connection it may still be best
diff --git a/en/using-d-i/using-d-i.xml b/en/using-d-i/using-d-i.xml
index f2e8faf47..f402abfad 100644
--- a/en/using-d-i/using-d-i.xml
+++ b/en/using-d-i/using-d-i.xml
@@ -283,7 +283,7 @@ cost of some features).
<term>anna</term><listitem><para>
Anna's Not Nearly APT. Installs packages which have been retrieved
-from the chosen mirror or installation medium.
+from the chosen mirror or installation media.
</para></listitem>
</varlistentry>
Reply to: