Expanded information for repology check

README.md

@@ -72,7 +72,7 @@ These options can be specified for any `COMMAND` except for  `create-config` whi
 **Commands**:
 
 * `check-remote-versions`: Prints report on the versions of packages.
-* `check-repology`: Returns newest versions known to repology.
+* `check-repology`: Returns versions known to repology.
 * `mkreadme`: Creates a README for an overlay.
 
 # Commands
@@ -112,7 +112,7 @@ $ overlay_maintain_tools check-remote-versions [OPTIONS]
 * `--help`: Show this message and exit.
 ## `overlay_maintain_tools check-repology`
 
-Returns newest versions known to repology.
+Returns versions known to repology. Reported versions will be newer than ones in overlay.
 
 **Usage**:
 

overlay_maintain_tools/main.py

@@ -108,7 +108,7 @@ def check_repology(
         exists=True,
     ),
 ):
-    """Returns newest versions known to repology."""
+    """Returns versions known to repology. Reported versions will be newer than ones in overlay."""
     from overlay_maintain_tools.repology import (
         get_higher_versions_in_repology,
         load_repology_cache,
@@ -120,7 +120,7 @@ def check_repology(
         repology_cache=load_repology_cache(repology_cache_location),
     )
 
-    print_func("Repology report.")
+    print_func("Repology report:")
 
     pkg_cache = ctx.obj.pkg_cache
     for (pkg, reply) in zip(pkg_cache, map(get_higher_versions_in_repology, pkg_cache)):
@@ -129,7 +129,8 @@ def check_repology(
             if reply_i and ctx.obj.quiet:
                 raise typer.Exit(100)
             print_func(
-                f"{pkg.atomname}:\nHave locally: {', '.join(pkg.versions)}\nNewest in repology: {''.join(reply_i)}"
+                f"{pkg.atomname}:\nHave locally: {', '.join(pkg.versions)}\n"
+                f"Versions in repology greater than ones in overlay: {''.join(reply_i)}"
             )