ru@ recently changed lorder to support library archives. Document

this new feature prominently.  Bump date while I'm here.
This commit is contained in:
Warner Losh 2006-04-27 15:48:54 +00:00
parent 9171a12bcd
commit 830de116de
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=158077

View File

@ -32,7 +32,7 @@
.\" @(#)lorder.1 8.2 (Berkeley) 4/28/95 .\" @(#)lorder.1 8.2 (Berkeley) 4/28/95
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd April 28, 1995 .Dd April 27, 2006
.Dt LORDER 1 .Dt LORDER 1
.Os .Os
.Sh NAME .Sh NAME
@ -47,6 +47,7 @@ The
utility uses utility uses
.Xr nm 1 .Xr nm 1
to determine interdependencies in the list of object files to determine interdependencies in the list of object files
and library archives
specified on the command line. specified on the command line.
The The
.Nm .Nm
@ -58,9 +59,16 @@ The output is normally used with
when a library is created to determine the optimum ordering of the when a library is created to determine the optimum ordering of the
object modules so that all references may be resolved in a single object modules so that all references may be resolved in a single
pass of the loader. pass of the loader.
.Pp
When linking static binaries,
.Nm
and
.Xr tsort 1
can be used to properly order library archives automatically.
.Sh EXAMPLES .Sh EXAMPLES
.Bd -literal -offset indent .Bd -literal -offset indent
ar cr library.a `lorder ${OBJS} | tsort` ar cr library.a `lorder ${OBJS} | tsort`
cc -o foo ${OBJS} `lorder ${STATIC_LIBS} | tsort`
.Ed .Ed
.Sh SEE ALSO .Sh SEE ALSO
.Xr ar 1 , .Xr ar 1 ,