Policy 12.3 + <pkg>.docs
hi,
I am currently upgrading simplyhtml from standards-version 3.9.6 to
3.9.8, and stumbled over this:
12.3
recommend to ship additional documentation for package `pkg' in a
separate package `pkg-doc' and install it into
`/usr/share/doc/pkg'.
§ 12.3 says at the end:
"However, installing the documentation into the documentation directory
of the main package is preferred since it is independent of the
packaging method and will be easier for users to find."
Now I have in the simplyhtml package
(http://anonscm.debian.org/cgit/pkg-java/simplyhtml.git):
simplyhtml-doc.docs:
build/docs/javadoc/
--> this creates a simplyhtml-doc package like this:
/.
/usr
/usr/share
/usr/share/doc-base
/usr/share/doc-base/simplyhtml-doc
/usr/share/doc
/usr/share/doc/simplyhtml-doc
/usr/share/doc/simplyhtml-doc/copyright
/usr/share/doc/simplyhtml-doc/javadoc
/usr/share/doc/simplyhtml-doc/javadoc/overview-tree.html
/usr/share/doc/simplyhtml-doc/javadoc/allclasses-frame.html
/usr/share/doc/simplyhtml-doc/javadoc/deprecated-list.html
/usr/share/doc/simplyhtml-doc/javadoc/com
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/SHTMLDocument.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/ActionBuilder.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/SHTMLPanel.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/AbstractPlugin.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/SplashScreen.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/SHTMLEditorPane.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/SHTMLEditorKit.SHTMLFactory.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/SHTMLWriter.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/SHTMLPlugin.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/package-summary.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/SHTMLEditorKit.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/DefaultTextResources.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/SHTMLDocument.SHTMLReader.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/Util.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/App.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/SHTMLPanelImpl.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/package-tree.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/SHTMLEditorPane.PasteMode.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/SHTMLPrefsChangeListener.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/package-frame.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/SHTMLAction.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/ScaledStyleSheet.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/NamedObject.html
/usr/share/doc/simplyhtml-doc/javadoc/com/lightdev/app/shtm/TextResources.html
/usr/share/doc/simplyhtml-doc/javadoc/com/sun
/usr/share/doc/simplyhtml-doc/javadoc/com/sun/demo
/usr/share/doc/simplyhtml-doc/javadoc/com/sun/demo/ElementTreePanel.html
/usr/share/doc/simplyhtml-doc/javadoc/com/sun/demo/package-summary.html
/usr/share/doc/simplyhtml-doc/javadoc/com/sun/demo/ExampleFileFilter.html
/usr/share/doc/simplyhtml-doc/javadoc/com/sun/demo/package-tree.html
/usr/share/doc/simplyhtml-doc/javadoc/com/sun/demo/package-frame.html
/usr/share/doc/simplyhtml-doc/javadoc/com/sun/demo/ElementTreePanel.ElementTreeModel.html
/usr/share/doc/simplyhtml-doc/javadoc/help-doc.html
/usr/share/doc/simplyhtml-doc/javadoc/overview-summary.html
/usr/share/doc/simplyhtml-doc/javadoc/de
/usr/share/doc/simplyhtml-doc/javadoc/de/calcom
/usr/share/doc/simplyhtml-doc/javadoc/de/calcom/cclib
/usr/share/doc/simplyhtml-doc/javadoc/de/calcom/cclib/text
/usr/share/doc/simplyhtml-doc/javadoc/de/calcom/cclib/text/PseudoDamerauLevenshtein.Type.html
/usr/share/doc/simplyhtml-doc/javadoc/de/calcom/cclib/text/PseudoDamerauLevenshtein.html
/usr/share/doc/simplyhtml-doc/javadoc/de/calcom/cclib/text/package-summary.html
/usr/share/doc/simplyhtml-doc/javadoc/de/calcom/cclib/text/FindReplaceEvent.html
/usr/share/doc/simplyhtml-doc/javadoc/de/calcom/cclib/text/PseudoDamerauLevenshtein.Alignment.html
/usr/share/doc/simplyhtml-doc/javadoc/de/calcom/cclib/text/package-tree.html
/usr/share/doc/simplyhtml-doc/javadoc/de/calcom/cclib/text/FindReplaceDialog.html
/usr/share/doc/simplyhtml-doc/javadoc/de/calcom/cclib/text/FindReplaceListener.html
/usr/share/doc/simplyhtml-doc/javadoc/de/calcom/cclib/text/package-frame.html
/usr/share/doc/simplyhtml-doc/javadoc/overview-frame.html
/usr/share/doc/simplyhtml-doc/javadoc/allclasses-noframe.html
/usr/share/doc/simplyhtml-doc/javadoc/serialized-form.html
/usr/share/doc/simplyhtml-doc/javadoc/script.js
/usr/share/doc/simplyhtml-doc/javadoc/package-list
/usr/share/doc/simplyhtml-doc/javadoc/constant-values.html
/usr/share/doc/simplyhtml-doc/javadoc/index.html
/usr/share/doc/simplyhtml-doc/javadoc/stylesheet.css
/usr/share/doc/simplyhtml-doc/javadoc/index-all.html
/usr/share/doc/simplyhtml-doc/changelog.Debian.gz
--> Is there a way to change the destination of <package>.docs files?
to satisfy the policy?
(looks like dh_installdocs always installs into /usr/share/doc/<docpkg>)
Thanks and Best Regards,
--
Felix Natter
Reply to: