NetBSD Problem Report #58067

From mouse@Stone.Rodents-Montreal.ORG  Sat Mar 23 03:32:51 2024
Return-Path: <mouse@Stone.Rodents-Montreal.ORG>
Received: from mail.netbsd.org (mail.netbsd.org [199.233.217.200])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	(Client CN "mail.NetBSD.org", Issuer "mail.NetBSD.org CA" (not verified))
	by mollari.NetBSD.org (Postfix) with ESMTPS id 694171A9239
	for <gnats-bugs@www46.NetBSD.org>; Sat, 23 Mar 2024 03:32:51 +0000 (UTC)
Message-Id: <202403230332.XAA07855@Stone.Rodents-Montreal.ORG>
Date: Fri, 22 Mar 2024 23:32:48 -0400 (EDT)
From: Mouse <mouse@Rodents-Montreal.ORG>
Reply-To: mouse@Rodents-Montreal.ORG
To: gnats-bugs@www46.NetBSD.org
Subject: 10.0 RC6: misleading reference to `pkgsrc' set
X-Send-Pr-Version: 3.95

>Number:         58067
>Category:       install
>Synopsis:       10.0_RC6 VAX INSTALL.more mentions quasi-nonexistent set
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    install-manager
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sat Mar 23 03:35:00 +0000 2024
>Last-Modified:  Sat Mar 23 14:55:01 +0000 2024
>Originator:     Mouse
>Release:        NetBSD 10.0_RC6
>Organization:
	Dis-
>Environment:
	Not relevant (pre-install doc issue)
>Description:
	The 10.0_RC6 VAX INSTALL document, at least the .more version,
	says (lines 234 through 236)

     Except for the pkgsrc set, which is traditionally unpacked
     into /usr/pkgsrc, all sets may be unpacked into /usr/src
     with the command:

	As far as I can tell, there is no pkgsrc set in the
	distribution.  The NetBSD-10.0_RC6/source/sets/ directory on
	ftp.n.o doesn't have one, at the very least.
>How-To-Repeat:
	Read the VAX INSTALL.more.  (Since I suspect they're built from
	a common source, I haven't bothered checking other forms of it
	or other arches' INSTALL.* files; I suspect this is common to
	them all.)  Notice the reference to a pkgsrc set.  Notice it
	isn't in the preceding list of source sets.  Look for it
	alongside the other source sets.  Fail.  If you're a naïve
	user, likely get confused.
>Fix:
	I'm not sure, since I don't use pkgsrc myself.  Guessing based
	on other references to it in INSTALL.more, I'd suggest
	replacing the above with something more like

		Except for pkgsrc, which is not strictly one of the
		distribution sets and, when installed, is installed
		differently (see below), all the sets....

/~\ The ASCII				  Mouse
\ / Ribbon Campaign
 X  Against HTML		mouse@rodents-montreal.org
/ \ Email!	     7D C8 61 52 5D E7 2D 39  4E F1 31 3E E8 B3 27 4B

>Audit-Trail:
From: Martin Husemann <martin@NetBSD.org>
To: gnats-bugs@netbsd.org
Cc: 
Subject: Re: install/58067: 10.0 RC6: misleading reference to `pkgsrc' set
Date: Sat, 23 Mar 2024 09:30:11 +0100

 On Sat, Mar 23, 2024 at 03:35:00AM +0000, Mouse wrote:
 >      Except for the pkgsrc set, which is traditionally unpacked
 >      into /usr/pkgsrc, all sets may be unpacked into /usr/src
 >      with the command:

 This refers to the pkgsrc.tgz archive that the installer optionally
 can download post-installation (in the "configure your machine" part).
 It is neither a real "set" nor part of the NetBSD release, but comes from
 the latest quaterly pkgsrc branch. It is (by default) fetched from:

 	https://cdn.NetBSD.org/pub/pkgsrc/stable/pkgsrc.tgz

 Not sure how to describe this clearly in the context you quoted.

 Martin

From: Mouse <mouse@Rodents-Montreal.ORG>
To: gnats-bugs@netbsd.org
Cc: 
Subject: Re: install/58067: 10.0 RC6: misleading reference to `pkgsrc' set
Date: Sat, 23 Mar 2024 10:54:50 -0400 (EDT)

 >>      Except for the pkgsrc set, which is traditionally unpacked
 >>      into /usr/pkgsrc, all sets may be unpacked into /usr/src
 >>      with the command:

 > This refers to the pkgsrc.tgz archive that the installer optionally
 > can download post-installation [...].

 > Not sure how to describe this clearly in the context you quoted.

 I don't see any any need to describe it fully.

 One option is to decide that there's no need to mention it there, to
 delete that part entirely: just replace everything from "Except"
 through "pkgsrc, a" with "A".

 Another option is the one I suggested in the PR: to mention it, but
 call it out as an exception and refer to the other descriptions of it
 further down the file.

 There are doubtless other options as well.  I just suspect the existing
 wording may be confusing, especially to new users - even I was
 confused briefly.  ("What, there's now a pkgsrc set?  No, it's not in
 the list above, and it's not in source/sets.  What's going on?")

 					Mouse

Home	PR Database Search