From: Bruno Haible <bruno@clisp.org>
Date: Sun, 7 Apr 2024 11:48:14 +0000 (+0200)
Subject: gnulib-tool.py: Add comment.
X-Git-Tag: v1.0~152
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=4c5fb7d139691afce0aa44190751b1ea23cd60b1;p=thirdparty%2Fgnulib.git

gnulib-tool.py: Add comment.

* pygnulib/constants.py (joinpath): Document a limitation.
---

diff --git a/ChangeLog b/ChangeLog
index 201eafa9b5..e6c2b5cd20 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2024-04-07  Bruno Haible  <bruno@clisp.org>
+
+	gnulib-tool.py: Add comment.
+	* pygnulib/constants.py (joinpath): Document a limitation.
+
 2024-04-07  Collin Funk  <collin.funk1@gmail.com>
 
 	gnulib-tool.py: Don't allow path normalization to delete a variable.
diff --git a/pygnulib/constants.py b/pygnulib/constants.py
index 7a88c21c39..a07e473529 100644
--- a/pygnulib/constants.py
+++ b/pygnulib/constants.py
@@ -269,7 +269,10 @@ def cleaner(sequence: str | list[str]) -> str | list[str | bool]:
 def joinpath(head: str, *tail: str) -> str:
     '''Join two or more pathname components, inserting '/' as needed. If any
     component is an absolute path, all previous path components will be
-    discarded.'''
+    discarded.
+    This function also replaces SUBDIR/../ with empty; therefore it is not
+    suitable when some of the pathname components use Makefile variables
+    such as '$(srcdir)'.'''
     newtail = []
     for item in tail:
         newtail += [item]