Re: pkgsrc create README for packages directory

[Alistair Crooks <agc%pkgsrc.org@localhost>]

On Tue, May 15, 2012 at 07:45:36AM -0500, Jeremy C. Reed wrote:
> It may be useful if pkgsrc automatically created a ${PACKAGES}/README 
> file that said what operating system version it was built with and what 
> branch or -current of pkgsrc it used.

Possibly, but that wouldn't help for binary packages.  Over time,
pkgsrc-based package installations will accrue a number of packages
built at different times (and, if one is following development
versions of an operating system, with different OS versions too). 
However, we do codify that infrastructure information, and much more,
in each binary package itself.  See pkg_info -b and pkg_info -B
(output below)
 
> pkgsrc should have some setting or file that identifies itself also. 
> Like always be called "HEAD" or "current" but then is changed for each 
> branch. Or do we already have this?

I'm not sure I agree with this.  The end unit of pkgsrc is the
(binary) package itself, more so since the build process was modified
to generate the binary package and install that.  VCS information has
really no relationship to the infrastructure that was used to build
the binary package, as the packages all have version information
embedded in them, and I'm not sure what you're trying to achieve with
a file like this - last time it was updated from a VCS?  the version
of the infrastructure it was built with?  Compiler settings?  Package
version information? Please clarify.
 
> I understand the README could be misleading or confusing in the case 
> that multiple people or different machines are building packages (due to 
> critical updates for example) for the same collection. So maybe the 
> information can be saved in a unique filename and then the packages 
> download server can merge them all together to generate the README.
> 
> Or maybe the pkg_summary can be extended to record some of the 
> higher-level metadata.

Again, not sure what you're trying to achieve with this.

Regards,
Alistair

[5:41:11] agc@netbsd-vm2 ...sys/fs [10373] > pkg_info -b rats
Information for rats-2.1nb5:

Build version:
security/rats/Makefile: $NetBSD: Makefile,v 1.24 2010/02/20 08:25:51 obache Exp 
$
security/rats/PLIST:    $NetBSD: PLIST,v 1.5 2002/09/30 13:52:55 taca Exp $
security/rats/distinfo: $NetBSD: distinfo,v 1.8 2010/02/20 08:25:51 obache Exp $
security/rats/patches/patch-aa: $NetBSD: patch-aa,v 1.4 2010/02/20 08:25:52 
obache Exp $
security/rats/patches/patch-ab: $NetBSD: patch-ab,v 1.1 2010/02/20 08:25:52 
obache Exp $


[5:41:35] agc@netbsd-vm2 ...sys/fs [10374] > pkg_info -B rats
Information for rats-2.1nb5:

Build information:
ABI=
BUILD_DATE=2012-03-04 11:58:54 -0800
BUILD_HOST=NetBSD netbsd-vm2.cupertino.alistaircrooks.com 6.99.3 NetBSD 6.99.3 
(GENERIC) #1: Sun Feb 19 23:59:30 PST 2012  
agc%netbsd-vm2.cupertino.alistaircrooks.com@localhost:/usr/build/obj/x86_64/usr/src/sys/arch/amd64/compile/GENERIC
 amd64
BUILTIN_PKGS=expat-2.0.1
CATEGORIES=security
CC_VERSION=gcc-4.5.3
CFLAGS=-O2 -I/usr/pkg/include -I/usr/X11R7/include
CMAKE_ARGS=
CONFIGURE_ARGS=--datadir=/usr/pkg/share/rats --x-includes=/usr/X11R7/include 
--x-libraries=/usr/X11R7/lib --prefix=/usr/pkg --build=x86_64--netbsd 
--host=x86_64--netbsd --mandir=/usr/pkg/man
CONFIGURE_ENV=INSTALL_INFO= 
MAKEINFO=/usr/pkgsrc/security/rats/work/.tools/bin/makeinfo FLEX= BISON= 
AWK=/usr/bin/awk CAT=/bin/cat ac_cv_path_CAT=/bin/cat CHMOD=/bin/chmod 
CMP=/usr/bin/cmp CP=/bin/cp DIFF=/usr/bin/diff ECHO=echo ac_cv_path_ECHO=echo 
EGREP=/usr/bin/egrep ac_cv_path_EGREP=/usr/bin/egrep SETENV=/usr/bin/env 
ENV_PROG=/usr/bin/env ac_cv_path_ENV=/usr/bin/env FALSE=false 
ac_cv_path_FALSE=false FIND=/usr/bin/find GREP=/usr/bin/grep 
ac_cv_path_GREP=/usr/bin/grep HOSTNAME=/bin/hostname LN=/bin/ln LS=/bin/ls 
MKDIR=/bin/mkdir\ -p MV=/bin/mv RM=/bin/rm RMDIR=/bin/rmdir SED=/usr/bin/sed 
SORT=/usr/bin/sort TAR=/bin/tar TEST=test ac_cv_path_TEST=test 
TOUCH=/usr/bin/touch TR=/usr/bin/tr TRUE=true ac_cv_path_TRUE=true PKG_CONFIG= 
PKG_CONFIG_LIBDIR=/usr/pkgsrc/security/rats/work/.buildlink/lib/pkgconfig:/usr/pkgsrc/security/rats/work/.buildlink/share/pkgconfig
 PKG_CONFIG_LOG=/usr/pkgsrc/security/rats/work/.pkg-config.log PKG_CONFIG_PATH= 
MAKE=make WRAPPER_DEBUG=no WRAPPER_UPDATE_CACHE=yes CC=gcc CFLAGS=-O2\ 
-I/usr/pkg/include\ -I/usr/X11R7/include CPPFLAGS=-I/usr/pkg/include\ 
-I/usr/X11R7/include CXX=c++ CXXFLAGS=-O2\ -I/usr/pkg/include\ 
-I/usr/X11R7/include COMPILER_RPATH_FLAG=-Wl,-R F77=g77 FC=g77 FFLAGS=-O LANG=C 
LC_COLLATE=C LC_CTYPE=C LC_MESSAGES=C LC_MONETARY=C LC_NUMERIC=C LC_TIME=C 
LDFLAGS=-L/usr/pkg/lib\ -L/usr/X11R7/lib\ -Wl,-R/usr/X11R7/lib\ 
-Wl,-R/usr/pkg/lib LINKER_RPATH_FLAG=-R 
PATH=/usr/pkgsrc/security/rats/work/.wrapper/bin:/usr/pkgsrc/security/rats/work/.buildlink/bin:/usr/pkgsrc/security/rats/work/.gcc/bin:/usr/pkgsrc/security/rats/work/.tools/bin:/usr/pkg/bin:/home/agc/scripts:/home/agc/bin:/usr/pkg/bin:/usr/pkg/sbin:/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin:/usr/local/sbin:/usr/X11R7/bin:/usr/pkg/bin:/usr/X11R7/bin
 PREFIX=/usr/pkg PKG_SYSCONFDIR=/usr/pkg/etc CXXCPP=cpp 
HOME=/usr/pkgsrc/security/rats/work/.home CONFIG_SHELL=/bin/sh LIBS= 
ac_given_INSTALL=/usr/bin/install\ -c\ -o\ agc\ -g\ agc
CPPFLAGS=   -I/usr/pkg/include -I/usr/X11R7/include
FFLAGS=-O
HOMEPAGE=http://www.fortifysoftware.com/security-resources/rats.jsp
LDFLAGS=  -L/usr/pkg/lib -L/usr/X11R7/lib -Wl,-R/usr/X11R7/lib 
-Wl,-R/usr/pkg/lib
LICENSE=gnu-gpl-v2
LOCALBASE=/usr/pkg
MACHINE_ARCH=x86_64
MACHINE_GNU_ARCH=x86_64
MAINTAINER=tech-pkg-ja%jp.NetBSD.org@localhost
NO_BIN_ON_CDROM=
NO_BIN_ON_FTP=
NO_SRC_ON_CDROM=
NO_SRC_ON_FTP=
OBJECT_FMT=ELF
OPSYS=NetBSD
OS_VERSION=6.99.3
PKGINFODIR=info
PKGMANDIR=man
PKGPATH=security/rats
PKGTOOLS_VERSION=20091115
PKG_SYSCONFBASEDIR=/usr/pkg/etc
PKG_SYSCONFDIR=/usr/pkg/etc
REQUIRES=/usr/X11R7/lib/libexpat.so.2
REQUIRES=/usr/lib/libc.so.12
REQUIRES=/usr/lib/libgcc_s.so.1
RESTRICTED=
_PLIST_IGNORE_FILES=
_USE_DESTDIR=user-destdir


[5:41:56] agc@netbsd-vm2 ...sys/fs [10375] >