[backintime] Naming of documentation directory

[c . buhtz]

Hello together,
I am upstream maintainer of "Back In Time" (src package: backintime 
[1]).


The source package results in two binary packages "backintime-common" 
(the CLI) and "backintime-qt" (the GUI).

Based on that package naming two folders are created in /usr/share/doc/*

/usr/share/doc/backintime-common/
/usr/share/doc/backintime-qt/

I would like to ask if there is any convention or policy that would 
forbid to have a third folder like this?


/usr/share/doc/backintime/
/usr/share/doc/backintime-common/
/usr/share/doc/backintime-qt/

The reason is that the user itself is often not aware about the 
separation between "common" and "qt" and know this piece of software 
just as "backintime". The latter is also the name of the shell command.


More details. Here is a selection of files that get installed for both 
packages in /usr/share/doc/*


/usr/share/doc/backintime-common/LICENSE
/usr/share/doc/backintime-common/README.md.gz
/usr/share/doc/backintime-common/changelog.Debian.gz
/usr/share/doc/backintime-common/changelog.gz
/usr/share/doc/backintime-common/copyright
/usr/share/doc/backintime-common/examples/config-example-local.gz
/usr/share/doc/backintime-common/examples/config-example-ssh.gz

/usr/share/doc/backintime-qt/changelog.Debian.gz
/usr/share/doc/backintime-qt/changelog.gz
/usr/share/doc/backintime-qt/copyright

Especially the "example" files (config-example*) I would like to have in 
a general folder named "backintime". Currently I am adding (at upstream) 
some more other example files to the project.


Or would it make sense doing something like this?

/usr/share/doc/backintime/
/usr/share/doc/backintime/common/
/usr/share/doc/backintime/qt/

Thanks in advance.

Best regards,
Christian Buhtz

[1] -- 

Re: [backintime] Naming of documentation directory

[Boyuan Yang]

Hi,

Regarding https://lists.debian.org/debian-python/2024/10/msg00055.html :

Have you made this issue aware by the package maintainers and uploaders
as listed on https://tracker.debian.org/pkg/backintime ?

If not, please contact them first, ideally by submitting a Debian bug
report against source package backintime (and cc the maintainers).

Personally I believe renaming the binary package backintime-qt to
backintime could be a reasonable move, but I have zero control over it.
Only the package maintainers as listed on
https://tracker.debian.org/pkg/backintime can decide how to handle this issue.

Thanks,
Boyuan Yang


signature.asc
Description: This is a digitally signed message part