Bug#945248: www.debian.org: 'How to download an image with jigdo' uses obsolete terms and references

Tom Roche <[email protected]>
Newsgroups gmane.linux.debian.devel.www
Message-ID <20191121204524.7276.65665.reportbug__37347.0824024238$1574369308$gmane$org@localhost>
Package: www.debian.org
Severity: important
Tags: newcomer

Dear Maintainer,

> *** Reporter, please consider answering these questions, where appropriate ***
>    * What led up to the situation?

Preparing to install Debian on a PC, haven't done that for a few years. (Hence the downlevel of this box.)

>    * What exactly did you do (or not do) that was effective (or ineffective)?

I RTFMed, and found information about `jigdo`, which I had not previously used. Specifically I looked @

https://www.debian.org/CD/jigdo-cd/#how

which currently has the following HTML:

- <h2><a name="how" id="how">How to download an image with jigdo</a></h2>
- <ul>
-   <li>Download a package containing <tt>jigdo-lite</tt>, which is
-   available for GNU/Linux, Windows and Solaris from the
-   <a href="http://atterer.org/jigdo/">jigdo homepage</a>. For FreeBSD,
-   install from /usr/ports/net-p2p/jigdo or grab the package with <tt>pkg_add
-   -r jigdo</tt>.
-   </li>

There are 2 problems with this text:

1. The current package name=`jigdo-file` (per, e.g., https://packages.debian.org/search?keywords=jigdo), not `jigdo-lite`. This error is repeated several times in subsequent text on that webpage.

2. The current jigdo homepage=https://www.einval.com/~steve/software/jigdo/ per the old homepage=http://atterer.org/jigdo/ cited above, which says (again, HTML)

> <p>I have stopped development on this software long ago. But luckily, <strong>Steve McIntyre has taken over development - thanks Steve!</strong> Please head to <a href="https://www.einval.com/~steve/software/jigdo/">einval.com for a forked jigdo version</a> with new features.</p>

Fortunately these errors are easy to fix (and I would do myself if the target page=https://www.debian.org/CD/jigdo-cd/ was in the Debian wiki):

0. Acquire access to the HTML source for https://www.debian.org/CD/jigdo-cd/ in some shell, and make it editable.

Following assumes shell=bash and path=/path/to/jigdo-cd.html to that file; change below as needed.

1. Run commandline=`sed -i -e 's|jigdo-lite|jigdo-file|g' /path/to/jigdo-cd.html`

2. Run commandline=`sed -i -e 's|http://atterer.org/jigdo/|https://www.einval.com/~steve/software/jigdo/|g' /path/to/jigdo-cd.html`

3. Check your work with commandline=`grep -nH -e 'jigdo-lite\|http://atterer.org/jigdo/' /path/to/jigdo-cd.html | wc -l` ; result should=0

4. Mount edited source as needed for the Debian web.

-- System Information:
Debian Release: 8.11
  APT prefers oldoldstable
  APT policy: (500, 'oldoldstable')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 3.16.0-4-amd64 (SMP w/8 CPU cores)
Locale: LANG=en_US.utf8, LC_CTYPE=en_US.utf8 (charmap=UTF-8) (ignored: LC_ALL set to en_US.utf8)
Shell: /bin/sh linked to /bin/dash
Init: sysvinit (via /sbin/init)
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.