[Bug 1929239] [NEW] debootstrap documentation bug

[Bill Yikes]

Public bug reported:

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.

** Affects: debootstrap (Ubuntu)
     Importance: Undecided
         Status: New

-- 
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