- Additional documentation for <var>package</var>, whether the
- documentation is packaged separately or not, should be
- installed to the directory
- <file>/usr/share/doc/<var>package</var></file> or its
- subdirectories.<footnote>
- Rationale: Once installed, the separation of the
- documentation packaging should be invisible to the user,
- and the documentation should be found in the expected
- location for the main binary package.
- </footnote>
+ If a package comes with large amounts of documentation that many
+ users of the package will not require, you should create a
+ separate binary package to contain it so that it does not take
+ up disk space on the machines of users who do not need or want
+ it installed. As a special case of this rule, shared library
+ documentation of any appreciable size should always be packaged
+ with the library development package (<ref id="sharedlibs-dev">)
+ or in a separate documentation package, since shared libraries
+ are frequently installed as dependencies of other packages by
+ users who have little interest in documentation of the library
+ itself. The documentation package for the
+ package <var>package</var> is conventionally
+ named <var>package</var>-doc
+ (or <var>package</var>-doc-<var>language-code</var> if there are
+ separate documentation packages for multiple languages).