GIT_SILENT Sync po/docbooks with svn

[dolphin.git] / doc / index.docbook

diff --git a/doc/index.docbook b/doc/index.docbook
index 05e1dca4581b9304a335d379697b8dc012846ced..43ee0db44d3630162cd380ab90345d3bfe97f0fb 100644 (file)
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -70,8 +70,8 @@
 
 <legalnotice>&FDLNotice;</legalnotice>
 
 
 <legalnotice>&FDLNotice;</legalnotice>
 

-<date>2020-12-24</date>
-<releaseinfo>Applications 21.04</releaseinfo>
+<date>2022-01-17</date>
+<releaseinfo>KDE Gear 22.04</releaseinfo>

 
 <abstract>
 <para>
 
 <abstract>
 <para>


@@ -349,9 +349,10 @@ as a detailed list which contains the name, size and last modification time of
 each item. Additional columns can be added by clicking a column header with the
 &RMB;.
 </para>
 each item. Additional columns can be added by clicking a column header with the
 &RMB;.
 </para>

-<para>In the context menu of the header line you can choose between custom or automatic 
-column width. Automatic width adjusts the width of all columns once to display the longest 
-item in the column completely, except for the <guilabel>Name</guilabel> column where 
+<para>In the context menu of the header line, you can add or remove side padding
+by checking or unchecking the respective menu item and choose between a custom
+or automatic column width. Automatic width adjusts the width of all columns once to display the
+longest item in the column completely, except for the <guilabel>Name</guilabel> column where 

 the extension is replaced by <quote>...</quote> 
 </para>
 <para>The order of columns can be changed by drag and drop of column headers, except for
 the extension is replaced by <quote>...</quote> 
 </para>
 <para>The order of columns can be changed by drag and drop of column headers, except for


@@ -773,6 +774,13 @@ current folder, &RMB; click in the work space and click
 <menuchoice><guimenuitem>Add to Places</guimenuitem></menuchoice> in the context menu.
 </para>
 
 <menuchoice><guimenuitem>Add to Places</guimenuitem></menuchoice> in the context menu.
 </para>
 

+<note>
+    <para>
+        The corresponding menu item visibility can be toggled via the
+        <link linkend="preferences-dialog-context-menu">&dolphin; context menu settings</link>.
+    </para>
+</note>
+

 </sect2>
 
 <sect2 id="filter-files">
 </sect2>
 
 <sect2 id="filter-files">


@@ -809,7 +817,7 @@ Start to type into the find input box and the search starts immediately.
 <screeninfo>Search files and for content in files</screeninfo>
 <mediaobject>
 <imageobject>
 <screeninfo>Search files and for content in files</screeninfo>
 <mediaobject>
 <imageobject>

-<imagedata fileref="nepomuk-search.png" format="PNG"/>
+<imagedata fileref="baloo-search.png" format="PNG"/>

 </imageobject>
 <textobject>
 <phrase>Search files and for content in files</phrase>
 </imageobject>
 <textobject>
 <phrase>Search files and for content in files</phrase>


@@ -831,7 +839,7 @@ starts the search from the user's <replaceable>Home</replaceable> folder.</para>
 <screeninfo>Search with More Options</screeninfo>
 <mediaobject>
 <imageobject>
 <screeninfo>Search with More Options</screeninfo>
 <mediaobject>
 <imageobject>

-<imagedata fileref="nepomuk-search-more-options.png" format="PNG"/>
+<imagedata fileref="baloo-search-more-options.png" format="PNG"/>

 </imageobject>
 <textobject>
 <phrase>Search with More Options</phrase>
 </imageobject>
 <textobject>
 <phrase>Search with More Options</phrase>


@@ -846,7 +854,10 @@ bar. This provides a very comfortable way for
 the user to shrink the number of search results.</para>
 <para>To start a search select one or more file types (<guilabel>Documents</guilabel>, 
 <guilabel>Audio</guilabel>, <guilabel>Video</guilabel>, <guilabel>Images</guilabel>),
 the user to shrink the number of search results.</para>
 <para>To start a search select one or more file types (<guilabel>Documents</guilabel>, 
 <guilabel>Audio</guilabel>, <guilabel>Video</guilabel>, <guilabel>Images</guilabel>),

-  a time period and rating<!--FIXME readd when again implemented: and tag, if you have defined any.--></para>
+a time period, rating, and tag, if you have defined any via
+<userinput>tag:<replaceable>foo</replaceable></userinput> in the input box.</para>
+ 
+ <para>It is possible to clear selection using the <guibutton>Clear Selection</guibutton> button.</para>

 
 <para>Alternatively you can use these options in the <guilabel>Places</guilabel> panel 
 together with the <guilabel>Filter</guilabel> bar to find files using Baloo or limit 
 
 <para>Alternatively you can use these options in the <guilabel>Places</guilabel> panel 
 together with the <guilabel>Filter</guilabel> bar to find files using Baloo or limit 


@@ -855,11 +866,10 @@ the search to files matching the filter expression.</para>
 <para>Use the Save icon to save a search to the <guilabel>Search For</guilabel>
 section in the <guilabel>Places</guilabel> panel to quickly access it again in the future.
 </para>
 <para>Use the Save icon to save a search to the <guilabel>Search For</guilabel>
 section in the <guilabel>Places</guilabel> panel to quickly access it again in the future.
 </para>

-<!--FIXME 16.12
-https://git.reviewboard.kde.org/r/123883/
-Add prototype of a "More search tools..." button
--->

 
 

+<para>
+Use the <guilabel>More Search Tools</guilabel> drop-down list to select other search tools than Baloo.
+</para>

 </sect2>
 
 <sect2 id="mounting-storage-media">
 </sect2>
 
 <sect2 id="mounting-storage-media">


@@ -1100,11 +1110,15 @@ the status bar is wide enough:
 <itemizedlist>
 
 <listitem><para>
 <itemizedlist>
 
 <listitem><para>

-A <guilabel>zoom slider</guilabel> which can be used to change the icon size quickly.
+The <guilabel>Show status bar</guilabel> item can be used for toggling status bar visibility.

 </para></listitem>
 
 <listitem><para>
 </para></listitem>
 
 <listitem><para>

-A bar that shows how much space is free on the current drive.
+The <guilabel>Show zoom slider</guilabel> item allows switching visibility of the icon size widget.
+</para></listitem>
+
+<listitem><para>
+The <guilabel>Show space information</guilabel> item can be used to switch on and off a bar that shows how much space is free on the current drive.

 </para></listitem>
 
 </itemizedlist>
 </para></listitem>
 
 </itemizedlist>


@@ -1294,7 +1308,10 @@ are displayed in a tree view, where the sub items can be expanded by &LMB; click
 <guiicon>&gt;</guiicon> icon and collapsed by clicking the <guiicon>v</guiicon> icon.
 </para>
 <para>
 <guiicon>&gt;</guiicon> icon and collapsed by clicking the <guiicon>v</guiicon> icon.
 </para>
 <para>

-<guilabel>Folder size displays</guilabel> allows defining the property to use then sorting folders by their size. It is possible to sort folders by <guilabel>Number of items</guilabel> or <guilabel>Size of contents</guilabel> and choose a limit to the recursive level (can be useful to constrain unneeded iterations in the deep folder structures or on the slow file systems).
+<guilabel>Folder size</guilabel> allows defining the property to use for sorting folders by their size.
+It is possible to sort folders by number of items by choosing <guilabel>Show number of items</guilabel> or by the size of the contents by choosing <guilabel>Show size of contents</guilabel>.
+The recursion level can be limited, which can be useful to constrain unneeded iterations in deep folder structures or on slow file systems.
+It is also possible to disable displaying folder size by choosing <guilabel>Show no size</guilabel> (which might improve performance in rare cases, however impacts other features like sorting).

 </para>
 <para>
 The <guilabel>Date style</guilabel> option can be used to configure the mode to display dates in &dolphin;. It is possible to choose between <guilabel>Relative</guilabel> (&eg;, <quote>Yesterday, 3:00pm</quote>) or <guilabel>Absolute</guilabel> (&eg;, <quote>2020-12-23 15:00</quote>).
 </para>
 <para>
 The <guilabel>Date style</guilabel> option can be used to configure the mode to display dates in &dolphin;. It is possible to choose between <guilabel>Relative</guilabel> (&eg;, <quote>Yesterday, 3:00pm</quote>) or <guilabel>Absolute</guilabel> (&eg;, <quote>2020-12-23 15:00</quote>).


@@ -1352,7 +1369,7 @@ several levels deeper in the folder hierarchy.
 
 </sect2>
 
 
 </sect2>
 

-<sect2 id="preferences-dialog-services">
+<sect2 id="preferences-dialog-context-menu">

 <title>Services</title>
 
 <para>
 <title>Services</title>
 
 <para>


@@ -1362,10 +1379,10 @@ appears when clicking a file or folder with the &RMB;.
 </para>
 
 <screenshot>
 </para>
 
 <screenshot>

-<screeninfo>Screenshot of the Services settings in &dolphin;'s preferences dialog</screeninfo>
+<screeninfo>Screenshot of the Services Menu settings in &dolphin;'s preferences dialog</screeninfo>

 <mediaobject>
 <imageobject>
 <mediaobject>
 <imageobject>

-<imagedata fileref="preferences-services.png" format="PNG"/>
+<imagedata fileref="preferences-context-menu.png" format="PNG"/>

 </imageobject>
 <textobject>
 <phrase>Services Settings.</phrase>
 </imageobject>
 <textobject>
 <phrase>Services Settings.</phrase>


@@ -1388,13 +1405,15 @@ and you have additional entries in the
 context menu like commit, update, add, remove &etc;
 </para>
 <para>
 context menu like commit, update, add, remove &etc;
 </para>
 <para>

-In the service list you can also choose if the <guimenuitem>Delete</guimenuitem>,
-<guimenuitem>Copy To</guimenuitem>, and <guimenuitem>Move To</guimenuitem>
+In the service list you can also choose if the <guimenuitem>Copy To</guimenuitem>,
+<guimenuitem>Move To</guimenuitem>, <guimenuitem>Add to Places</guimenuitem>,
+<guimenuitem>Sort By</guimenuitem>, <guimenuitem>View Mode</guimenuitem>,
+<guimenuitem>Open in New Tab</guimenuitem>, <guimenuitem>Open in New Window</guimenuitem>,
+<guimenuitem>Copy Location</guimenuitem>, and <guimenuitem>Duplicate Here</guimenuitem>

 commands are shown in the context menu.
 </para>
 <para>
 &dolphin; has to be restarted to activate the changes for some of these settings.
 commands are shown in the context menu.
 </para>
 <para>
 &dolphin; has to be restarted to activate the changes for some of these settings.

-<!--FIXME wrong for Copy To + Move To + Delete, what about the other items?-->

 </para>
 
 </sect2>
 </para>
 
 </sect2>


@@ -1436,6 +1455,37 @@ largest files can be deleted automatically.
 
 </sect2>
 
 
 </sect2>
 

+<sect2 id="preferences-user-feedback">
+<title>User Feedback</title>
+
+<para>
+This group contains settings which control your contributing information on the &dolphin; usage to its developers.
+
+<screenshot>
+<screeninfo>Screenshot of the User Feedback settings in &dolphin;'s preferences dialog</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="preferences-user-feedback.png" format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>User Feedback Settings.</phrase>
+</textobject>
+<caption><para>User Feedback Settings in &dolphin;'s Preferences Dialog.</para></caption>
+</mediaobject>
+</screenshot>
+
+<itemizedlist>
+
+<listitem><para>
+You can contribute some feedback on &dolphin; if you wish. Use sliders to configure your level of participation.
+</para></listitem>
+
+</itemizedlist>
+
+</para>
+
+</sect2>
+

 </sect1>
 <!-- begin copy to konqueror filemanager.docbook -->
 <sect1 id="view-properties">
 </sect1>
 <!-- begin copy to konqueror filemanager.docbook -->
 <sect1 id="view-properties">


@@ -1545,6 +1595,11 @@ be accessed with toolbar buttons or with items in the menu of the
 folder.</action></para>
 <para>You will find an explanation of all available objects in &konqueror;'s handbook in the chapter
 <ulink url="help:/konqueror/making.html">Create New</ulink>.</para>
 folder.</action></para>
 <para>You will find an explanation of all available objects in &konqueror;'s handbook in the chapter
 <ulink url="help:/konqueror/making.html">Create New</ulink>.</para>

+<note>
+    <para>
+        It is possible to create your own <guisubmenu>Create New...</guisubmenu> submenu items. Use files from <ulink url="https://invent.kde.org/frameworks/kio/-/tree/master/src/new_file_templates">KIO source repository</ulink> as a reference and put the resulting <filename role="extension">.desktop</filename> file into the <filename role="directory">.local/share/templates</filename> in your home directory (the address can be determined using the <userinput>kf5-config --path templates</userinput> command in &konsole;), then restart &dolphin;.
+    </para>
+</note>

 </listitem>
 </varlistentry>
 
 </listitem>
 </varlistentry>