[network/smb4k] doc: Updated handbook.
Alexander Reinholdt
null at kde.org
Tue Jul 23 05:26:39 BST 2024
Git commit 7dc540744159edc14c4baf0a51b46840a76fb6ba by Alexander Reinholdt.
Committed on 23/07/2024 at 04:25.
Pushed by areinholdt into branch 'master'.
Updated handbook.
M +- -- doc/configuration_page_authentication.png
D +- -- doc/configuration_page_authentication_dialog_default_login.png
M +- -- doc/configuration_page_bookmarks.png
M +- -- doc/configuration_page_custom_settings.png
M +- -- doc/configuration_page_mounting.png
M +- -- doc/configuration_page_network.png
M +- -- doc/configuration_page_profiles.png
D +- -- doc/configuration_page_profiles_migration_assistant.png
M +- -- doc/configuration_page_synchronization.png
M +- -- doc/configuration_page_user_interface.png
M +27 -73 doc/index.docbook
https://invent.kde.org/network/smb4k/-/commit/7dc540744159edc14c4baf0a51b46840a76fb6ba
diff --git a/doc/configuration_page_authentication.png b/doc/configuration_page_authentication.png
index 877ced2d7..4d4b1b84f 100644
Binary files a/doc/configuration_page_authentication.png and b/doc/configuration_page_authentication.png differ
diff --git a/doc/configuration_page_authentication_dialog_default_login.png b/doc/configuration_page_authentication_dialog_default_login.png
deleted file mode 100644
index 4d28efd73..000000000
Binary files a/doc/configuration_page_authentication_dialog_default_login.png and /dev/null differ
diff --git a/doc/configuration_page_bookmarks.png b/doc/configuration_page_bookmarks.png
index 5bd142d73..3d820c892 100644
Binary files a/doc/configuration_page_bookmarks.png and b/doc/configuration_page_bookmarks.png differ
diff --git a/doc/configuration_page_custom_settings.png b/doc/configuration_page_custom_settings.png
index 930ac90c9..78c79af0d 100644
Binary files a/doc/configuration_page_custom_settings.png and b/doc/configuration_page_custom_settings.png differ
diff --git a/doc/configuration_page_mounting.png b/doc/configuration_page_mounting.png
index 0a311f9aa..e2fc41260 100644
Binary files a/doc/configuration_page_mounting.png and b/doc/configuration_page_mounting.png differ
diff --git a/doc/configuration_page_network.png b/doc/configuration_page_network.png
index 1a92a34cc..75aba7119 100644
Binary files a/doc/configuration_page_network.png and b/doc/configuration_page_network.png differ
diff --git a/doc/configuration_page_profiles.png b/doc/configuration_page_profiles.png
index e095e05f1..7df05e37b 100644
Binary files a/doc/configuration_page_profiles.png and b/doc/configuration_page_profiles.png differ
diff --git a/doc/configuration_page_profiles_migration_assistant.png b/doc/configuration_page_profiles_migration_assistant.png
deleted file mode 100644
index d3585a45a..000000000
Binary files a/doc/configuration_page_profiles_migration_assistant.png and /dev/null differ
diff --git a/doc/configuration_page_synchronization.png b/doc/configuration_page_synchronization.png
index ae77c3bc9..6ebb66a1a 100644
Binary files a/doc/configuration_page_synchronization.png and b/doc/configuration_page_synchronization.png differ
diff --git a/doc/configuration_page_user_interface.png b/doc/configuration_page_user_interface.png
index e711900b4..b4a71f957 100644
Binary files a/doc/configuration_page_user_interface.png and b/doc/configuration_page_user_interface.png differ
diff --git a/doc/index.docbook b/doc/index.docbook
index 684951457..5f0026bf0 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -37,7 +37,7 @@
</copyright>
<legalnotice>&underFDL;</legalnotice>
- <date>2024-04-03</date>
+ <date>2024-07-22</date>
<releaseinfo>&smb4k; 4.0.0</releaseinfo><!--FIXME change releaseinfo number-->
<abstract>
@@ -3308,77 +3308,6 @@ export QT_QPA_PLATFORMTHEME=qt6ct
</variablelist>
</sect3>
</sect2>
- </sect1>
-
-<!--
- Configuring Smb4K : Authentication
--->
-
- <sect1 id="configuration_page_authentication">
- <title>Authentication</title>
-
- <para>Here you can change the settings affecting the authentication.</para>
-
- <screenshot>
- <screeninfo>Screenshot of the "Authentication" configuration page</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata fileref="configuration_page_authentication.png" format="PNG" />
- </imageobject>
- <textobject>
- <phrase>The "Authentication" configuration page</phrase>
- </textobject>
- </mediaobject>
- </screenshot>
-
-<!--
- Configuring Smb4K : Authentication : Settings
--->
-
- <sect2 id="configuration_page_authentication_settings">
- <title>Settings</title>
-
- <variablelist>
- <varlistentry>
- <term>
- <menuchoice><guibutton>Save logins in a wallet</guibutton></menuchoice>
- </term>
- <listitem>
- <para>The user names and passwords are stored in a subfolder named <filename role="directory">Smb4K</filename> of the current network wallet (default: "kdewallet"). The advantage of this method is, that the authentication data is stored permanently and encrypted on your hard drive. You only have to provide it once and the next time it is needed, &smb4k; will read it from the wallet. If you uncheck this option, the authentication data won't be stored at all.</para>
- <para>Default: selected</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <menuchoice><guibutton>Use a default login</guibutton></menuchoice>
- </term>
- <listitem>
- <para>The default login is used by default to authenticate to the servers in your network neighborhood. If you enable this feature, a password dialog pops up, where you can provide the default login information.</para>
- <screenshot>
- <screeninfo>Screenshot of the default login input dialog</screeninfo>
- <mediaobject>
- <imageobject><imagedata fileref="configuration_page_authentication_dialog_default_login.png" format="PNG" /></imageobject>
- <textobject><phrase>The default login input dialog</phrase></textobject>
- </mediaobject>
- </screenshot>
- <para>You have to fill in at least the user name. Empty passwords are supported.</para>
- <para>Default: not selected</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </sect2>
-
-<!--
- Configuring Smb4K : Authentication : Wallet Entries
--->
-
- <sect2 id="configuration_page_authentication_wallet_entries">
- <title>Wallet Entries</title>
-
- <para>In the editor you can change or delete existing wallet entries. However, before you can edit them, they have to be loaded from the digital wallet by pressing the <guibutton>Load</guibutton> button. The wallet entries then appear in the list view. An entry can be edited either by selecting it and clicking the <guibutton>Edit</guibutton> button or by double-clicking. A password dialog with the stored user name and password is shown and you can modify the credentials.</para>
- <para>An entry can be removed by selecting it and clicking the <guibutton>Remove</guibutton> button. All wallet entries can be removed at once by clicking the <guibutton>Clear</guibutton> button. With the <guibutton>Reset</guibutton> button you can restore the initial state.</para>
- <para>After you finished editing, the changes can be committed to the wallet by clicking <guibutton>Save</guibutton>.</para>
- </sect2>
</sect1>
<!--
@@ -4201,6 +4130,30 @@ export QT_QPA_PLATFORMTHEME=qt6ct
</sect2>
</sect1>
+<!--
+ Configuring Smb4K : Authentication
+-->
+
+ <sect1 id="configuration_page_authentication">
+ <title>Authentication</title>
+
+ <para>Here you can enter the default login credentials. If you use profiles, they are only valid for the active profile.</para>
+
+ <screenshot>
+ <screeninfo>Screenshot of the "Authentication" configuration page</screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="configuration_page_authentication.png" format="PNG" />
+ </imageobject>
+ <textobject>
+ <phrase>The "Authentication" configuration page</phrase>
+ </textobject>
+ </mediaobject>
+ </screenshot>
+
+ <para>All login credentials are stored in your password manager (⪚ KeePassXC, &kwallet; or GNOME Keyring). To change them, you can use the <link linkend="network_neighborhood_browser_authentication">password dialog</link>. To delete individual entries, use your password manager.</para>
+ </sect1>
+
<!--
Configuring Smb4K : Bookmarks
-->
@@ -4208,7 +4161,7 @@ export QT_QPA_PLATFORMTHEME=qt6ct
<sect1 id="configuration_page_bookmarks">
<title>Bookmarks</title>
- <para>...</para>
+ <para>On this configuration page, you can edit your bookmarks. If you use profiles, only those of the active profile are shown.</para>
<screenshot>
<screeninfo>Screenshot of the "Bookmarks" configuration page</screeninfo>
@@ -4230,6 +4183,7 @@ export QT_QPA_PLATFORMTHEME=qt6ct
<sect1 id="configuration_page_custom_settings">
<title>Custom Settings</title>
+ <!-- FIXME -->
<para>All servers and shares for which you defined custom settings are listed here.</para>
<screenshot>
More information about the kde-doc-english
mailing list