Bug 61520: Add JavaDoc about name-references in Excel

git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@1808763 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/src/java/org/apache/poi/ss/usermodel/Name.java b/src/java/org/apache/poi/ss/usermodel/Name.java
index 983e438b5d86e34aa13e025b7885c6964d6b1b97..67bc245d0ccdf11a0e76cfc99ea490ab9f0a60a7 100644 (file)
--- a/src/java/org/apache/poi/ss/usermodel/Name.java
+++ b/src/java/org/apache/poi/ss/usermodel/Name.java
@@ -134,6 +134,11 @@ public interface Name {
      *  <li><code>-PMT(Interest_Rate/12,Number_of_Payments,Loan_Amount)</li>
      * </ul>
      *
+     * Note: Using relative values like 'A1:B1' can lead to unexpected moving of
+     *      the cell that the name points to when working with the workbook in Microsoft Excel,
+     *      usually using absolute references like '$A$1:$B$1' avoids this, see also
+     *      https://superuser.com/a/1031047/126954
+     *
      * @param formulaText the reference for this name
      * @throws IllegalArgumentException if the specified formulaText is unparsable
     */