libredbdiff: usage

1 files changed, 29 insertions, 9 deletions

diff --git a/src/abslibre-tools/libredbdiff b/src/abslibre-tools/libredbdiff
index 1c3bad1..64cf8eb 100755
--- a/src/abslibre-tools/libredbdiff
+++ b/src/abslibre-tools/libredbdiff
@@ -156,16 +156,36 @@ usage() {
 	flag '-n' "Don't update anything, just compare already downloaded files."
 	flag '-h' 'Show this message'
 	echo
-	print "Output format:"
-	print "type_character  parabola_pkgname  (arch_pkgname)   parabola_pkgver - (arch_pkgver)"
+	prose "In the compare mode the output is in the format:"
 	echo
-	print "Type characters:"
-	flag '=' "Arch package with the same pkgname and greater pkgver was found"
-	flag 'p' "Arch package with pkgname equal to a provide and greater
-	          pkgver was found In this case arch_pkgname is a provide of
-	          parabola_pkgname"
-	flag 'o' "No Arch package with the same pkgname or with pkgname equal to
-	          a provide was found"
+	print '\t[repo]'
+	print '\tpkgline'
+	print '\tpkgline'
+	print '\t...'
+	print '\t[repo]'
+	print '\tpkgline'
+	print '\tpkgline'
+	print '\t...'
+	echo
+	prose "That is, the output is organized by Parabola repository, and
+	       within each repository section, there is one line for each
+	       package in that Parabola repo that seems to be behind the
+	       equivalent package in Arch."
+	echo
+	print "The line-format for packages is:"
+	printf "\t$printf_format" \
+	       status parabola_pkgname '[arch_pkgname]' parabola_pkgver arch_pkgver
+	echo
+	print "Where 'status' is one of the characters:"
+	flag '=' "An Arch package with the same pkgname as a Parabola package
+	          was found, and Arch has a higher pkgver than Parabola.  In
+	          this case, arch_pkgname is not present (as it is the same as
+	          the parabola_pkgname)."
+	flag 'p' "An Arch package with a pkgname that is provide'd by a Parabola
+	          package was found, and the pkgver of the Arch package is
+	          higher than the pkgver of the parabola package."
+	flag 'o' "It appears that this Parabola package is not a replacement for
+	          an Arch package."
 }
 
 main() {