[Github-comments] [geany/geany] Rpg sidebar tree (see #259) (#1813)

[Nick Treleaven]

ntrel commented on this pull request.

Haven't tested, but the idea seems great. (To be honest if this works well I don't know why we need the other 2 options besides *Show Tree*).

I've reviewed the doc changes and made suggestions, not a blocker. If I have time maybe I'll fix those.

> @@ -530,6 +530,48 @@ order. It is not alphabetical as shown in the documents list
 See the `Notebook tab keybindings`_ section for useful
 shortcuts including for Most-Recently-Used document switching.
 
+Document list views
+^^^^^^^^^^^^^^^^^^^
+
+There are three different ways to display documents on the sidebar if *Show
+documents list* is active.  To switch between views press the right mouse button
+on documents list and select one of those radio buttons:

on *the* documents list

those radio buttons -> these items
(Users might not know what radio buttons are)

> +    .. image:: ./images/sidebar_documents_only.png
+
+Show Paths
+    Show open documents as a two-level tree in which first level is the paths
+    of directories containing open files and the second level is the file names of
+    the documents open in that path.  All documents with the same path are grouped
+    together under the same first level item.  Paths are in sorted order and
+    documents are sorted within each group.
+
+    .. image:: ./images/sidebar_show_paths.png
+
+Show Tree
+    Show paths as above, but as a multiple level partial tree.  The tree is only
+    expanded at positions where two or more directory paths to open documents
+    share the same prefix.  The common prefix is shown as a parent level, and
+    the remainer of those paths are shown as child levels.  This applies

remainder

> +    the documents open in that path.  All documents with the same path are grouped
+    together under the same first level item.  Paths are in sorted order and
+    documents are sorted within each group.
+
+    .. image:: ./images/sidebar_show_paths.png
+
+Show Tree
+    Show paths as above, but as a multiple level partial tree.  The tree is only
+    expanded at positions where two or more directory paths to open documents
+    share the same prefix.  The common prefix is shown as a parent level, and
+    the remainer of those paths are shown as child levels.  This applies
+    recursively down the paths making a tree to the file names of open documents,
+    which are grouped in sorted order as an additional level below the last path
+    segment.
+
+    For convenience two common file locations are handled specifically, open

specifically, -> specially:

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/geany/geany/pull/1813#pullrequestreview-298969183
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.geany.org/pipermail/github-comments/attachments/20191008/1ea85879/attachment.html>