pkgsrc-wip/pkg_summary-utils/files/NEWS
Aleksey Cheusov fe84e550aa Version 0.21.0, by Aleksey Cheusov, Tue, 11 Nov 2008 22:59:51 +0200
new executable pkg_uniq_summary for filtering out repeated summaries

  Man pages are rewritten in 'man' macroses. Now they may be seen
  under Solaris too.
  Homemade macro VB and VE are used to implement EXAMPLES section,
  these macro implements "verbatim" output.

  pkg_src_summary fix: when reading DESCR files failed a bad error
  message was output (`` was output instead of real filename).

  regression tests (test.sh)
2008-11-11 20:59:18 +00:00

484 lines
18 KiB
Text

----------------------------------------------------------------------
Version 0.21.0, by Aleksey Cheusov, Tue, 11 Nov 2008 22:59:51 +0200
new executable pkg_uniq_summary for filtering out repeated summaries
Man pages are rewritten in 'man' macroses. Now they may be seen
under Solaris too.
Homemade macro VB and VE are used to implement EXAMPLES section,
these macro implements "verbatim" output.
pkg_src_summary fix: when reading DESCR files failed a bad error
message was output (`` was output instead of real filename).
regression tests (test.sh)
----------------------------------------------------------------------
Version 0.20.0, by Aleksey Cheusov, Sun, 26 Oct 2008 13:09:43 +0200
Regression test framework appeared (run 'bmake test').
Regression tests for most utilities.
FIXED: Broken pkg_src_summary -m.
Affected versions: 0.17.0-0.19.0
pkg_summary4view: /usr/bin/awk -f --> runawk
----------------------------------------------------------------------
Version 0.19.0, by Aleksey Cheusov, Wed, 22 Oct 2008 21:38:19 +0300
all scripts are preprocessed before installation
(sed 's,@@bindir@@,${BINDIR},g' etc.)
pkg_src_summary: fix for packages having more than one file listed
in DESCR_SRC
FIX for pkg_src_summary -p: For a huge number of packages 'make
plist' fails because this stage requires package's sources
extracted. Now 'make plist' failures are not critical,
i.e. summary for such package is generated in any case.
fix in pkg_src_fetch_var.in: comments are removed
PKGNAME=pkgname-ver ### trtrtr -> PKGNAME=pkgname-ver
fix in pkg_micro_src_summary: If PKGREVISION is set to 0 (or empty)
in Makefile (bug?), then nb0 is *not* added to PKGNAME
----------------------------------------------------------------------
Version 0.17.2, by Aleksey Cheusov, Sat, 4 Oct 2008 14:47:09 +0300
FIX: pkg_src_summary may fail for packages when fields contain
quotes (e.g. COMMENT field for devel/apache-ant15/Makefile rev. 1.10)
----------------------------------------------------------------------
Version 0.17.1, by Aleksey Cheusov, Tue, 30 Sep 2008 23:28:39 +0300
FIX for -A option: strip ending / symbol from dependencies
(DEPENDS and BUILD_DEPENDS)
www/typo3/Makefile revision 1.5
DEPENDS+= ... ../../archivers/php-zlib/
^^^
/
extra slash character here --------/
----------------------------------------------------------------------
Version 0.17.0, by Aleksey Cheusov, Sat, 20 Sep 2008 02:29:07 +0300
pkg_src_summary:
Fields with empty values (like NOT_FOR=) are not printed.
The following fields are added to the default list of fields
generated by pkg_src_summary: NO_BIN_ON_FTP, NO_SRC_ON_FTP,
NO_BIN_ON_CDROM, NO_SRC_ON_CDROM.
New field ALLSRCFILES (also generated by default) - sum of
DISTFILES and PATCHFILES prepanded with DIST_SUBDIR.
pkg_grep_summary:
pkg_grep_summary FIELD 'fvalue == ""' also matches packages
with no FIELD at all. That is no field becomes synonym to
FIELD=
new option -e
pkg_grep_summary -e FIELD is shorter equivalent for
pkg_grep_summary FIELD 'fvalue == ""'
----------------------------------------------------------------------
Version 0.16.0, by Aleksey Cheusov, Sat, 13 Sep 2008 11:23:57 +0300
A code that moves/adds ASSIGNMENTS to PKGPATH is separated into a
separate script "pkg_assignments2pkgpath". One application for it is
distbb.
Sample of usage: pkg_src_summary ... | pkg_assignments2pkgpath
pkg_src_summary: PKGPATH enriched with variable assignments and
passed to pkg_src_summary may contain spaces. They should be
represented as ~. In output spaces are also encoded as ~.
Example:
$ export PSS_FIELDS='PKGNAME PKGPATH DEPENDS BUILD_DEPENDS'
$ pkg_src_summary sysutils/mc:PKG_OPTIONS.mc=-x11~-slang,PKGNAME=mc-myown-4.6.1nb4
PKGNAME=mc-myown-4.6.1nb4
PKGPATH=sysutils/mc
DEPENDS= perl>=5.0:../../lang/perl5 unzip-[0-9]*:../../archivers/unzip glib2>=2.4.0:../../devel/glib2 glib2>=2.14.3:../../devel/glib2
BUILD_DEPENDS= pkg-config>=0.19:../../devel/pkg-config checkperms>=1.1:../../sysutils/checkperms
ASSIGNMENTS=PKG_OPTIONS.mc=-x11~-slang PKGNAME=mc-4.6.1nb4
$
----------------------------------------------------------------------
Version 0.15.0, by Aleksey Cheusov, Sun, 7 Sep 2008 21:04:34 +0300
pkg_grep_summary: in order to support summaries for multi-variant
packages it is strongly recommented to use 'fvalue' variable in
condition, not $2. Man page and README updated accordingly.
pkg_cmp_summary: -m option added for comparing summaries for
multi-variant packages
(PKGPATH=CATEGORY/PACKAGE[:var1=value1[,var2=value2[...]]] format).
----------------------------------------------------------------------
Version 0.14.0, by Aleksey Cheusov, Sun, 7 Sep 2008 01:25:37 +0300
pkg_src_summary: added option -M which implies -m and moves/adds
ASSIGNMENTS field to PKGPATH.
Example:
0 ~>export PSS_FIELDS='PKGPATH PKGNAME'
0 ~>pkg_src_summary -M lang/lua www/php-apc www/ap2-python
PKGPATH=lang/lua
PKGNAME=lua-5.1.3nb1
PKGPATH=www/php-apc:PHP_VERSION_REQD=4
PKGNAME=php4-apc-4.4.8.3.0.16
PKGPATH=www/php-apc:PHP_VERSION_REQD=5
PKGNAME=php5-apc-5.2.6.3.0.16
PKGPATH=www/ap2-python:PKG_APACHE=apache2,PYTHON_VERSION_REQD=25
PKGNAME=ap2-py25-python-3.2.10
PKGPATH=www/ap2-python:PKG_APACHE=apache2,PYTHON_VERSION_REQD=24
PKGNAME=ap2-py24-python-3.2.10
PKGPATH=www/ap2-python:PKG_APACHE=apache2,PYTHON_VERSION_REQD=23
PKGNAME=ap2-py23-python-3.2.10
PKGPATH=www/ap2-python:PKG_APACHE=apache22,PYTHON_VERSION_REQD=25
PKGNAME=ap22-py25-python-3.2.10
PKGPATH=www/ap2-python:PKG_APACHE=apache22,PYTHON_VERSION_REQD=24
PKGNAME=ap22-py24-python-3.2.10
PKGPATH=www/ap2-python:PKG_APACHE=apache22,PYTHON_VERSION_REQD=23
PKGNAME=ap22-py23-python-3.2.10
0 ~>
----------------------------------------------------------------------
Version 0.13.1, by Aleksey Cheusov, Sun, 7 Sep 2008 01:25:37 +0300
VARIANTS7 is reimplemented through pbulk's mk/pbulk/pbulk-index.mk.
I hope this API will not change...
----------------------------------------------------------------------
Version 0.13.0, by Aleksey Cheusov, Sat, 6 Sep 2008 23:05:15 +0300
-----------------
pkg_src_summary: new option -m added that generates summary
for all variants of multi-variant packages
(Python {23,24,25}, PHP {4,5}, Apache {1.3,2,2.2} etc.)
Example:
0 ~>export PSS_FIELDS='PKGPATH PKGNAME'
0 ~>./pkg_src_summary -m lang/lua www/php-apc www/ap2-python
PKGPATH=lang/lua
PKGNAME=lua-5.1.3nb1
PKGPATH=www/php-apc
PKGNAME=php4-apc-4.4.8.3.0.16
=> ASSIGNMENTS=PHP_VERSION_REQD=4
PKGPATH=www/php-apc
=> PKGNAME=php5-apc-5.2.6.3.0.16
=> ASSIGNMENTS=PHP_VERSION_REQD=5
PKGPATH=www/ap2-python
=> PKGNAME=ap2-py25-python-3.2.10
=> ASSIGNMENTS=PYTHON_VERSION_REQD=25 PKG_APACHE=apache2
PKGPATH=www/ap2-python
=> PKGNAME=ap22-py25-python-3.2.10
=> ASSIGNMENTS=PYTHON_VERSION_REQD=25 PKG_APACHE=apache22
PKGPATH=www/ap2-python
PKGNAME=ap2-py24-python-3.2.10
ASSIGNMENTS=PYTHON_VERSION_REQD=24 PKG_APACHE=apache2
PKGPATH=www/ap2-python
PKGNAME=ap22-py24-python-3.2.10
ASSIGNMENTS=PYTHON_VERSION_REQD=24 PKG_APACHE=apache22
PKGPATH=www/ap2-python
PKGNAME=ap2-py23-python-3.2.10
ASSIGNMENTS=PYTHON_VERSION_REQD=23 PKG_APACHE=apache2
PKGPATH=www/ap2-python
PKGNAME=ap22-py23-python-3.2.10
ASSIGNMENTS=PYTHON_VERSION_REQD=23 PKG_APACHE=apache22
0 ~>
See lines with '=>'.
-----------------
pkg_src_summary: the following format of input PKGPATH is supported:
real_pkgpath[:var1=value1[,var2=value2[...]]]
Example:
0 ~>export PSS_FIELDS='PKGNAME PKGPATH DEPENDS BUILD_DEPENDS'
0 ~>pkg_src_summary textproc/dictem:EMACS_TYPE=xemacs
=> PKGNAME=xemacs-dictem-0.82
PKGPATH=textproc/dictem
=> DEPENDS=dict-client>=1.9.14:../../textproc/dict-client xemacs>=21.4<21.5:../../editors/xemacs xemacs>=21.4<21.5:../../editors/xemacs
BUILD_DEPENDS= checkperms>=1.1:../../sysutils/checkperms
=> ASSIGNMENTS=EMACS_TYPE=xemacs
0 ~>pkg_src_summary www/ap2-wsgi:PYTHON_VERSION_DEFAULT=23,PKG_APACHE_DEFAULT=apache2
=> PKGNAME=ap2-py23-wsgi-1.3
PKGPATH=www/ap2-wsgi
=> DEPENDS= python23>=2.3:../../lang/python23 apache>=2.0.51<2.2:../../www/apache2 python23>=2.3.5nb6:../../lang/python23 apache>=2.0.61nb2:../../www/apache2
BUILD_DEPENDS= libtool-base>=1.5.18nb5:../../devel/libtool-base perl>=5.0:../../lang/perl5 checkperms>=1.1:../../sysutils/checkperms
=> ASSIGNMENTS=PYTHON_VERSION_DEFAULT=23 PKG_APACHE_DEFAULT=apache2
0 ~>
See lines with '=>'.
----------------------------------------------------------------------
Version 0.12.0, by Aleksey Cheusov, Mon, 7 Jul 2008 17:26:35 +0300
minor fixes in pkg_grep_summary
added: pkg_grep_summary.1
----------------------------------------------------------------------
Version 0.11.0, by Aleksey Cheusov, Sat, 14 Jun 2008 15:33:06 +0300
pkg_src_summary:
-d, -D and -A options for generating summary of the specified
packages and their dependancies. -d is for DEPENDS
dependancies, -D is for BUILD_DEPENDS and -A is for both. See
pkg_src_summary(1) for details.
----------------------------------------------------------------------
Version 0.10.0, by Aleksey Cheusov, Sat, 14 Jun 2008 13:30:04 +0300
added: pkg_summary-utils(7) that describes what pkg_summary-utils
project is. All tools refer to it in its manual pages and
pkg_summary-utils(7) refers to manual pages of all tools.
pkg_src_summary:
a list of fields listed in -f|--fields option may be separated
by comma, not only space.
PSS_OPTIONS environment variable specifies default options to be
placed in front of any explicit options. See man page for the
sample.
-a and -r options added for adding and removing the specified
fields to/from the list of fields generated by default.
See man page for the samples.
pkg_update_src_summary:
a list of fields listed in -f|--fields option may be separated
by comma, not only space.
----------------------------------------------------------------------
Version 0.9.0, by Aleksey Cheusov, Sat, 14 Jun 2008 10:38:55 +0300
ADDED: CVS_CHECKSUM field to pkg_src_summary. This gives a way to
compare two pkgsrc trees by comparing their pkg_src_summaries
comparing not only an information about package versions but also
an information about CVS files and their revisions.
new script added: 'cvs_checksum' that analyses local cvs
repository and lists all files in it with their revisions and,
optionally, calculates a checksum for all this. Run
'cvs_checksum -h' for more information. CKSUM environment
variable sets a checksum program, by default, standard 'cksum'.
pkg_src_summary can generate new field: CVS_CHECKSUM, a checksum
calculated by 'cvs_checksum' program for a package. By default
CVS_CHECKSUM is NOT generated.
'pkg_cmp_summary -c' prints '!' (this means "not equal") for
packages with the same versions but different CVS_CHECKSUM provided
that CVS_CHECKSUM is set in both compared packages.
----------------------------------------------------------------------
Version 0.8.0, by Aleksey Cheusov
FIXED: pkg_src_summary pkgpath
pkg_summary4view:
DESCRIPTION, PLIST, PROVIDES and REQUIRES fields now look
better. "FIELD_NAME:" is not followed by any data on the same
line. Data are displayed on the next lines.
Multilined DEPENDS field (pkg_summary(5) from binary packages)
now looks nicer - just like in case pkg_src_summary
CONFLICTS field is processed just like DEPENDS
Fields with values (DEPENDS - noe dependancies, NOTFOR - no
restrictions etc.) are not output at all.
pkg_src_summary:
added option -p|--make-plist for using 'bmake plist'
instead 'cat PLIST'. @directives are removed.
----------------------------------------------------------------------
Version 0.7.0, by Aleksey Cheusov, Sat, 10 May 2008 12:43:07 +0300
pkg_src_summary is now "distributed" tool, i.e. it can build
src_summary using several processes or machines.
Examples:
# for SMP machine
env PSS_SLAVES=+5 pkg_src_summary ...
# for machines in a network
env PSS_SLAVES='host1 host2 host3' \
PSS_PPERS=5 \
PSS_TRANSPORT=/usr/bin/ssh pkg_src_summary ...
PSS_PPERS variable sets a number of packages per slave that
are built at once, defaults to 10.
pkg_src_summary: PSS_FIELDS overrides the default
list of generated fields
pkg_update_src_summary: -i|--fields options specify a list of
generated fields.
----------------------------------------------------------------------
Version 0.6.2, by Aleksey Cheusov
grepping functionality of pkg_grep_summary has been moved to a
separate file pkg_grep_summary.awk. Similar code fragments found
in pkg_refresh_summary and pkg_update_src_summary use
pkg_grep_summary.awk now.
----------------------------------------------------------------------
Version 0.6.1, by Aleksey Cheusov, Wed, 7 May 2008 23:07:00 +0300
README file added. There are available a few examples how to use
all these tools separately and together . You can use it as a
titorial.
----------------------------------------------------------------------
Version 0.6.0, by Aleksey Cheusov, Wed, 7 May 2008 21:53:35 +0300
NEW tool: pkg_grep_summary
Run 'pkg_grep_summary -h' for a documentation.
----------------------------------------------------------------------
Version 0.5.1, by Aleksey Cheusov, Mon, 5 May 2008 01:00:43 +0300
FIXED: pkg_update_summary fails under Linux, Solaris, Interix and
probably other OSes when there are no binary packages in a specified
directory. This happens because xargs works differently on
NetBSD/FreeBSD and Linux/Solaris/Interix. In NetBSD/FreeBSD xargs's
command is NOT run at all when there is no input, while on L/S/I it is
run once without arguments and (pkg_info -X in our case) fails.
DESCR improved
Minor fixes in documentation ans NEWS
----------------------------------------------------------------------
Version 0.5.0, by Aleksey Cheusov, Sun, 27 Apr 2008 14:37:46 +0300
Lots of tasks from TODO are implemented.
pkg_src_fetch_var:
- minor fixes in comments
- new options -h|--help for use message
- new options -f|--fields|-v|--vars for specifying a list of fields
to be generated. By default PKGNAME and PKPATH
are generated as earlier versions did.
Example:
echo 'wip/distbb' | \
pkg_src_fetch_var -f='PKGNAME PKGPATH COMMENT MAINTAINER'
- bmake '+=' operator is also supported
pkg_src_summary:
- new options -h|--help for use message
- new options -f|--fields for specifying a list of fields
to be generated. By default PKGNAME and PKPATH
are generated as earlier versions did.
- 'print-summary-data' pkgsrc target is not used anymore.
Instead, variable's values are obtained directly by bmake.
Side effect/incompatibility: NOTFOR and ONLYFOR are set to
<empty_string> instead of 'any' string in case
NOT_FOR_PLATFORM and ONLY_FOR_PLATFORM are not specified.
pkg_micro_src_summary:
- new options -f|--fields for specifying a list of fields
to be generated. By default PKGNAME and PKPATH
are generated as earlier versions did.
Example:
pkg_micro_src_summary -f 'PKGNAME PKGPATH COMMENT MAINTAINER' \
lang/lua wip/distbb
- In case pkg_src_fetch_var failes pkg_micro_src_summary fallbacks
to pkg_src_summary.
----------------------------------------------------------------------
Version 0.4.6, by Aleksey Cheusov, Sun, 13 Apr 2008 14:56:41 +0300
fix for pkg_summary4view: doesn't depend on input fields order.
fix for pkg_src_summary: PKGNAME and PKGPATH are printed first.
----------------------------------------------------------------------
Version 0.4.5, by Aleksey Cheusov, Sat, 13 Apr 2008 00:43:22 +0300
Both pkg_micro_src_summary and pkg_src_summary generate
nicely formatted bmake failures to stderr.
(will be used by future versions of distbb)
----------------------------------------------------------------------
Version 0.4.4, by Aleksey Cheusov, Sat, 12 Apr 2008 19:53:22 +0300
lots of fixes and improvements in manual pages
minors fixes in utilities
----------------------------------------------------------------------
Version 0.4.3, by Aleksey Cheusov, Sat, 12 Apr 2008 18:00:50 +0300
added:
- pkg_list_all_pkgs.1
- pkg_refresh_summary.1
----------------------------------------------------------------------
Version 0.4.2, by Aleksey Cheusov, Wed, 9 Apr 2008 00:34:58 +0300
pkg_src_fetch_var:
- read PKGPATHs instead of Makefile filenames.
In order to Makefiles from PKGPATH, PKGSRCDIR environment
variable is used (/usr/pkgsrc by default).
- TAB character is used as a fields separator instead of SPC
pkg_micro_src_summary:
- added options: -h|--help|-f|--fields
-f|--fields is for specifying fields to be included
to the summary, PKGNAME and PKGPATH by default
----------------------------------------------------------------------
Version 0.4.1, by Aleksey Cheusov, Wed, 9 Apr 2008 23:14:03 +0300
ADDED: -f|--fields=<fields> option to pkg_src_fetc_var
clean-ups
----------------------------------------------------------------------
Version 0.4.0, by Aleksey Cheusov
first publicly available release (with name pkg_summary-utils)