Merge pull request #1187 from aurutils/build-partial-results
[aurutils.git] / man1 / aur-depends.1
blobbb9b88030039bbdec3af47928f6ca86174bd9c1f
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.
120 Dependency requirements are checked with
121 .BR vercmp (8)
122 if the
123 .B \-\-verify
124 option is specified.
126 .SH NOTES
127 While versioned dependencies are listed, they are ignored when
128 resolving the dependency graph. This is because versioned queries are
129 not supported by aurweb, and no additional comparisons are done by
130 .BR aur\-depends .
131 The resulting
132 .B .SRCINFO
133 files can however be checked for consistency with
134 .BR aur\-graph (1).
136 .B FS#54906
137 for details.
139 .SH SEE ALSO
140 .ad l
142 .BR aur (1),
143 .BR aur\-graph (1),
144 .BR aur\-query (1)
146 .SH AUTHORS
147 .MT https://github.com/AladW
148 Alad Wenter
151 .\" vim: set textwidth=72: