<legalnotice>&FDLNotice;</legalnotice>
-<date>2020-05-05</date>
-<releaseinfo>Applications 20.08</releaseinfo>
+<date>2022-01-17</date>
+<releaseinfo>KDE Gear 22.04</releaseinfo>
<abstract>
<para>
<listitem><para>
A file or folder can be opened by clicking it with the &LMB; (or
-double-clicking, if <guilabel>Double-click to open files and folders</guilabel>
-is enabled in the &systemsettings; in the <menuchoice><guimenu>Input Devices</guimenu>
-<guimenuitem>Mouse</guimenuitem></menuchoice> module.
+double-clicking, if <guilabel>Open by double-clicking instead</guilabel>
+is enabled in the &systemsettings; in the <menuchoice><guimenu>Workspace</guimenu>
+<guimenuitem>General Behavior</guimenuitem></menuchoice> module).
</para></listitem>
<listitem><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
<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">
+<title>Filtering Files</title>
+
+<para>
+&dolphin; is capable of filtering files, &ie; showing only those items in the
+view whose name contains a given text. For example, if you wish to show
+only the <acronym>MP3</acronym> files within a folder, you could filter for <quote>.mp3</quote>.
+This would then filter out all files whose name does not contain <quote>.mp3</quote>.
+</para>
+
+<para>
+To filter files, first enable the filter bar, either by pressing <keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo>
+or via the menu: <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Filter...</guimenuitem> </menuchoice>.
+You can then enter the text to be filtered for in the filter bar. The filter bar can
+be disabled either by pressing &Esc;, or with a &LMB; click on the
+<guiicon>Hide Filter Bar</guiicon> icon.
+</para>
+
</sect2>
<sect2 id="finding-searching-in-file">
<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>
<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>
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>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="filter-files">
-<title>Filtering Files</title>
-
-<para>
-&dolphin; is capable of filtering files, &ie; showing only those items in the
-view whose name contains a given text. For example, if you wish to show
-only the <acronym>MP3</acronym> files within a folder, you could filter for <quote>.mp3</quote>.
-This would then filter out all files whose name does not contain <quote>.mp3</quote>.
-</para>
-
-<para>
-To filter files, first enable the filter bar, either by pressing <keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo>
-or via the menu: <menuchoice> <guimenu>Tools</guimenu> <guimenuitem>Show Filter Bar</guimenuitem> </menuchoice>.
-You can then enter the text to be filtered for in the filter bar. The filter bar can
-be disabled either by pressing &Esc;, or with a &LMB; click on the
-<guiicon>Hide Filter Bar</guiicon> icon.
-</para>
-
-</sect2>
-
</sect1>
</chapter>
<para>
In this tab, you can configure for which file types previews are shown.
-Moreover, the maximum size of remote files for which previews are generated can be chosen.
+Moreover, the maximum size of local and remote files for which previews are generated can be chosen.
</para>
<para>
If previews are enabled for folders, previews of some files in the folder will
<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>
-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>
<guiicon>></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> (⪚, <quote>Yesterday, 3:00pm</quote>) or <guilabel>Absolute</guilabel> (⪚, <quote>2020-12-23 15:00</quote>).
</para>
</listitem>
</itemizedlist>
<listitem><para>
The option to open items with a single or double mouse click is a system wide setting and can be
-changed in the &systemsettings; in the <menuchoice><guimenu>Input Devices</guimenu>
-<guimenuitem>Mouse</guimenuitem></menuchoice> module.</para>
+changed in the &systemsettings; in the <menuchoice><guimenu>Workspace</guimenu>
+<guimenuitem>General Behavior</guimenuitem></menuchoice> module.</para>
</listitem>
<listitem><para>
</sect2>
-<sect2 id="preferences-dialog-services">
+<sect2 id="preferences-dialog-context-menu">
<title>Services</title>
<para>
</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>
-<imagedata fileref="preferences-services.png" format="PNG"/>
+<imagedata fileref="preferences-context-menu.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Services Settings.</phrase>
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.
-<!--FIXME wrong for Copy To + Move To + Delete, what about the other items?-->
</para>
</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">
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>
Is disabled if the current user does not have write permission on the selected item(s).</action></para></listitem>
</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Filter...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Enables and disables the <link linkend="filter-files">filter bar</link>.</action>
+You can also use the alternate shortcut <keycombo action="simul">&Shift;<keycap>/</keycap></keycombo>
+for this action.</para></listitem>
+</varlistentry>
+
<varlistentry>
<term><menuchoice>
<shortcut>
<para>
<variablelist>
-<varlistentry>
-<term><menuchoice>
-<shortcut>
-<keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo>
-</shortcut>
-<guimenu>Tools</guimenu>
-<guimenuitem>Show Filter Bar</guimenuitem>
-</menuchoice></term>
-<listitem><para><action>Enables and disables the <link linkend="filter-files">filter bar</link>.</action>
-You can also use the alternate shortcut <keycombo action="simul">&Shift;<keycap>/</keycap></keycombo>
-for this action.</para></listitem>
-</varlistentry>
-
<varlistentry>
<term><menuchoice>
<shortcut>
projects / dolphin.git / blobdiff