包的示例文件应该放在哪里？

Question

我正在构建一个用于在 Raspbian 上部署的 Debian 软件包。到目前为止，一切看起来都不错——我有库进入 /usr/libs，头文件进入 /usr/include 和变更日志进入 /usr/share/doc。从长远来看，我还将有一些实用程序进入 /usr/bin。

但是，我也有一些我想包含的代码示例。对于大多数 Raspbian 用户，我可以将它们放入 /home/pi/some-examples-we-all-love。但是，安装程序可能不是 pi 用户，并且默认的 pi 帐户可能已被删除。似乎是一个可怕的想法。

一种替代方法是将示例安装到 /tmp/some-examples-we-all-love 中，然后尝试找到调用 sudo 来安装软件包的用户的姓名，并使用 postinst 脚本复制到他们的主目录中，然后清理。但我不知道这是否真的可能。

另一种选择是将示例放在树中的其他位置，然后在 /usr/bin 中安装一个名为“install-the-lovely-examples”或类似的实用程序脚本，并要求用户在他们想要的任何目录中运行它安装的例子。然后脚本会将示例复制到他们喜欢的任何文件夹中，无论何时何地。它还具有充当伪备份的优势，以防用户对示例进行处理并希望从头开始重试。

我觉得第三个选项可能是最好的，但是示例文件应该存储在哪里？

Answer 1

例子应该进去/usr/share/doc/${package}/examples。这在Policy 部分 12.6 中有记录，您会在大多数 Debian 派生系统上找到此类示例。