pkg/28760: doc/pkgsrc.html (.txt, ...) error

[kre%munnari.OZ.AU@localhost]

>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@localhost:/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