diff --git a/docs/manual/OptionalTasks/javah.html b/docs/manual/OptionalTasks/javah.html
index 3e7735ee9..abbefea25 100644
--- a/docs/manual/OptionalTasks/javah.html
+++ b/docs/manual/OptionalTasks/javah.html
@@ -42,6 +42,12 @@ name="implementationvalues">Here are the choices</a>:</p>
   <li>kaffeh (the native standard compiler of <a href="http://www.kaffe.org" target="_top">Kaffe</a>)</li>
 </ul>
 
+<p><b>Note:</b> if you are using this task to work on multiple files
+  the command line may become too long on some operating systems.
+  Unfortunately the javah command doesn't support command argument
+  files the way javac (for example) does, so all that can be done is
+  breaking the amount of classes to compile into smaller chunks.</p>
+
 <h3>Parameters</h3>
 <table border="1" cellpadding="2" cellspacing="0">
   <tr>