On Mon, 11 Sep 2023, 17:58 Russ Allbery, <r...@debian.org> wrote: > Luca Boccassi <bl...@debian.org> writes: > > > Two more things went missing: Simon's suggestion on the versioned > > dependencies on the virtual packages, > > Ah, yes, I'm sorry, I talked myself out of that and then completely forgot > the previous discussion so didn't say anything. > > My concern is that it felt like we were providing a detailed description > of an entirely normal dependency management situation (you always have to > depend on the version of a package you use that provides the interface > you're using unless it's old enough that it doesn't matter), and I wasn't > sure what was special about this one that warranted spelling that out > other than the need to add the version constraint to both stanzas. So I > kept that part but omitted the rest. > > The phrasing Simon proposed I think would be appropriate if we thought > most packages would need a version constraint, but I didn't think the > functionality was changing that quickly. Am I wrong about that? It felt > awkward to include the version constraints and then tell people to remove > them if they're going to be able to remove them 95% of the time, but I > don't know if that's the case. > > Maybe the right way to do this is just have two examples, one as the > default and another if you're using tmpfiles.d functionality added in a > specific version of systemd that's newer than the version shipped with the > stable version of Debian prior to the one you're targeting. >
Ok, I have no opinion either way and am fine with the solution you and Simon agree on > and the link from the tmpfiles section to the service directory section > > (given it was moved). > > It's there (last sentence): > > +If the files or directories are only needed by a system service or > +otherwise should only be created when that service is running, packages > +should define those files and directories in the ``systemd`` unit for the > +service (and, for alternative init systems, in the configuration for that > +init system) instead of using the ``tmpfiles.d`` mechanism. See > +:ref:`s-services-dirs` for more details. > > You don't need to spell out the section title; Sphinx defaults to adding > that for you based on the heading that you're linking to. (I think we are > excessively explicit in a bunch of places in Policy currently due to a > conversion artifact from DebianDoc-XML.) > Got it, thanks >