git: 811f36c660a2 - stable/12 - lorder: add note that it is no longer required

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

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

commit 811f36c660a2d40b57bfbf8a9728866d83130d12
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:34 +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