From: Paul Eggert <eggert@cs.ucla.edu>
Date: Sun, 1 Sep 2002 10:26:58 +0000 (+0000)
Subject: (Limitations of Usual Tools): Add "ls".
X-Git-Tag: AUTOCONF-2.53c~14
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=9d9085f803137c0dd4980a67b7cc7ff7213e64d1;p=thirdparty%2Fautoconf.git

(Limitations of Usual Tools): Add "ls".
---

diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 7f0d158a9..6bddbde13 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -10070,6 +10070,22 @@ works for executables, so @samp{cp -p} is used instead for these
 systems.  DJGPP versions 2.04 and later have full symlink support.
 
 
+@item @command{ls}
+@c ---------------
+@prindex @command{ls}
+@cindex Listing directories
+The portable options are @option{-acdilrtu}.  Modern practice is for
+@option{-l} to output both owner and group, but traditional
+@command{ls} omits the group.
+
+Modern practice is for all diagnostics to go to standard error, but
+traditional @samp{ls foo} prints the message @samp{foo not found} to
+standard output if @file{foo} does not exist.  Be careful when writing
+shell commands like @samp{sources=`ls *.c 2>/dev/null`}, since with
+traditional @command{ls} this is equivalent to @samp{sources="*.c not
+found"} if there are no @samp{.c} files.
+
+
 @item @command{mkdir}
 @c ------------------
 @prindex @command{mkdir}