PR/12058: Document the 's' command to ar

PR/12058: Document the 's' command to ar

[Nick Clifton]

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