This is the mail archive of the
binutils@sourceware.org
mailing list for the binutils project.
PR/12058: Document the 's' command to ar
- From: Nick Clifton <nickc at redhat dot com>
- To: binutils at sourceware dot org
- Date: Fri, 29 Oct 2010 12:09:28 +0100
- Subject: PR/12058: Document the 's' command to ar
Hi Guys,
I have checked in the patch below in order to document the 's' command
letter that is accepted by the ar command.
Cheers
Nick
binutils/ChangeLog
2010-10-29 Nick Clifton <nickc@redhat.com>
PR binutils/12058
* ar.c (usage): Revert previous change. Describe how 's' can be
used as a command letter.
* doc/binutils.texi (ar cmdline): Describe how 's' can be used as
a command letter.
Index: binutils/ar.c
===================================================================
RCS file: /cvs/src/src/binutils/ar.c,v
retrieving revision 1.66
diff -u -3 -p -r1.66 ar.c
--- binutils/ar.c 28 Oct 2010 14:11:29 -0000 1.66
+++ binutils/ar.c 29 Oct 2010 08:45:14 -0000
@@ -230,9 +230,9 @@ usage (int help)
/* xgettext:c-format */
const char * command_line =
#if BFD_SUPPORTS_PLUGINS
- _("Usage: %s [emulation options] [--plugin <name>] [-]{dmpqrtx}[abcfilNoPsSuvV] [member-name] [count] archive-file file...\n");
+ _("Usage: %s [emulation options] [--plugin <name>] [-]{dmpqrstx}[abcfilNoPsSuvV] [member-name] [count] archive-file file...\n");
#else
- _("Usage: %s [emulation options] [-]{dmpqrtx}[abcfilNoPsSuvV] [member-name] [count] archive-file file...\n");
+ _("Usage: %s [emulation options] [-]{dmpqrstx}[abcfilNoPsSuvV] [member-name] [count] archive-file file...\n");
#endif
fprintf (s, command_line, program_name);
@@ -244,6 +244,7 @@ usage (int help)
fprintf (s, _(" p - print file(s) found in the archive\n"));
fprintf (s, _(" q[f] - quick append file(s) to the archive\n"));
fprintf (s, _(" r[ab][f][u] - replace existing or insert new file(s) into the archive\n"));
+ fprintf (s, _(" s - act as ranlib\n"));
fprintf (s, _(" t - display contents of archive\n"));
fprintf (s, _(" x[o] - extract file(s) from the archive\n"));
fprintf (s, _(" command specific modifiers:\n"));
Index: binutils/doc/binutils.texi
===================================================================
RCS file: /cvs/src/src/binutils/doc/binutils.texi,v
retrieving revision 1.171
diff -u -3 -p -r1.171 binutils.texi
--- binutils/doc/binutils.texi 10 Sep 2010 12:11:27 -0000 1.171
+++ binutils/doc/binutils.texi 29 Oct 2010 08:45:16 -0000
@@ -345,6 +345,13 @@ output for each file inserted, along wit
@samp{r} to indicate whether the file was appended (no old member
deleted) or replaced.
+@item s
+@cindex ranlib
+Add an index to the archive, or update it if it already exists. Note
+this command is an exception to the rule that there can only be one
+command letter, as it is possible to use it as either a command or a
+modifier. In either case it does the same thing.
+
@item t
@cindex contents of archive
Display a @emph{table} listing the contents of @var{archive}, or those