From nobody Wed May 10 15:33:57 2023 X-Original-To: dev-commits-src-main@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 4QGfFf6SXSz4B2w7; Wed, 10 May 2023 15:33:58 +0000 (UTC) (envelope-from mhorne@freebsd.org) Received: from smtp.freebsd.org (smtp.freebsd.org [IPv6:2610:1c1:1:606c::24b:4]) (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 "smtp.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4QGfFf5zsWz4132; Wed, 10 May 2023 15:33:58 +0000 (UTC) (envelope-from mhorne@freebsd.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1683732838; 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: in-reply-to:in-reply-to:references:references; bh=Oke5W90OtGZ47TwXOpKYotaVJjTFLvauBBLPAzOp1FQ=; b=Jd0bw8w+JjtOsxeXLWPMvzoLa3EwgVpXSw8psvI589y4BQyxckaMOjW0d3GTZ6PeDDpQXX iMNB9KLA8zlahAQOLzM2+nFwefvpeZKXeYCbJ39o5l6lnwPcgmGrOwsM7AzWAmheu9QzIh Ocg6lg6XaAnTQlq3iYLGRwIhlQyGq1e7s/AFKYGO6soTjMh6UZbLII1STbL8Dx72er9lt9 poD4o6kOah88RX2fUm3IUu3jLYdgNWTXQv3l7A7CxDo7svbbka5W/xd/nWuHiJDKduiv8G vp9RsrD1cz78MqClzalJzAA7A+TB4nui06UVtX0LsBdPgSLmE0fQVDezjaEUog== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1683732838; 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: in-reply-to:in-reply-to:references:references; bh=Oke5W90OtGZ47TwXOpKYotaVJjTFLvauBBLPAzOp1FQ=; b=B7geLFarn80PPmpi2SOXyJbCMXYSAp1lLYkNjdw0hi/+g3AdcEqAHXZ0tOZea/ajw2Akkb wG388lvUZVh6WKsKoDBKJCN9n5tK5UUMiWbaYvshIxQP5lmwTvOerFqDp4icJ2X1Jnt+bi pYpteBfcRxkalJ0zeTr/n2ZXrasiRAwxi/fs15s4tjKtrj8mwTM2BJQz2/0jC9u1FVxwIQ vPkvLIpycWp+Z4N+Cywq6XSPPUGa0lnlhIMkhexoEO/p2ZyvZMLy1XyCeM6tT9DAy2Cgh0 3Fvy+C64BUwjmMLzBOz4wKoO4WFNo65aLgPaLViXdjairzCWNaLIsZvhyu2o1A== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1683732838; a=rsa-sha256; cv=none; b=Ve6mB4i+mivLxFRIl8a3xihDaUqaMMSoSkjWxfSE1PBkFHFKmfNFyq1DVlTxKf5T7lnQnV 6ThI0ZuzhJW/VYjqAUlXhmEUPk7H7evzQZEW4boTr4arMbaaZb1c6WyqtreLpgsfzuZpH0 DOP/xHV1c2wdVnzF+NSRYbT3EQjyO/4PuZh0gaBDA6fqmFLybpMM0pxioFR8Pf5dPJ4V3u hxpApxb7gsurl+emZ3H9okiW4LVKGG7JKoLZkXhMma18JV/p5t9K48JdyxIXzbPueDd6CB tz7C+40BUgpackvGuu7k5lPLxTmEjNncN8vg+yyv3ZH4DQrMM1WkuZgnYQ91/A== Received: from [192.168.1.151] (host-173-212-76-127.public.eastlink.ca [173.212.76.127]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (Client did not present a certificate) (Authenticated sender: mhorne) by smtp.freebsd.org (Postfix) with ESMTPSA id 4QGfFf3V8Kzst3; Wed, 10 May 2023 15:33:58 +0000 (UTC) (envelope-from mhorne@freebsd.org) Message-ID: Date: Wed, 10 May 2023 12:33:57 -0300 List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-main@freebsd.org X-BeenThere: dev-commits-src-main@freebsd.org MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:102.0) Gecko/20100101 Thunderbird/102.11.0 Subject: Re: git: c3b611e153e0 - main - hier(7): drop list of /usr/include subdirectories Content-Language: en-CA From: Mitchell Horne To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org References: <202305101327.34ADRsNa088464@gitrepo.freebsd.org> In-Reply-To: <202305101327.34ADRsNa088464@gitrepo.freebsd.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-ThisMailContainsUnwantedMimeParts: N On 5/10/23 10:27, Mitchell Horne wrote: > The branch main has been updated by mhorne: > > URL: https://cgit.FreeBSD.org/src/commit/?id=c3b611e153e0480a354559f82fe5dc4c455bad4e > > commit c3b611e153e0480a354559f82fe5dc4c455bad4e > Author: Mitchell Horne > AuthorDate: 2023-05-10 12:52:47 +0000 > Commit: Mitchell Horne > CommitDate: 2023-05-10 13:17:41 +0000 > > hier(7): drop list of /usr/include subdirectories > > It is nice to have, however, the location of this information means that > it will naturally be missed by developers adding or removing directories > to the layout, so it trends out-of-date and it is out-of-date. > > The target audience for hier(7) is users and administrators. It is not > expected to be a place that programmers should go to learn about the > purposes of the different C headers provided by FreeBSD. > > Program authors needing FreeBSD-specific interfaces or libraries > (#include , for instance) will either be following a more > detailed man page, or consulting the header contents directly. Folks > targeting standardized headers (#include ) will not need > hier(7) to tell them where those headers are under /usr/include. > > In other words, this is more detail than necessary for this document. > I'd go as far as to say that many of the existing entries in this list > do little more than parrot the name of the directory. > > With all this in mind, let's drop the maintenance burden. > > Reviewed by: imp, emaste > MFC after: 1 week > Sponsored by: The FreeBSD Foundation > Differential Revision: https://reviews.freebsd.org/D40000 > --- For these changes I forgot to include the related PR reference (sorry grahamperrin). PR: 261349 Mitchell