aur-depends.1: add missing separator
[aurutils.git] / man1 / aur-depends.1
blob9ca63df9761c628ba69a587bbd2aa2d51c59e219
1 .TH AUR-DEPENDS 1 2023-03-10 AURUTILS
2 .SH NAME
3 aur\-depends \- retrieve dependencies using aurweb
5 .SH SYNOPSIS
6 .SY "aur depends"
7 .OP \-anrtJ
8 .IR "pkgname [pkgname...]"
9 .YS
11 .SH DESCRIPTION
12 .B aur\-depends
13 solves dependencies for packages provided on the command line using
14 .BR aur\-query (1).
15 If a hyphen is specified, packages are taken from standard input.
16 .PP
17 The transitive closure of dependencies within AUR is computed, with
18 Dependency information printed to standard output as edges
19 .IR \%pkgbase\etdepends .
20 By default,
21 .I depends
22 resolves to
23 .BR pkgbase .
25 .SH OPTIONS
26 .TP
27 .BR \-a ", " \-\-all ", " \-\-show\-all
28 Include direct
29 .BR pacman (8)
30 dependencies of dependencies in the output. Implies
31 .BR \-\-pkgname .
33 .TP
34 .BR \-n ", " \-\-pkgname
35 Print dependency information to stdout as
36 .BR pkgname
37 instead of
38 .BR pkgbase .
39 Unless
40 .B \-\-all
41 is specified, only AUR dependencies are printed.
43 .TP
44 .BR \-t ", " \-\-table
45 Print dependency information in the following format:
46 .IP
47 .IR \%pkgname\etdepends\etpkgbase\etpkgver\ettype
48 .IP
49 where
50 .I type
51 is one of
52 .BR Self ,
53 .BR Depends ,
54 .BR MakeDepends ,
55 .BR CheckDepends
56 and
57 .BR OptDepends .
59 .TP
60 .BR \-r ", " \-\-reverse
61 Print
62 .I \%depends\etpkgbase
63 pairs as input for
64 .BR tsort (1).
65 When combined with
66 .BR \-\-table ,
67 the
68 .I depends
69 column is replaced with reverse dependencies
70 .RI ( requiredby ).
71 Version information is left out in this case. When combined with
72 .BR \-\-all ,
73 unknown reverse dependencies are marked with a hyphen.
75 .TP
76 .BR \-J ", " \-\-json
77 Print dependency information as JSON.
79 .TP
80 .BR \-\-jsonl
81 Print dependency information as JSON Lines (newline delimited JSON).
83 .SS Dependency options
84 When resolving dependencies,
85 .B aur\-depends
86 considers all types (
87 .IR depends ,
88 .IR makedepends ,
89 and
90 .IR checkdepends )
91 of dependencies by default.
92 .I optdepends
93 can be taken into account with the
94 .BR \-\-optdepends
95 option.
96 .PP
97 Types can be removed selectively with
98 the
99 .BR \-\-no\-depends ,
100 .BR \-\-no\-makedepends ,
102 .B \-\-no\-checkdepends
103 options. In particular, these options may be used to bypass cycles
104 between dependencies of differing types.
106 Support for virtual dependencies
107 .RI ( provides )
108 can be disabled with the
109 .B \-\-no\-provides
110 option. In particular, any packages listed on the command-line can
111 only provide themselves with this option enabled.
114 Dependencies can be removed selectively with the
115 .BR \-\-assume\-installed
116 option. Multiple packages can be specified by separating them with a
117 comma.
119 .SH NOTES
120 While versioned dependencies are listed, they are ignored when
121 resolving the dependency graph. This is because versioned queries are
122 not supported by aurweb, and no additional comparisons are done by
123 .BR aur\-depends .
124 The resulting
125 .B .SRCINFO
126 files can however be checked for consistency with
127 .BR aur\-graph (1).
129 .B FS#54906
130 for details.
132 .SH SEE ALSO
133 .ad l
135 .BR aur (1),
136 .BR aur\-graph (1),
137 .BR aur\-query (1)
139 .SH AUTHORS
140 .MT https://github.com/AladW
141 Alad Wenter
144 .\" vim: set textwidth=72: