From f80c8ff7ff3b1eef22a3c90943f324d45d855b97 Mon Sep 17 00:00:00 2001
From: Boris Kolpackov <boris@codesynthesis.com>
Date: Wed, 16 Nov 2022 07:52:11 +0200
Subject: Initial low verbosity diagnostics rework

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

(limited to 'libbuild2/algorithm.hxx')

diff --git a/libbuild2/algorithm.hxx b/libbuild2/algorithm.hxx
index 756c3fe..e9245f4 100644
--- a/libbuild2/algorithm.hxx
+++ b/libbuild2/algorithm.hxx
@@ -930,6 +930,8 @@ namespace build2
   // Update/clean a backlink issuing appropriate diagnostics at appropriate
   // levels depending on the overload and the changed argument.
   //
+  // Note that these functions assume (target.leaf() == link.leaf ()).
+  //
   enum class backlink_mode
   {
     link,      // Make a symbolic link if possible, hard otherwise.
@@ -952,6 +954,8 @@ namespace build2
                    bool changed,
                    backlink_mode = backlink_mode::link);
 
+  // Note: verbosite should be 2 or greater.
+  //
   LIBBUILD2_SYMEXPORT void
   update_backlink (context&,
                    const path& target,
@@ -959,6 +963,8 @@ namespace build2
                    backlink_mode = backlink_mode::link,
                    uint16_t verbosity = 3);
 
+  // Note: verbosite should be 2 or greater.
+  //
   LIBBUILD2_SYMEXPORT void
   clean_backlink (context&,
                   const path& link,
-- 
cgit v1.1