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 7691e50f8..d0bfe8511 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,3 +1,8 @@
+#
+# These text are in general 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
 VAL=VAL
 # default meta variable defined in the org.kohsuke.args4j.spi.StopOptionHandler
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 94f9f735e..d3046f904 100644
--- a/org.eclipse.jgit/resources/org/eclipse/jgit/internal/JGitText.properties
+++ b/org.eclipse.jgit/resources/org/eclipse/jgit/internal/JGitText.properties
@@ -1,3 +1,6 @@
+#
+# These text are processed using java.text.MessageFormat.
+#
 abbreviationLengthMustBeNonNegative=Abbreviation length must not be negative.
 abortingRebase=Aborting rebase: resetting to {0}
 abortingRebaseFailed=Could not abort rebase