Bug#865120: release-notes: document i386/amd64 kernel changes for jessie->stretch

[Justin B Rye <justin.byam.rye@gmail.com>]

Stuart Prescott wrote:
> With Stretch, amd64 flavour kernels are no longer supplied within the i386
> Debian architecture (i.e. for a 64 bit kernel with a 32 bit userspace). The
> release notes should document that these kernel packages are no longer
> offered so that users don't accidentally run unsupported kernels indefinitely
> (hence severity:important).
> 
> The upgrade path is to enable amd64 as a foreign architecture and then install
> the relevant amd64 kernel image.
> 
> A 0th draft at some wording for §4.6/4.6.1:

Ben has pointed out a couple of extra things that ought to be
mentioned; I'm basically just nitpicking the spelling and so on.

> Users of the i386 port are advised that the amd64 flavour of kernel

We're standardising to en_US, so it's a kernel "flavor" (but no, not
"advized").

> is no longer included within the i386 port but that these kernels

i386 isn't exactly a "port"; I'd suggest sticking to "the i386
architecture".  However, since the text varies from arch to arch, the
version that's shown to i386 users can afford to be slightly less
wordy about it.  I'd suggest:

 <para>
  Users are advised that the <literal>-amd64</literal> flavor of kernel
  is no longer provided for the <literal>i386</literal> architecture.
  These kernels

> should instead be installed directly from the amd64 port using the
> ability for apt and dpkg to install foreign architecture packages
> (known as multiarch).

(Perhaps phrase this as "using multiarch, the mechanism allowing the
installation of foreign-architecture packages"?)
 
> - check if running i386 userspace with amd64 kernel:
>     `dpkg --print-architure` is i386, and
>     `uname -r` ends in amd64
>

Typo: --print-archiTECture.

Here's a version bringing it slightly closer to full sentences:

 <itemizedlist>
  <listitem>
   <para>
    To check if you are running <literal>i386</literal> userspace with
    <literal>amd64</literal> kernel, run:
    <command>dpkg --print-architecture; uname -r</command> (would give
    <literal>i386</literal> and a flavor ending in
    <literal>-amd64</literal>).
   </para>
  </listitem>

> - add amd64 as foreign architecture
>     `dpkg --add-architecture amd64; apt-get update`
> 
> - (install the appropriate kernel metapackage as described already)

  <listitem>
   <para>
    To add <literal>amd64</literal> as a foreign architecture, run:
    <command>dpkg --add-architecture amd64; apt-get update</command>
   </para>
  </listitem>
  <listitem>
   <para>
    (Install the appropriate kernel metapackage as described above.)
   </para>
  </listitem>
 </itemizedlist>

-- 
JBR	with qualifications in linguistics, experience as a Debian
	sysadmin, and probably no clue about this particular package