# HG changeset patch
# User Doug Simon <doug.simon@oracle.com>
# Date 1395315413 -3600
# Node ID 2496f9f49f6b072d0b348183f324a782d0d23146
# Parent  da2431cc150667e0d93fcd8596b3a58c4b7b732c
improved javadoc for Debug.logv() to explain why it should be avoided

diff -r da2431cc1506 -r 2496f9f49f6b graal/com.oracle.graal.debug/src/com/oracle/graal/debug/Debug.java
--- a/graal/com.oracle.graal.debug/src/com/oracle/graal/debug/Debug.java	Thu Mar 20 11:48:39 2014 +0100
+++ b/graal/com.oracle.graal.debug/src/com/oracle/graal/debug/Debug.java	Thu Mar 20 12:36:53 2014 +0100
@@ -356,7 +356,9 @@
 
     /**
      * Prints a message to the current debug scope's logging stream. This method must only be called
-     * if debugging is {@linkplain Debug#isEnabled() enabled}.
+     * if debugging is {@linkplain Debug#isEnabled() enabled} as it incurs allocation at the call
+     * site. If possible, call one of the other {@code log()} methods in this class that take a
+     * fixed number of parameters.
      * 
      * @param format a format string
      * @param args the arguments referenced by the format specifiers in {@code format}