From: Mark Mitchell <mark@codesourcery.com>
Date: Tue, 4 Oct 2005 05:34:17 +0000 (+0000)
Subject: 	* at-file.texi: New file.
X-Git-Url: http://git.efficios.com/?a=commitdiff_plain;h=7b96829ccc499ace9643b8e04ff531a4a0985c51;p=deliverable%2Fbinutils-gdb.git

	* at-file.texi: New file.
---

diff --git a/libiberty/ChangeLog b/libiberty/ChangeLog
index 5aa2174057..23aae90067 100644
--- 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
index 0000000000..567fbf5bce
--- /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.