[Libreoffice-commits] help.git: source/text

Seth Chaiklin (via logerrit) logerrit at kemper.freedesktop.org
Mon Nov 30 20:24:14 UTC 2020 

 source/text/shared/optionen/01140000.xhp |   57 ++++++++++++++++++++-----------
 1 file changed, 38 insertions(+), 19 deletions(-)

New commits:
commit 6e7f4ece270fd504303ab279795462ce22c3de27
Author:     Seth Chaiklin <sdc.blanco at youmail.dk>
AuthorDate: Tue Nov 24 14:22:43 2020 +0100
Commit:     Seth Chaiklin <sdc.blanco at youmail.dk>
CommitDate: Mon Nov 30 21:23:54 2020 +0100

    tdf#138389 update help for Options>Language Settings>Languages, especially Date Acceptance Patterns
    
       *corrected and elaborated "Date Acceptance Patterns" section
         + Added explanation about how to use date acceptance.
         + Added explanation about how default patterns are provided.
         + Added explanation about how patterns are lost with locale change.
         + Added explanations for how to make Date Acceptance Patterns.
         * Corrected explanation about Y-M-D pattern.
           Thanks to Eike Rathke and Mike Kaganski for technical advice
             about "Date acceptance patterns".
       * re-arrange controls to correspond to order in dialog box
       * change label:  "CTL" --> "Complex text layout"
    
    Change-Id: I586698ce6eb986e3b3baab9e55db4a601723e3bd
    Reviewed-on: https://gerrit.libreoffice.org/c/help/+/106510
    Tested-by: Jenkins
    Reviewed-by: Seth Chaiklin <sdc.blanco at youmail.dk>

diff --git a/source/text/shared/optionen/01140000.xhp b/source/text/shared/optionen/01140000.xhp
index 57303fa15..ba8f0f384 100644
--- a/source/text/shared/optionen/01140000.xhp
+++ b/source/text/shared/optionen/01140000.xhp
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <helpdocument version="1.0">
-
 <!--
  * This file is part of the LibreOffice project.
  *
@@ -19,10 +18,9 @@
  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  -->
 
-
 <meta>
       <topic id="textsharedoptionen01140000xml" indexer="include" status="PUBLISH">
-         <title xml-lang="en-US" id="tit">Languages</title>
+         <title xml-lang="en-US" id="tit">Languages (Options)</title>
          <filename>/text/shared/optionen/01140000.xhp</filename>
       </topic>
    </meta>
@@ -60,20 +58,41 @@
       <paragraph xml-lang="en-US" id="par_id3157958" role="paragraph"><ahelp hid="cui/ui/optlanguagespage/localesetting">Specifies the locale setting of the country setting. This influences settings for numbering, currency and units of measure.</ahelp></paragraph>
       <paragraph xml-lang="en-US" id="par_id0125201009445950" role="paragraph">The "Default" entry selects the locale which name is reported by the operating system.</paragraph>
       <paragraph xml-lang="en-US" id="par_id3156410" role="paragraph">A change in this field is immediately applicable. However, some formats that were formatted by default change only if the document is newly loaded.</paragraph>
-<bookmark xml-lang="en-US" branch="hid/cui/ui/optlanguagespage/decimalseparator" id="bm_id2873012" localize="false"/>
-<h3 id="par_idN106DE">Decimal separator key - Same as locale setting</h3>
-      <paragraph xml-lang="en-US" id="par_idN106E2" role="paragraph"><ahelp hid=".">Specifies to use the decimal separator key that is set in your system when you press the respective key on the number pad.</ahelp></paragraph>
-      <paragraph xml-lang="en-US" id="par_idN106F1" role="paragraph">If this checkbox is activated, the character shown after "Same as locale setting" is inserted when you press the key on the number pad. If this checkbox is not activated, the character that your keyboard driver software provides is inserted.</paragraph>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/optlanguagespage/currencylb" id="bm_id9471419" localize="false"/>
 <h3 id="hd_id3147209">Default currency</h3>
       <paragraph xml-lang="en-US" id="par_id3145120" role="paragraph"><ahelp hid="cui/ui/optlanguagespage/currencylb">Specifies the default currency that is used for the currency format and the currency fields.</ahelp> If you change the locale setting, the default currency changes automatically.</paragraph>
       <paragraph xml-lang="en-US" id="par_id3148491" role="paragraph">The default entry applies to the currency format that is assigned to the selected locale setting.</paragraph>
       <paragraph xml-lang="en-US" id="par_id3157909" role="paragraph">A change in <emph>Default currency</emph> field will be transmitted to all open documents and will lead to corresponding changes in the dialogs and icons that control the currency format in these documents.</paragraph>
+<bookmark xml-lang="en-US" branch="hid/cui/ui/optlanguagespage/decimalseparator" id="bm_id2873012" localize="false"/>
+<h3 id="par_idN106DE">Decimal separator key - Same as locale setting</h3>
+      <paragraph xml-lang="en-US" id="par_idN106E2" role="paragraph"><ahelp hid=".">Specifies to use the decimal separator key that is set in your system when you press the respective key on the number pad.</ahelp></paragraph>
+      <paragraph xml-lang="en-US" id="par_idN106F1" role="paragraph">If this checkbox is activated, the character shown after "Same as locale setting" is inserted when you press the key on the number pad. If this checkbox is not activated, the character that your keyboard driver software provides is inserted.</paragraph>
+
 <bookmark xml-lang="en-US" branch="hid/cui/ui/optlanguagespage/datepatterns" id="bm_id9471429" localize="false"/>
 <h3 id="hd_id31472109">Date acceptance patterns</h3>
-      <paragraph xml-lang="en-US" id="par_id3145121" role="paragraph"><ahelp hid=".">Specifies the date acceptance patterns for the current locale. Calc spreadsheet and Writer table cell input needs to match locale dependent date acceptance patterns before it is recognized as a valid date.</ahelp> Default locale dependent date acceptance patterns are generated during build time, but it is possible to add more or modify them in this edit box.</paragraph>
-      <paragraph xml-lang="en-US" id="par_id3148492" role="paragraph">Additionally to the date acceptance patterns defined here, every locale accepts input in an ISO 8601 Y-M-D pattern, and since %PRODUCTNAME 3.5 that also leads to the YYYY-MM-DD format being applied.</paragraph>
-      <paragraph xml-lang="en-US" id="par_id3157939" role="paragraph">Syntax: <emph>Y</emph> means year, <emph>M</emph> means month, and <emph>D</emph> means day, regardless of localization.</paragraph>
+      <paragraph xml-lang="en-US" id="par_id3145121" role="paragraph"><ahelp hid=".">Specifies the date acceptance patterns for the current locale. Calc spreadsheet and Writer table cell input needs to match locale dependent date acceptance patterns before it is recognized as a valid date.</ahelp></paragraph>
+      <paragraph role="paragraph" id="par_id381606257267459">If you type numbers and characters that correspond to the defined date acceptance patterns in a table cell, and then move the cursor outside of the cell, %PRODUCTNAME will automatically recognize and convert the input to a date, and format it according to the locale setting.</paragraph> 
+      <paragraph role="paragraph" id="par_id391606257292899">The initial pattern(s) in <emph>Date acceptance patterns</emph> are determined by the locale (set in <emph>Locale setting</emph>), but you can modify these default patterns, and add more patterns.  Use <keycode>;</keycode> to separate each pattern.</paragraph> 
+      <paragraph role="paragraph" id="par_id261606302453895">Patterns can be composed according to the following rules:</paragraph>
+    <list type="unordered">
+     <listitem>
+      <paragraph id="par_id941606302524110" role="listitem">A pattern must start with <emph>D</emph>, <emph>M</emph>, or <emph>Y</emph>, and include at least two items, with at least one separator between each one. </paragraph>
+      <paragraph id="par_id961606302527780" role="listitem">A pattern may also include all three, in any order.</paragraph>
+     </listitem>
+     <listitem>
+      <paragraph xml-lang="en-US" id="par_id3157939" role="listitem"><emph>Y</emph> means year, <emph>M</emph> means month, and <emph>D</emph> means day, regardless of which locale is set. Each can only be used once in a pattern.</paragraph>
+     </listitem>
+     <listitem>
+      <paragraph id="par_id601606302514959" role="listitem"><keycode>.</keycode> <keycode>-</keycode> <keycode>:</keycode> <keycode>/</keycode> <keycode>,</keycode> can be used as separators between and after <emph>D</emph>, <emph>M</emph>, and <emph>Y</emph>.</paragraph>  
+      <paragraph id="par_id621606303306587" role="listitem">Any combination of separators can be used, and more than one separator can be used between <emph>D</emph>, <emph>M</emph>, and <emph>Y</emph>, but the input must match the separator pattern exactly for recognition.</paragraph> 
+     </listitem>
+     <listitem>
+      <paragraph id="par_id621606303767851" role="listitem">Patterns can combine different separators, and may include a trailing separator.</paragraph>
+      <paragraph role="listitem" id="par_id151606303867002">Examples of valid patterns are: <literal>D,Y ; Y-M ; M.D.Y  ; D-M/Y ;  M.D.</literal> </paragraph>
+     </listitem>
+    </list>
+      <paragraph role="paragraph" id="par_id181606257326394">If you change the <emph>Locale setting</emph>, the date acceptance pattern will be reset to the new locale default, and any user-defined modifications or additions will be lost.</paragraph>
+      <paragraph role="paragraph" id="par_id821606257357323">In addition to the patterns defined in the edit box, input matching the <literal>Y-M-D</literal> pattern is also recognized and converted automatically to a date, and since %PRODUCTNAME 3.5 is formatted as <literal>YYYY-MM-DD</literal> (ISO 8601).</paragraph>
       <h2 id="hd_id3153127">Default languages for documents</h2>
       <paragraph id="par_id3149763" role="paragraph">Specifies the languages for spelling, thesaurus and hyphenation.</paragraph>
       <embed href="text/shared/guide/language_select.xhp#language_select"/>
@@ -84,24 +103,24 @@
 <bookmark xml-lang="en-US" branch="hid/cui/ui/optlanguagespage/westernlanguage" id="bm_id4734946" localize="false"/>
 <h3 id="hd_id3151210">Western</h3>
       <paragraph xml-lang="en-US" id="par_id3153192" role="paragraph"><ahelp hid="cui/ui/optlanguagespage/westernlanguage">Specifies the language used for the spellcheck function in western alphabets.</ahelp></paragraph>
+<bookmark xml-lang="en-US" branch="hid/cui/ui/optlanguagespage/asiansupport" id="bm_id105594" localize="false"/>
+<h3 id="hd_id3148575">Show UI elements for East Asian writings</h3>
+      <paragraph xml-lang="en-US" id="par_id3145748" role="paragraph"><ahelp hid="cui/ui/optlanguagespage/asiansupport">Activates Asian languages support. You can now modify the corresponding Asian language settings in <item type="productname">%PRODUCTNAME</item>.</ahelp></paragraph>
+      <paragraph xml-lang="en-US" id="par_id3152938" role="paragraph">If you want to write in Chinese, Japanese or Korean, you can activate the support for these languages in the user interface.</paragraph>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/optlanguagespage/asianlanguage" id="bm_id908841" localize="false"/>
 <h3 id="hd_id3156422">Asian</h3>
       <paragraph xml-lang="en-US" id="par_id3159149" role="paragraph"><ahelp hid="cui/ui/optlanguagespage/asianlanguage">Specifies the language used for the spellcheck function in Asian alphabets.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/optlanguagespage/complexlanguage" id="bm_id2717062" localize="false"/>
-<h3 id="hd_id3158407">CTL</h3>
+<bookmark xml-lang="en-US" branch="hid/cui/ui/optlanguagespage/ctlsupport" id="bm_id295724" localize="false"/>
+<h3 id="hd_id3146147">Show UI elements for Bi-Directional writing</h3>
+      <paragraph xml-lang="en-US" id="par_id3149667" role="paragraph"><ahelp hid="cui/ui/optlanguagespage/ctlsupport">Activates complex text layout support. You can now modify the settings corresponding to complex text layout in <item type="productname">%PRODUCTNAME</item>.</ahelp></paragraph>
+      <embed href="text/shared/guide/ctl.xhp#ctl"/>
+<h3 id="hd_id3158407">Complex text layout</h3>
       <paragraph xml-lang="en-US" id="par_id3156212" role="paragraph"><ahelp hid="cui/ui/optlanguagespage/complexlanguage">Specifies the language for the complex text layout spellcheck.</ahelp></paragraph>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/optlanguagespage/currentdoc" id="bm_id3376262" localize="false"/>
 <h3 id="hd_id3149807">For the current document only</h3>
       <paragraph xml-lang="en-US" id="par_id3155432" role="paragraph"><ahelp hid="cui/ui/optlanguagespage/currentdoc">Specifies that the settings for default languages are valid only for the current document.</ahelp></paragraph>
       <h2 id="hd_id3156441">Enhanced language support</h2>
-<bookmark xml-lang="en-US" branch="hid/cui/ui/optlanguagespage/asiansupport" id="bm_id105594" localize="false"/>
-<h3 id="hd_id3148575">Show UI elements for East Asian writings</h3>
-      <paragraph xml-lang="en-US" id="par_id3145748" role="paragraph"><ahelp hid="cui/ui/optlanguagespage/asiansupport">Activates Asian languages support. You can now modify the corresponding Asian language settings in <item type="productname">%PRODUCTNAME</item>.</ahelp></paragraph>
-      <paragraph xml-lang="en-US" id="par_id3152938" role="paragraph">If you want to write in Chinese, Japanese or Korean, you can activate the support for these languages in the user interface.</paragraph>
-<bookmark xml-lang="en-US" branch="hid/cui/ui/optlanguagespage/ctlsupport" id="bm_id295724" localize="false"/>
-<h3 id="hd_id3146147">Show UI elements for Bi-Directional writing</h3>
-      <paragraph xml-lang="en-US" id="par_id3149667" role="paragraph"><ahelp hid="cui/ui/optlanguagespage/ctlsupport">Activates complex text layout support. You can now modify the settings corresponding to complex text layout in <item type="productname">%PRODUCTNAME</item>.</ahelp></paragraph>
-      <embed href="text/shared/guide/ctl.xhp#ctl"/>
 <bookmark xml-lang="en-US" branch="hid/cui/ui/optlanguagespage/ignorelanguagechange" id="bm_id295725" localize="false"/>
 <h3 id="hd_id3146148">Ignore system input language</h3>
       <paragraph xml-lang="en-US" id="par_id3149668" role="paragraph"><ahelp hid=".">Indicates whether changes to the system input language/keyboard will be ignored. If ignored, when new text is typed that text will follow the language of the document or current paragraph, not the current system language.</ahelp></paragraph>

More information about the Libreoffice-commits mailing list