Re: [PATCH] intro.5: Import FreeBSD additions

["David H. Gutteridge" <david%gutteridge.ca@localhost>]

On Fri, 19 Jun 2026 at 16:00:05 -0400, Alexander Ziaee wrote:
> Hi, I would like to share the improvements I've made in FreeBSD.
> ---
>  share/man/man5/intro.5 | 67 ++++++++++++++++++++++++++++++-----------
> -
>  1 file changed, 48 insertions(+), 19 deletions(-)
> 
> diff --git a/share/man/man5/intro.5 b/share/man/man5/intro.5
> index 5b7a7f4b9c27..921110ab603d 100644
> --- a/share/man/man5/intro.5
> +++ b/share/man/man5/intro.5
> @@ -1,7 +1,8 @@
> -.\"     $NetBSD: intro.5,v 1.5 2009/03/11 13:50:39 joerg Exp $
>  .\"
> -.\" Copyright (c) 1998 The NetBSD Foundation, Inc.
> -.\" All rights reserved.
> +.\" SPDX-License-Identifier: BSD-3-Clause
> +.\"
> +.\" Copyright (c) 1983, 1991, 1993
> +.\"	The Regents of the University of California.  All rights
> reserved.
>  .\"
>  .\" Redistribution and use in source and binary forms, with or
> without
>  .\" modification, are permitted provided that the following
> conditions
> @@ -11,29 +12,57 @@
>  .\" 2. Redistributions in binary form must reproduce the above
> copyright
>  .\"    notice, this list of conditions and the following disclaimer
> in the
>  .\"    documentation and/or other materials provided with the
> distribution.
> +.\" 3. Neither the name of the University nor the names of its
> contributors
> +.\"    may be used to endorse or promote products derived from this
> software
> +.\"    without specific prior written permission.
>  .\"
> -.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND
> CONTRIBUTORS
> -.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT
> NOT LIMITED
> -.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
> PARTICULAR
> -.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR
> CONTRIBUTORS BE
> -.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
> OR
> -.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
> OF
> -.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
> BUSINESS
> -.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
> WHETHER IN
> -.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
> OTHERWISE)
> -.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
> ADVISED OF THE
> -.\" POSSIBILITY OF SUCH DAMAGE.
> +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS
> IS'' AND
> +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
> THE
> +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
> PARTICULAR PURPOSE
> +.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE
> LIABLE
> +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
> CONSEQUENTIAL
> +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
> GOODS
> +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
> INTERRUPTION)
> +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
> CONTRACT, STRICT
> +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
> ANY WAY
> +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
> POSSIBILITY OF
> +.\" SUCH DAMAGE.
>  .\"
> -.Dd April 21, 1998
> +.Dd June 19, 2026
>  .Dt INTRO 5
>  .Os
>  .Sh NAME
>  .Nm intro
>  .Nd introduction to file formats
>  .Sh DESCRIPTION
> -This section contains documentation on binary and configuration
> -file formats.
> +This section contains information about the file formats
> +which comprise most data structures in the
> +.Bx
> +environment, including:
> +.Pp
> +.Bl -bullet -compact
> +.It
> +.Xr ascii 7
> +configuration and resource files
> +.It
> +system binary file and stream structures
> +.It
> +composition of database files
> +.El
> +.Sh FILES
> +.Bl -tag -width "/usr/local/etc/" -compact
> +.It Pa /etc/
> +base system software configuration files
> +.It Pa /usr/local/etc/
> +locally installed software configuration files
> +.El
> +.Sh SEE ALSO
> +.Xr apropos 1 ,
> +.Xr intro 1 ,
> +.Xr hier 7 ,
> +.Xr intro 8
>  .Sh HISTORY
> -.Nm intro
> -appeared in
> +The
> +.Nm Ns Pq 5
> +manual page first appeared in
>  .Nx 1.4 .

Leaving aside the copyright aspect uwe@ mentioned, unlike (most?) other
BSDs, NetBSD doesn't install what other BSDs call "ports" (we call
"pkgsrc") to /usr/local; the default is /usr/pkg. If listing what's
commonly found in the section 5 context, I might expect more entries
than just those two.

Regards,

Dave

PS I said I'd leave aside copyright, but as one aspect, the patch has
+.\" SPDX-License-Identifier: BSD-3-Clause
which TNF has not approved for use, though there has been recent
discussion about the topic, e.g.,
https://gnats.netbsd.org/cgi-bin/query-pr-single.pl?number=60287
was filed.