From nobody Mon Dec 20 18:05:03 2021 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id B475319015A2; Mon, 20 Dec 2021 18:05:03 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4JHnYW3LFHz4Z3Y; Mon, 20 Dec 2021 18:05:03 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4F1261AB34; Mon, 20 Dec 2021 18:05:03 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1BKI53ZD065565; Mon, 20 Dec 2021 18:05:03 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1BKI537s065564; Mon, 20 Dec 2021 18:05:03 GMT (envelope-from git) Date: Mon, 20 Dec 2021 18:05:03 GMT Message-Id: <202112201805.1BKI537s065564@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Ed Maste Subject: git: 3e01ee76f204 - main - lorder: add note that it is no longer required List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-all@freebsd.org X-BeenThere: dev-commits-src-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: emaste X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 3e01ee76f2042fe07ad5cf8edeb5065bc0aba320 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1640023503; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=r3qrEIuqBGgHY2ctGaxLqxQIr2tVA4+Jg9elT0LvCq4=; b=KhFcNr2jTCwXfHZCN/9bfHpC93WCww1sLy8Kur/MyHs5dx0E+2ON/njJC+eR0j3qd1D8tt 9STnJK0m2UIV8Ruh2N56QEUvkb786xYnsAqVRMlnaHvWv1ILmdXwr6jS74m61pecfmiv/j bQMrC47Fpi6S7wFM88SRfeZ1CPG6GlSfepi0cZHlPe2S5xmbPGfDxq3aom+o9GgufokfgC //nVPlK3u/9wdMk5Ahg3XhCwg6pmS50EQ+5MiVSADmkIrPj4zAEpAvgl1x8hltnVSxtJ9G 5e9ZcTDPw/2AeRh9yGkzmyvsGnVI1oGcSqctG8ub2JievALxle+hZlqeoGimhQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1640023503; a=rsa-sha256; cv=none; b=MqkDVYkmv54VQAZpmrRfJSnhAzbUkxHeqVxMV3oypyCLd/2beWUM5iZptRsLHRAIGdmzkN ZXiW1Le06TwvRYk/QXaFhcZxURzH0/ZDz8ZkoaArSkMvA26Fsdu5lQRFVzlL3fwdCRTJIT VCI/TG4jzoYWIR0feEpOELTPvUT2jpbbXm9Zri+v2yxSaNv96D8raQIwMdUeT7Ox2lwgqA h9jKD+OPCUy3clVWghyacydbDwbhbo5fKhLqwmji55BNG6vgUp6LOUvYwuZ2UEvil3Cyix PF2CfBy9eIM07Z+ZJH+aYBdNFsAHzjhPyP5Sb6OmHdLNgw7ALksA8y8j6BNVeA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by emaste: URL: https://cgit.FreeBSD.org/src/commit/?id=3e01ee76f2042fe07ad5cf8edeb5065bc0aba320 commit 3e01ee76f2042fe07ad5cf8edeb5065bc0aba320 Author: Ed Maste AuthorDate: 2021-12-20 17:57:34 +0000 Commit: Ed Maste CommitDate: 2021-12-20 17:59:01 +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 --- 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