From d59c591f3a4e41b9628af391f1cb4ea6c81652c9 Mon Sep 17 00:00:00 2001
From: Alad Wenter <alad@archlinux.org>
Date: Mon, 23 Sep 2024 17:57:56 +0200
Subject: [PATCH] aur.1: split into high and low level commands

Fixes #998
---
 man1/aur.1 | 56 +++++++++++++++++++++++++++++++-------------------------
 1 file changed, 31 insertions(+), 25 deletions(-)

diff --git a/man1/aur.1 b/man1/aur.1
index 17bb10aa..fa80b3bd 100644
--- a/man1/aur.1
+++ b/man1/aur.1
@@ -20,6 +20,11 @@ A brief overview of local repositories is given in the
 section.
 .
 .SH AUR COMMANDS
+We divide
+.B aur
+commands into high level commands and low level commands. The low level
+comands support development of high level or alternative commands.
+.PP
 The below gives a short overview; see the respective documentation for
 details.
 .PP
@@ -34,18 +39,12 @@ through the
 environment variable, for example
 .IR /usr/local/lib/aurutils:/usr/lib/aurutils .
 .
+.SH HIGH-LEVEL COMMANDS
 .P
 .BR aur\-build (1)
 .RS 4
 Build packages to a local repository.
 .RE
-.
-.P
-.BR aur\-chroot (1)
-.RS 4
-Build pacman packages with systemd-nspawn.
-.RE
-.
 .P
 .BR aur\-depends (1)
 .RS 4
@@ -59,12 +58,6 @@ Fetch packages from a location.
 .RE
 .
 .P
-.BR aur\-format (1)
-.RS 4
-Format AurJson output to text strings.
-.RE
-.
-.P
 .BR aur\-graph (1)
 .RS 4
 Print package/dependency directed graph.
@@ -77,42 +70,55 @@ Print the AUR package list.
 .RE
 .
 .P
-.BR aur\-query (1)
+.BR aur\-repo (1)
 .RS 4
-Send GET requests to the aurweb RPC interface.
+Manage local repositories.
 .RE
 .
 .P
-.BR aur\-repo (1)
+.BR aur\-search (1)
 .RS 4
-Manage local repositories.
+Search for AUR packages.
 .RE
 .
 .P
-.BR aur\-repo\-filter (1)
+.BR aur\-sync (1)
 .RS 4
-Filter packages in the Arch Linux repositories.
+Download and build AUR packages automatically.
 .RE
 .
+.SH LOW-LEVEL COMMANDS
 .P
-.BR aur\-search (1)
+.BR aur\-chroot (1)
 .RS 4
-Search for AUR packages.
+Build pacman packages with systemd-nspawn.
 .RE
 .
 .P
-.BR aur\-srcver (1)
+.BR aur\-format (1)
 .RS 4
-List version of VCS packages.
+Format AurJson output to text strings.
 .RE
 .
 .P
-.BR aur\-sync (1)
+.BR aur\-query (1)
 .RS 4
-Download and build AUR packages automatically.
+Send GET requests to the aurweb RPC interface.
 .RE
 .
 .P
+.BR aur\-repo\-filter (1)
+.RS 4
+Filter packages in the Arch Linux repositories.
+.RE
+.
+.P
+.BR aur\-srcver (1)
+.RS 4
+List version of VCS packages.
+.RE
+
+.P
 .BR aur\-vercmp (1)
 .RS 4
 Check packages for AUR updates.
-- 
2.11.4.GIT