REPLACE-COMMONBUMP(1)

NAME
replace-commonbump - tool to help expanding (replacing) commonbump file to the real list of Makefiles

SYNOPSIS
replace-commonbump [-ah] [-p pkgsrcdir] [-T list_file]

DESCRIPTION
replace-commonbump is a perl script for pkgsrc developers. It simplifies the process expanding commonbump file into commonbump-replace. The commonbump file is to be created by the first stage of the PKGREVISION bump process as described in revbump(1).

replace-commonbump -h displays a short usage.

If -p is given, pkgsrcdir is used instead of the default /usr/pkgsrc.

If -a is given, check the whole pkgsrc tree, disregard both the -T option and the default commonbump file. It will check if “# used by” is included or not, usually in Makefile.common in the package.

If -T is given, list_file is used instead of the default commonbump.

replace-commonbump prints the package name (in category/package form) on stdout for each package where it failed, but usually none.

The internal process is divided into three stages.

1.  Read entire pkgsrc tree and check the referer -> referenced relation, then internally keeps (opposite) referenced -> referer relation table.

2.  Read a file, named commonbump or the argument given with -T, which usually lists Makefile.common or *common.mk files to be expanded.

3.  Expand the filenames listed in commonbump into the list of packagename/Makefile by the referenced -> referer relation. replace-commonbump then outputs to the file commonbump.replaced (currently the name is fixed).

ENVIRONMENT
PKGSRCDIR pkgsrc root directory. Defaults to /usr/pkgsrc.

SEE ALSO
blbump(1), check-cvs-diff(1), finddepends(1), revbump(1)