[network/smb4k] doc: Updated handbook.

[Alexander Reinholdt]

Git commit ad44578e3aee29a681ac65e926e0480c5c394cc8 by Alexander Reinholdt.
Committed on 23/11/2022 at 05:41.
Pushed by areinholdt into branch 'master'.

Updated handbook.

M  +4-5doc/index.docbook

https://invent.kde.org/network/smb4k/commit/ad44578e3aee29a681ac65e926e0480c5c394cc8

diff --git a/doc/index.docbook b/doc/index.docbook
index 51c3deb6..5997f181 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -218,7 +218,7 @@
 
   
   
-Abort any running process of the network neighborhood 
browser. This action is invisible by default and will only be visible (instead 
of the Scan Network|Workgroup|Computer action) when 
a network scan is running.
+Abort any running process of the network neighborhood 
browser. This action is invisible by default and will only be visible when a 
network scan is running.
   
 
 
@@ -229,7 +229,7 @@
 
   
   
-Search the network neighborhood for a specified term. 
Activating this action opens the search tool bar, where you can enter the 
search term and start the search.
+Search the network 
neighborhood for a specified term. Activating this action opens the 
search tool bar, where you can enter the search term and start the 
search.
   
 
 
@@ -240,8 +240,7 @@
 
   
   
-Add a bookmark to the currently selected remote share. This 
action is disabled if no share is selected.
-Read the Adding 
Bookmarks section for more details.
+Add a bookmark to 
the currently selected remote share. This action is disabled if no share is 
selected.
   
 
 
@@ -307,7 +306,7 @@
 
   
   
-Mount the selected remote share. By default, and if you 
clicked anything different than a share with type "Disk" or "IPC", this action 
is disabled. If you selected a mounted share, this action is replaced by the 
Unmount action.
+Mount the selected remote share. By default, and if you 
selected anything different than a share with type "Disk" or "IPC", this action 
is disabled. For a mounted share, this action is replaced with the 
Unmount action.
   
 
 

Formatting / indenting Docbook files

[Thiago Masato Costa Sueto]

Hello,

I'd like to know how to properly indent Docbook files, as properly indented
XML is much more readable.

A simple xmllint --format does not work (tags get jumbled together), and
xmllint --loaddtd --noent is the only way I found to make it work, but it
translates all entities into tags, which doesn't seem right. Tidy doesn't
seem to work either. This is reproducible even with the default template
provided by KDocTools (
https://invent.kde.org/frameworks/kdoctools/-/blob/master/src/template.docbook
).

I figure I must be missing something.

Thanks in advance.

---

Thiago Sueto