gnulib-tool.py: Add comment.

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

diff --git a/ChangeLog b/ChangeLog
index 201eafa9b582c78fbd07d9648045bf30321060ee..e6c2b5cd20f13fedae0f734e1b0f5a628c86c6b6 100644 (file)
--- 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 7a88c21c3977cce020195944c696ccbcd0804172..a07e47352904395bacb75b1e699a8e68bddc9f53 100644 (file)
--- 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]