diff --git a/org.eclipse.jgit.pgm/resources/org/eclipse/jgit/pgm/internal/CLIText.properties b/org.eclipse.jgit.pgm/resources/org/eclipse/jgit/pgm/internal/CLIText.properties
index b5a93fca1..2650b8cea 100644
--- a/org.eclipse.jgit.pgm/resources/org/eclipse/jgit/pgm/internal/CLIText.properties
+++ b/org.eclipse.jgit.pgm/resources/org/eclipse/jgit/pgm/internal/CLIText.properties
@@ -1,6 +1,6 @@
 #
-# These text are in general processed using java.text.MessageFormat.
-# exceptions are the usage_* and meta_-messages which are processed through
+# Messages with format elements ({0}) are processed using java.text.MessageFormat.
+# Exceptions are the usage_* and meta_-messages which are processed through
 # annotations in Args4j.
 #
 # default meta variable defined in the org.kohsuke.args4j.spi.StringOptionHandler
diff --git a/org.eclipse.jgit/resources/org/eclipse/jgit/internal/JGitText.properties b/org.eclipse.jgit/resources/org/eclipse/jgit/internal/JGitText.properties
index d3046f904..fe431319f 100644
--- a/org.eclipse.jgit/resources/org/eclipse/jgit/internal/JGitText.properties
+++ b/org.eclipse.jgit/resources/org/eclipse/jgit/internal/JGitText.properties
@@ -1,5 +1,5 @@
 #
-# These text are processed using java.text.MessageFormat.
+# Messages with format elements ({0}) are processed using java.text.MessageFormat.
 #
 abbreviationLengthMustBeNonNegative=Abbreviation length must not be negative.
 abortingRebase=Aborting rebase: resetting to {0}