Complete and cleanup function documentation in preparation for auto-extraction

Also:

- Move the $target.*() function family from functions-name.cxx to separate
  functions-target.cxx.

- Get rid of the separate $process_path_ex.*() family, merging it with
  $process_path.*().

1 files changed, 11 insertions, 0 deletions

diff --git a/libbuild2/functions-target-triplet.cxx b/libbuild2/functions-target-triplet.cxx
index b89cadf..6e12c97 100644
--- a/libbuild2/functions-target-triplet.cxx
+++ b/libbuild2/functions-target-triplet.cxx
@@ -13,6 +13,12 @@ namespace build2
   {
     function_family f (m, "target_triplet");
 
+    // $string(<target-triplet>)
+    //
+    // Return the canonical (that is, without the `unknown` vendor component)
+    // target triplet string.
+    //
+
     // Note that we must handle NULL values (relied upon by the parser
     // to provide conversion semantics consistent with untyped values).
     //
@@ -21,6 +27,11 @@ namespace build2
       return t != nullptr ? t->string () : string ();
     };
 
+    // $representation(<target-triplet>)
+    //
+    // Return the complete target triplet string that always contains the
+    // vendor component.
+    //
     f["representation"] += [](target_triplet t)
     {
       return t.representation ();