On Wed, 19 Sep 2012 22:14:06 Jakub Wilk wrote:
> >I've noticed that even if I pass "usr/share/{packagename}/help" as
> >argument to dh_sphinxdoc it can't find documentation so I have to pass
> >"usr/share/{packagename}/help/{lang}" as many times as I have
> >translations to process.
>
> This is intentional.
OK but why is it intentional??
> >At the moment to avoid passing multiple arguments to dh_sphinxdoc I've
> >changed location for docs files to "usr/share/doc/{packagename}/help"
> >where dh_sphinxdoc found all the translations automatically without any
> >additional arguments.
>
> What's wrong with passing multiple arguments?
Poor maintainability. Whenever upstream adds new language/translation I need
to add argument to dh_sphinxdoc.
> >Perhaps you would agree that it is a bit inconvenient to change docs
> >install location together with introducing a compatibility symlink just
> >to overcome this little limitation in dh_sphinxdoc.
>
> It's certainly something wrong when you change the package contents to
> make the packaging tools work better. But it's not necessarily the tools
> that are at fault…
To show that dh_sphinxdoc recursively scan and process
/usr/share/doc/{packagename} for all nested sphinx-generated help
translations.
If some sphinx-generated content goes to
/usr/share/{packagename}/help/{fr,de,en,etc.} there is no way to handle all of
them with one call to dh_sphinxdoc like it is possible for
/usr/share/doc/{packagename}/help/{fr,de,en,etc.}
> What is this compatiblity symlink for? If your package actually accesses
> files in /usr/share/{packagename}/help/, then it sounds like a violation
> of Policy §12.3 (“packages must not require the existence of any files in
> /usr/share/doc/ in order to function”).
Right, thanks for reminding. This explains that moving folder with
translations is not an option. So we're back to the limitation I'm talking
about. How to process multiple instances of sphinx doc in one call if content
is in /usr/share/{packagename}?
Thank you.
Regards,
Dmitry.
--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
