lorder: add note that it is no longer required

Use of lorder(1) is not required by contemporary linkers.

The GNU coreutils manual[1] has a good description of the use of lorder
and tsort:

    This whole procedure has been obsolete since about 1980, because
    Unix archives now contain a symbol table (traditionally built by
    ranlib, now generally built by ar itself), and the Unix linker uses
    the symbol table to effectively make multiple passes over an archive
    file.

See 0e1e341b48 for some more details.

[1] https://www.gnu.org/software/coreutils/manual/html_node/tsort-background.html

PR:		259254 [exp-run]
MFC after:	2 weeks
Sponsored by:	The FreeBSD Foundation
This commit is contained in:
Ed Maste 2021-12-20 12:57:34 -05:00
parent 4b97eef0bb
commit 3e01ee76f2

View file

@ -28,7 +28,7 @@
.\" @(#)lorder.1 8.2 (Berkeley) 4/28/95
.\" $FreeBSD$
.\"
.Dd August 14, 2015
.Dd December 20, 2021
.Dt LORDER 1
.Os
.Sh NAME
@ -61,6 +61,13 @@ When linking static binaries,
and
.Xr tsort 1
can be used to properly order library archives automatically.
.Pp
The use of
.Nm
is not required by contemporary linkers, and
.Nm
may be removed from a future version of
.Fx .
.Sh ENVIRONMENT
.Bl -tag -width indent
.It Ev NM