From nobody Thu Jan 20 20:50:20 2022 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 258751967519; Thu, 20 Jan 2022 20:50:21 +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 4Jfvlw6KwKz4dNV; Thu, 20 Jan 2022 20:50:20 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1642711820; 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=7VkRYXfxotUsSTSSu9J+7671CYZ3g89ah7au2RQObI4=; b=fDaUeLEIlS8m6Y9YbSS8xbuLwczL0Riphbom5Igu/6gatUFZVESExFwcWGWplEclmkyfOS lq7ANULI4yqyRHdt8oSBYXK0D/8UezXyI8VHUOyfQBDJl547ClDgDsLwhAPioQTodDnaX7 Vj12cZHLWoQVLu4OWF6hPk+9x9bdsue+L45wAnc5LrgZCkAopl9dP5iEwTDZRcg/ZubDbL WKME4IgkLsQU/OMHpnx1gXularxRkHjvYFfl6hG/JtRhsH2wlG35VffsUVG09VRwxRS4hJ EqsYfSM7GQ8jGhBCo8jn0st+0/CKT2ctHIh2z/RirDJRKEUpmKwH0PRKiT9L9Q== 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 B99D67198; Thu, 20 Jan 2022 20:50:20 +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 20KKoKU6054873; Thu, 20 Jan 2022 20:50:20 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 20KKoKw4054863; Thu, 20 Jan 2022 20:50:20 GMT (envelope-from git) Date: Thu, 20 Jan 2022 20:50:20 GMT Message-Id: <202201202050.20KKoKw4054863@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: John Baldwin Subject: git: c96dfb2156fa - main - Rework documentation of OLD_*. 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: jhb X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: c96dfb2156fa8a83dd225d1a9b31070123469288 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1642711820; 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=7VkRYXfxotUsSTSSu9J+7671CYZ3g89ah7au2RQObI4=; b=U1GigYNSVb2IqdAg64CsLOKX6NisbleovP0sVHDrfJNPJbABISYbURjP+tlv96ccE67ZOZ HK4oO+hnsG1YJqBY0lyJTn3SnKPghThhEdkzgwHolWDj6mSwt7d2KISyY/z49uO6e+Ipf+ W7dnfLbd4yz65/wGKl9piE3usuMjowL90SjZVSts31o967zmG1+YtLLIkYuLJty/fVWpTn quDFaQsoPydHOZCj+wm+vm1A+Y/+OvT3rtYTbtDrKZq5Yz/aS8jRsWmyyAOEqTu+/14eKx w84gdTmiXZYPrsFVktDkAlcMR25IYuLCEyGSPUFfIt4oClEH7IWKumM/tUgtOg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1642711820; a=rsa-sha256; cv=none; b=RClkZlLRyMXzHjuliAeJwyJem3DJBW35aF0mcn+lafWPgvVXK33SAP8t5/lqJ7nNq1MGVe 5yzs/WPzoMOpvDo+3CpVLYqss7EHlANUhDw1HiaDzRgn1Fu9jm967B6svrUgod0GmaEUQH LWFEXROzt7edbuoG9+FQqxN75U9DPkP6EHKISiO7rg3J0SP2bRzuLTGxNra9NqNWpGXbBx A7grIFI85dFIspieV4Os5IXkRoHTA8x41WhNpCxCjh6K8YDFTJPJJNAqWHqdjgHGJdXGt/ +l7/b63dHSMKXNr7WKBZxXkJfOAWAQCYFg2Za0e0K/GmOM4Xkj7J+1VwZRLObw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by jhb: URL: https://cgit.FreeBSD.org/src/commit/?id=c96dfb2156fa8a83dd225d1a9b31070123469288 commit c96dfb2156fa8a83dd225d1a9b31070123469288 Author: John Baldwin AuthorDate: 2022-01-20 20:46:29 +0000 Commit: John Baldwin CommitDate: 2022-01-20 20:46:29 +0000 Rework documentation of OLD_*. - Be more explicit in the difference between OLD_DIRS and OLD_FILES (the former is only in delete-old-libs whereas the latter is in delete-old). - Document that debug symbols in /usr/lib/debug/ for files in OLD_FILES and OLD_LIBS are removed as well. Reviewed by: emaste Sponsored by: The University of Cambridge, Google Inc. Differential Revision: https://reviews.freebsd.org/D33847 --- ObsoleteFiles.inc | 19 +++++++++++++------ tools/build/mk/OptionalObsoleteFiles.inc | 4 ++-- 2 files changed, 15 insertions(+), 8 deletions(-) diff --git a/ObsoleteFiles.inc b/ObsoleteFiles.inc index 4febe214df46..d4343561436f 100644 --- a/ObsoleteFiles.inc +++ b/ObsoleteFiles.inc @@ -2,17 +2,24 @@ # $FreeBSD$ # # This file lists old files (OLD_FILES), libraries (OLD_LIBS) and -# directories (OLD_DIRS) which should get removed at an update. Recently -# removed entries first (with the date as a comment). Dynamic libraries are -# special cased (OLD_LIBS). Static libraries or the generic links to -# the dynamic libraries (lib*.so) should (if you don't know why to make an -# exception, make this a "must") be viewed as normal files (OLD_FILES). +# directories (OLD_DIRS) which should get removed after an update. +# Recently removed entries should be listed first (with the date as a +# comment). OLD_LIBS should only list dynamic libraries. Static libraries, +# links to dynamic libraries (lib*.so), and linker scripts should be listed +# in OLD_FILES. OLD_LIBS are removed by the delete-old-libs target, whereas +# OLD_FILES and OLD_DIRS are removed by the delete-old target. This +# separation allows users to avoid deleting old dynamic libraries still +# required by existing binaries. +# +# For files listed in OLD_FILES and OLD_LIBS, the check-old* and +# delete-old* targets will also delete associated debug symbols from +# usr/lib/debug. # # In case of a complete directory hierarchy the sorting is in depth first # order. # # Files that are installed or removed depending on some build option -# are to be listed in /usr/src/tools/build/mk/OptionalObsoleteFiles.inc +# should be listed in /usr/src/tools/build/mk/OptionalObsoleteFiles.inc # instead of in this file. # # Before you commit changes to this file please check if any entries in diff --git a/tools/build/mk/OptionalObsoleteFiles.inc b/tools/build/mk/OptionalObsoleteFiles.inc index 580ae319032c..147f5adfffd3 100644 --- a/tools/build/mk/OptionalObsoleteFiles.inc +++ b/tools/build/mk/OptionalObsoleteFiles.inc @@ -1,8 +1,8 @@ # # $FreeBSD$ # -# This file add support for the WITHOUT_* and WITH_* knobs in src.conf(5) to -# the check-old and delete-old* targets. +# This file adds support for the WITHOUT_* and WITH_* knobs in src.conf(5) to +# the check-old* and delete-old* targets. # .if ${MK_ACCT} == no