NetBSD Problem Report #48177

From www@NetBSD.org  Tue Sep  3 18:03:35 2013
Return-Path: <www@NetBSD.org>
Received: from mail.netbsd.org (mail.netbsd.org [149.20.53.66])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(Client CN "mail.NetBSD.org", Issuer "Postmaster NetBSD.org" (verified OK))
	by mollari.NetBSD.org (Postfix) with ESMTPS id 9F8A2703F9
	for <gnats-bugs@gnats.NetBSD.org>; Tue,  3 Sep 2013 18:03:35 +0000 (UTC)
Message-Id: <20130903180334.0C03E71026@mollari.NetBSD.org>
Date: Tue,  3 Sep 2013 18:03:34 +0000 (UTC)
From: hramrach@gmail.com
Reply-To: hramrach@gmail.com
To: gnats-bugs@NetBSD.org
Subject: the pkgsrc binary package installation instructions are lacking
X-Send-Pr-Version: www-1.0

>Number:         48177
>Category:       pkg
>Synopsis:       the pkgsrc binary package installation instructions are lacking
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    pkg-manager
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue Sep 03 18:05:00 +0000 2013
>Originator:     Michal Suchanek
>Release:        -
>Organization:
>Environment:
-
>Description:
Between the NetBSD guide and pkgsrc guide (referenced from NetBSD guide) there are some bits missing when it comes to setting up binary package installation.

NetBSD guide: 

> Precompiled binaries are available on the NetBSD FTP server for some ports. To install them the PKG_PATH variable needs to be adjusted in the following way (under the sh(1) shell):

> # export PKG_PATH="http://ftp.NetBSD.org/pub/pkgsrc/packages/NetBSD/<PORT>/<RELEASE-NUMBER>/All"
> # export PKG_PATH

> Where <RELEASE-NUMBER> needs to be replaced by the release number of an existing NetBSD release (for example, 5.0). <PORT> needs to be replaced by the Port name for the used architecture (for example, amd64)


It may be obvious for an experienced user what port is and what is the compatibility between different major and minor releases but for user inexperienced with NetBSD this is insufficient.

The version policy should be referenced as well as a way to obtain <PORT> on running system.

the pkgsrc guide has only this text:

> # PKG_PATH="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/OPSYS/ARCH/VERSIONS/All"
> # export PATH PKG_PATH

It does not explain OPSYS ARCH and VERSION at all.

There are nice examples in /root/.profile but they are commented out (and even if they weren't it does not mean they would be effective) and it's not obvious that the user should look in that file for examples.

The pkgsrc home page has quickstart guide which has this example:

> PKG_PATH="http://ftp.NetBSD.org/pub/pkgsrc/packages/$(uname -s)/$(uname -m)/$(uname -r|cut -f '1 2' -d.)/All"
> export PKG_PATH

This is however not referenced from neither NetBSD guide nor pkgsrc guide.

>How-To-Repeat:
Try to install a  binary package following the NetBSD guide.
>Fix:
Add more examples and/or references in the guides.

NetBSD Home
NetBSD PR Database Search

(Contact us) $NetBSD: query-full-pr,v 1.39 2013/11/01 18:47:49 spz Exp $
$NetBSD: gnats_config.sh,v 1.8 2006/05/07 09:23:38 tsutsui Exp $
Copyright © 1994-2007 The NetBSD Foundation, Inc. ALL RIGHTS RESERVED.