[utilities/ark] doc: doc: Explain when "Extract here" does not create subfolder

[Méven Car]

Git commit 44fcbaf98d0e02dd31ef9377a6929799bd4a4e7e by Méven Car, on behalf of Andrew Shark.
Committed on 15/02/2024 at 08:30.
Pushed by meven into branch 'master'.

doc: Explain when "Extract here" does not create subfolder

If the archive contains only one entry (file or folder), then when extracting, the subfolder is not created.

See `BatchExtractJob::setupDestination()`.

This may be unobvious for some users, so need to document this.

M  +2    -1    doc/index.docbook

https://invent.kde.org/utilities/ark/-/commit/44fcbaf98d0e02dd31ef9377a6929799bd4a4e7e

diff --git a/doc/index.docbook b/doc/index.docbook
index a63c249fd..709a284ba 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -393,7 +393,8 @@ The menu has these additional items to extract an archive using &ark;:
 <itemizedlist>
 <listitem>
 <para><guimenuitem>Extract here</guimenuitem> creates a 
-subfolder in the folder with the archive and extracts the folders and files into it.</para>
+subfolder in the folder with the archive and extracts the folders and files into it. In
+case the archive contains only one file or folder, no subfolder will be created.</para>
 </listitem>
 <listitem>
 <para><guimenuitem>Extract here and delete archive</guimenuitem> creates a