man pages: make more friendly for help generation

Also few minor fixups added.

1 files changed, 10 insertions, 8 deletions

diff --git a/doc/apk-version.8.scd b/doc/apk-version.8.scd
index add4871..1e29b1e 100644
--- a/doc/apk-version.8.scd
+++ b/doc/apk-version.8.scd
@@ -10,18 +10,20 @@ apk version - compare package versions
 
 *apk version* -c _versions_...
 
-*apk version* -t _left_ _right_
+*apk version* -t _version1_ _version2_
 
 *apk version* -I
 
 # DESCRIPTION
 
 *apk version* compares the versions of installed packages against package
-versions available from repositories (see *apk-repositories*(5)). If no
-packages are specified, all installed packages are considered.  Otherwise,
-the comparison is limited to the explicitly listed packages. A summary is
-printed on stdout, with the difference between package versions being
-represented as *>*, *=*, or *<*.
+versions available from repositories (see *apk-repositories*(5)). It can also
+be used to validate and compare version strings.
+
+In default mode, if no packages are specified, all installed packages are
+considered. Otherwise, the comparison is limited to the explicitly listed
+packages. A summary is printed on stdout, with the difference between package
+versions being represented as *>*, *=*, or *<*.
 
 *apk version -c* tests the specified version string(s) for validity and prints
 a list of _invalid_ version strings. If all version strings are valid, nothing
@@ -44,8 +46,8 @@ specified).
 	Consider packages from all repository tags.
 
 *-l* _operand_
-	Limit output to packages whose comparison is among the given operands,
-	specified as any combination of *>*, *=*, and *<*.
+	Limit to packages with output matching given _operand_. The _operand_
+	can be specified as any combination of *>*, *=*, and *<*.
 
 # AUTHORS