* at-file.texi: New file.

diff --git a/libiberty/ChangeLog b/libiberty/ChangeLog
index 5aa21740578346fe5e5e5f88e280a29b35ad451f..23aae90067ad8ed460ab66e7c78dbbba9556d184 100644 (file)
--- a/libiberty/ChangeLog
+++ b/libiberty/ChangeLog
@@ -1,3 +1,7 @@
+2005-10-03  Mark Mitchell  <mark@codesourcery.com>
+
+       * at-file.texi: New file.
+
 2005-09-27  Mark Mitchell  <mark@codesourcery.com>
 
        * argv.c (expandargv): Do not use xmalloc_failed.

diff --git a/libiberty/at-file.texi b/libiberty/at-file.texi
new file mode 100644 (file)
index 0000000..567fbf5
--- /dev/null
+++ b/libiberty/at-file.texi
@@ -0,0 +1,16 @@
+@c This file is designed to be included in manuals that use 
+@c expandargv.
+
+@item @@@var{file}
+Read command-line options from @var{file}.  The options read are
+inserted in place of the original @@@var{file} option.  If @var{file}
+does not exist, or cannot be read, then the option will be treated
+literally, and not removed.  
+
+Options in @var{file} are separated by whitespace.  A whitespace
+character may be included in an option by surrounding the entire
+option in either single or double quotes.  Any character (including a
+backslash) may be included by prefixing the character to be included
+character with a backslash.  The @var{file} may itself contain
+additional @@@var{file} options; any such options will be processed
+recursively.