# HG changeset patch
# User Philip Nienhuis <prnienhuis@users.sf.net>
# Date 1589217528 -7200
# Node ID 5bf3f462c11e4ebd629e69c13e6f97350134be70
# Parent  739f66d9107ee050e5965321241308d1b1164574
Document that make_absolute_filename and canonicalize_file_name do not
perform tilde expansion (bug #58326)

* syscalls.cc (Fcanonicalize_file_name): Document that tilde expansion is not
performed.  Add tilde_expand to @seealso list.
* utils.cc (Fmake_absolute_filename): Document that tilde expansion is not
performed.  Add tilde_expand to @seealso list.

diff -r 739f66d9107e -r 5bf3f462c11e libinterp/corefcn/syscalls.cc
--- a/libinterp/corefcn/syscalls.cc	Sun May 10 20:36:31 2020 +0200
+++ b/libinterp/corefcn/syscalls.cc	Mon May 11 19:18:48 2020 +0200
@@ -1334,8 +1334,9 @@
 @deftypefn {} {[@var{cname}, @var{status}, @var{msg}] =} canonicalize_file_name (@var{fname})
 Return the canonical name of file @var{fname}.
 
-If the file does not exist the empty string ("") is returned.
-@seealso{make_absolute_filename, is_absolute_filename, is_rooted_relative_filename, is_same_file}
+If the file does not exist the empty string ("") is returned.  No tilde
+expansion of @var{fname} is performed.
+@seealso{make_absolute_filename, is_absolute_filename, is_rooted_relative_filename, is_same_file, tilde_expand}
 @end deftypefn */)
 {
   if (args.length () != 1)
diff -r 739f66d9107e -r 5bf3f462c11e libinterp/corefcn/utils.cc
--- a/libinterp/corefcn/utils.cc	Sun May 10 20:36:31 2020 +0200
+++ b/libinterp/corefcn/utils.cc	Mon May 11 19:18:48 2020 +0200
@@ -1002,8 +1002,9 @@
 Return the full name of @var{file} beginning from the root of the file
 system.
 
-No check is done for the existence of @var{file}.
-@seealso{canonicalize_file_name, is_absolute_filename, is_rooted_relative_filename, isfolder}
+No check is done for the existence of @var{file}.  No tilde expansion of
+@var{file} is performed.
+@seealso{canonicalize_file_name, is_absolute_filename, is_rooted_relative_filename, isfolder, tilde_expand}
 @end deftypefn */)
 {
   if (args.length () != 1)