aboutsummaryrefslogtreecommitdiffstats
path: root/manual/packaging.rst
diff options
context:
space:
mode:
authorJay Berkenbilt <jberkenbilt@users.noreply.github.com>2023-06-17 20:02:44 +0200
committerGitHub <noreply@github.com>2023-06-17 20:02:44 +0200
commit463953bc96ead56227ef3dbf62639eb7e3545ab4 (patch)
tree357065933d636effd8a2651571eb2c02e22a847c /manual/packaging.rst
parent9b09436ce1f7427570f1016d02e7bf2bed4479f4 (diff)
parent13761120b1dbe126a9d39b9439086b76b4860b27 (diff)
downloadqpdf-463953bc96ead56227ef3dbf62639eb7e3545ab4.tar.zst
Merge pull request #992 from jberkenbilt/future
Future
Diffstat (limited to 'manual/packaging.rst')
-rw-r--r--manual/packaging.rst6
1 files changed, 6 insertions, 0 deletions
diff --git a/manual/packaging.rst b/manual/packaging.rst
index 1bd89758..ca32554a 100644
--- a/manual/packaging.rst
+++ b/manual/packaging.rst
@@ -26,6 +26,12 @@ particularly useful to packagers.
combined with either ``ctest --verbose`` or ``ctest
--output-on-failure``.
+- Packagers should never define the ``FUTURE`` build option. API
+ changes enabled by ``FUTURE`` are not stable and may be
+ API/ABI-breaking. That option is intended only for people who are
+ testing their code with a local build of qpdf to provide early
+ feedback or prepare for possible future changes to the API.
+
- qpdf's install targets do not install completion files by default
since there is no standard location for them. As a packager, it's
good if you install them wherever your distribution expects such