tdf#114240 Add note on extension security

Added note on extension security. Expert configuration
settings deliberately ommitted not to tempt end user.

Change-Id: I28d9398c3b2abc8bea44c2956c16bb11d600fb9f
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/114585
Tested-by: Adolfo Jayme Barrientos <fitojb@ubuntu.com>
Reviewed-by: Adolfo Jayme Barrientos <fitojb@ubuntu.com>

1 files changed, 18 insertions, 16 deletions

diff --git a/source/text/shared/01/packagemanager.xhp b/source/text/shared/01/packagemanager.xhp
index 1281912a91..c0287f3e7d 100644
--- a/source/text/shared/01/packagemanager.xhp
+++ b/source/text/shared/01/packagemanager.xhp
@@ -1,4 +1,5 @@
-<?xml version="1.0" encoding="UTF-8"?><helpdocument version="1.0">
+<?xml version="1.0" encoding="UTF-8"?>
+<helpdocument version="1.0">
 <!--
  * This file is part of the LibreOffice project.
  *
@@ -33,9 +34,10 @@
 <bookmark xml-lang="en-US" branch="hid/desktop/ui/extensionmanager/@@nowidget@@" id="@@nowidget@@" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/desktop/ui/extensionmanager/ExtensionManagerDialog" id="bm_id307931" localize="false"/>
 <bookmark xml-lang="en-US" branch="hid/service:com.sun.star.deployment.ui.PackageManagerDialog" id="bm_id2198553" localize="false"/>
-<paragraph id="par_idN10543" role="heading" xml-lang="en-US" level="1"><link href="text/shared/01/packagemanager.xhp">Extension Manager</link></paragraph>
+<h1 id="par_idN10543"><link href="text/shared/01/packagemanager.xhp">Extension Manager</link></h1>
 <paragraph id="par_idN10553" role="paragraph" xml-lang="en-US"><ahelp hid="desktop/ui/extensionmanager/ExtensionManagerDialog">The Extension Manager adds, removes, disables, enables, and updates %PRODUCTNAME extensions.</ahelp></paragraph>
 </section>
+<note id="par_id941619265371175">For security reasons, the installation and removal of extensions are controlled by settings in the <link href="text/shared/optionen/expertconfig.xhp" name="expert configuration">Expert Configuration</link>. By default, installation and removal are enabled.</note>
 <section id="howtoget"><embed href="text/shared/00/00000406.xhp#packagemanager"/>
 </section>
 <paragraph id="par_idN10615" role="paragraph" xml-lang="en-US">The following are examples of %PRODUCTNAME extensions:</paragraph>
@@ -57,7 +59,7 @@
 </listitem>
 </list>
 <section id="extscope">
-<paragraph id="hd_id8570513" role="heading" xml-lang="en-US" level="2">Extension Scope</paragraph>
+<h2 id="hd_id8570513">Extension Scope</h2>
 </section>
 <paragraph id="par_idN1068A" role="paragraph" xml-lang="en-US">Users with administrator or root privileges will see a dialog where they can choose to install extensions "for all users" or "only for me". Normal users without those privileges can install, remove, or modify extensions only for their own use.</paragraph>
 <list type="ordered">
@@ -68,11 +70,11 @@
 <paragraph id="par_idN1069C" role="paragraph" xml-lang="en-US">A user without root privileges can only install an extension for own usage. This is called a user extension.</paragraph>
 </listitem>
 </list><comment>UFI: Extension Guide needed. Until we have that guide, I'll add some more info in this file.</comment>
-<paragraph id="hd_id3895382" role="heading" xml-lang="en-US" level="2">To install an extension</paragraph>
+<h2 id="hd_id3895382">To install an extension</h2>
 <paragraph id="par_id9143955" role="paragraph" xml-lang="en-US">An extension is available as a file with the file extension .oxt.</paragraph>
 <bookmark xml-lang="en-US" branch="hid/desktop/ui/extensionmanager/getextensions" id="bm_id8800926" localize="false"/>
 <paragraph id="par_id7857905" role="paragraph" xml-lang="en-US"><ahelp hid=".">You can find a collection of extensions on the Web.</ahelp> Click the "Get more extensions online" link in the Extension Manager to open your Web browser and see the <link href="https://extensions.libreoffice.org/">https://extensions.libreoffice.org/</link> page.</paragraph>
-<paragraph id="hd_id5016937" role="heading" xml-lang="en-US" level="3">To install a user extension</paragraph>
+<h3 id="hd_id5016937">To install a user extension</h3>
 <paragraph id="par_id1856440" role="paragraph" xml-lang="en-US">Do any of the following:</paragraph>
 <list type="ordered">
 <listitem>
@@ -85,7 +87,7 @@
 <paragraph id="par_id8714255" role="paragraph" xml-lang="en-US">Choose <item type="menuitem">Tools - Extension Manager</item> and click <item type="menuitem">Add</item>.</paragraph>
 </listitem>
 </list>
-<paragraph id="hd_id3734550" role="heading" xml-lang="en-US" level="4">To install a shared extension in text mode (for system administrators)</paragraph>
+<h4 id="hd_id3734550">To install a shared extension in text mode (for system administrators)</h4>
 <list type="ordered">
 <listitem>
 <paragraph id="par_id4139225" role="paragraph" xml-lang="en-US">As an administrator, open a terminal or command shell.</paragraph>
@@ -104,7 +106,7 @@
 <paragraph id="par_idN106AD" role="paragraph" xml-lang="en-US"><ahelp hid=".">Select the extension that you want to remove, enable, or disable. For some extensions, you can also open an Options dialog.</ahelp></paragraph>
 
 <bookmark xml-lang="en-US" branch="hid/desktop/ui/extensionmanager/addbtn" id="bm_id8800928" localize="false"/>
-<paragraph id="par_idN10639" role="heading" xml-lang="en-US" level="2">Add</paragraph>
+<h2 id="par_idN10639">Add</h2>
 <paragraph id="par_idN106BA" role="paragraph" xml-lang="en-US"><ahelp hid="desktop/ui/extensionmanager/addbtn">Click Add to add an extension.</ahelp></paragraph>
 <paragraph id="par_idN106BD" role="paragraph" xml-lang="en-US">A file dialog opens where you can select the extension that you want to add. To copy and to register the selected extension, click Open.</paragraph>
 
@@ -113,38 +115,38 @@
 <paragraph id="par_id4856410" role="paragraph" xml-lang="en-US">An extension can show a license dialog. <ahelp hid="desktop/ui/showlicensedialog/ShowLicenseDialog">Read the license. Click the Scroll Down button to scroll down if necessary. Click Accept to continue the installation of the extension.</ahelp></paragraph><comment>insert hidden text for Show License</comment>
 
 <bookmark xml-lang="en-US" branch="hid/desktop/ui/extensionmanager/removebtn" id="bm_id0523200810562584" localize="false"/>
-<paragraph id="par_idN10643" role="heading" xml-lang="en-US" level="2">Remove</paragraph>
+<h2 id="par_idN10643">Remove</h2>
 <paragraph id="par_idN106D1" role="paragraph" xml-lang="en-US"><ahelp hid=".">Select the extension that you want to remove, and then click Remove.</ahelp></paragraph>
 
 <bookmark xml-lang="en-US" branch="hid/DESKTOP_HID_EXTENSION_MANAGER_LISTBOX_ENABLE" id="bm_id8800928" localize="false"/>
-<paragraph id="par_idN1064D" role="heading" xml-lang="en-US" level="2">Enable</paragraph>
+<h2 id="par_idN1064D">Enable</h2>
 <paragraph id="par_idN106DE" role="paragraph" xml-lang="en-US"><ahelp hid="DESKTOP_HID_EXTENSION_MANAGER_LISTBOX_ENABLE">Select the extension that you want to enable, and then click Enable.</ahelp></paragraph>
 
 <bookmark xml-lang="en-US" branch="hid/DESKTOP_HID_EXTENSION_MANAGER_LISTBOX_DISABLE" id="bm_id8800929" localize="false"/>
-<paragraph id="par_idN10657" role="heading" xml-lang="en-US" level="2">Disable</paragraph>
+<h2 id="par_idN10657">Disable</h2>
 <paragraph id="par_idN106EB" role="paragraph" xml-lang="en-US"><ahelp hid="DESKTOP_HID_EXTENSION_MANAGER_LISTBOX_DISABLE">Select the extension that you want to disable, and then click Disable.</ahelp></paragraph>
 
 <bookmark xml-lang="en-US" branch="hid/desktop/ui/extensionmanager/updatebtn" id="bm_id8800930" localize="false"/>
-<paragraph id="hd_id4453566" role="heading" xml-lang="en-US" level="2">Update</paragraph>
+<h2 id="hd_id4453566">Update</h2>
 <paragraph id="par_id4129459" role="paragraph" xml-lang="en-US"><ahelp hid="desktop/ui/extensionmanager/updatebtn">Click to check for online updates of all installed extensions. To check for updates of the selected extension only, choose the Update command from the context menu. The check for availability of updates starts immediately.</ahelp> You will see the <link href="text/shared/01/extensionupdate.xhp">Extension Update</link> dialog.</paragraph>
 
 <bookmark xml-lang="en-US" branch="hid/desktop/ui/extensionmanager/optionsbtn" id="bm_id052320081054360" localize="false"/>
-<paragraph id="hd_id4921414" role="heading" xml-lang="en-US" level="2">Options</paragraph>
+<h2 id="hd_id4921414">Options</h2>
 <paragraph id="par_id1439558" role="paragraph" xml-lang="en-US"><ahelp hid=".">Select an installed extension, then click to open the Options dialog for the extension.</ahelp></paragraph>
 
-<paragraph id="hd_id4921415" role="heading" xml-lang="en-US" level="2">Display Extensions</paragraph>
+<h2 id="hd_id4921415">Display Extensions</h2>
 <paragraph id="par_id1439559" role="paragraph" xml-lang="en-US">You can filter the list of displayed extensions by their <link href="text/shared/01/packagemanager.xhp#extscope">scope</link>.</paragraph>
 
 <bookmark xml-lang="en-US" branch="hid/desktop/ui/extensionmanager/bundled" id="bm_id052320081054361" localize="false"/>
-<paragraph id="par_id0103201110331828" role="heading" xml-lang="en-US" level="3">Bundled with %PRODUCTNAME</paragraph>
+<h3 id="par_id0103201110331828">Bundled with %PRODUCTNAME</h3>
 <paragraph id="par_id1439560" role="paragraph" xml-lang="en-US"><ahelp hid=".">Bundled extensions are installed by the system administrator using the operating system specific installer packages. These can not be installed, updated or removed here.</ahelp></paragraph>
 
 <bookmark xml-lang="en-US" branch="hid/desktop/ui/extensionmanager/shared" id="bm_id052320081054362" localize="false"/>
-<paragraph id="par_id0103201110331829" role="heading" xml-lang="en-US" level="3">Installed for all users</paragraph>
+<h3 id="par_id0103201110331829">Installed for all users</h3>
 <paragraph id="par_id1439561" role="paragraph" xml-lang="en-US"><ahelp hid=".">Filter extensions available for all users of this computer.</ahelp> These can be updated or removed only with administrator or root privileges.</paragraph>
 
 <bookmark xml-lang="en-US" branch="hid/desktop/ui/extensionmanager/user" id="bm_id052320081054363" localize="false"/>
-<paragraph id="par_id0103201110331830" role="heading" xml-lang="en-US" level="3">Installed for current user</paragraph>
+<h3 id="par_id0103201110331830">Installed for current user</h3>
 <paragraph id="par_id1439562" role="paragraph" xml-lang="en-US"><ahelp hid=".">Filter extensions only available for the currently logged in user.</ahelp></paragraph>
 
 <paragraph id="par_id0103201110331832" role="paragraph" xml-lang="en-US">Some additional commands can appear in the context menu of an extension in the Extension Manager window, depending on the selected extension. You can choose to show the license text again. You can choose to exclude the extension from checking for updates or to include an excluded extension.</paragraph>