summaryrefslogtreecommitdiff
path: root/man/1/pkg
blob: f96b6f7ed49ac3ef0f07b5135a16cca05d3bee3d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
=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>

fetch given I<package> from the package_root and install it

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

Remove I<package> from the local packages tree

=item B<eval> I<expression>

Evauluate I<expression>. See the 'Examples' section and pkg(7)

=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<local-update>

Update the local package list

=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<remote-update>

Update remote package list

=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>

Update local and remote package list

=item B<upgrade> [ 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 WARNING

This is early-beta software. No backwards compatibility guaranteed.
Please refer to pkg(7)

=head1 EXAMPLES

=over

=item * B<pkg remote-update; pkg upgrade>

Get new stuff from the packages_root

=item * B<pkg local-update; pkg push>

Push local changes to the packages_root

=item * B<pkg refresh core>

'Fake-Upgrade'. Execute the appropiate commands as if the core package had been
upgraded (useful when you change something but don't want to commit/push yet)

=back

=head1 AUTHOR

Daniel Friesel <derf@derf.homelinux.org>

=head1 CREDITS

=over

=item * Lars Stoltenow (penma)

for pointing out various bugs and design mistakes

=item * Maximilian Gass (mxey)

many ideas and suggestions

=back

=head1 SEE ALSO

L<pkg.conf>(5), pkg(7)

=cut

vim:ft=pod