source/text/scalc/guide/address_auto.xhp | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-)
New commits: commit 77ac257cd73c3420134ac68abd53da5d389286f6 Author: Eike Rathke <er...@redhat.com> AuthorDate: Mon Nov 28 20:25:53 2022 +0100 Commit: Eike Rathke <er...@redhat.com> CommitDate: Mon Nov 28 20:33:11 2022 +0100 Adjust using label names to reality Escaping a single quote with a backslash (\') was always wrong, and meanwhile the finding labels automatically feature was deactivated per default long time ago. Change-Id: I58057c36d1b7a23c60670e1972608a6b86ca7a07 Reviewed-on: https://gerrit.libreoffice.org/c/help/+/143415 Reviewed-by: Eike Rathke <er...@redhat.com> Tested-by: Jenkins diff --git a/source/text/scalc/guide/address_auto.xhp b/source/text/scalc/guide/address_auto.xhp index 03a55b5aca..0679b7aa7f 100644 --- a/source/text/scalc/guide/address_auto.xhp +++ b/source/text/scalc/guide/address_auto.xhp @@ -46,8 +46,9 @@ <paragraph id="par_id3152597" role="paragraph" xml-lang="en-US">You can use cells with text to refer to the rows or to the columns that contain the cells.</paragraph><comment>removed table as a workaround for issue 108715</comment> <paragraph id="par_id3156283" role="paragraph" xml-lang="en-US"><image id="img_id3154942" src="media/helpimg/names_as_addressing.png" width="5.408cm" height="2.212cm" localize="true"><alt xml-lang="en-US" id="alt_id3154942">Example spreadsheet</alt></image></paragraph> <paragraph id="par_id3154512" role="paragraph" xml-lang="en-US">In the example spreadsheet, you can use the string <item type="literal">'Column One'</item> in a formula to refer to the cell range <item type="literal">B3</item> to <item type="literal">B5</item>, or <item type="literal">'Column Two'</item> for the cell range <item type="literal">C2</item> to <item type="literal">C5</item>. You can also use <item type="literal">'Row One'</item> for the cell range <item type="literal">B3</item> to <item type="literal">D3</item>, or <item type="literal">'Row Two'</item> for the cell range <item type="literal">B4</item> to <item type="literal">D4</item>. The result of a formula that uses a cell name, for example, <item type="literal">SUM('Column One')</item>, is 600.</paragraph> -<paragraph id="par_id3155443" role="paragraph" xml-lang="en-US">This function is active by default. To turn this function off, choose <switchinline select="sys"><caseinline select="MAC"><emph>%PRODUCTNAME - Preferences</emph></caseinline><defaultinline><emph>Tools - Options</emph></defaultinline></switchinline><emph> - %PRODUCTNAME Calc - Calculate</emph> and clear the <emph>Automatically find column and row labels</emph> check box.</paragraph> -<paragraph id="par_id3149210" role="tip" xml-lang="en-US">If you want a name to be automatically recognized by Calc, the name must start with a letter and be composed of alphanumeric characters. If you enter the name in the formula yourself, enclose the name in single quotation marks ('). If a single quotation mark appears in a name, you must enter a backslash in front of the quotation mark, for example, <item type="literal">'Harry\'s Bar'</item>.</paragraph> +<paragraph id="par_id3155443" role="paragraph" xml-lang="en-US">Automatically finding labels is a legacy feature and deactivated by default as it can produce nondeterministic behavior depending on actual document content. To turn this function on, choose <switchinline select="sys"><caseinline select="MAC"><emph>%PRODUCTNAME - Preferences</emph></caseinline><defaultinline><emph>Tools - Options</emph></defaultinline></switchinline><emph> - %PRODUCTNAME Calc - Calculate</emph> and mark the <emph>Automatically find column and row labels</emph> check box.</paragraph> +<paragraph id="par_id3155444" role="paragraph" xml-lang="en-US">Using defined labels instead is always possible and behaves similar but in a defined way.</paragraph> +<paragraph id="par_id3149210" role="tip" xml-lang="en-US">If you enter a label name in the formula yourself, enclose the name in single quotation marks ('). If a single quotation mark appears in a name, you must double it, for example, <item type="literal">'Harry''s Bar'</item>.</paragraph> <section id="relatedtopics"><comment>mw changed reference to deleted Calc guide address_byname.xhp to refer to Calc guide value_with_name.xhp</comment><comment>UFI: changed embedvar links to embed links</comment> <embed href="text/scalc/guide/value_with_name.xhp#value_with_name"/>