man1/aur-graph.1

   1 .TH AUR-GRAPH 1 2020-11-08 AURUTILS
   2 .SH NAME
   3 aur\-graph \- print package/dependency directed graph
   4 .
   5 .SH SYNOPSIS
   6 .SY "aur graph"
   7 .RB [ .SRCINFO ...]
   8 .YS
   9 .
  10 .SH DESCRIPTION
  11 .B aur\-graph
  12 prints out a partial ordering of packages (tab-separated)
  13 .RB ( pkgbase )
  14 specified in
  15 .B .SRCINFO
  16 files. If no files are listed on the command-line, input
  17 is taken from standard input.
  18 .
  19 .SH OPTIONS
  20 Options can be specified with the
  21 .B \-v
  22 parameter. Every option requires a single
  23 .B \-v
  24 parameter prepending it.
  25 .
  26 .TP
  27 .BR CHECKDEPENDS=[1|0] ", " DEPENDS=[1|0] ", " MAKEDEPENDS=[1|0]
  28 When enabled (set to
  29 .BR 1 ),
  30 list included
  31 .BR checkdepends ,
  32 .BR depends ,
  33 or
  34 .BR makedepends .
  35 For a split package, only global dependencies corresponding to
  36 .B pkgbase
  37 are printed. Defaults to
  38 .BR 0
  39 for
  40 .B CHECKDEPENDS
  41 and
  42 .BR 1
  43 for
  44 .B DEPENDS
  45 and
  46 .BR MAKEDEPENDS .
  47 .
  48 .TP
  49 .B PRINTALL=[0,1]
  50 List all global dependencies for a
  51 .BR pkgbase .
  52 Any encountered dependencies are printed as-is, that is, no version
  53 comparisons are done by
  54 .BR aur\-graph ,
  55 nor are results limited to
  56 .B pkgbase
  57 encountered in specified
  58 .B .SRCINFO
  59 files.
  60 .
  61 .SH EXAMPLES
  62 .B aur\-graph
  63 supports
  64 .B provides
  65 and versioned dependencies. This can be used to verify output from
  66 tools with no or limited support for such dependencies, for example
  67 .BR aur\-depends (1):
  68 .PP
  69 .EX
  70     $ mkdir build; cd build
  71     $ aur depends <package> | xargs -d '\\n' aur fetch
  72     $ aur graph */.SRCINFO >/dev/null
  73 .EE
  74 .PP
  75 .B aur\-graph
  76 output is suitable as input for
  77 .BR tsort (1),
  78 provided no cycles are present. The resulting topologically ordered
  79 list can be used to build packages in the correct order. For example:
  80 .PP
  81 .EX
  82     $ cd build
  83     $ aur graph */.SRCINFO | tsort | tac > deps.txt
  84     $ aur build -a deps.txt
  85 .EE
  86 .PP
  87 To improve performance,
  88 .B .SRCINFO
  89 files may be concatenated before processing:
  90 .PP
  91 .EX
  92     $ cat */.SRCINFO | aur graph | tsort | tac
  93 .EE
  94 .
  95 .SH SEE ALSO
  96 .ad l
  97 .nh
  98 .BR aur (1),
  99 .BR aur\-build (1),
 100 .BR aur\-depends (1),
 101 .BR awk (1),
 102 .BR tac (1),
 103 .BR tsort (1)
 104 .
 105 .SH AUTHORS
 106 .MT https://github.com/AladW
 107 Alad Wenter
 108 .ME
 109 .
 110 .\" vim: set textwidth=72: