@kugel- I still can't do anything with github, so I have posted my suggested
text below.
```
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:
Documents Only
Show only file names of open documents in sorted order.
.. 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
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
files below the users home directory, and open files below an open project
base path. Each of these is moved to its own top level tree instead of
being in place in the normal tree. The top level of these trees are each
labelled differently. For the home directory tree the path of the home
directory is shown as ``~``, and for the project tree the path to the
project
base path is shown simply as the project name.
.. image:: ./images/sidebar_show_tree.png
In all cases paths and file names that do not fit in the width available are
ellipsised.
```
--
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#issuecomment-379611465
