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
