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>
diff --git a/AllLangHelp_shared.mk b/AllLangHelp_shared.mk
index 50cd9a6..173b708 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 6c48511..b757ead 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 0000000..c5d03ce
--- /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 bfe8ee9..f5de9d6 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
