git: b498248f7a70 - stable/13 - lorder: add note that it is no longer required

From: Ed Maste <emaste_at_FreeBSD.org>
Date: Mon, 03 Jan 2022 01:17:21 UTC
The branch stable/13 has been updated by emaste:

URL: https://cgit.FreeBSD.org/src/commit/?id=b498248f7a705d45cab6ac14ec67bb408621aabf

commit b498248f7a705d45cab6ac14ec67bb408621aabf
Author:     Ed Maste <emaste@FreeBSD.org>
AuthorDate: 2021-12-20 17:57:34 +0000
Commit:     Ed Maste <emaste@FreeBSD.org>
CommitDate: 2022-01-03 01:17:00 +0000

    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 0e1e341b486c 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
    
    (cherry picked from commit 3e01ee76f2042fe07ad5cf8edeb5065bc0aba320)
---
 usr.bin/lorder/lorder.1 | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/usr.bin/lorder/lorder.1 b/usr.bin/lorder/lorder.1
index b3bfc2d37d35..de03b626fc5f 100644
--- a/usr.bin/lorder/lorder.1
+++ b/usr.bin/lorder/lorder.1
@@ -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