=pod

=head1 NAME

pkg - Package maintenance utility

=head1 SYNOPSIS

B<pkg> I<action> [ I<arguments> ]

=head1 DESCRIPTION

B<pkg> is the basic script for maintaining packages

I<action> may be one of:

=over

=item B<add>, B<install> I<package> [ I<repository type> ]

fetch given I<package>, tracked with I<repository type> (default: hg)
from the package_root and install it

=item B<changelog> I<package>

Show I<package>'s changelog (if available)

=item B<changeroot> I<source>

Change the default source on all packages to I<source>

Example: `changeroot ssh://kraftwerk/var/packages_root` will change
the source of core to 'ssh://kraftwerk/var/packages_root/core'

=item B<delete>, B<remove> I<package>

Remove I<package> from the local packages tree
Note: This does not yet remove the symlinks

=item B<info> I<package>

Show information on I<package>, like dependencies, version, etc

=item B<list>

List all installed packages

=item B<list-all>

List all available (both installed and not installed packages

Hint: `diff <(pkg list) <(pkg list-all)` will show all packages
that are currently not installed

=item B<log> I<package>

Show commit history for package

=item B<status> [ I<package> ]


Check for local changes to the I<package>'s files.
If no arguments is given, checks all installed packages

=item B<update> [ I<package> ]

retrieve and install newest available version of I<package>.
If no argument is given, updates all installed packages

=back

=head1 FILES

=over

=item F<~/.pkg.conf>

Contains configuration vars

=back

=head1 BUGS

packages tracked in git are not completely supported.
'pkg update' will always try to update them, no matter whether there were
changed or not. Plus, the output of 'pkg update' will break a  bit.

=head1 AUTHOR

Daniel Friesel <derf@derf.homelinux.org>

=head1 SEE ALSO

L<pkg.conf>(5)

=cut

vim:ft=pod