diff src/syscalls.cc @ 14819:67b6b47a22f6

doc: Clarify docstrings for canonicalize_file_name, make_absolute_filename * syscalls.cc (canonicalize_file_name): Clarify docstring. * utils.cc (make_absolute_filename): Clarify docstring.
author Rik <octave@nomad.inbox5.com>
date Fri, 29 Jun 2012 13:38:28 -0700
parents eff4a5933e28
children 460a3c6d8bf1
line wrap: on
line diff
--- a/src/syscalls.cc	Fri Jun 29 08:45:54 2012 -0700
+++ b/src/syscalls.cc	Fri Jun 29 13:38:28 2012 -0700
@@ -1594,8 +1594,10 @@
 
 DEFUNX ("canonicalize_file_name", Fcanonicalize_file_name, args, ,
   "-*- texinfo -*-\n\
-@deftypefn {Built-in Function} {[@var{cname}, @var{status}, @var{msg}]} canonicalize_file_name (@var{name})\n\
-Return the canonical name of file @var{name}.\n\
+@deftypefn {Built-in Function} {[@var{cname}, @var{status}, @var{msg}] =} canonicalize_file_name (@var{fname})\n\
+Return the canonical name of file @var{fname}.  If the file does not exist\n\
+the empty string (\"\") is returned.\n\
+@seealso{make_absolute_filename, is_absolute_filename, is_rooted_relative_filename}\n\
 @end deftypefn")
 {
   octave_value_list retval;