Date: Wed, 10 May 2023 12:33:57 -0300 From: Mitchell Horne <mhorne@freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org Subject: Re: git: c3b611e153e0 - main - hier(7): drop list of /usr/include subdirectories Message-ID: <f486719d-6125-2a4b-5ca1-64c57a9d0acc@freebsd.org> In-Reply-To: <202305101327.34ADRsNa088464@gitrepo.freebsd.org> References: <202305101327.34ADRsNa088464@gitrepo.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
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 <mhorne@FreeBSD.org> > AuthorDate: 2023-05-10 12:52:47 +0000 > Commit: Mitchell Horne <mhorne@FreeBSD.org> > 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 <sys/queue.h>, for instance) will either be following a more > detailed man page, or consulting the header contents directly. Folks > targeting standardized headers (#include <sys/time.h>) 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?f486719d-6125-2a4b-5ca1-64c57a9d0acc>