Bug#1063858: False disk set size in README.(html|txt), and a few minor corrections

Kevin Price <[email protected]>
Newsgroups gmane.linux.debian.devel.cd
Message-ID <7e2355b6-a11f-4d29-bf82-55a708ca106d__38639.2934176669$1707843823$gmane$org@osnanet.de>
Package: debian-cd
X-Debbugs-Cc: J.A. Bezemer <[email protected]>, Steve
McIntyre <[email protected]>
Version: 3.2.1
Severity: minor

Dear maintainers, dear Steve[1]:

In the official current stable (12.5) images, the /README.(html|txt)
files (see att.) seem to miscount the total number of disks in each set.
For instance, in debian-12.5.0-amd64-DLBD-2.iso, section "About This
Disc" says: "[...]this disc is number 2 of a set of 1 discs"

1. This is obviously false, not only in the DLBD images.

While we're at it, could we tidy up the generating script in a few more
minor details, without separate bug reports maybe?

2. Aforementioned sentence's full stop is awkwardly misplaced in the
html (line-break in-between), and it's missing in the txt.

3. I was not quite certain about the version number to file this bug
against, so I took a look at the XHTML header for sth. like 'meta
name="generator"'. Wouldn't that be helpful to include?

4. The html claims to be "XHTML 1.0 Strict", but fails to validate
against https://validator.w3.org/ . AFAICT, that's only due to errors in
the section "Last-Minute Notes":

4.a. The "<li>" beginning with "This is an official release" lacks a
closing "</li>".

4.b. Where it says "<A
HREF="https://bugs.debian.org/">bugs.debian.org</A>" it should
respectively say "a", "href", and "/a" instead.

5. The html header defines the language to be "English". Maybe "en"
would be more preferable?

Please let me know how I could be of any further assistance in resolving
these issues.

[1] FWIW, See also
https://lists.debian.org/debian-user/2024/01/msg00796.html , and please
accept my apology for being slow to file this bug.

-- System Information:
Debian Release: 12.5
  APT prefers stable-updates
  APT policy: (500, 'stable-updates'), (500, 'stable-security'), (500,
'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 6.1.0-18-amd64 (SMP w/4 CPU threads; PREEMPT)
Kernel taint flags: TAINT_PROPRIETARY_MODULE, TAINT_OOT_MODULE,
TAINT_UNSIGNED_MODULE
Locale: LANG=de_DE.UTF-8, LC_CTYPE=de_DE.UTF-8 (charmap=UTF-8), LANGUAGE
not set
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages debian-cd depends on:
ii  apt                        2.6.1
ii  bc                         1.07.1-3+b1
ii  bzip2                      1.0.8-5+b1
ii  cpp                        4:12.2.0-3
ii  curl                       7.88.1-10+deb12u5
ii  dctrl-tools [grep-dctrl]   2.24-3+b1
ii  dpkg-dev                   1.21.22
ii  genisoimage                9:1.1.11-3.4
pn  libcompress-zlib-perl      <none>
pn  libdigest-md5-perl         <none>
ii  libdpkg-perl               1.21.22
ii  libfile-slurp-perl         9999.32-2
ii  libyaml-libyaml-perl       0.86+ds-1
ii  lynx                       2.9.0dev.12-1
ii  make                       4.3-4.1
ii  perl [libdigest-sha-perl]  5.36.0-7+deb12u1
ii  pigz                       2.6-1
ii  tofrodos                   1.7.13+ds-6
ii  uuid-runtime               2.38.1-5+b1
ii  wget                       1.21.3-1+b2
ii  xorriso                    1.5.4-4

Versions of packages debian-cd recommends:
ii  dosfstools       4.2-1
ii  hfsutils         3.2.6-15
ii  isolinux         3:6.04~git20190206.bf6db5b4+dfsg1-3
ii  mtools           4.0.33-1+really4.0.32-1
ii  syslinux-common  3:6.04~git20190206.bf6db5b4+dfsg1-3

debian-cd suggests no packages.

-- no debconf information

HTH, cheers
-- 
Kevin Price
README.txt (text/plain, 5.3 KB)
   Debian GNU/Linux 12.5.0 "Bookworm" - Official amd64 DLBD Binary-2 with
                           firmware 20240210-11:28

                                             (HTML version in README.html)

                      Welcome to the exciting world of
                              Debian GNU/Linux

   This is one disc in a set containing the Debian GNU/Linux distribution.
   Debian is a very extensive collection of software. But it is more. It
   is a complete Operating System (OS) for your computer. And it is free
   (as in "freedom").

   CONTENTS:
     * Introduction
     * About This Disc
     * Installing
     * Last-Minute Notes
     * Installing software using Apt
     * CD/DVD Manufacturers
     * More Information
     * Browse This Disc

Introduction
============

   An operating system is the set of basic programs and utilities that
   make your computer run. At the core of an operating system is the
   kernel. The kernel is the most fundamental program on the computer,
   which does all the basic housekeeping and lets you start other
   programs. Debian is kernel independent. It currently uses either the
   Linux or FreeBSD kernel. Most of the basic operating system tools come
   from the GNU project; hence the name GNU/Linux.

   Debian is available for various kinds of computers ("architectures").
   Check the ports page for more information.

   Read more at:

     https://www.debian.org/intro/about

About This Disc
===============

   This disc is labeled

   Debian GNU/Linux 12.5.0 "Bookworm" - Official amd64 DLBD Binary-2 with
                           firmware 20240210-11:28

   which means that this disc is number 2 of a set of 1 discs It
   contains programs ("binaries") for `amd64' computers.

   The programs on the Binary discs are ordered by popularity. The
   Binary-1 disc contains the most popular programs and the installation
   tools; it is possible to install and run Debian with only the Binary-1
   disc. The other discs, up to Binary-1, contain mostly
   special-interest programs.

   The Release Notes for "bookworm" are available on the Debian web site.

Installing
==========

   Because Debian is a complete Operating System, the installation
   procedure may seem a bit unusual. You can install Debian GNU/Linux
   either alongside your current OS, or as the only OS on your computer.

   An Installation Guide is included on this disc at
   doc/manual/en/index.html (English version)

   Several translations of the Installation Guide are included on this
   disc in the doc/ directory, along with various other documents.

   Note: additional translations, other formats (like PDF and TXT) and
   updated versions for the Installation Guide are available from the
   Debian web site.

   For the impatient ones: you can start the installation program easily
   by booting off this disc. Note that not all (esp. older) systems
   support this.

   You can also examine the /install/ directory; you might be able to
   start the installation system directly from there.

Last-Minute Notes
=================

     * This is an official release of the Debian system. Please report any
       bugs you find in the Debian Bug Tracking System; details at
       [1]bugs.debian.org.
     * If you're reporting bugs against this disc or the installation
       system, please also mention the version of this disc; this can be
       found in the file /.disk/info.

Installing software using Apt
=============================

   After installing or upgrading, Debian's packaging system can use CDs,
   DVDs, local collections, or networked servers (FTP, HTTP) to
   automatically install software from (.deb packages). This is done
   preferably with the `apt' and `aptitude' programs.

   You can install packages from the commandline using apt. For example,
   if you want to install the packages `commprog' and `maxgame', you can
   give the command:

     apt install commprog maxgame

   Note that you don't have to enter the complete path, or the `.deb'
   extension. `Apt' will figure this out itself.

   Or use aptitude for a full screen interactive selection of available
   Debian packages.

CD/DVD Manufacturers
====================

   You are completely free to manufacture and re-distribute CDs/DVDs of
   the Debian GNU/Linux Operating System, like this one. There is no
   charge from us (but of course donations are always welcome).

   For all needed information and contact addresses, please refer to:

     https://www.debian.org/CD/

More Information
================

   The Binary-1 disc contains much more information about various aspects
   of the Debian Operating System and the Debian organization. See the
   README on that disc for more info.

   Also on the Internet are many resources. To name a few:
     * https://www.debian.org/          The Debian homepage
     * https://www.debian.org/doc/      Debian Documentation
     * https://www.debian.org/support/  Debian User Support
     * https://www.tldp.org/            The Linux Documentation Project
     * https://www.linux.org/           General Linux homepage



      See the Debian contact page (https://www.debian.org/contact) for
                        information on contacting us.

References

   1. https://bugs.debian.org/
README.html (text/html, 8.5 KB)
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
  <title>Debian GNU/Linux -- The Universal Operating System</title>
  <meta name="Description" content="Debian GNU/Linux is a free distribution of the GNU/Linux operating system. It is maintained and updated through the work of many users who volunteer their time and effort." />
  <meta name="Keywords" content="debian, GNU, linux, unix, open source, free, DFSG" />
  <meta name="Language" content="English" />
  <meta name="Author" content="J.A. Bezemer, [email protected]" />
  <link rev="made" href="mailto:[email protected]" />
  <link href="css/debinstall.css" rel="stylesheet" type="text/css" />
  <link href="css/debinstall-print.css" media="print" rel="stylesheet" type="text/css" />
</head>
<body id="readme">

  <!-- The HTML and TEXT file are NOT the actual source code. -->
  <!-- For that, see https://salsa.debian.org/images-team/debian-cd -->




  <div id="header">
    <div id="upperheader">
      <div id="logo">
        <a href="https://www.debian.org/" title="www.debian.org"><img
	    src="pics/openlogo-nd-50.png" width="70" height="120"
	    alt="www.debian.org" /></a>
      </div><!-- end logo -->
      <p class="section"><em>Installer</em></p>
    </div><!-- end upperheader -->
    <!--UdmComment-->


    <div id="intro">
      <div id="splash">
        <h1>
	Welcome to the exciting world of 
        <span id="debian-img"><img
	    src="pics/debian-61.png" alt="Debian GNU/Linux"
            height="94" width="211" /></span></h1>

        <p>This is one disc in a set containing the
        <a href="https://www.debian.org/">Debian GNU/Linux</a> distribution.
        Debian is a very extensive collection of software. But it
        is more. It is a complete Operating System (OS) for your
        computer. And it is <a href=
        "https://www.debian.org/intro/free">free</a> (as in
        &ldquo;freedom&rdquo;).</p>
      </div>
    </div>

    <p id="breadcrumbs">
      <span class="alt">(<a href= "README.txt">Text version</a>)</span>
      Debian GNU/Linux 12.5.0 "Bookworm" - Official amd64 DLBD Binary-2 with firmware 20240210-11:28
    </p>
  </div><!-- end header -->

  <div id="outer">
    <ul class="toc">
      <li><a href="#introduction">Introduction</a></li>
      <li><a href="#thisdisc">About This Disc</a></li>
      <li><a href="#install">Installing</a></li>
      <li><a href="#lastmin">Last-Minute Notes</a></li>
      <li><a href="#apt">Installing software using Apt</a></li>
      <li><a href="#cdmanuf">CD/DVD Manufacturers</a></li>
      <li><a href="#other">More Information</a></li>
      <li><a href=".">Browse This Disc</a></li>
    </ul>

    <h2 id="introduction">
      Introduction
    </h2>

    <p>An operating system is the set of basic programs and utilities
    that make your computer run. At the core of an operating system is
    the kernel. The kernel is the most fundamental program on the
    computer, which does all the basic housekeeping and lets you start
    other programs. Debian is kernel independent. It currently uses
    either the <a href= "https://www.linux.org/">Linux</a>
    or <a href="https://www.freebsd.org/">FreeBSD</a> kernel. Most of
    the basic operating system tools come from the <a href=
    "https://www.gnu.org/">GNU project</a>; hence the name
    GNU/Linux.</p>

    <p>Debian is available for various kinds of computers
    (&ldquo;architectures&rdquo;). Check the
    <a href="https://www.debian.org/ports">ports</a> page for more
    information.</p>

    <p><a href="https://www.debian.org/intro/about">Read more...</a></p>

    <h2 id="thisdisc">
      About This Disc
    </h2>

    <p>This disc is labeled
    <small><strong>Debian GNU/Linux 12.5.0 "Bookworm" - Official amd64 DLBD Binary-2 with firmware 20240210-11:28</strong></small>
    which means that this disc is number 2 of a set of 1 discs
    .
    It contains programs ("binaries") for `amd64' computers.</p>
    <p>The programs on the Binary discs are ordered by popularity. The Binary-1
    disc contains the most popular programs and the installation tools; it is
    possible to install and run Debian with only the Binary-1 disc. The other
    discs, up to Binary-1, contain mostly special-interest programs.</p>
    <p>The Release Notes for "bookworm" are available on the
    <a href="https://www.debian.org/releases/bookworm/releasenotes">Debian web
    site</a>.</p>

    <h2 id="install">
      Installing
    </h2>

    <p>Because Debian is a complete Operating System, the
    installation procedure may seem a bit unusual. You can install
    Debian GNU/Linux either <em>alongside</em> your current OS, or as
    the <em>only</em> OS on your computer.</p>
    <p>An <b>Installation Guide</b> is included on this disc at
    <tt><a href="doc/manual/en/index.html">doc/manual/en/index.html</a></tt>
    (English version)</p>

    <p>Several translations of the Installation Guide are included on this disc in
    the <tt><a href="doc">doc/</a></tt> directory, along with various other
    documents.</p>

    <p>Note: additional translations, other formats (like PDF and TXT) and
    updated versions for the Installation Guide are available from
    <a href="https://www.debian.org/releases/bookworm/installmanual">the Debian web site</a>.
    </p>

    <p>For the impatient ones: you can start the installation program easily by
    booting off this disc.  Note that not all (esp. older) systems support
    this.</p>

    <p>You can also examine the <tt><a href="install/">/install/</a></tt>
    directory; you might be able to start the installation system directly
    from there.</p>


    <h2 id="lastmin">
      Last-Minute Notes
    </h2>

    <ul>
     <li>This is an official release of the Debian system. Please report any
     bugs you find in the Debian Bug Tracking System; details at <A
     HREF="https://bugs.debian.org/">bugs.debian.org</A>.
     <li>If you're reporting bugs against this disc or the installation
     system, please also mention the version of this disc; this can be found
     in the file <tt><a href=".disk/info">/.disk/info</a></tt>.</li>

    </ul>

    <h2 id="apt">
      Installing software using Apt
    </h2>

    <p>After installing or upgrading, Debian's packaging system can
    use CDs, DVDs, local collections, or networked servers (FTP,
    HTTP) to automatically install software from (.deb
    <em>packages</em>). This is done preferably with the &lsquo;apt&rsquo; and
    &lsquo;aptitude&rsquo; programs.</p>

    <p>You can install packages from the commandline using
    apt. For example, if you want to install the
    packages &lsquo;commprog&rsquo; and &lsquo;maxgame&rsquo;, you can give the
    command:</p>

    <p>
      <code>apt install commprog maxgame</code>
    </p>

    <p>Note that you don't have to enter the complete path, or the
    &lsquo;.deb&rsquo; extension. &lsquo;Apt&rsquo; will figure this out
    itself.</p>

    <p>Or use aptitude for a full screen interactive selection of
    available Debian packages.</p>

    <h2 id="cdmanuf">
      CD/DVD Manufacturers
    </h2>

    <p>You are completely free to manufacture and re-distribute CDs/DVDs of the
    Debian GNU/Linux Operating System, like this one. There is no charge from
    us (but of course donations are always welcome).</p>

    <p>For all needed information and contact addresses, please
    refer to:</p>

    <p>
      <a href="https://www.debian.org/CD/">https://www.debian.org/CD/</a>
    </p>

    <h2 id="other">
      More Information
    </h2>


    <p>The Binary-1 disc contains much more information about various aspects
    of the Debian Operating System and the Debian organization.  See the README
    on that disc for more info.</p>


    <p>Also on the Internet are many resources. To name a few:</p>

    <ul>
      <li>
        <a href="https://www.debian.org/">The Debian homepage</a>
      </li>
      <li>
        <a href="https://www.debian.org/doc/">Debian Documentation</a>
      </li>
      <li>
        <a href="https://www.debian.org/support">Debian User Support</a>
      </li>
      <li>
        <a href="https://www.tldp.org/">The Linux Documentation Project</a>
      </li>
      <li>
        <a href="https://www.linux.org/">General Linux homepage</a>
      </li>
    </ul>


    <div id="fineprint">
      <p>
      See the Debian <a href=
      "https://www.debian.org/contact">contact page</a>
      for information on contacting us.</p>
    </div>
  </div>
</body>
</html>
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.