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
“freedom”).</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
(“architectures”). 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 ‘apt’ and
‘aptitude’ programs.</p>
<p>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:</p>
<p>
<code>apt install commprog maxgame</code>
</p>
<p>Note that you don't have to enter the complete path, or the
‘.deb’ extension. ‘Apt’ 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>