[1/2] [website] Add up-to-date download page for Debian

Sun Sep 20 16:05:37 CDT 2015

Hi

On 09/20/2015 05:00 AM, Kyle Auble wrote:
> I know the old page was removed just a few months ago, but I wrote a new
> one (modeled on the Ubuntu page). It explains the differences between
> "wine" vs. "wine-development" and has instructions for those that want
> the Backports version. Also, per the suggestion at the end of the Debian
> bug report, the links to Debian package info are for both packages, and
> each lists all available versions.

Great! Just a few things:

>
> ---
>  templates/en/download/debian.template | 133 ++++++++++++++++++++++++++++++++++
>  1 file changed, 133 insertions(+)
>  create mode 100644 templates/en/download/debian.template
>
> diff --git a/templates/en/download/debian.template b/templates/en/download/debian.template
> new file mode 100644
> index 0000000..eff7d88
> --- /dev/null
> +++ b/templates/en/download/debian.template
> @@ -0,0 +1,133 @@
> +<!--TITLE:[Installing the latest Wine on Debian]-->
> +<!--BLURB:[Installing the latest Wine on Debian]-->
> +
> +<h1 class="title"><a href="https://www.debian.org/" target="_new">
> +<img src="{$root}/images/distro/debian.png" width="50" height="50"
> +  alt="Debian Logo" border="0"></a>
> +Wine on Debian
> +<a href="https://www.debian.org/" target="_new">
> +<img src="{$root}/images/distro/debian.png" width="50" height="50"
> +  alt="Debian Logo" border="0"></a></h1>
> +
> +<p>You can directly install software for Debian from <i>.deb</i> package
> +files, but using the APT package manager (or a front-end such as
> +Aptitude or Synaptic) to get software from the official Debian repos is
> +much safer and cleaner. This page explains how to install your preferred
> +version of Wine this way.</p>
> +
> +<h2>Apt-Get Basics (for 32-Bit Debian)</h2>

Drop "Apt-Get" from the heading. The explanations at the end of this
section are not apt-get related.

> +
> +<p>So long as your package system is configured correctly and
> +up-to-date, grabbing Wine should be simple, whether you use Debian
> +<i>stable</i>, <i>testing</i>, or <i>unstable</i>. On <b>32-bit</b>
> +Debian, you can install a stable release of Wine with a single
> +<i>apt-get</i> command:</p>
> +
> +<pre>sudo apt-get install wine</pre>
> +
> +<p>Starting with Debian Jessie (release 8.0), there is also a package of
> +Wine's development release that can be installed alongside the stable
> +release:</p>
> +
> +<pre>sudo apt-get install wine-development</pre>
> +
> +<p>Note that you currently need to use the command
> +'<b>wine-development</b>' instead of '<b>wine</b>' to run the
> +development version from the command-line.</p>
> +
> +<p>Also, while the "wine-development" package on Debian <i>unstable</i>
> +should closely track upstream, the version on Debian <i>stable</i> will
> +only upgrade with each new release of Debian. Similarly, the version on
> +Debian <i>testing</i> will track upstream except while Debian is in its
> +biennial code-freeze.</p>

When Debian is in freeze, the packages aren't updated in unstable
either. Instead last time they were updated in the "experimental" suite.
Furthermore you might mention Backports already here. Finally I'd
suggest "major release" to make it more distinct from point releases.

I'd suggest something like:
~~~
The "wine-development" package on Debian should closely track upstream.
The version on Debian stable will only upgrade with each new
major release of Debian, but current packages should be available from
Debian Backports (see below).
While Debian is in its biennial code-freeze the packages aren't updated
in testing and unstable. Instead you should find current
versions in experimental.
~~~

Note: I hope to update Backports from experimental during the freeze.
But it's too early to know, yet. I don't think we need to mention this
aspect in any way here, yet.

> +
> +<h2>On 64-Bit Debian</h2>
> +
> +<p>Even if your system uses <b>64-bit</b> Debian, you probably still
> +want a Wine installation that can run 32-bit Windows applications. To
> +install 32-bit application support, just make sure your system is
> +configured to pull in 32-bit packages and the index is updated
> +first:</p>
> +
> +<pre>
> +sudo dpkg --add-architecture i386
> +sudo apt-get update
> +sudo apt-get install wine-development
> +</pre>
> +
> +<p>Starting with Debian Stretch, you can also install Wine on 64-bit
> +ARM systems:</p>
> +
> +<pre>
> +sudo dpkg --add-architecture armhf
> +sudo apt-get update
> +sudo apt-get install wine-development
> +</pre>
> +
> +<h2>Debian Backports</h2>
> +
> +<p>If you are on Debian <i>stable</i> and want a newer version of
> +"wine-development", starting with Debian Jessie, you can grab a version
> +in sync with upstream from Debian <i>backports</i>. To install it, you

*Backports (capital B)

> +need to
> +<a href="http://backports.debian.org/Instructions/" target="_new">
> +enable the Backports repo
> +</a>
> +first by adding the following line to one of your <i>sources.list</i>
> +files (replace <b>xx</b> with an appropriate country code):</p>
> +
> +<pre>
> +deb ftp://ftp.xx.debian.org/debian/ jessie-backports main contrib
> +</pre>

Nowadays you can use httpredir.debian.org (formerly http.debian.net), a
redirector to the best nearby Debian mirror:

~~~
[...] by adding the following line to one of your <i>sources.list</i>
files:</p>

<pre>
deb http://httpredir.debian.org/debian/ jessie-backports main
</pre>
~

> +
> +<p>You can do this either through Synaptic
> +(<b>Settings -> Repositories -> Other Software -> Add</b>)
> +or by editing the <i>sources.list</i> file directly
> +('<b>sudo nano /etc/apt/sources.list</b>').

Nitpick: s/nano/editor/
In Debian you have /usr/bin/editor pointing to your favourite text
editor (per default nano)

> +Once you've added your sources, update your package index
> +(<b>Reload</b> in Synaptic or '<b>sudo apt-get update</b>' on the
> +  command-line).</p>
> +
> +<p>If you don't mind possibly upgrading other dependencies to
> +<i>backports</i> versions too, you can install everything in one

*Backports (capital B)

> +swoop:</p>
> +
> +<pre>sudo apt-get install -t jessie-backports wine-development</pre>
> +
> +<p>If you want to be more selective about keeping <i>stable</i>
> +dependencies though, you can use the form:</p>
> +
> +<pre>sudo apt-get install wine-development/jessie-backports</pre>
> +
> +<p>However, if any other packages need to be installed or updated, this
> +method will abort with a list of such packages. You can selectively
> +install those from either <i>stable</i> or <i>backports</i>, then repeat
> +the command to install "wine-development/jessie-backports".</p>
> +
> +<h2>More Information</h2>
> +
> +<p>For more info, you can see the Debian package site:</p>
> +
> +<ul><li>
> +<a href="https://packages.debian.org/search?keywords=wine"
> +  target="_new">
> +wine
> +</a> (stable release)</li>
> +
> +<li>
> +<a href="https://packages.debian.org/search?keywords=wine-development"
> +  target="_new">
> +wine-development
> +</a> (development release)</li></ul>

Nitpick: I'd drop the "search?keywords=".
https://packages.debian.org/wine-development is easier to read/memorize
and redirects to the form that you used.

Minor display issue: the underlining of the links "wine" and
"wine-development" is too long. It spans over the space up to the
bracket here. Maybe pull the "</a>" to the same line. This looks ugly in
the source, but fixes the display here.

> +
> +<p>There are also useful wiki pages out there too:</p>
> +
> +<ul><li>
> +<a href="http://wiki.winehq.org/Debian" target="_new">
> +Debian on the Wine Wiki
> +</a></li>
> +
> +<li>
> +<a href="https://wiki.debian.org/Wine" target="_new">
> +Wine on the Debian Wiki
> +</a></li></ul>
>

Greets
jre