1 files changed, 162 insertions, 0 deletions
diff --git a/man/1/pkg.pod b/man/1/pkg.pod
new file mode 100644
index 0000000..7f207ba
--- /dev/null
+++ b/man/1/pkg.pod
@@ -0,0 +1,162 @@
+=head1 NAME
+
+pkg - distributed dotfile and script manager
+
+=head1 SYNOPSIS
+
+B<pkg> [I<options>] 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> I<package>
+
+fetch given I<package> from the package_root and install it
+
+=item B<remove> I<package>
+
+Remove I<package> from the local packages tree
+
+=item B<eval> I<expression>
+
+Evauluate I<expression>. See pkg(7)
+
+=item B<info> I<package>
+
+Show information on I<package>, like dependencies, version, etc
+
+=item B<list> [I<filter>]
+
+List packages depending on I<filter>:
+
+=over
+
+=item * B<all>
+
+show all packages
+
+=item * B<local>
+
+show currently installed packages (default)
+
+=item * B<not-installed>
+
+show remote packages which are not installed
+
+=back
+
+=item B<log> I<package>
+
+Show commit history for package
+
+=item B<push> [ I<package> ]
+
+push new local versions to PKG_ROOT.
+If no argument is given, pushes all installed packages
+
+=item B<refresh> [ I<package> ]
+
+Check prereqs and update symlinks of I<package>.
+If no argument is given, refreshs all installed packages
+
+=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> [ B<local>|B<remote> ]
+
+Update local/remote package list (both if no argument is given)
+
+=item B<pull> [ I<package> ]
+
+retrieve and install newest available version of I<package>.
+If no argument is given, updates all installed packages
+
+=back
+
+=head2 SHORT ACTIONS
+
+Instead of the I<action>s described above, you may also use their short
+forms:
+
+  short   long form
+  -----   ---------
+     a    add
+     e    eval
+     f    pull      (think "fetch")
+     i    info
+     l    log
+     ls   list
+     p    push
+     r    refresh
+     rm   remove
+     s    status
+     u    update
+
+=head1 OPTIONS
+
+Options marked as [boolean] may be negated
+by prepending a 'no', like '--no-auto-update'.
+
+Options always override the configuration file.
+Also, every option refers to a configuration parameter,
+so please see pkg.conf(5) for more information.
+
+=head1 FILES
+
+=over
+
+=item F<~/.pkg.conf>
+
+Contains configuration vars
+
+=back
+
+=head1 EXAMPLES
+
+=over
+
+=item * B<pkg remote-update; pkg upgrade>
+
+Get new stuff from the packages_root.
+Note: If you haven't disabled AUTOUPDATE, B<pkg upgrade> will suffice here
+
+=item * B<pkg local-update; pkg push>
+
+Push local changes to the packages_root.
+Note: If you haven't disabled AUTOUPDATE, B<pkg push> will suffice here
+
+=item * B<pkg refresh pkg>
+
+'Fake-Upgrade'. Execute the appropiate commands as if the pkg package had been
+upgraded (useful when you change something but don't want to commit/push yet)
+
+=back
+
+=head1 AUTHOR
+
+Daniel Friesel E<lt>derf@derf.homelinux.orgE<gt>
+
+=head1 CREDITS
+
+=over
+
+=item * Lars Stoltenow (penma)
+
+for pointing out various bugs and design mistakes
+
+=item * Maximilian GaE<szlig> (mxey)
+
+many ideas and suggestions
+
+=back
+
+=head1 SEE ALSO
+
+L<pkg.conf>(5), pkg(7)