Package: release-notes
Severity: normal
Tags: patch
In upgrading.dbk, Section 4.3.3 "Adding APT source from CD-ROM or DVD"
has:
1) references to /cdrom throughout
...but apparently that's not obsolete quite yet; it's only Wheezy's
apt-cdrom that's FHS-compliant and uses /media/cdrom (see #611569).
Do we know if users will need any special advice for handling the
switch?
2) references to /dev/hdc
These days that would be /dev/sr0 or /dev/scd0 or something, but
presumably we should be talking about the /dev/cdrom symlink, right?
3) no references to Blu-ray Discs
We offer images for DVD and (via jigdo only) BD, but this section
talks almost exclusively about "CDs" (and "the CD-ROM drive"), with
only one mention of DVDs and none of Blu-ray. Should we perhaps make
the cover-term "optical media" in the title, and phrase things so we
can fit in a reference to "CDs (or DVDs or Blu-ray Discs)" the first
time it comes up in the text?
Or perhaps we could treat "CDs" as the cover-term, so it's "from CDs"
in the title, and put an expanded version in the first place where
it's mentioned in the text - "optical media (that is, CDs, DVDs, or
Blu-ray Discs)".
My patch goes for /dev/cdrom, and "optical media" in the title.
(I also pluralise "sources" in the title, bringing it in line with the
other section titles. Even if I'm only adding one such APT source,
other people on other occasions follow the same procedure.)
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
Index: upgrading.dbk
===================================================================
--- upgrading.dbk (revision 9683)
+++ upgrading.dbk (working copy)
@@ -519,9 +519,10 @@
</section>
<section id="cdroms">
-<title>Adding APT source from CD-ROM or DVD</title>
+<title>Adding APT sources from optical media</title>
<para>
-If you want to use CDs <emphasis>only</emphasis>, comment out the existing
+If you want to use <emphasis>only</emphasis> CDs
+(or DVDs or Blu-ray Discs), comment out the existing
<quote><literal>deb</literal></quote> lines in <filename>/etc/apt/sources.list</filename> by
placing a hash sign (<literal>#</literal>) in front of them.
</para>
@@ -529,12 +530,12 @@
Make sure there is a line in <filename>/etc/fstab</filename> that enables
mounting your CD-ROM drive at the <filename>/cdrom</filename> mount point (the
exact <filename>/cdrom</filename> mount point is required for
-<command>apt-cdrom</command>). For example, if <filename>/dev/hdc</filename>
-is your CD-ROM drive, <filename>/etc/fstab</filename> should contain a line
+<command>apt-cdrom</command>). For example, if <filename>/dev/cdrom</filename>
+points at your CD-ROM drive, <filename>/etc/fstab</filename> should contain a line
like:
</para>
<programlisting>
-/dev/hdc /cdrom auto defaults,noauto,ro 0 0
+/dev/cdrom /cdrom auto defaults,noauto,ro 0 0
</programlisting>
<para>
Note that there must be <emphasis>no spaces</emphasis> between the words
