From c76af87bd682696b8aaf6dc112eef781da72c85d Mon Sep 17 00:00:00 2001 From: Klaus Aehlig Date: Thu, 25 Aug 2022 10:49:21 +0200 Subject: tutorial/thrid-party-software: clarify tree refrence ... emphasizing that it constructs only a single artifact. In this way, we avoid confusion with globs (that are introduced later). --- doc/tutorial/third-party-software.org | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) (limited to 'doc/tutorial/third-party-software.org') diff --git a/doc/tutorial/third-party-software.org b/doc/tutorial/third-party-software.org index 2e1fb77e..5573716c 100644 --- a/doc/tutorial/third-party-software.org +++ b/doc/tutorial/third-party-software.org @@ -56,8 +56,10 @@ $ mkdir -p fmt-layer/src The directory ~include/fmt~ contains only header files. As we want all files in this directory to be included in the ~"header directory"~ target, we can safely -use the explicit ~TREE~ reference[fn:1], which collects /all/ directory contents -from ~"."~. Note that the ~TARGETS~ file is only part of the overlay, and +use the explicit ~TREE~ reference[fn:1], which collects, in a single +artifact (describing a directory) /all/ directory contents +from ~"."~ of the workspace root. Note that the ~TARGETS~ file is only part of +the overlay, and therefore will not be part of this tree. Furthermore, this tree should be staged to ~"fmt"~, so that any consumer can include those headers via ~~. The resulting header directory target ~"hdrs"~ in ~include/fmt/TARGETS~ should be -- cgit v1.2.3