summaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
authorKieran Bingham <kieran.bingham@ideasonboard.com>2022-10-01 00:28:23 +0100
committerKieran Bingham <kieran.bingham@ideasonboard.com>2022-10-13 12:40:23 +0100
commit0aac297afd0cf2748c20f919bdd8d5e390b8d9a8 (patch)
treeae960b5c71a356fa8b1075c6dcae27edd28e6585 /Documentation
parentcfe30ec54f586a54a24612125402b57b2263bdc9 (diff)
meson: Shared Object version handling
The libcamera project is not yet ready to declare ABI nor API stability, but it will benefit the community to be able to provide more regular release cycles to determine 'versioned' points of history. Ideally, these releases will be made at any ABI breakage, but can be made at arbitary time based points along the way. To support releases which may not be ABI stable, declare the soversion of both the libcamera and libcamera-base library to be dependant upon both the major minor and patch component of the project version. As part of this, introduce a new 'Versions' summary section to highlight the different version components that may become apparent within any given build. Bumping versions may leave dangling libcamera.so.* symlinks in build directories. This will confuse Doxygen which will print during its directory scanning phase a warning that the symlink can't be read. As we don't need Doxygen to follow symlinks, disable it with EXCLUDE_SYMLINKS. Reviewed-by: Jacopo Mondi <jacopo@jmondi.org> Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com> Signed-off-by: Kieran Bingham <kieran.bingham@ideasonboard.com>
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/Doxyfile.in2
1 files changed, 2 insertions, 0 deletions
diff --git a/Documentation/Doxyfile.in b/Documentation/Doxyfile.in
index 88dfcdda..e4f0cd42 100644
--- a/Documentation/Doxyfile.in
+++ b/Documentation/Doxyfile.in
@@ -66,6 +66,8 @@ EXCLUDE_SYMBOLS = libcamera::BoundMethodArgs \
*::details \
std::*
+EXCLUDE_SYMLINKS = YES
+
HTML_OUTPUT = api-html
GENERATE_LATEX = NO