howdy Julian, On 13-May-2020, Julian Andres Klode wrote:
> So I'd argue this needs some rewording to point the user a bit further > down if they want to delete deferred uploads (the distinction between > delayed and deferred is not particularly clear either, deferred is the > delayed target basically). The underlying problem here, IMO, is that the upload queue commands API is just not well documented at all. The ‘dcut(1)’ manual page is not the place to document that system; documenting it in this package runs the significant risk of divergence from the authoritative documentation that should reside in a location published by the FTP team. That should be done in the authoritative location for the FTP team, ideally <URL: https://ftp-master.debian.org/>. I think that improvement should be requested in a bug report to the ‘ftp.debian.org’ pseudo-package. With that said, yes we can do more to avoid the problem you encountered. The manual page ‘dcut(1)’ currently has a reference to the “Queue.README” document online (very difficult to discover, and should be better published; perhaps another bug report to ‘ftp.debian.org’ needed), citing that as the authoritative source for upload queue commands. I will resolve this bug report with two changes: * Make that reference to “Queue.README” more prominent. * Expand on the importance of it for understanding the queues and the queue commands. -- \ “The deepest sin against the human mind is to believe things | `\ without evidence.” —Thomas Henry Huxley, _Evolution and | _o__) Ethics_, 1893 | Ben Finney <[email protected]>
signature.asc
Description: PGP signature
