From 902ceae0d303acec9511ef48dc9faf5f73cf900c Mon Sep 17 00:00:00 2001 From: syl20bnr Date: Sun, 8 Oct 2017 12:20:03 -0400 Subject: [PATCH] treemacs: update README.org to be more conventional Layer READMEs don't list the configuration of the package so this commit removes the mentions of treemacs package readme. Reformat the documentation of layer variables Reformat key bindings in table Respect 80 chars max per line. --- layers/+filetree/treemacs/README.org | 140 +++++++++++++++------------ 1 file changed, 79 insertions(+), 61 deletions(-) diff --git a/layers/+filetree/treemacs/README.org b/layers/+filetree/treemacs/README.org index cbeb2ff46..bc0ea75f0 100644 --- a/layers/+filetree/treemacs/README.org +++ b/layers/+filetree/treemacs/README.org @@ -5,17 +5,22 @@ * Table of Contents :TOC_4_gh:noexport: - [[#description][Description]] - [[#features][Features:]] -- [[#installation][Installation]] +- [[#install][Install]] - [[#configuration][Configuration]] + - [[#follow-mode][Follow mode]] + - [[#file-watch][File watch]] + - [[#collapsed-directories][Collapsed directories]] - [[#key-bindings][Key Bindings]] - [[#global][Global]] - [[#inside-treemacs][Inside Treemacs]] * Description -This layer brings in [[https://github.com/Alexander-Miller/treemacs][Treemacs]] to replace Neotree as the default file and project explorer: +This layer brings in [[https://github.com/Alexander-Miller/treemacs][Treemacs]] to replace Neotree as the default file and project +explorer: + ** Features: -An detailed overview over Treemacs' available features is available in [[https://github.com/Alexander-Miller/treemacs#detailed-feature-list][its readme]]. In a short summary Treemacs offers -the following: +An detailed overview over Treemacs' available features is available in [[https://github.com/Alexander-Miller/treemacs#detailed-feature-list][its +readme]]. In a short summary Treemacs offers the following: * Simple and powerful navigation and ability to detail exactly how and where a file should be opened * Good looking png icons. @@ -26,33 +31,44 @@ the following: * Optional follow-mode to automatically focus the currently selected file. * Optional filewatch-mode to automatically refresh the view after (and only after) changes to the shown filesystem. -* Installation -To use this layer, add =treemacs= to the existing =dotspacemacs-configuration-layers= in your =dotspacemacs= file. -In addition you can also specify the following configuration variables: - - * =treemacs-use-follow-mode= - When t =treemacs-follow-mode= will be enabled. - Default value: t - * =treemacs-use-filewatch-mode= - When t =treemacs-filewatch-mode= will be enabled. - Default value: t - * =treemacs-use-collapsed-directories= - Maximum number of single-dir-child directories Treemacs will collapse into one. - Default value: 3 - - Using all 3 options the =dotspacemacs-configuration-layers= will look like this: - -#+BEGIN_SRC emacs-lisp - (treemacs - :variables - treemacs-use-follow-mode t - treemacs-use-filewatch-mode t - treemacs-use-collapsed-directories 3) -#+END_SRC +* Install +To use this layer, add =treemacs= to the existing +=dotspacemacs-configuration-layers= in your =dotspacemacs= file. * Configuration -A detailed list of all possible configuration options can be found in [[https://github.com/Alexander-Miller/treemacs#configuration][Treemacs' readme]]. You can also look at -~M-x customize-group treemacs~. +** Follow mode +To have treemacs automatically syncs with your current buffer set the +layer variable =treemacs-use-follow-mode= to non-nil. + +#+BEGIN_SRC emacs-lisp + (setq-default dotspacemacs-configuration-layers '( + (treemacs :variables treemacs-use-follow-mode t))) +#+END_SRC + +Default value is =t=. + +** File watch +To automatically refresh the Treemacs buffer when a buffer changes set +the layer variable =treemacs-use-filewatch-mode= to non-nil. + +#+BEGIN_SRC emacs-lisp + (setq-default dotspacemacs-configuration-layers '( + (treemacs :variables treemacs-use-filewatch-mode t))) +#+END_SRC + +Default value is =t=. + +** Collapsed directories +Treemacs tries to collapse empty directory names into one name. It is possible +to control how deep Treemacs will search for empty directories by settings the +layer variable =treemacs-use-collapsed-directories= to a positive number. + +#+BEGIN_SRC emacs-lisp + (setq-default dotspacemacs-configuration-layers '( + (treemacs :variables treemacs-use-collapsed-directories 3))) +#+END_SRC + +Default value is 3. * Key Bindings ** Global @@ -68,38 +84,40 @@ A detailed list of all possible configuration options can be found in [[https:// | ~M-0~ | Selected the treemacs window. Actually selects window #10, which is always assigned to treemacs. | ** Inside Treemacs -Treemacs will use either j/k or n/p to go to the next/previous line, depending on whether vim/hybrid editing style is used. -Likewise refresh is only bound to g when emacs editing style is used, since under vim g is a prefix for many other commands. +Treemacs will use either ~j/k~ or ~n/p~ to go to the next/previous line, +depending on whether vim/hybrid editing style is used. Likewise refresh is only +bound to g when emacs editing style is used, since under vim g is a prefix for +many other commands. | Key Binding | Description | |-------------+---------------------------------------------------------------------------------------------------------------------------------------| -| ? | Summon the helpful hydra to show you the treemacs keymap. | -| j/n | Goto next/prev line. | -| h | Switch treemacs' root directory to current root's parent, if possible. | -| l | Use currently selected directory as new root. Do nothing for files. | -| M-j/M-n | Select next node at the same depth as currently selected node, if possible. | -| th | Toggle the hiding and displaying of dotfiles. | -| tw | Toggle whether the treemacs buffer should have a fixed width. | -| tf | Toggle treemacs-follow-mode. | -| ta | treemacs-filewatch-mode. | -| w | Reset the width of the treemacs buffer to its default. With a prefix arg set a new default first. | -| TAB | Push the button in the current line to open/close the selected node. | -| mouse1 | Do the same as TAB when mouse1 clicking on an icon. Clicking anywhere other than an icon does nothing. | -| g/r/gr | Refresh and rebuild the treemacs buffer. | -| d | Delete node at point. A delete action must always be confirmed. Directories are deleted recursively. | -| cf | Create a file. | -| cd | Create a directory. | -| R | Rename the currently selected node. Reload buffers visiting renamed files or files in renamed direcotries. | -| u | Select parent of selected node, if possible. | -| q | Hide/show an existing treemacs buffer. | -| Q | Kill the treemacs buffer. | -| RET | Do what I mean. (Run the action defined in ~treemacs-default-actions~ for the current button.) | -| ov | Open current file or tag by vertically splitting next-window. Stay in current window with a prefix argument. | -| oh | Open current file or tag by horizontally splitting next-window. Stay in current window with a prefix argument. | -| oo/RET | Open current file or tag, performing no split and using next-window directly. Stay in current window with a prefix argument. | -| oaa | Open current file or tag, using ace-window to decide which buffer to open the file in. Stay in current window with a prefix argument. | -| oah | Open current file or tag by horizontally splitting a buffer selected by ace-window. Stay in current window with a prefix argument. | -| oav | Open current file or tag by vertically splitting a buffer selected by ace-window. Stay in current window with a prefix argument. | -| ox | Open current file or dir, using the xdg-open shell-command. | -| yy | Copy the absolute path of the node at point. | -| yr | Copy the absolute path of the current treemacs root. | +| ~?~ | Summon the helpful hydra to show you the treemacs keymap. | +| ~j/n~ | Goto next/prev line. | +| ~h~ | Switch treemacs' root directory to current root's parent, if possible. | +| ~l~ | Use currently selected directory as new root. Do nothing for files. | +| ~M-j/M-n~ | Select next node at the same depth as currently selected node, if possible. | +| ~th~ | Toggle the hiding and displaying of dotfiles. | +| ~tw~ | Toggle whether the treemacs buffer should have a fixed width. | +| ~tf~ | Toggle treemacs-follow-mode. | +| ~ta~ | treemacs-filewatch-mode. | +| ~w~ | Reset the width of the treemacs buffer to its default. With a prefix arg set a new default first. | +| ~TAB~ | Push the button in the current line to open/close the selected node. | +| ~mouse1~ | Do the same as TAB when mouse1 clicking on an icon. Clicking anywhere other than an icon does nothing. | +| ~g/r/gr~ | Refresh and rebuild the treemacs buffer. | +| ~d~ | Delete node at point. A delete action must always be confirmed. Directories are deleted recursively. | +| ~cf~ | Create a file. | +| ~cd~ | Create a directory. | +| ~R~ | Rename the currently selected node. Reload buffers visiting renamed files or files in renamed direcotries. | +| ~u~ | Select parent of selected node, if possible. | +| ~q~ | Hide/show an existing treemacs buffer. | +| ~Q~ | Kill the treemacs buffer. | +| ~RET~ | Do what I mean. (Run the action defined in ~treemacs-default-actions~ for the current button.) | +| ~ov~ | Open current file or tag by vertically splitting next-window. Stay in current window with a prefix argument. | +| ~oh~ | Open current file or tag by horizontally splitting next-window. Stay in current window with a prefix argument. | +| ~oo/RET~ | Open current file or tag, performing no split and using next-window directly. Stay in current window with a prefix argument. | +| ~oaa~ | Open current file or tag, using ace-window to decide which buffer to open the file in. Stay in current window with a prefix argument. | +| ~oah~ | Open current file or tag by horizontally splitting a buffer selected by ace-window. Stay in current window with a prefix argument. | +| ~oav~ | Open current file or tag by vertically splitting a buffer selected by ace-window. Stay in current window with a prefix argument. | +| ~ox~ | Open current file or dir, using the xdg-open shell-command. | +| ~yy~ | Copy the absolute path of the node at point. | +| ~yr~ | Copy the absolute path of the current treemacs root. |