[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#704515: release-notes: updates for "Adding APT source from CD-ROM or DVD"

Package: release-notes
Severity: normal
Tags: patch

In upgrading.dbk, Section 4.3.3 "Adding APT source from CD-ROM or DVD"

 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

 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 id="cdroms">
-<title>Adding APT source from CD-ROM or DVD</title>
+<title>Adding APT sources from optical media</title>
-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.
@@ -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
-/dev/hdc /cdrom auto defaults,noauto,ro 0 0
+/dev/cdrom /cdrom auto defaults,noauto,ro 0 0
 Note that there must be <emphasis>no spaces</emphasis> between the words

Reply to: