Subject: pkg/28760: doc/pkgsrc.html (.txt, ...) error
To: None <pkg-manager@netbsd.org, gnats-admin@netbsd.org,>
From: None <kre@munnari.OZ.AU>
List: pkgsrc-bugs
Date: 12/23/2004 11:33:00
>Number:         28760
>Category:       pkg
>Synopsis:       doc/pkgsrc.html (.txt, ...) error
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    pkg-manager
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Thu Dec 23 11:33:00 +0000 2004
>Originator:     Robert Elz
>Release:        NetBSD 1.6X  (-- pkgsrc current as of date/time of this message)
>Organization:
	Prince of Songkla University
>Environment:
	None of this is relevant ...
System: NetBSD jade.coe.psu.ac.th 1.6X NetBSD 1.6X (JADE) #17: Wed Sep 24 20:25:35 ICT 2003 kre@jade.coe.psu.ac.th:/usr/src/real-sys/arch/i386/compile/JADE i386
Architecture: i386
Machine: i386
>Description:
	pkgsrc.txt says (section 4.2.3) ...
		[using .txt version to avoid markup noise confusing things]

If you want to install a binary package that you've either created yourself
(see next section), that you put into pkgsrc/packages manually or that is
located on a remote FTP server, you can use the "bin-install" target. This
target will install a binary package - if available - via pkg_add(1), else do a
make package. The list of remote FTP sites searched is kept in the variable
BINPKG_SITE, which defaults to ftp.NetBSD.org. Any flags that should be added
to pkg_add(1) can be put into BIN_INSTALL_FLAGS. See pkgsrc/mk/ 
bsd.pkg.defaults.mk for more details.

	BINPKG_SITE should be BINPKG_SITES
	bsd.pkg.defaults.mk should be defaults/mk.conf

>How-To-Repeat:
	By inspection (or perhaps more honestly, by attempting to do
	what it said to do and wondering why pkgsrc kept attempting
	to ftp to its default binpkg site after I thought I told it
	not to bother...)
>Fix:
	Add the missing S to BINPKG_SITE, and correct the path for the
	defaults file.    The appended patch does that assuming the .html
	file is the master copy (I suspect there's actually an XML
	version buried someplace else which isn't distributed, in which
	case you're going to need to go editing manually...)

	It might also be a good idea to explicitly mention that the
	value of BINPKG_SITES is intended to be a list of ftp URLs, not
	a list of "remote FTP sites", and include some mention of
	the correct way to construct those URLs so they work correctly.
	(Not relevant to me as all I wanted to do was "BINPKG_SITES=").


--- pkgsrc.html	2004-12-04 04:53:54.000000000 +0700
+++ pkgsrc.html-FIX	2004-12-23 18:29:12.000000000 +0700
@@ -2580,7 +2580,7 @@
             <span><strong class="command">make
             package</strong></span>. The list of remote FTP sites
             searched is kept in the variable <code class=
-            "varname">BINPKG_SITE</code>, which defaults to
+            "varname">BINPKG_SITES</code>, which defaults to
             ftp.NetBSD.org. Any flags that should be added to
             <a href=
             "http://netbsd.gw.com/cgi-bin/man-cgi?pkg_add+1+NetBSD-current">
@@ -2588,7 +2588,7 @@
             "refentrytitle">pkg_add</span>(1)</span></a> can be put
             into <code class="varname">BIN_INSTALL_FLAGS</code>.
             See <code class=
-            "filename">pkgsrc/mk/bsd.pkg.defaults.mk</code> for
+            "filename">pkgsrc/mk/defaults/mk.conf</code> for
             more details.</p>
 
             <p>A final word of warning: If you setup a system that