tdf#80589 Add help page for Expert Configuration

Change-Id: I07b23a13c77ffd028998d0583ab7d66615d060ae Reviewed-on: https://gerrit.libreoffice.org/18375 Reviewed-by: Caolán McNamara <caolanm@redhat.com> Tested-by: Caolán McNamara <caolanm@redhat.com>
author: Olivier Hallot <olivier.hallot@edx.srv.br> 2015-09-07 09:46:54 -0300
committer: Caolán McNamara <caolanm@redhat.com> 2015-09-13 19:39:16 +0000
commit: dad7181e3a620b129ac0c0e9842c55730c41b170 (patch)
tree: 9b85575d62e0c0aeba50b255678b228642eac1b7
parent: e898a3bb4d3fc992a2b3acfde48fec72014ff37e (diff)
4 files changed, 144 insertions, 31 deletions
diff --git a/AllLangHelp_shared.mk b/AllLangHelp_shared.mk
index 50cd9a65c4..173b7082b0 100644
--- a/AllLangHelp_shared.mk
+++ b/AllLangHelp_shared.mk
@@ -901,6 +901,7 @@ $(eval $(call gb_AllLangHelp_add_helpfiles,shared,\
     helpcontent2/source/text/shared/optionen/BasicIDE \
     helpcontent2/source/text/shared/optionen/experimental \
     helpcontent2/source/text/shared/optionen/java \
+    helpcontent2/source/text/shared/optionen/expertconfig \
     helpcontent2/source/text/shared/optionen/javaclasspath \
     helpcontent2/source/text/shared/optionen/javaparameters \
     helpcontent2/source/text/shared/optionen/macrosecurity \
diff --git a/source/auxiliary/shared.tree b/source/auxiliary/shared.tree
index 6c48511366..b757ead9e3 100644
--- a/source/auxiliary/shared.tree
+++ b/source/auxiliary/shared.tree
@@ -51,6 +51,7 @@
 <topic id="shared/text/shared/optionen/01012000.xhp">Appearance</topic>
 <topic id="shared/text/shared/optionen/01013000.xhp">Accessibility</topic>
 <topic id="shared/text/shared/optionen/java.xhp">Advanced</topic>
+<topic id="shared/text/shared/optionen/expertconfig.xhp">Expert Configuration</topic>
 <topic id="shared/text/shared/optionen/persona_firefox.xhp">Personalization</topic>
 <topic id="shared/text/shared/optionen/BasicIDE.xhp">Basic IDE Options</topic>
 <topic id="shared/text/shared/optionen/opencl.xhp">OpenCL</topic>
diff --git a/source/text/shared/optionen/expertconfig.xhp b/source/text/shared/optionen/expertconfig.xhp
new file mode 100644
index 0000000000..c5d03ced2e
--- /dev/null
+++ b/source/text/shared/optionen/expertconfig.xhp
@@ -0,0 +1,87 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<helpdocument version="1.0">
+<!--
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This file incorporates work covered by the following license notice:
+ *
+ *   Licensed to the Apache Software Foundation (ASF) under one or more
+ *   contributor license agreements. See the NOTICE file distributed
+ *   with this work for additional information regarding copyright
+ *   ownership. The ASF licenses this file to you under the Apache
+ *   License, Version 2.0 (the "License"); you may not use this file
+ *   except in compliance with the License. You may obtain a copy of
+ *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
+-->
+
+<meta>
+  <topic id="topic_0709201509091142" status="PUBLISH">
+    <title xml-lang="en-US" id="tit">Expert Configuration</title>
+    <filename>/text/shared/optionen/expertconfig.xhp</filename>
+  </topic>
+</meta>
+
+<body>
+<bookmark xml-lang="en-US" branch="hid/cui/ui/aboutconfigdialog/AboutConfig" id="bm_id6982839" localize="false"/>
+<bookmark xml-lang="en-US" branch="index" id="bm_id0609201521552432">
+  <bookmark_value>expert configuration;setting options</bookmark_value>
+</bookmark>
+
+
+<paragraph id="hd_id0609201521430015" role="heading" xml-lang="en-US" level="1">Expert Configuration</paragraph>
+
+<section id="howtoget">
+<paragraph id="par_id0609201521430059" role="paragraph" xml-lang="en-US">Choose <emph>Tools – Options – %PRODUCTNAME – Advanced – Expert Configuration</emph></paragraph>
+</section>
+<paragraph id="par_id0609201521211455" role="paragraph" xml-lang="en-US"><ahelp hid="">Opens the Expert Configuration dialog for advanced settings and configuration of %PRODUCTNAME.</ahelp> The Expert Configuration dialog allows user to access hundreds of %PRODUCTNAME configuration preferences, and most of them are not available in the user interface or in the options dialogs.</paragraph>
+<paragraph id="par_id0609201521211432" role="warning" xml-lang="en-US">The Expert Configuration dialog let you access, edit and save configuration preferences that can harm your %PRODUCTNAME user profile. It can turn the user profile of %PRODUCTNAME unstable, inconsistent or even unusable. Proceed only if you know what you are doing.</paragraph>
+<paragraph id="par_id0609201521305414" role="tip" xml-lang="en-US">The expert configuration does not modify the %PRODUCTNAME system installation in your computer.</paragraph>
+
+<paragraph id="hd_id0609201523011635" role="heading" xml-lang="en-US" level="2">Text search entry area</paragraph>
+<paragraph id="par_id0609201523011613" role="paragraph" xml-lang="en-US"><ahelp hid="cui/ui/aboutconfigdialog/searchEntry">Type the preference you want to display in the text area</ahelp>. Then click in the Search button.</paragraph>
+
+<paragraph id="hd_id0609201523011655" role="heading" xml-lang="en-US" level="2">Search button</paragraph>
+<paragraph id="par_id0609201523011660" role="paragraph" xml-lang="en-US"><ahelp hid="cui/ui/aboutconfigdialog/searchButton">Click to search your preference text in the Preferences tree.</ahelp></paragraph>
+
+<paragraph id="hd_id0609201523011616" role="heading" xml-lang="en-US" level="2">Preferences tree</paragraph>
+<paragraph id="par_id0609201523011650" role="paragraph" xml-lang="en-US"><ahelp hid="cui/ui/aboutconfigdialog/preferences">List the preferences organized hierarchically in a tree layout.</ahelp> To open the branches, double click in the (+) sign. Once the preference is visible in the tree, you can edit it.</paragraph>
+
+<paragraph id="hd_id0609201523011617" role="heading" xml-lang="en-US" level="3">Preference Name</paragraph>
+<paragraph id="par_id0609201523011639" role="paragraph" xml-lang="en-US">The name of the preference.</paragraph>
+
+<paragraph id="hd_id0609201523011665" role="heading" xml-lang="en-US" level="3">Property</paragraph>
+<paragraph id="par_id0609201523011673" role="paragraph" xml-lang="en-US">Shows the name of the property of the preference.</paragraph>
+
+<paragraph id="hd_id0609201523011688" role="heading" xml-lang="en-US" level="3">Type</paragraph>
+<paragraph id="par_id0609201523011699" role="paragraph" xml-lang="en-US">Defines the type of the property. Valid types are:</paragraph>
+
+<list type="unordered">
+  <listitem>
+    <paragraph id="par_id0709201509091312" role="ul_item" xml-lang="en-US"><item type="literal">string</item>: Alphanumeric values;</paragraph>
+  </listitem>
+  <listitem>
+    <paragraph id="par_id0709201509091353" role="ul_item" xml-lang="en-US"><item type="literal">long</item>: integer numbers;</paragraph>
+  </listitem>
+  <listitem>
+    <paragraph id="par_id0709201509091351" role="ul_item" xml-lang="en-US"><item type="literal">boolean</item>: true or false values;</paragraph>
+  </listitem>
+  <listitem>
+    <paragraph id="par_id0709201509091355" role="ul_item" xml-lang="en-US"><item type="literal">void</item>: properties of type of <item type="literal">void</item> cannot be modified.</paragraph>
+  </listitem></list>
+
+<paragraph id="hd_id0609201523011612" role="heading" xml-lang="en-US" level="3">Value</paragraph>
+<paragraph id="par_id0609201523011630" role="paragraph" xml-lang="en-US">Current value of the property..</paragraph>
+
+<paragraph id="hd_id0609201523011642" role="heading" xml-lang="en-US" level="2">Edit</paragraph>
+<paragraph id="par_id060920152301168" role="paragraph" xml-lang="en-US"><ahelp hid="cui/ui/aboutconfigdialog/edit">Opens a dialog to edit the preference.</ahelp></paragraph>
+<paragraph id="par_id0609201523043085" role="tip" xml-lang="en-US">You can double click in the preference row to edit the current value of the property.</paragraph>
+
+<paragraph id="hd_id0709201508091163" role="heading" xml-lang="en-US" level="2">Reset</paragraph>
+<paragraph id="par_id0709201508091160" role="paragraph" xml-lang="en-US"><ahelp hid="cui/ui/aboutconfigdialog/reset">Undo changes done so far in this dialog.</ahelp></paragraph>
+</body>
+
+</helpdocument>
+\ No newline at end of file
diff --git a/source/text/shared/optionen/java.xhp b/source/text/shared/optionen/java.xhp
index bfe8ee9560..f5de9d636f 100644
--- a/source/text/shared/optionen/java.xhp
+++ b/source/text/shared/optionen/java.xhp
@@ -1,7 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-
-
+<helpdocument version="1.0">
 <!--
  * This file is part of the LibreOffice project.
  *
@@ -18,41 +16,67 @@
  *   License, Version 2.0 (the "License"); you may not use this file
  *   except in compliance with the License. You may obtain a copy of
  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
- -->
+-->
 
-
-		<helpdocument version="1.0">
 <meta>
-<topic id="textsharedoptionenjavaxml" indexer="include" status="PUBLISH">
-<title id="tit" xml-lang="en-US">Advanced</title>
-<filename>/text/shared/optionen/java.xhp</filename>
-</topic>
+  <topic id="textsharedoptionenjavaxml" indexer="include" status="PUBLISH">
+    <title xml-lang="en-US" id="tit">Advanced</title>
+    <filename>/text/shared/optionen/java.xhp</filename>
+  </topic>
 </meta>
+
 <body>
+
+
 <section id="advanced">
 <bookmark xml-lang="en-US" branch="hid/cui/ui/optadvancedpage/OptAdvancedPage" id="bm_id6882839" localize="false"/>
-<bookmark xml-lang="en-US" branch="index" id="bm_id4077578"><bookmark_value>Java;setting options</bookmark_value><bookmark_value>experimental features</bookmark_value><bookmark_value>unstable options</bookmark_value>
+<bookmark xml-lang="en-US" branch="index" id="bm_id4077578">
+  <bookmark_value>Java;setting options</bookmark_value>
+  <bookmark_value>experimental features</bookmark_value>
+  <bookmark_value>unstable options</bookmark_value>
+  <bookmark_value>expert configuration;setting options</bookmark_value>
 </bookmark>
-<paragraph role="heading" id="par_idN10558" xml-lang="en-US" level="1" l10n="NEW"><link href="text/shared/optionen/java.xhp">Advanced</link></paragraph>
-<paragraph role="paragraph" id="par_idN10568" xml-lang="en-US" l10n="CHG">Specifies the support options for Java applications in %PRODUCTNAME, including which Java Runtime Environment (JRE) to use. It also specifies whether to use experimental (unstable) features such as macro recording.</paragraph>
+
+
+<paragraph id="par_idN10558" role="heading" xml-lang="en-US" level="1"><link href="text/shared/optionen/java.xhp">Advanced</link></paragraph>
+<paragraph id="par_idN10568" role="paragraph" xml-lang="en-US">Specifies the support options for Java applications in %PRODUCTNAME, including which Java Runtime Environment (JRE) to use. It also specifies whether to use experimental (unstable) features such as macro recording and access expert configuration.</paragraph>
 </section>
-<section id="howtoget">
-  <embed href="text/shared/00/00000406.xhp#advanced"/>
+
+<section id="howtoget"><embed href="text/shared/00/00000406.xhp#advanced"/>
 </section>
-<paragraph role="heading" id="par_idN1056B" xml-lang="en-US" level="2" l10n="NEW">Java options</paragraph>
-<bookmark xml-lang="en-US" branch="hid/cui/ui/optadvancedpage/javaenabled" id="bm_id6882839" localize="false"/><paragraph role="heading" id="par_idN1057F" xml-lang="en-US" level="3" l10n="NEW">Use a Java runtime environment</paragraph>
-<paragraph role="paragraph" id="par_idN10583" xml-lang="en-US" l10n="CHG"><ahelp hid="cui/ui/optadvancedpage/javaenabled">Allows you to run Java applications in %PRODUCTNAME.</ahelp> When a Java application attempts to access your hard drive, a prompt opens.<comment>UFI: moved this para here from Security tab page</comment></paragraph>
-<bookmark xml-lang="en-US" branch="hid/cui/ui/optadvancedpage/javas" id="bm_id6775719" localize="false"/><paragraph role="heading" id="par_idN10610" xml-lang="en-US" level="3" l10n="NEW">Java runtime environments (JRE) already installed:</paragraph>
-<paragraph role="paragraph" id="par_idN10614" xml-lang="en-US" l10n="CHG"><ahelp hid="cui/ui/optadvancedpage/javas">Select the JRE that you want to use. On some systems, you must wait a minute until the list gets populated. On some systems, you must restart %PRODUCTNAME to use your changed setting.</ahelp> The path to the JRE is displayed beneath the list box.</paragraph>
-<bookmark xml-lang="en-US" branch="hid/cui/ui/optadvancedpage/add" id="bm_id5543382" localize="false"/><paragraph role="heading" id="par_idN105A5" xml-lang="en-US" level="3" l10n="NEW">Add</paragraph>
-<paragraph role="paragraph" id="par_idN10635" xml-lang="en-US" l10n="CHG"><ahelp hid="cui/ui/optadvancedpage/add">Add a path to the root folder of a JRE on your computer.</ahelp> The path is set in the following dialog.<comment>UFI: #i38927#</comment></paragraph>
-<bookmark xml-lang="en-US" branch="hid/cui/ui/optadvancedpage/parameters" id="bm_id1588793" localize="false"/><paragraph role="heading" id="par_idN105A9" xml-lang="en-US" level="3" l10n="NEW">Parameters</paragraph>
-<paragraph role="paragraph" id="par_idN10657" xml-lang="en-US" l10n="NEW"><ahelp hid="cui/ui/optadvancedpage/parameters">Opens the <link href="text/shared/optionen/javaparameters.xhp">Java Start Parameters</link> dialog.</ahelp></paragraph>
-<bookmark xml-lang="en-US" branch="hid/cui/ui/optadvancedpage/classpath" id="bm_id5799127" localize="false"/><paragraph role="heading" id="par_idN105AD" xml-lang="en-US" level="3" l10n="NEW">Class Path</paragraph>
-<paragraph role="paragraph" id="par_idN10686" xml-lang="en-US" l10n="NEW"><ahelp hid="cui/ui/optadvancedpage/classpath">Opens the <link href="text/shared/optionen/javaclasspath.xhp">Class Path</link> dialog.</ahelp></paragraph>
-<paragraph xml-lang="en-US" id="hd_id3148618" role="heading" level="2">Optional (unstable) options</paragraph>
-<paragraph xml-lang="en-US" id="hd_id3148619" role="heading" level="3"><ahelp hid="cui/ui/optadvancedpage/experimental">Enable experimental features</ahelp></paragraph>
-<paragraph xml-lang="en-US" id="par_id3156344" role="paragraph">It enables features that are not yet complete or contain known bugs. The list of these features is different version by version, or even it can be empty.</paragraph>
-<paragraph xml-lang="en-US" id="hd_id3148610" role="heading" level="3"><ahelp hid="cui/ui/optadvancedpage/macrorecording">Enable macro recording</ahelp></paragraph><paragraph xml-lang="en-US" id="par_id3156345" role="paragraph">It enables macro recording, so the <link href="text/shared/guide/macro_recording.xhp" name="Tools - Macros - Record Macro"><item type="menuitem">Tools - Macros - Record Macro</item></link> menu item will be available.</paragraph>
+
+<paragraph id="par_idN1056B" role="heading" xml-lang="en-US" level="2">Java options</paragraph>
+<bookmark xml-lang="en-US" branch="hid/cui/ui/optadvancedpage/javaenabled" id="bm_id6882839" localize="false"/>
+
+<paragraph id="par_idN1057F" role="heading" xml-lang="en-US" level="3">Use a Java runtime environment</paragraph>
+<paragraph id="par_idN10583" role="paragraph" xml-lang="en-US"><ahelp hid="cui/ui/optadvancedpage/javaenabled">Allows you to run Java applications in %PRODUCTNAME.</ahelp> When a Java application attempts to access your hard drive, a prompt opens.<comment>UFI: moved this para here from Security tab page</comment></paragraph>
+<bookmark xml-lang="en-US" branch="hid/cui/ui/optadvancedpage/javas" id="bm_id6775719" localize="false"/>
+
+<paragraph id="par_idN10610" role="heading" xml-lang="en-US" level="3">Java runtime environments (JRE) already installed:</paragraph>
+<paragraph id="par_idN10614" role="paragraph" xml-lang="en-US"><ahelp hid="cui/ui/optadvancedpage/javas">Select the JRE that you want to use. On some systems, you must wait a minute until the list gets populated. On some systems, you must restart %PRODUCTNAME to use your changed setting.</ahelp> The path to the JRE is displayed beneath the list box.</paragraph>
+<bookmark xml-lang="en-US" branch="hid/cui/ui/optadvancedpage/add" id="bm_id5543382" localize="false"/>
+
+<paragraph id="par_idN105A5" role="heading" xml-lang="en-US" level="3">Add</paragraph>
+<paragraph id="par_idN10635" role="paragraph" xml-lang="en-US"><ahelp hid="cui/ui/optadvancedpage/add">Add a path to the root folder of a JRE on your computer.</ahelp> The path is set in the following dialog.<comment>UFI: #i38927#</comment></paragraph>
+<bookmark xml-lang="en-US" branch="hid/cui/ui/optadvancedpage/parameters" id="bm_id1588793" localize="false"/>
+
+<paragraph id="par_idN105A9" role="heading" xml-lang="en-US" level="3">Parameters</paragraph>
+<paragraph id="par_idN10657" role="paragraph" xml-lang="en-US"><ahelp hid="cui/ui/optadvancedpage/parameters">Opens the <link href="text/shared/optionen/javaparameters.xhp">Java Start Parameters</link> dialog.</ahelp></paragraph>
+<bookmark xml-lang="en-US" branch="hid/cui/ui/optadvancedpage/classpath" id="bm_id5799127" localize="false"/>
+
+<paragraph id="par_idN105AD" role="heading" xml-lang="en-US" level="3">Class Path</paragraph>
+<paragraph id="par_idN10686" role="paragraph" xml-lang="en-US"><ahelp hid="cui/ui/optadvancedpage/classpath">Opens the <link href="text/shared/optionen/javaclasspath.xhp">Class Path</link> dialog.</ahelp></paragraph>
+
+<paragraph id="hd_id3148618" role="heading" xml-lang="en-US" level="2">Optional (unstable) options</paragraph>
+
+<paragraph id="hd_id3148619" role="heading" xml-lang="en-US" level="3"><ahelp hid="cui/ui/optadvancedpage/experimental">Enable experimental features</ahelp></paragraph>
+<paragraph id="par_id3156344" role="paragraph" xml-lang="en-US">It enables features that are not yet complete or contain known bugs. The list of these features is different version by version, or even it can be empty.</paragraph>
+
+<paragraph id="hd_id3148610" role="heading" xml-lang="en-US" level="3"><ahelp hid="cui/ui/optadvancedpage/macrorecording">Enable macro recording</ahelp></paragraph>
+<paragraph id="par_id3156345" role="paragraph" xml-lang="en-US">It enables macro recording, so the <link href="text/shared/guide/macro_recording.xhp" name="Tools - Macros - Record Macro"><item type="menuitem">Tools - Macros - Record Macro</item></link> menu item will be available.</paragraph>
+
+<paragraph id="hd_id0609201521211497" role="heading" xml-lang="en-US" level="2"><link href="text/shared/optionen/expertconfig.xhp">Expert Configuration</link></paragraph>
+<paragraph id="par_id0609201521444658" role="paragraph" xml-lang="en-US"><ahelp hid="cui/ui/optadvancedpage/expertconfig">Opens the Expert Configuration dialog for advanced settings and configuration of %PRODUCTNAME.</ahelp></paragraph>
 </body>
-</helpdocument>
+
+</helpdocument>
+\ No newline at end of file
author	Olivier Hallot <olivier.hallot@edx.srv.br>	2015-09-07 09:46:54 -0300
committer	Caolán McNamara <caolanm@redhat.com>	2015-09-13 19:39:16 +0000
commit	dad7181e3a620b129ac0c0e9842c55730c41b170 (patch)
tree	9b85575d62e0c0aeba50b255678b228642eac1b7
parent	e898a3bb4d3fc992a2b3acfde48fec72014ff37e (diff)