-
Notifications
You must be signed in to change notification settings - Fork 1
/
pakt.1
107 lines (83 loc) · 3.23 KB
/
pakt.1
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
.TH "PAKT" "1" "October 2024" "pakt v0.1.0" "User Commands"
.SH NAME
pakt \- categorize installed Arch Linux packages
.SH SYNOPSIS
\fIpakt\fR <pacman or AUR helper arguments + categories>
.SH DESCRIPTION
pakt is a POSIX-compliant shell wrapper around pacman or an AUR helper of your choice. It adds "categories" as a new feature of your package manager. It means that while you install packages, you can assign tags in order to group them and gain an overview over your system.
The package names will be put into files with the name of the respective categories. The path to look for is either \fI$XDG_DATA_HOME/pakt/\fR or \fI~/.local/share/pakt/\fR.
.SH OPTIONS
You should be able to alias pakt to the name of your package manager, therefore the arguments are the same, with the exception of category flags.
+\fIcategory1\fR
.br
Assigns the packages written before to \fIcategory1\fR.
+\fIcategory1\fR,\fIcategory2\fR,\fIcategory3\fR
.br
Assigns the packages written before to \fIcategory1\fR, \fIcategory2\fR and \fIcategory3\fR.
++
.br
Assigns the packages written before to all currently existing categories.
If you include these flags when uninstalling packages, their names will be removed from the respective categories. Otherwise, they will stay in the category files.
.SH EXAMPLES
\fIpakt\fR -S neovim
.br
Categories are optional, of course.
\fIpakt\fR -S neovim +cli
.br
Category syntax in its simplest form.
\fIpakt\fR -S neovim +cli pipewire +sound
.br
neovim gets assigned to \fBcli\fR, pipewire to \fBsound\fR.
.br
You can write as much of these pairs as you like.
\fIpakt\fR -S neovim +core,cli,dev htop
.br
Categories follow a comma-separated syntax.
.br
neovim gets assigned to \fBcore\fR, \fBcli\fR and \fBdev\fR, htop to none.
\fIpakt\fR -S neovim ++
.br
neovim gets assigned to all categories that have a file
.br
at \fI$XDG_DATA_HOME/pakt/\fR or \fI~/.local/share/pakt/\fR.
\fIpakt\fR -Rcnsu neovim +dev
.br
neovim will be uninstalled and removed from the \fBdev\fR category,
.br
not from \fBcore\fR and \fBcli\fR though.
\fIpakt\fR -Rcnsu neovim ++
.br
neovim will be uninstalled and removed from all its categories,
.br
including \fBcore\fR, \fBcli\fR and \fBdev\fR.
.SH ENVIRONMENT
PAKT_CONF_PATH
.br
Path of the \fIpakt.conf\fR configuration file. Defaults to \fI/etc\fR.
.SH FILES
\fI/etc/pakt.conf\fR
.br
Default address of the configuration file. Look into the file for more information.
\fI/etc/pakt.conf.default\fR
.br
Default configuration options for \fIpakt.conf\fR.
.br
It's also a part of the souce code at \fIpakt.conf.default\fR.
\fI~/.local/share/pakt/\fR
.br
Path containing category files, if \fI$XDG_DATA_HOME\fR is not set.
.br
Category files are plain lists of packages assigned to the respective category.
.SH AUTHORS
Sergey Lavrent <https://github.com/hiimsergey>
.LP
MrMineDe <https://github.com/mrminede>
.SH LICENSE
GPLv2: GNU General Public License version 2
.LP
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by the law.
.SH BUGS
https://github.com/mrminede/pakt/issues
.SH SEE ALSO
\fBpakt-sync\fR(1) \fBpakt-dry\fR(1)