diff --git a/utils/readme.txt b/utils/readme.txt
index 3e8833c4ea..d5cda70bfc 100644
--- a/utils/readme.txt
+++ b/utils/readme.txt
@@ -12,8 +12,11 @@ brmake
     nothing.
 
 check-package
-    a script that checks the coding style of a package's Config.in and
-    .mk files, and also tests them for various types of typoes.
+    a script that checks the coding style across the buildroot tree. It
+    checks package's Config.in and .mk files, runs shellcheck for all shell
+    scripts, flake8 for python files, checks for typoes, etc.
+    It checks the .checkpackageignore file if errors should be ignored and
+    errors if there's a file listed that doesn't produce an error.
 
 genrandconfig
     a script that generates a random configuration, used by the autobuilders