Hi Marc, Quoting Marc Haber (2025-02-16 13:31:49) > sbuild's README.Debian dates back to 2006 and mentions features that will be > removed with the release of Lenny. I don't know how many people will continue > reading after this. > > The manual pages look like they have been touched since their last > copyright date which also dates back to the 2000-and-zero years, but > they also mention Debian releases that have been archived for years. And > they are not quite helpful with the more modern features such as > unshare. > > I understand that sbuild is a tool that is mainly used by experts that > don't need proper docs, but I have for example avoided sbuild for more > than a decade because I never took the time to find out which of the > external docs that are available might be more helpful than the docs > that come with the package.
thank you for reaching out. This is very similar to #1080194. The thing I have mostly been working on the past few months was to improve the sbuild-out-of-the-box experience. Ideally, for a first-time user of sbuild, they would have to do only these steps: $ sudo apt install sbuild $ cd ./unpacked-pkg $ subild --chroot-mode=unshare And this will work today. The wiki page describes some of that already, but the goal is to turn the man page into the primary source of documentation and then let the wiki only document crafty hacks on top of that. The above works because recently sbuild gained a chroot manager which will automatically create and upgrade chroot tarballs for you, if you use the unshare backend. This feature is still marked as experimental and in the last few releases I did change some small things here and there as I got feedback from sbuild users in how they would like to use and configure this new functionality. But things are stabilizing. So I intend to do a major rewrite of the first part of the man page for Trixie. If you have any feedback for the sbuild unshare mode and chroot manager, I'd like to hear it. Is there something that you'd like to see in sbuild's README.Debian? Thanks! cheers, josch
signature.asc
Description: signature
