Re: git: c3b611e153e0 - main - hier(7): drop list of /usr/include subdirectories

From: Mitchell Horne <mhorne_at_freebsd.org>
Date: Wed, 10 May 2023 15:33:57 UTC
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