aboutsummaryrefslogtreecommitdiff
path: root/doc/packaging.cli
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2023-11-16 08:53:51 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2023-11-16 08:53:51 +0200
commit25ca13a52ed6a70e2ae4684505de92b6ab1277bd (patch)
treef1eb4d6d54dc89f539cb2ab5204fd59f27b4da20 /doc/packaging.cli
parent73f17691813548138aed2fb8d96c9130ab7025ca (diff)
Further work on packaging guide
Diffstat (limited to 'doc/packaging.cli')
-rw-r--r--doc/packaging.cli48
1 files changed, 48 insertions, 0 deletions
diff --git a/doc/packaging.cli b/doc/packaging.cli
index 53ecfbe..e9af520 100644
--- a/doc/packaging.cli
+++ b/doc/packaging.cli
@@ -1738,6 +1738,54 @@ subdirectory.
@@ TODO
+\h#howto-no-extension-header|How do I handle headers without extensions|
+
+If all the headers in a project have no extension, then you can simply
+specify the empty \c{extension} value for the \c{hxx{\}} target type
+in \c{build/root.build}:
+
+\
+hxx{*}: extension =
+cxx{*}: extension = cpp
+\
+
+Note, however, that using wildcard patterns for such headers in your
+\c{buildfile} is a bad idea since such a wildcard will most likely pick up
+other files that also have no extension (such as \c{buildfile}, executables on
+UNIX-like systems, etc). Instead, it's best to spell the names of such headers
+explicitly. For example, instead of:
+
+\
+lib{hello}: {hxx cxx}{*}
+\
+
+Write:
+
+\
+lib{hello}: cxx{*} hxx{hello}
+\
+
+If only some headers in a project have no extension, then it's best to specify
+the non-empty extension for the \c{extension} variable in \c{build/root.build}
+(so that you can still use wildcard for headers with extensions) and spell out
+the headers with no extension explicitly. Continuing with the above example,
+if we have both the \c{hello.hpp} and \c{hello} headers, then we can handle
+them like this:
+
+\
+hxx{*}: extension = hpp
+cxx{*}: extension = cpp
+\
+
+\
+lib{hello}: {hxx cxx}{*} hxx{hello.}
+\
+
+Notice the trailing dot in \c{hxx{hello.\}} \- this is the explicit \"no
+extension\" specification. See \l{b#targets Targets and Target Types}
+for details.
+
+
\h1#faq|Packaging FAQ|
\h#faq-alpha-stable|Why is my package in \c{alpha} rather than \c{stable}?|