[nongnu] elpa/hyperdrive aa3acc3f6a 2/4: Docs: Split out No empty directories section

[ELPA Syncer]

branch: elpa/hyperdrive
commit aa3acc3f6ae348486187c4f0d1a4e909fe6bb9f9
Author: Joseph Turner <joseph@ushin.org>
Commit: Joseph Turner <joseph@ushin.org>

    Docs: Split out No empty directories section
---
 doc/hyperdrive-manual.org | 28 +++++++++++++++++-----------
 1 file changed, 17 insertions(+), 11 deletions(-)

diff --git a/doc/hyperdrive-manual.org b/doc/hyperdrive-manual.org
index 37fdd8616f..9966fb6878 100644
--- a/doc/hyperdrive-manual.org
+++ b/doc/hyperdrive-manual.org
@@ -758,19 +758,25 @@ DNS domains are checked for suspicious characters (see
 
 * Known limitations
 
-** Files and folders can have the same name
+** No empty directories
 
 Instead of files and folders, Hyperdrive technically has entries and
-entry prefixes. In other words, "folders" don't exist unless they
-contain files. It's possible for a "file" entry and a "folder" entry
-prefix to have the same name, like ~hyper://PUBLIC-KEY/foo/bar/~ (a
-"folder") and ~hyper://PUBLIC-KEY/foo/bar~ (a "file"). In this case, the
-folder listing for ~hyper://PUBLIC-KEY/path/~ would display the ~to~ entry
-but not the ~to/~ entry prefix. Because entry prefixes only exist when
-they prefix an entry, deleting the last "file" in a "folder" causes
-the "folder" to disappear as well.  When a hyperdrive "file" or
-"folder" is not found, ~hyperdrive.el~ prompts you for an action
-(see [[*Unknown paths]]).
+entry prefixes.  In other words, folders don't exist unless they
+contain files.  This results in potentially unexpected behavior:
+
+- it is not possible to create empty directories
+- deleting the last file in a folder deletes the folder as well
+
+When a hyperdrive file or folder is not found, ~hyperdrive.el~ prompts
+you for an action (see [[*Unknown paths]]).
+
+** Files and folders can have the same name
+
+In the current implementation of Hyperdrive, it's possible for an
+entry (folder) and an entry prefix (folder) to have the same name,
+e.g., ~hyper://PUBLIC-KEY/foo/bar/~ and ~hyper://PUBLIC-KEY/foo/bar~. In
+this case, the folder listing for ~hyper://PUBLIC-KEY/foo/~ would
+display the ~bar~ entry but not the ~bar/~ entry prefix.
 
 * Tips