https://gcc.gnu.org/bugzilla/show_bug.cgi?id=69540
Bug ID: 69540 Summary: add a short info on .so priority in -l Product: gcc Version: 6.0 Status: UNCONFIRMED Keywords: documentation Severity: normal Priority: P3 Component: c Assignee: unassigned at gcc dot gnu.org Reporter: arkadiusz at drabczyk dot org Target Milestone: --- Not a big thing but just to limit a discrepancy between what gcc says and what it actually does I think it's a good idea to add a few words about .so to a description of -l in gcc/doc/invoke.texi. Currently only .a files are mentioned but in fact not only are .so also searched but have priority over .a. It could be something like: "The only difference between using an @option{-l} option and specifying a file name is that @option{-l} surrounds @var{library} with @samp{lib} and @samp{.so} on systems with shared libraries support or with @samp{.a} if @var{library} with @samp{.so} is not found and on all other system and searches several directories." Anybody who needs more details will look into ld manual anyway.