diff --git a/doc/fern.txt b/doc/fern.txt index 6aac095a..9863ac03 100644 --- a/doc/fern.txt +++ b/doc/fern.txt @@ -645,128 +645,128 @@ See |fern-action| for more detail. ----------------------------------------------------------------------------- GLOBAL *fern-mapping-global* -(fern-action-zoom:half) +*(fern-action-zoom:half)* Zoom width of the drawer style fern to half of the global width. The original window width will be restored once user leave the window. It only works on a drawer style fern window. -(fern-action-zoom:full) +*(fern-action-zoom:full)* Zoom width of the drawer style fern to full of the global width. The original window width will be restored once user leave the window. It only works on a drawer style fern window. -(fern-action-hidden-set) +*(fern-action-hidden-set)* Show hidden nodes. For example hidden nodes in file:// scheme is a file or directory starts from '.' character. -(fern-action-hidden-unset) +*(fern-action-hidden-unset)* Hide hidden nodes. For example hidden nodes in file:// scheme is a file or directory starts from '.' character. -(fern-action-hidden-unset) +*(fern-action-hidden-unset)* Toggle hidden nodes. For example hidden nodes in file:// scheme is a file or directory starts from '.' character. -(fern-action-include) +*(fern-action-include)* Open a prompt to enter include filter. Users can type a |pattern| to filter nodes recursively. -(fern-action-exclude) +*(fern-action-exclude)* Open a prompt to enter exclude filter. Users can type a |pattern| to filter nodes recursively. -(fern-action-mark-clear) +*(fern-action-mark-clear)* Clear existing marks. -(fern-action-mark-toggle) +*(fern-action-mark-toggle)* Toggle marks on cursor node(s). -(fern-action-mark-set) +*(fern-action-mark-set)* Set marks on cursor node(s). -(fern-action-mark-unset) +*(fern-action-mark-unset)* Unset marks on cursor node(s). -(fern-action-debug) +*(fern-action-debug)* Echo debug information of a cursor node. -(fern-action-reload) +*(fern-action-reload)* Reload on a cursor node and its children. -(fern-action-expand) +*(fern-action-expand)* Expand on a cursor node. -(fern-action-collapse) +*(fern-action-collapse)* Collapse on a cursor node. -(fern-action-reveal) +*(fern-action-reveal)* Open a prompt to reveal a node in a tree. -(fern-action-enter) +*(fern-action-enter)* Open a new fern buffer which root node is a cursor node. In other word, get enter the directory. -(fern-action-leave) +*(fern-action-leave)* Open a new fern buffer which root node is a parent node of the current root node. In other word, go up directory. -(fern-action-open:select) +*(fern-action-open:select)* Open a cursor node or marked nodes through "window selector" (|fern-glofern-glossary-window-selector|.) -(fern-action-open:split) -(fern-action-open:vsplit) -(fern-action-open:tabedit) +*(fern-action-open:split)* +*(fern-action-open:vsplit)* +*(fern-action-open:tabedit)* Open a cursor node or marked nodes with a corresponding command. The command will be applied on an "anchor" window when invoked from a drawer style fern (|fern-glossary-anchor|.) -(fern-action-edit-or-error) +*(fern-action-edit-or-error)* Open a cursor node or marked nodes with |edit| command or fallback to print an error. Note that when 'hidden' has set or 'bufhidden' is "hide", the |edit| command will never fails. -(fern-action-open:edit-or-split) -(fern-action-open:edit-or-vsplit) -(fern-action-open:edit-or-tabedit) +*(fern-action-open:edit-or-split)* +*(fern-action-open:edit-or-vsplit)* +*(fern-action-open:edit-or-tabedit)* Open a cursor node or marked nodes with |edit| command or fallback to a corresponding command. Note that when 'hidden' has set or 'bufhidden' is "hide", the |edit| command will never fails. -(fern-action-open:above) -(fern-action-open:left) -(fern-action-open:below) -(fern-action-open:right) +*(fern-action-open:above)* +*(fern-action-open:left)* +*(fern-action-open:below)* +*(fern-action-open:right)* Open a cursor node or marked nodes on a corresponding direction from an "anchor" window. The command will be applied on the anchor window when invoked from a drawer style fern (|fern-glossary-anchor|.) -(fern-action-open:top) -(fern-action-open:leftest) -(fern-action-open:bottom) -(fern-action-open:rightest) +*(fern-action-open:top)* +*(fern-action-open:leftest)* +*(fern-action-open:bottom)* +*(fern-action-open:rightest)* Open a cursor node or marked nodes on a edge of a corresponding direction from an "anchor" window. The command will be applied on the anchor window when invoked from a drawer style fern (|fern-glossary-anchor|.) -(fern-action-open:side) +*(fern-action-open:side)* Open a cursor node or marked nodes on the right side of the current window. The behavior is slightly different between a drawer style fern window and a split style fern window due to the presence of "anchor". -(fern-action-open-or-enter) +*(fern-action-open-or-enter)* Invoke "open" action on a leaf node and "enter" action on a branch node. -(fern-action-open-or-expand) +*(fern-action-open-or-expand)* Invoke "open" action on a leaf node and "expand" action on a branch node. -(fern-action-open:edit) +*(fern-action-open:edit)* An alias to "open:edit-or-error" action. Users can overwrite this mapping to change the default behavior of "open:edit" action like: > @@ -774,7 +774,7 @@ GLOBAL *fern-mapping-global* \ (fern-action-open:edit) \ (fern-action-open:edit-or-tabedit) < -(fern-action-open) +*(fern-action-open)* An alias to "open:edit" action. Users can overwrite this mapping to change the default behavior of "open" action like: > @@ -782,13 +782,13 @@ GLOBAL *fern-mapping-global* \ (fern-action-open) \ (fern-action-open:select) < -(fern-action-cancel) +*(fern-action-cancel)* Cancel tree rendering. -(fern-action-redraw) +*(fern-action-redraw)* Redraw tree. -(fern-wait) +*(fern-wait)* Wait a previous asynchronous action to continue asynchronous actions sequentially. Note this is not action. @@ -798,29 +798,29 @@ FILE *fern-mapping-file* The following mappings/actions are only available on file:// scheme. -(fern-action-new-file) +*(fern-action-new-file)* Open a prompt to ask a path and create a file of the input path from the path of a cursor node. Any intermediate directories of the destination will be created. -(fern-action-new-dir) +*(fern-action-new-dir)* Open a prompt to ask a path and create a directory of the input path from the path of a cursor node. Any intermediate directories of the destination will be created. -(fern-action-copy) +*(fern-action-copy)* Open a prompt to ask a path and copy a file/directory of the cursor node or marked node path(s) to the input path(s). Any intermediate directories of the destination will be created. The prompt will repeatedly open if multiple nodes has marked. -(fern-action-move) +*(fern-action-move)* Open a prompt to ask a path and move a file/directory of the cursor node or marked node path(s) to the input path(s). Any intermediate directories of the destination will be created. The prompt will repeatedly open if multiple nodes has marked. -(fern-action-trash) +*(fern-action-trash)* Open a prompt to ask if fern can send the cursor node or marked nodes to the system trash-bin. It uses the following implementations to send the node(s) into system trash-bin. @@ -833,24 +833,24 @@ The following mappings/actions are only available on file:// scheme. Note that the action fails without removing the files/directories if no requirement exists on Linux. -(fern-action-remove) +*(fern-action-remove)* Open a prompt to ask if fern can DELETE the cursor node or marked nodes. BE CAREFUL with this action while it DELETE the file/direcoty and users cannot restore (like "rm" in terminal.) -(fern-action-cd:root) -(fern-action-lcd:root) -(fern-action-tcd:root) +*(fern-action-cd:root)* +*(fern-action-lcd:root)* +*(fern-action-tcd:root)* Invoke |:cd|, |:lcd|, or |:tcd| command on the path of the root node. -(fern-action-cd:cursor) -(fern-action-lcd:cursor) -(fern-action-tcd:cursor) +*(fern-action-cd:cursor)* +*(fern-action-lcd:cursor)* +*(fern-action-tcd:cursor)* Invoke |:cd|, |:lcd|, or |:tcd| command on the path of a cursor node. -(fern-action-cd) -(fern-action-lcd) -(fern-action-tcd) +*(fern-action-cd)* +*(fern-action-lcd)* +*(fern-action-tcd)* An alias to "cd:cursor", "lcd:cursor", and "tcd:cursor" action. Users can overwrite this mapping to change the default behavior like: > @@ -858,77 +858,77 @@ The following mappings/actions are only available on file:// scheme. \ (fern-action-cd) \ (fern-action-cd:root) < -(fern-action-clipboard-copy) +*(fern-action-clipboard-copy)* Copy a cursor node or marked nodes into an internal clipboard. Actual copy happens when users paste the nodes with "clipboard-paste" action. Note that this action has NO-relation with the system clipboard. -(fern-action-clipboard-move) +*(fern-action-clipboard-move)* Move a cursor node or marked nodes into an internal clipboard. Actual move happens when users paste the nodes with "clipboard-paste" action. Note that this action has NO-relation with the system clipboard. -(fern-action-clipboard-paste) +*(fern-action-clipboard-paste)* Paste copied/moved nodes on a cursor node. It does not clear the internal clipboard so users can copy -> paste -> paste -> ... Note that this action has NO-relation with the system clipboard. -(fern-action-clipboard-clear) +*(fern-action-clipboard-clear)* Clear the internal clipboard. Note that this action has NO-relation with the system clipboard. -(fern-action-grep) +*(fern-action-grep)* Open a prompt to ask a grep pattern and execute grep command under the cursor node. It respects the value of 'grepprg' and 'grepformat'. -(fern-action-rename:select) -(fern-action-rename:split) -(fern-action-rename:vsplit) -(fern-action-rename:tabedit) -(fern-action-rename:above) -(fern-action-rename:left) -(fern-action-rename:below) -(fern-action-rename:right) -(fern-action-rename:top) -(fern-action-rename:leftest) -(fern-action-rename:bottom) -(fern-action-rename:rightest) -(fern-action-rename:edit-or-error) -(fern-action-rename:edit-or-split) -(fern-action-rename:edit-or-vsplit) -(fern-action-rename:edit-or-tabedit) -(fern-action-rename:edit) -(fern-action-rename:side) -(fern-action-rename) +*(fern-action-rename:select)* +*(fern-action-rename:split)* +*(fern-action-rename:vsplit)* +*(fern-action-rename:tabedit)* +*(fern-action-rename:above)* +*(fern-action-rename:left)* +*(fern-action-rename:below)* +*(fern-action-rename:right)* +*(fern-action-rename:top)* +*(fern-action-rename:leftest)* +*(fern-action-rename:bottom)* +*(fern-action-rename:rightest)* +*(fern-action-rename:edit-or-error)* +*(fern-action-rename:edit-or-split)* +*(fern-action-rename:edit-or-vsplit)* +*(fern-action-rename:edit-or-tabedit)* +*(fern-action-rename:edit)* +*(fern-action-rename:side)* +*(fern-action-rename)* Open "renamer" (|fern-glossary-renamer|) for a cursor node or marked nodes in similar manners of global "open" actions. -(fern-action-open:system) +*(fern-action-open:system)* Open a cursor node or marked nodes on a default program of the system. For example, a cursor node points a PDF file, an application "Preview" will open that file in macOS. -(fern-action-terminal:select) -(fern-action-terminal:split) -(fern-action-terminal:vsplit) -(fern-action-terminal:tabedit) -(fern-action-terminal:above) -(fern-action-terminal:left) -(fern-action-terminal:below) -(fern-action-terminal:right) -(fern-action-terminal:top) -(fern-action-terminal:leftest) -(fern-action-terminal:bottom) -(fern-action-terminal:rightest) -(fern-action-terminal:edit-or-error) -(fern-action-terminal:edit-or-split) -(fern-action-terminal:edit-or-vsplit) -(fern-action-terminal:edit-or-tabedit) -(fern-action-terminal:edit) -(fern-action-terminal:side) -(fern-action-terminal) +*(fern-action-terminal:select)* +*(fern-action-terminal:split)* +*(fern-action-terminal:vsplit)* +*(fern-action-terminal:tabedit)* +*(fern-action-terminal:above)* +*(fern-action-terminal:left)* +*(fern-action-terminal:below)* +*(fern-action-terminal:right)* +*(fern-action-terminal:top)* +*(fern-action-terminal:leftest)* +*(fern-action-terminal:bottom)* +*(fern-action-terminal:rightest)* +*(fern-action-terminal:edit-or-error)* +*(fern-action-terminal:edit-or-split)* +*(fern-action-terminal:edit-or-vsplit)* +*(fern-action-terminal:edit-or-tabedit)* +*(fern-action-terminal:edit)* +*(fern-action-terminal:side)* +*(fern-action-terminal)* Open terminal window(s) on or on parent of a cursor node or marked nodes in similar manners of global "open" actions.