From d0d4486702b045852dca36008746afeb8754ae85 Mon Sep 17 00:00:00 2001
From: Boris Kolpackov <boris@codesynthesis.com>
Date: Wed, 1 Nov 2023 11:50:08 +0200
Subject: Tighten/optimize cleaning of fsdir{} during match

---
 libbuild2/algorithm.hxx | 5 +++++
 1 file changed, 5 insertions(+)

(limited to 'libbuild2/algorithm.hxx')

diff --git a/libbuild2/algorithm.hxx b/libbuild2/algorithm.hxx
index 19f7db2..11e655b 100644
--- a/libbuild2/algorithm.hxx
+++ b/libbuild2/algorithm.hxx
@@ -740,6 +740,11 @@ namespace build2
   // cleaning to normal execute and these functions should only be used in
   // special cases where this is not possible.
   //
+  // Note also that neither function should be called on fsdir{} since it's
+  // hard to guarantee such an execution won't be too early (see the
+  // implementation for details). If you do need to clean fsdir{} during
+  // match, use fsdir_rule::perform_clean_direct() instead.
+  //
   LIBBUILD2_SYMEXPORT bool
   clean_during_match (tracer&,
                       action, const target&);
-- 
cgit v1.1