diff --git a/vlib/v/help/build/build.txt b/vlib/v/help/build/build.txt
index 24f4d6e61e..01fe780c4a 100644
--- a/vlib/v/help/build/build.txt
+++ b/vlib/v/help/build/build.txt
@@ -159,9 +159,11 @@ NB: the build flags are shared with the run command too:
           127          0.016ms            127ns tos
 
   -message-limit <limit>
-    The maximum amount of warnings / errors / notices, that will be accumulated (defaults to 100).
-    The checker will abort prematurely once this limit has been reached.
-    Setting this to 0 or a negative value, will disable the limit.
+    The maximum amount of warnings / errors / notices, that will be accumulated (defaults to 200).
+    The parser and checker, will return prematurely, once this limit has been reached.
+    Setting this to a negative value like -1, will disable the limit.
+    Setting this to 0, will stop showing errors, but the compiler will still exit with a non zero
+    exit code, if there are any.
 
   -no-parallel
     Do not run the compiler in parallel (currently only the cgen stage has parallelization).