From: Dominik Stadler <centic@apache.org>
Date: Mon, 18 Sep 2017 18:55:07 +0000 (+0000)
Subject: Bug 61520: Add JavaDoc about name-references in Excel
X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=357816942a6008b12fe5a068a4066e46b11e8f92;p=poi.git

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 983e438b5d..67bc245d0c 100644
--- 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
     */