Hi, don't be so fast with closing this bug! If you fail to operate my software then I'd consider that a bug in my documentation. Even more so, when the person making the mistake is a fellow DD!
Quoting Samuel Thibault (2025-08-23 09:31:01) > > mmdebstrap --arch=hurd-i386 '' chroot.tar "deb > > http://ftp.ports.debian.org/debian-ports/ unstable main" "deb > > http://ftp.ports.debian.org/debian-ports/ unreleased main" > > Wow, I didn't know you could pass an empty suite and several mirrors. > That is not really clear from man mmdebstrap. The main hint is in the synopsis at the very top of the man page: | SYNOPSIS | mmdebstrap [OPTION...] [SUITE [TARGET [MIRROR...]]] >From there you can also see that SUITE is even completely optional. You only need to pass the empty string if you *also* want to specify a TARGET. The order of these arguments is copied from debootstrap to make the tool a bit more familiar. > Probably the second > paragraph of the DESCRIPTION should explicitly mention this use case. The second paragraph is about the SUITE parameter and an empty SUITE value is not only interesting when using the apt sources entry. Instead it says: | The value of the I<SUITE> argument will be used to determine which apt index to | use for finding out the set of C<Essential:yes> packages and/or the set of | packages with the right priority for the selected variant. This functionality | can be disabled by choosing the empty string for I<SUITE>. In case of debian ports you probably want an empty suite not because you are supplying information via the sources.list but rather because essential packages can also be part of the essential set, right? > Also, the "The MIRROR option" paragraph should at least start as "The > MIRROR options" You are completely correct. I now pushed this: https://gitlab.mister-muffin.de/josch/mmdebstrap/commit/fb4896cafbb8ee9b9dd0d7a0142bc795e0dc8af3 Maybe we also need more examples. I think hurd might be a bit too complex but how about this: mmdebstrap --variant=apt --arch=m68k \ --include="debian-ports-archive-keyring" \ '' m68k-chroot.tar \ "deb http://deb.debian.org/debian-ports/ unstable main" \ "deb http://deb.debian.org/debian-ports/ unreleased main" I'd also like to add a deb822 example now that apt wants to convert our sources to it but that's hard to write so that it becomes copy-pastable from the man page... Thanks! cheers, josch
signature.asc
Description: signature
