Bug#902942: systemd: please ship man/*.xml files

[Luca Boccassi]

Control: tags -1 wontfix
Control: close -1

On Tue, 03 Jul 2018 13:54:56 +0200 Dominique Dumont <dod at debian.org>
wrote:
> Package: systemd
> Version: 239-3
> Severity: wishlist
> 
> Dear Maintainer,
> 
> libconfig-model-systemd-perl provides a model so that cme command can
> check or edit some systemd configuration files. [1]
> 
> This systemd model is generated [2] from the systemd documentation
provided
> in man/*.xml (man pages are not used because they are much harder to
parse)
> 
> Currently this model is generated upstream and the generated model is
> shipped in the source tarball [3] of libconfig-model-systemd-perl.
> 
> To be compliant with Debian policy, libconfig-model-systemd-perl
package
> should:
> * drop systemd model from upstream tarball
> * regenerate systemd model from systemd xml files
> 
> The latter should be done using xml files shipped as binary package,
> either in systemd package (along the man pages) or in a systemd-
source
> package.
> 
> Could you ship these xml file in a binary package ?
> 
> All the best
> 
> [1]
https://github.com/dod38fr/config-model/wiki/Managing-systemd-configuration-with-cme
> [2]
https://github.com/dod38fr/config-model-systemd/blob/master/contrib/parse-man.pl
> [3]
https://cpan.metacpan.org/authors/id/D/DD/DDUMONT/Config-Model-Systemd-0.238.2.tar.gz

The manpages sources are an internal implementation details. They are
xml fed into docbook at the moment, but this is not a stable interface,
and in fact we are likely going to change to a different format. So it
is not advisable to build functionality to rely on them. If you really
want to, you can fetch the source package using apt, but I recommend
against it.

-- 
Kind regards,
Luca Boccassi
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: This is a digitally signed message part
URL: <http://alioth-lists.debian.net/pipermail/pkg-systemd-maintainers/attachments/20240526/89196def/attachment.sig>