2003-04-23  Simon Law  <sfllaw@uwaterloo.ca>

	* doc/cppopts.texi (-Wall): Clarify the comment about default 
	warnings.

	* doc/invoke.texi (-l): Re-word the section on POSIX compliance.
	Mention the linker's preference for shared libraries.

Index: cppopts.texi
===================================================================
RCS file: /cvsroot/gcc/gcc/gcc/doc/cppopts.texi,v
retrieving revision 1.15.8.2
diff -u -r1.15.8.2 cppopts.texi
--- cppopts.texi	16 Mar 2003 14:13:10 -0000	1.15.8.2
+++ cppopts.texi	24 Apr 2003 01:42:15 -0000
@@ -72,7 +72,7 @@
 Turns on all optional warnings which are desirable for normal code.  At
 present this is @option{-Wcomment} and @option{-Wtrigraphs}.  Note that
 many of the preprocessor's warnings are on by default and have no
-options to control them.
+options to control them individually.
 
 @item -Wcomment
 @itemx -Wcomments
--- invoke.texi.orig	2003-04-23 21:33:14.000000000 -0400
+++ invoke.texi	2003-04-23 21:45:08.000000000 -0400
@@ -4510,8 +4510,8 @@
 @itemx -l @var{library}
 @opindex l
 Search the library named @var{library} when linking.  (The second
-alternative with the library as a separate argument is only for
-POSIX compliance and is not recommended.)
+alternative, naming the library as a separate argument, is only 
+provided for POSIX compliance and is @emph{not} recommended.)
 
 It makes a difference where in the command you write this option; the
 linker searches and processes libraries and object files in the order they
@@ -4519,7 +4519,11 @@
 after file @file{foo.o} but before @file{bar.o}.  If @file{bar.o} refers
 to functions in @samp{z}, those functions may not be loaded.
 
-The linker searches a standard list of directories for the library,
+The linker searches a standard list of directories for the library.
+First, it looks for a shared library, unless @option{-static} is 
+supplied.  If it finds a shared library, whose name is architecture 
+dependent, it links the object file with the shared library.
+Failing to find a shared library, it resorts to looking for a static 
+version,
 which is actually a file named @file{lib@var{library}.a}.  The linker
 then uses this file as if it had been specified precisely by name.