#1071652 Man page forgets to mention actual --second-stage usage

Package:
debootstrap
Source:
debootstrap
Submitter:
Date:
2024-05-23 03:51:04 UTC
Severity:
normal
#1071652#5
Date:
2024-05-23 03:22:46 UTC
From:
To:
Man page says:
       --second-stage
              Complete  the bootstrapping process.  Other arguments are generally not needed.

Well one cannot just run these two in sequence:
SYNOPSIS
       debootstrap [OPTION...]  SUITE TARGET [MIRROR [SCRIPT]]
       debootstrap [OPTION...]  --second-stage

On https://unix.stackexchange.com/a/355197/179494 we see the answer.
Therefore the man page must kindly also mention: "to run the second stage,
chroot to where you've unpacked the archive, and run
/debootstrap/debootstrap --second-stage
"
#1071652#10
Date:
2024-05-23 03:50:10 UTC
From:
To:
As a matter of fact, the solution I posted doesn't work either.

Therefore, be sure on the man page, to mention the true sequence needed:

# debootstrap ....
(missing step goes here)
# debootstrap --second-stage