d-i manual : precisions in the debootstrap appendix

[Baptiste Jammet <baptiste@mailoo.org>]

Hi all,

As someone reported on -l10n-french [0], there is some imperfections in 
the debootstrap appendix of the manual.
I don't know debootstrap very well, but based on the remarks, here is a 
first draft.
Please review and correct if needed.

[0] https://lists.debian.org/debian-l10n-french/2016/12/msg00026.html

Keeping the original submitter in Cc, and the full message (in french) 
below for reference.

Baptiste

Le 12/12/2016 23:51, Gaël Marloie a écrit :
> Bonjour,
>
> Je suis en train d'utiliser debootstrap
> https://www.debian.org/releases/jessie/mips/apds03.html.fr
> pour installer un mini pc arm et je me permet de vous signaler des
> oublis dans le sens qu'une personne qui ne connaît pas sera à mon avis
> perdue.
>
> dans le paragraphe D.3.3. Lancer *debootstrap*
> Dans la commande il est nécessaire de rajouter --foreign si
> l'architecture de la machine est différente.
>
> Dans le paragraphe D.3.4. Configurer le système de base
> il faut avoir installé qemu-user-static et copier
> /usr/bin/qemu-ARCH-static /mnt/debinst/usr/bin
> et lancer la commande :
>
> LANG=C.UTF-8 chroot /mnt/debinst qemu-ARCH-static /bin/bash
>
> Juste après une étape importante a été oubliée :
> /debootstrap/debootstrap --second-stage
>
> Car pour continuer paragraphe D.3.4.1. il faut avoir la commande
> apt-get or celle-ci n'est installée qu'après
> avoir lancer --second-stage
>
> Bien cordialement,
> Gaël Marloie
Index: chroot-install.xml
===================================================================
--- chroot-install.xml	(revision 70396)
+++ chroot-install.xml	(working copy)
@@ -191,6 +191,9 @@
      /mnt/debinst http://ftp.us.debian.org/debian
 </screen></informalexample>
 
+If the target architecture is different than the host, you should add the
+<userinput>--foreign</userinput> option.
+
 </para>
   </sect2>
 
@@ -205,6 +208,14 @@
 # LANG=C.UTF-8 chroot /mnt/debinst /bin/bash
 </screen></informalexample>
 
+Again, if the target architecture is different,
+you will need to first copy qemu-user-static to the new host:
+
+<informalexample><screen>
+# cp /usr/bin/qemu-ARCH-static /mnt/debinst/usr/bin
+# LANG=C.UTF-8 chroot /mnt/debinst /bin/bash
+</screen></informalexample>
+
 After chrooting you may need to set the terminal definition to be
 compatible with the &debian; base system, for example:
 
@@ -215,6 +226,12 @@
 Depending on the value of TERM, you may have to install the
 <classname>ncurses-term</classname> package to get support for it.
 
+Or finish the multi-stage boot strap in the case of a foreign architecture:
+
+<informalexample><screen>
+/debootstrap/debootstrap --second-stage
+</screen></informalexample>
+
 </para>
 
    <sect3>