From 2bb461105df66bc63d4f980d9c31d7cc6b69a841 Mon Sep 17 00:00:00 2001
From: imp <imp@FreeBSD.org>
Date: Thu, 27 Apr 2006 15:48:54 +0000
Subject: ru@ recently changed lorder to support library archives.  Document
 this new feature prominently.  Bump date while I'm here.

---
 usr.bin/lorder/lorder.1 | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

(limited to 'usr.bin/lorder/lorder.1')

diff --git a/usr.bin/lorder/lorder.1 b/usr.bin/lorder/lorder.1
index 6cced8f..20ac7e0 100644
--- a/usr.bin/lorder/lorder.1
+++ b/usr.bin/lorder/lorder.1
@@ -32,7 +32,7 @@
 .\"     @(#)lorder.1	8.2 (Berkeley) 4/28/95
 .\" $FreeBSD$
 .\"
-.Dd April 28, 1995
+.Dd April 27, 2006
 .Dt LORDER 1
 .Os
 .Sh NAME
@@ -47,6 +47,7 @@ The
 utility uses
 .Xr nm 1
 to determine interdependencies in the list of object files
+and library archives
 specified on the command line.
 The
 .Nm
@@ -58,9 +59,16 @@ The output is normally used with
 when a library is created to determine the optimum ordering of the
 object modules so that all references may be resolved in a single
 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
 .Bd -literal -offset indent
 ar cr library.a `lorder ${OBJS} | tsort`
+cc -o foo ${OBJS} `lorder ${STATIC_LIBS} | tsort`
 .Ed
 .Sh SEE ALSO
 .Xr ar 1 ,
-- 
cgit v1.1