NAME

	create, install, pull, push, remove – trivial package management

SYNOPSIS

	contrib/create [ –d dependency ] [ –r root ] [ –u user ] [ –x exclude ] name proto contrib/install [ –f ] [ –r root ] user/name contrib/list [ –v ] [ user | user/name ] contrib/pull [ –c file ] [ –s file ] name contrib/push name contrib/remove name

DESCRIPTION

Contrib is a simple package management system based on replica(1). It can be used to create, install, upgrade and remove software packages in the sources repository. To create a package and become its maintainer it is necessary to have an authenticated sources account and a contrib directory /n/sources/contrib/$user. Contrib/create Create builds a new package name, and performs an initial push to sources. The file structure is defined by proto. Dependencies can be specified with the –d name option. If the package is staged away from its final destination a root directory for the published package may be specified with –r root. If the user has a different name for their sources account from their current user account then this may be specified with the –u user option. Use the –x option to exclude the exclude files from the synchronization. When create runs it puts the current window into hold mode and reads text describing the package. The first line of this text is printed by contrib/list and should be a short summary of the package's contents. Contrib/install Install the package name maintained by the user user to the local file system. The –f option forces the installation to continue irrespective of missing dependent packages. Packages are normally installed at / however an alternative root directory may be specified with –r root. Contrib/list List the available packages and a one line description of each. The –v option produces a more verbose multi–line form. Contrib/pull Update the local package name from sources. Locally modified files cause a warning and are not overwritten unless the –c or –s options are used – as described in replica(1). Contrib/push Used by the package maintainer to update the package name on sources from the local system. Contrib/remove Print the commands necessary to remove the package name, this allows the commands to be edited before they are sent to the shell. The commands printed for files which have been modified with respect to the repository are commented out.

EXAMPLE

	Install the abaco web browser. % contrib/install fgb/abaco

FILES

	/usr/$user/lib/replica          databases of packages created locally. /dist/replica/*                 databases of packages installed locally. /n/sources/contrib/rob/replica   database of rob's packages. /n/sources/contrib/rob/root      files representing in rob's packages.

SOURCE

	/rc/bin/contrib

SEE ALSO

	proto(2), replica(1), replica(8)

BUGS

	Send bug reports to benavento@gmail.com

Copyright © 2008 Lucent Technologies. All rights reserved.