From nobody Mon Jan 03 01:18:00 2022 X-Original-To: dev-commits-src-branches@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 9BB3D192C3C6; Mon, 3 Jan 2022 01:18:00 +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 4JRyY42jMwz4hTC; Mon, 3 Jan 2022 01:18:00 +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 3EB531C610; Mon, 3 Jan 2022 01:18:00 +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 2031I0Mq050967; Mon, 3 Jan 2022 01:18:00 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 2031I0gs050966; Mon, 3 Jan 2022 01:18:00 GMT (envelope-from git) Date: Mon, 3 Jan 2022 01:18:00 GMT Message-Id: <202201030118.2031I0gs050966@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Ed Maste Subject: git: 811f36c660a2 - stable/12 - lorder: add note that it is no longer required List-Id: Commits to the stable branches of the FreeBSD src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-branches@freebsd.org X-BeenThere: dev-commits-src-branches@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/stable/12 X-Git-Reftype: branch X-Git-Commit: 811f36c660a2d40b57bfbf8a9728866d83130d12 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1641172680; 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=qZZqWcnCyar+kl0UhcM7Z6wO/rALwxEAJ8DwxjqEqIY=; b=NELfinKDo6QZNQi6zMBxdvR31MumZFtR1E8Dwn248eZZIbgf1W9gprvl9R510TJPqx/kYU R9l+er711Fbf3EHBCptRF63jV/GmKMLiQiChEk7jG4NLU2XMBHvIZB8CQnV4BmGTrBBwGh 54Pa2BkcclOr+WgwWQzUfPw+SZgUQ1AZC09Li86S+eXxsZ71iOxuFNby7M+qi72zvtRbg1 Eau/IB838sLIoMJapX1mDs8P48iAAYG7zr6FXhKJljAlpAWPG6M72frJ4Y7RfiPyn3/9+r +GgjPwFAO1ikUNP2b512D27UWTEPD0K0Lf+n86Y0stuRMchihPtKadDDCkI23g== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1641172680; a=rsa-sha256; cv=none; b=lwBRjHaFUZxMjWsIJX2HBd6q+ikZKm0OEZTNNQfkgQ1Jx+mWO2mSoC87ltxY2N4HXYfIQY rnKCyCVHEak77a97MGN7WkN7+o9oyONKcX/uRTDljkC5/iBFPFxWbnLOB2Xv3qfNAWQG0S xdx75WLD8fvv5cq8JbQqoEJ/iI5KijUkdJcrvAKA7/HnXtyBVym2RrFJ8kdlW/apeI/Yl+ AVePz6Q7cCuzWFIpiYD6Cuu3hHGh779OcmKkJOkhHnCkbHam//71WmT6/oqTL14uLNA+3K +0E2EW66ev4KPld0/edL/sDDPGbaEeHzzAltVnSdVPD0pqRsKjF6o2Whbyd8yA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch stable/12 has been updated by emaste: URL: https://cgit.FreeBSD.org/src/commit/?id=811f36c660a2d40b57bfbf8a9728866d83130d12 commit 811f36c660a2d40b57bfbf8a9728866d83130d12 Author: Ed Maste AuthorDate: 2021-12-20 17:57:34 +0000 Commit: Ed Maste 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