[Bug 1929239] Re: debootstrap documentation bug

[Bill Yikes]

There is also a problem with the man page, which says:

       --second-stage
              Complete the bootstrapping process.  Other arguments are generally not needed.

To "complete the bootstrapping process" is vague.  Naturally everyone
wants to complete the bootstrapping process.  But according to
https://www.debian.org/releases/bullseye/arm64/apds03.en.html, the
--second-stage is *only* for situations where the installation host and
the target host have different architectures.  The man page needs to be
more clear.

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to debootstrap in Ubuntu.
https://bugs.launchpad.net/bugs/1929239

Title:
  debootstrap documentation bug

Status in debootstrap package in Ubuntu:
  New

Bug description:
  The documentation for debootstrap is broken and also needs
  reorganization.  It lives here:

  https://www.debian.org/releases/bullseye/arm64/apds03.en.html

  To put this in "Appendix D: Random Bits" is a bit unsettling.  It
  should have a chapter of its own sitting in parallel to the installer
  guides.

  The main bug is telling users to run commands inside chroot that must
  run outside of chroot.  The first paragraph says: "$ symbolizes a
  command to be entered in the user's current system, while # refers to
  a command entered in the Debian chroot."  Then every command given on
  that page follows a hash.  E.g. "# mke2fs -j /dev/sda6".  That's
  impossible.  You can't chroot before you have a filesystem.

  Normally the best place to report this would be the "www.debian.org"
  /project/ in the Debian bug tracker, but the Debian bug tracker only
  function by email and last time I checked the mail server did not
  accept email from me.  If someone would mirror this upstream it would
  be appreciated.

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/debootstrap/+bug/1929239/+subscriptions