;;; helm-help.el --- Help messages for Helm. -*- lexical-binding: t -*- ;; Copyright (C) 2012 ~ 2015 Thierry Volpiatto ;; This program is free software; you can redistribute it and/or modify ;; it under the terms of the GNU General Public License as published by ;; the Free Software Foundation, either version 3 of the License, or ;; (at your option) any later version. ;; This program is distributed in the hope that it will be useful, ;; but WITHOUT ANY WARRANTY; without even the implied warranty of ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the ;; GNU General Public License for more details. ;; You should have received a copy of the GNU General Public License ;; along with this program. If not, see . ;;; Code: (require 'helm) (defvar helm-org-headings--nofilename) (declare-function helm-source-org-headings-for-files "helm-org.el") (defgroup helm-help nil "Embedded help for `helm'." :group 'helm) (defface helm-helper '((t :inherit helm-header)) "Face for helm help string in minibuffer." :group 'helm-help) (defcustom helm-documentation-file "~/.emacs.d/helm-doc.org" "The file where you want to save helm documentation." :group 'helm-help :type 'string) (defvar helm-help--string-list '(helm-help-message helm-buffer-help-message helm-ff-help-message helm-read-file-name-help-message helm-generic-file-help-message helm-grep-help-message helm-pdfgrep-help-message helm-etags-help-message helm-ucs-help-message helm-bookmark-help-message helm-esh-help-message helm-buffers-ido-virtual-help-message helm-moccur-help-message helm-top-help-message helm-apt-help-message helm-el-package-help-message helm-M-x-help-message helm-imenu-help-message helm-colors-help-message helm-semantic-help-message helm-kmacro-help-message)) ;;;###autoload (defun helm-documentation (arg) "Preconfigured helm for helm documentation. With a prefix arg refresh the documentation. Find here the documentation of all sources actually documented." (interactive "P") (require 'helm-org) (when arg (delete-file helm-documentation-file) (helm-aif (get-file-buffer helm-documentation-file) (kill-buffer it))) (unless (file-exists-p helm-documentation-file) (with-temp-file helm-documentation-file (erase-buffer) (cl-loop for elm in helm-help--string-list for str = (symbol-value elm) do (insert (substitute-command-keys (if (functionp str) (funcall str) str)))))) (let ((helm-org-headings--nofilename t)) (helm :sources (helm-source-org-headings-for-files (list helm-documentation-file)) :candidate-number-limit 99999 :buffer "*helm documentation*"))) ;;; Global help message - Used by `helm-help' ;; ;; (defvar helm-help-message (lambda () (concat "\n\n\n* Helm generic help\n" "\\" "\n`helm' is an Emacs incremental completion and selection narrowing framework. Narrow the list by typing some pattern, Multiple patterns are allowed by splitting by space. Select with natural Emacs operations, choose with RET. ** Help C-h m : Run this generic help for helm. ** Basic Operations C-p, Up: Previous Line C-n, Down : Next Line M-v, PageUp : Previous Page C-v, PageDown : Next Page Enter : Execute first (default) action / Select M-< : First Line M-> : Last Line M-PageUp, C-M-S-v, C-M-y : Previous Page (other-window) M-PageDown, C-M-v : Next Page (other-window) Tab, C-i : Show action list Left : Previous Source Right, C-o : Next Source C-k : Delete pattern (with prefix arg delete from point to end) C-j or C-z: Persistent Action (Execute action with helm session kept) ** Shortcuts For nth Action f1-12: Execute nth 1 to 12 Action(s). ** Visible Marks Visible marks store candidate. Some actions uses marked candidates. \\[helm-toggle-visible-mark] : Toggle Visible Mark \\[helm-prev-visible-mark] : Previous Mark \\[helm-next-visible-mark] : Next Mark ** Miscellaneous Commands \\[helm-toggle-resplit-window] : Toggle vertical/horizontal split helm window. \\[helm-quit-and-find-file] : Drop into `find-file'. \\[helm-delete-current-selection] : Delete selected item (visually). \\[helm-kill-selection-and-quit] : Kill display value of candidate and quit (with prefix arg kill the real value). \\[helm-yank-selection] : Yank selection into pattern. \\[helm-follow-mode] : Toggle automatical execution of persistent action. \\[helm-follow-action-forward] : Run persistent action and goto next line. \\[helm-follow-action-backward] : Run persistent action and goto previous line. \\[helm-force-update] : Recalculate and redisplay candidates. \\[helm-toggle-suspend-update] : Suspend/reenable update. ** Global Commands \\\\[helm-resume] revives last `helm' session. It is very useful, so you should bind any key. \n** Helm Map \\{helm-map}")) "Detailed help message string for `helm'. It also accepts function or variable symbol.") ;;;###autoload (defun helm-help () "Help of `helm'." (interactive) (with-helm-alive-p (save-selected-window (helm-help-internal "*Helm Help*" (lambda () (helm-aif (assoc-default 'help-message (helm-get-current-source)) (insert (substitute-command-keys (helm-interpret-value it)) (substitute-command-keys (helm-interpret-value helm-help-message))) (substitute-command-keys (helm-interpret-value helm-help-message)))))))) ;;; Local help messages. ;;; `helm-buffer-list' help ;; ;; (defvar helm-buffer-help-message "\n* Helm Buffer\n ** Helm buffers tips: *** Completion: **** Major-mode: You can enter a partial name of major-mode (e.g lisp, sh) to narrow down buffers. To specify the major-mode, prefix it with \"*\" e.g \"*lisp\". If you want to match all buffers but the ones with a specific major-mode (negation), prefix the major-mode with \"!\" e.g \"*!lisp\". If you want to specify more than one major-mode, separate them with \",\", e.g \"*!lisp,!sh,!fun\" will list all buffers but the ones in lisp-mode, sh-mode and fundamental-mode. Enter then a space and a pattern to narrow down to buffers matching this pattern. **** Search inside buffers: If you enter a space and a pattern prefixed by \"@\" helm will search for text matching this pattern INSIDE the buffer (i.e not in the name of buffer). NOTE that if you enter your pattern prefixed with \"@\" but escaped, helm will search a buffer matching \"@pattern\" but will not search inside. **** Search by directory name: If you prefix the beginning of pattern with \"/\" the match will occur on directory name of buffer, it is interesting to narrow down to one directory for example, subsequent string entered after a space will match on buffer-name only. Note that negation is not supported for matching on buffer-file-name. You can specify more than one directory starting from helm v1.6.8 **** Fuzzy matching: Note that if `helm-buffers-fuzzy-matching' is non--nil you will have fuzzy matching on buffer names (not on directory name matching and major-mode though). A pattern starting with \"^\" will disable fuzzy matching and will match by exact regexp. **** Examples: if I enter in pattern prompt: \"*lisp ^helm @moc\" helm will narrow down the list by selecting only buffers that are in lisp mode, start by helm and match \"moc\" in their contents. if I enter in pattern prompt: \"*lisp ^helm moc\" Notice there is no \"@\" this time helm will look for lisp mode buffers starting by \"helm\" and have \"moc\" in their name. if I enter in pattern prompt: \"*!lisp !helm\" helm will narrow down to buffers that are not in \"lisp\" mode and that do not match \"helm\" if I enter in pattern prompt: /helm/ w3 helm will narrow down to buffers that are in any \"helm\" subdirectory and matching w3. *** Creating buffers When creating a new buffer use \\[universal-argument] to choose a mode for your buffer in a list. This list is customizable, see `helm-buffers-favorite-modes'. *** Killing buffers You have a command to kill buffer(s) and quit emacs and a command to kill buffers one by one \(no marked\) without quitting helm. You can run this persistent kill buffer command either with the regular `helm-execute-persistent-action' called with a prefix arg (C-u C-j) or with its specific command `helm-buffer-run-kill-persistent' see binding below. *** Meaning of colors and prefixes for buffers: Remote buffers are prefixed with '@'. Red => Buffer have its file modified on disk by an external process. Indianred2 => Buffer exists but its file have been deleted. Orange => Buffer is modified and its file not saved to disk. Italic => A non--file buffer. \n** Specific commands for `helm-buffers-list': \\ \\[helm-buffer-run-zgrep]\t\t->Grep Buffer(s) works as zgrep too (C-u grep all buffers but non--file buffers). \\[helm-buffers-run-multi-occur]\t\t->Multi Occur buffer or marked buffers. (C-u toggle force searching current-buffer). \\[helm-buffer-switch-other-window]\t\t->Switch other window. \\[helm-buffer-switch-other-frame]\t\t->Switch other frame. \\[helm-buffer-run-query-replace-regexp]\t\t->Query replace regexp in marked buffers. \\[helm-buffer-run-query-replace]\t\t->Query replace in marked buffers. \\[helm-buffer-run-ediff]\t\t->Ediff current buffer with candidate. If two marked buffers ediff those buffers. \\[helm-buffer-run-ediff-merge]\t\t->Ediff merge current buffer with candidate. If two marked buffers ediff merge those buffers. \\[helm-buffer-diff-persistent]\t\t->Toggle Diff buffer with saved file without quitting. \\[helm-buffer-revert-persistent]\t\t->Revert buffer without quitting. \\[helm-buffer-save-persistent]\t\t->Save buffer without quitting. \\[helm-buffer-run-kill-buffers]\t\t->Delete marked buffers and quit. \\[helm-buffer-run-kill-persistent]\t\t->Delete buffer without quitting helm. \\[helm-toggle-all-marks]\t\t->Toggle all marks. \\[helm-mark-all]\t\t->Mark all. \\[helm-toggle-buffers-details]\t\t->Toggle details. \\[helm-buffers-toggle-show-hidden-buffers]\t\t->Show hidden buffers. \\[helm-buffers-mark-similar-buffers]\t\t->Mark all buffers with same type (color) than current. \\[helm-buffer-help]\t\t->Display this help.") ;;; Find files help (`helm-find-files') ;; ;; (defvar helm-ff-help-message "\n* Helm Find Files\n ** Helm find files tips: *** Navigation summary **** Use `C-j' (persistent action) on a directory to go down one level. **** Use `C-l' on a directory to go up one level. **** Use `C-r' to walk back the resulting tree of all the `C-l' you did. Note: The tree is reinitialized each time you enter a new tree with `C-j' or by entering some pattern in prompt. *** Quick pattern expansion: \n**** Enter `~/' at end of pattern to quickly reach home directory. **** Enter `/' at end of pattern to quickly reach root of your file system. **** Enter `./' at end of pattern to quickly reach `default-directory' (initial start of session). If you are already in `default-directory' this will move cursor on top. **** Enter `../' at end of pattern will reach upper directory, moving cursor on top. NOTE: This is different to using `C-l' in that `C-l' don't move cursor on top but stay on previous subdir name. **** Enter any environment var (e.g `$HOME') at end of pattern, it will be expanded. **** You can yank any valid filename after pattern, it will be expanded. *** You can complete with partial basename (start on third char entered) e.g \"fob\" or \"fbr\" will complete \"foobar\" but \"fb\" will wait for a third char for completing. *** Use `C-u C-j' to watch an image. *** `C-j' on a filename will expand in helm-buffer to this filename. Second hit on `C-j' will display buffer filename. Third hit on `C-j' will kill buffer filename. NOTE: `C-u C-j' will display buffer directly. *** To browse images directories turn on `helm-follow-mode' and navigate with arrow keys. You can also use `helm-follow-action-forward' and `helm-follow-action-backward' (`C-'). *** You can turn off/on (toggle) autoupdate completion at any moment with `C-DEL'. NOTE: On a terminal C- may not work, use in this case C-c . *** You can create a new directory and a new file at the same time. just write the path in prompt and press `'. e.g You can create \"~/new/newnew/newnewnew/my_newfile.txt\". *** To create a new directory, add a \"/\" at end of new name and press . *** To create a new file just write the filename not ending with \"/\". *** Recursive search from helm find files **** You can use helm browse project (see binding below). - With no prefix arg If your current directory is under version control with one of git or hg and you have installed helm-ls-git and/or helm-ls-hg https://github.com/emacs-helm/helm-ls-git.git https://github.com/emacs-helm/helm-ls-hg you will see all your files under version control, otherwise you will be back to helm-find-files. - With one prefix arg You will see all the files under this directory and other subdirectories (recursion) and this list of files will be cached. - With two prefix args same but the cache will be refreshed. **** You can start a recursive search with Locate of Find (See commands below). With Locate you can use a local db with a prefix arg; If the localdb doesn't already exists, you will be prompted for its creation, if it exists and you want to refresh it, give two prefix args. *** Insert filename at point or complete filename at point On insertion (no completion, i.e nothing at point): - `C-c i' => insert absolute file name. - `C-u C-c i' => insert abbreviate file name. - `C-u C-u C-c i' => insert relative file name. On completion: - target starts by ~/ => insert abbreviate file name. - target starts by / or [a-z]:/ => insert full path. - otherwise => insert relative file name. *** Using wildcard to select multiple files Use of wilcard is supported to give a set of files to an action: e.g You can copy all the files with \".el\" extension by using \"*.el\" and then run your copy action. You can do the same but with \"**.el\" (note the two stars), this will select recursively all \".el\" files under current directory. NOTE: When using an action that involve an external backend (e.g grep), using \"**\" is not advised (even if it works fine) because it will be slower to select all your files, you have better time letting the backend doing it, it will be faster. However, if you know you have not many files it is reasonable to use this, also using not recursive wilcard (e.g \"*.el\") is perfectly fine for this. This feature (\"**\") is activated by default with the option `helm-file-globstar'. The directory selection with \"**foo/\" like bash shopt globstar option is not supported yet. *** Copying renaming asynchronously If you use async library (if you have installed helm from MELPA you do) you can enable async for copying/renaming etc... your files by enabling `dired-async-mode'. Note that even when async is enabled, running a copy/rename action with a prefix arg will execute action synchronously, it will follow also the first file of the marked files in its destination directory. *** Bookmark your `helm-find-files' session You can bookmark your `helm-find-files' session with `C-x r m'. You can retrieve later these bookmarks easily by using M-x helm-filtered-bookmarks or from the current `helm-find-files' session just hitting `C-x r b'. *** Run Gid from `helm-find-files' You can navigate to a project containing an ID file created with the `mkid' command from id-utils, and run the `gid' command which will use the symbol at point in `helm-current-buffer' as default. \n** Specific commands for `helm-find-files':\n \\ \\[helm-ff-run-locate]\t\t->Run Locate (C-u to specify locate db, M-n insert basename of candidate) \\[helm-ff-run-browse-project]\t\t->Browse project (`C-u' recurse, `C-u C-u' recurse and refresh db) \\[helm-ff-run-find-sh-command]\t\t->Run Find shell command from this directory. \\[helm-ff-run-grep]\t\t->Run Grep (C-u Recursive). \\[helm-ff-run-pdfgrep]\t\t->Run Pdfgrep on marked files. \\[helm-ff-run-zgrep]\t\t->Run zgrep (C-u Recursive). \\[helm-ff-run-gid]\t\t->Run gid (id-utils). \\[helm-ff-run-etags]\t\t->Run Etags (C-u use thing-at-point `C-u C-u' reload cache) \\[helm-ff-run-rename-file]\t\t->Rename File (C-u Follow). \\[helm-ff-run-query-replace-on-marked]\t\t->Query replace on marked files. \\[helm-ff-run-copy-file]\t\t->Copy File (C-u Follow). \\[helm-ff-run-byte-compile-file]\t\t->Byte Compile File (C-u Load). \\[helm-ff-run-load-file]\t\t->Load File. \\[helm-ff-run-symlink-file]\t\t->Symlink File. \\[helm-ff-run-hardlink-file]\t\t->Hardlink file. \\[helm-ff-run-delete-file]\t\t->Delete File. \\[helm-ff-run-kill-buffer-persistent]\t\t->Kill buffer candidate without quitting. \\[helm-ff-persistent-delete]\t\t->Delete file without quitting. \\[helm-ff-run-switch-to-eshell]\t\t->Switch to Eshell. \\[helm-ff-run-eshell-command-on-file]\t\t->Eshell command on file (C-u Apply on marked files, otherwise treat them sequentially). \\[helm-ff-run-ediff-file]\t\t->Ediff file. \\[helm-ff-run-ediff-merge-file]\t\t->Ediff merge file. \\[helm-ff-run-complete-fn-at-point]\t\t->Complete file name at point. \\[helm-ff-run-switch-other-window]\t\t->Switch other window. \\[helm-ff-run-switch-other-frame]\t\t->Switch other frame. \\[helm-ff-run-open-file-externally]\t\t->Open file with external program (C-u to choose). \\[helm-ff-run-open-file-with-default-tool]\t\t->Open file externally with default tool. \\[helm-ff-rotate-left-persistent]\t\t->Rotate Image Left. \\[helm-ff-rotate-right-persistent]\t\t->Rotate Image Right. \\[helm-find-files-up-one-level]\t\t->Go down precedent directory. \\[helm-ff-run-switch-to-history]\t\t->Switch to last visited directories history. \\[helm-ff-file-name-history]\t\t->Switch to file name history. \\[helm-ff-properties-persistent]\t\t->Show file properties in a tooltip. \\[helm-mark-all]\t\t->Mark all visibles candidates. \\[helm-ff-run-toggle-auto-update]\t\t->Toggle auto expansion of directories. \\[helm-unmark-all]\t\t->Unmark all candidates, visibles and invisibles. \\[helm-ff-run-gnus-attach-files]\t\t->Gnus attach files to message buffer. \\[helm-ff-run-print-file]\t\t->Print file, (C-u to refresh printers list). \\[helm-enlarge-window]\t\t->Enlarge helm window. \\[helm-narrow-window]\t\t->Narrow helm window. \\[helm-ff-run-toggle-basename]\t\t->Toggle basename/fullpath. \\[helm-ff-run-find-file-as-root]\t\t->Find file as root. \\[helm-ff-run-insert-org-link]\t\t->Insert org link. \\[helm-ff-help]\t\t->Display this help info.") ;;; Help for `helm-read-file-name' ;; ;; (defvar helm-read-file-name-help-message "\n* Helm read file name\n ** Helm read file name tips: \n*** Enter `~/' at end of pattern to quickly reach home directory. *** Enter `/' at end of pattern to quickly reach root of your file system. *** Enter `./' at end of pattern to quickly reach `default-directory' (initial start of session). If you are in `default-directory' move cursor on top. *** Enter `../' at end of pattern will reach upper directory, moving cursor on top. NOTE: This different to using `C-l' in that `C-l' don't move cursor on top but stay on previous subdir name. *** You can complete with partial basename (start on third char entered) e.g \"fob\" or \"fbr\" will complete \"foobar\" but \"fb\" will wait for a third char for completing. *** Persistent actions: By default `helm-read-file-name' use the persistent actions of `helm-find-files'. **** Use `C-u C-j' to watch an image. **** `C-j' on a filename will expand in helm-buffer to this filename. Second hit on `C-j' will display buffer filename. Third hit on `C-j' will kill buffer filename. NOTE: `C-u C-j' will display buffer directly. **** To browse images directories turn on `helm-follow-mode' and navigate with arrow keys. **** When you want to delete backward characters to e.g creating a new file or directory, autoupdate may keep updating to an existent directory preventing you to do so, in this case just hit C- and then . This should not needed when copying/renaming files because autoupdate is disabled by default in this case. NOTE: On a terminal C- may not work, use in this case C-c . **** You can create a new directory and a new file at the same time, just write the path in prompt and press . e.g You can create \"~/new/newnew/newnewnew/my_newfile.txt\". **** To create a new directory, add a \"/\" at end of new name and press . **** To create a new file just write the filename not ending with \"/\". \n** Specific commands for helm-read-file-name:\n \\ \\[helm-find-files-up-one-level]\t\t->Go down precedent directory. \\[helm-ff-run-toggle-auto-update]\t\t->Toggle auto expansion of directories. \\[helm-ff-run-toggle-basename]\t\t->Toggle basename. \\[helm-ff-file-name-history]\t\t->File name history. C/\\[helm-cr-empty-string]\t\t->Maybe return empty string (unless `must-match'). \\[helm-next-source]\t\t->Goto next source. \\[helm-previous-source]\t->Goto previous source. \\[helm-read-file-name-help]\t\t->Display this help info.") ;;; Generic file help - Used by locate. ;; ;; (defvar helm-generic-file-help-message "\n* Helm Generic files\n ** Helm generic file tips:\n *** Locate You can add after writing search pattern any of the locate command line options. e.g -b, -e, -n ...etc. See Man locate for more infos. Some other sources (at the moment recentf and file in current directory sources) support the -b flag for compatibility with locate when they are used with it. *** Browse project When your directory is not under version control, don't forget to refresh your cache when files have been added/removed in your directory. *** Find command Recursively search files using \"find\" shell command. Candidates are all filenames that match all given globbing patterns. This respects the options `helm-case-fold-search' and `helm-findutils-search-full-path'. You can pass arbitrary options directly to find after a \"*\" separator. For example, this would find all files matching \"book\" that are larger than 1 megabyte: book * -size +1M \n** Specific commands for helm locate and others files sources: \\ \\[helm-ff-run-toggle-basename]\t\t->Toggle basename. \\[helm-ff-run-grep]\t\t->Run grep (C-u recurse). \\[helm-ff-run-zgrep]\t\t->Run zgrep. \\[helm-ff-run-gid]\t\t->Run gid (id-utils). \\[helm-ff-run-pdfgrep]\t\t->Run Pdfgrep on marked files. \\[helm-ff-run-copy-file]\t\t->Copy file(s) \\[helm-ff-run-rename-file]\t\t->Rename file(s). \\[helm-ff-run-symlink-file]\t\t->Symlink file(s). \\[helm-ff-run-hardlink-file]\t\t->Hardlink file(s). \\[helm-ff-run-delete-file]\t\t->Delete file(s). \\[helm-ff-run-byte-compile-file]\t\t->Byte compile file(s) (C-u load) (elisp). \\[helm-ff-run-load-file]\t\t->Load file(s) (elisp). \\[helm-ff-run-ediff-file]\t\t->Ediff file. \\[helm-ff-run-ediff-merge-file]\t\t->Ediff merge file. \\[helm-ff-run-switch-other-window]\t\t->Switch other window. \\[helm-ff-properties-persistent]\t\t->Show file properties. \\[helm-ff-run-etags]\t\t->Run etags (C-u use tap, C-u C-u reload DB). \\[helm-yank-text-at-point]\t\t->Yank text at point. \\[helm-ff-run-open-file-externally]\t\t->Open file with external program (C-u to choose). \\[helm-ff-run-open-file-with-default-tool]\t\t->Open file externally with default tool. \\[helm-ff-run-insert-org-link]\t\t->Insert org link. \\[helm-generic-file-help]\t\t->Show this help.") ;;; Grep help ;; ;; (defvar helm-grep-help-message "\n* Helm Grep\n ** Helm grep tips:\n *** You can start grep with a prefix arg to recurse in subdirectories. *** You can use wild card when selecting files (e.g *.el) *** You can grep in many differents directories by marking files or wild cards. *** You can save your results in a grep-mode buffer, see commands below. *** Important:\n Grepping on remote file will work only with grep, not ack-grep, but it is anyway bad supported as tramp doesn't support multiple process running in a short delay (less than 5s actually) among other things, so I strongly advice hitting `C-!' (i.e suspend process) before entering anything in pattern, and hit again `C-!' when your regexp is ready to send to remote process, even if helm is handling this by delaying each process at 5s. Or even better don't use tramp at all and mount your remote file system on SSHFS. * Helm Gid\n ** Helm Gid tips Helm gid read the database created with the `mkid' command from id-utils. The name of the database file can be customized with `helm-gid-db-file-name', it is usually \"ID\". Helm Gid use the symbol at point as default-input. You have access to this command also from `helm-find-files' which allow you to navigate to another directory to consult its database. \n** Specific commands for Helm Grep:\n \\ \\[helm-goto-next-file]\t->Next File. \\[helm-goto-precedent-file]\t\t->Precedent File. \\[helm-yank-text-at-point]\t\t->Yank Text at point in minibuffer. \\[helm-grep-run-other-window-action]\t\t->Jump other window. \\[helm-grep-run-other-frame-action]\t\t->Jump other frame. \\[helm-grep-run-persistent-action]\t\t->Run persistent action (Same as `C-j'). \\[helm-grep-run-default-action]\t\t->Run default action (Same as RET). \\[helm-grep-run-save-buffer]\t\t->Save to a `grep-mode' enabled buffer. \\[helm-grep-help]\t\t->Show this help.") ;;; Pdf grep help ;; ;; (defvar helm-pdfgrep-help-message "\n* Helm PdfGrep Map\n \n** Specific commands for Pdf Grep:\n \\ \\[helm-goto-next-file]\t->Next File. \\[helm-goto-precedent-file]\t\t->Precedent File. \\[helm-yank-text-at-point]\t\t->Yank Text at point in minibuffer. \\[helm-pdfgrep-help]\t\t->Show this help.") ;;; Etags help ;; ;; (defvar helm-etags-help-message "\n* Helm Etags Map\n \n** Specific commands for Etags:\n \\ \\[helm-goto-next-file]\t->Next File. \\[helm-goto-precedent-file]\t\t->Precedent File. \\[helm-yank-text-at-point]\t\t->Yank Text at point in minibuffer. \\[helm-etags-help]\t\t->Show this help.") ;;; Ucs help ;; ;; (defvar helm-ucs-help-message "\n* Helm Ucs\n \n** Specific commands for `helm-ucs':\n \\ \\[helm-ucs-persistent-insert]\t->Insert char. \\[helm-ucs-persistent-forward]\t->Forward char. \\[helm-ucs-persistent-backward]\t->Backward char. \\[helm-ucs-persistent-delete]\t->Delete char backward. \\[helm-ucs-help]\t\t->Show this help.") ;;; Bookmark help ;; ;; (defvar helm-bookmark-help-message "\n* Helm bookmark name\n \n** Specific commands for bookmarks:\n \\ \\[helm-bookmark-run-jump-other-window]\t\t->Jump other window. \\[helm-bookmark-run-delete]\t\t->Delete bookmark. \\[helm-bookmark-run-edit]\t\t->Edit bookmark. \\[helm-bookmark-toggle-filename]\t\t->Toggle bookmark location visibility. \\[helm-bookmark-help]\t\t->Run this help.") ;;; Eshell command on file help ;; ;; (defvar helm-esh-help-message "\n* Helm eshell on file\n ** Helm eshell on file tips: *** Passing extra args after filename: Normally your command or alias will be called with file as argument. e.g 'candidate_file' But you can also pass an argument or more after 'candidate_file' like this: %s [extra_args]\n 'candidate_file' will be added at '%s' and your command will look at this: 'candidate_file' [extra_args] *** Specify many files as args (marked files): e.g file1 file2 ... Call `helm-find-files-eshell-command-on-file' with one prefix-arg Otherwise you can pass one prefix-arg from the command selection buffer. NOTE: This is not working on remote files. With two prefix-arg before starting or from the command selection buffer the output is printed to your `current-buffer'. Note that with no prefix-arg or a prefix-arg value of '(16) (C-u C-u) the command is called once for each file like this: file1 file2 etc... \n** Specific commands for `helm-find-files-eshell-command-on-file':\n \\ \\[helm-esh-help]\t\t->Display this help.") ;;; Ido virtual buffer help ;; ;; (defvar helm-buffers-ido-virtual-help-message "\n* Helm ido virtual buffers\n \n** Specific commands for ido virtuals buffers:\n \\ \\[helm-ff-run-switch-other-window]\t\t->Switch other window. \\[helm-ff-run-switch-other-frame]\t\t->Switch other frame. \\[helm-ff-run-grep]\t\t->Grep file. \\[helm-ff-run-zgrep]\t\t->Zgrep file. \\[helm-ff-run-delete-file]\t\t->Delete file. \\[helm-ff-run-open-file-externally]\t\t->Open file externally. \\[helm-buffers-ido-virtual-help]\t\t->Display this help.") ;;; Moccur help ;; ;; (defvar helm-moccur-help-message "\n* Helm Moccur\n ** Helm Moccur tips: *** Matching Multiple regexp matching is allowed, just enter a space to separate your regexps. Matching empty lines is supported with the regexp \"^$\", you will get the results with only the buffer-name and the line number, you can of course save and edit these results (i.e add text to the empty line) . *** Automatically matching symbol at point You can match automatically the symbol at point, but keeping the minibuffer empty ready to write into. This is disabled by default, to enable this you have to add `helm-source-occur' and `helm-source-moccur' to `helm-sources-using-default-as-input'. *** Jump to the corresponding line in the searched buffer You can do this with `C-j' (persistent-action), to do it repetitively you can use `C-' and `C-' or enable `helm-follow-mode' with `C-c C-f'. *** Saving results Same as with helm-grep, you can save the results with `C-x C-s'. Of course if you don't save your results, you can get back your session with `helm-resume'. *** Refreshing the resumed session. When the buffer(s) where you ran helm-(m)occur have been modified, you will be warned of this with the buffer flashing to red, you can refresh the buffer by running `C-c C-u'. This can be done automatically by customizing `helm-moccur-auto-update-on-resume'. *** Refreshing a saved buffer Just hit `g' to update your buffer. *** Edit a saved buffer To do so you have to install wgrep https://github.com/mhayashi1120/Emacs-wgrep and then: 1) C-c C-p to edit the buffer(s). 2) C-x C-s to save your changes. Tip: Use the excellent iedit https://github.com/tsdh/iedit to modify occurences in your buffer. \n** Specific commands for Helm Moccur:\n \\ \\[helm-goto-next-file]\t->Next Buffer. \\[helm-goto-precedent-file]\t\t->Precedent Buffer. \\[helm-yank-text-at-point]\t\t->Yank Text at point in minibuffer. \\[helm-moccur-run-goto-line-ow]\t\t->Goto line in other window. \\[helm-moccur-run-goto-line-of]\t\t->Goto line in new frame. \\[helm-moccur-help]\t\t->Show this help.") ;;; Helm Top ;; ;; (defvar helm-top-help-message "\n* Helm Top\n \n** Helm Top tips: \n** Specific commands for Helm Top:\n \\ \\[helm-top-run-sort-by-com]\t->Sort by commands. \\[helm-top-run-sort-by-cpu]\t->Sort by cpu usage. \\[helm-top-run-sort-by-user]\t->Sort alphabetically by user. \\[helm-top-run-sort-by-mem]\t->Sort by memory.") ;;; Helm Apt ;; ;; (defvar helm-apt-help-message "\n* Helm Apt\n \n** Helm Apt tips: \n** Specific commands for Helm Apt:\n \\ \\[helm-apt-show-all]\t->Show all packages. \\[helm-apt-show-only-installed]\t->Show installed packages only. \\[helm-apt-show-only-not-installed]\t->Show not installed packages only. \\[helm-apt-show-only-deinstalled]\t-Show deinstalled (not purged yet) packages only.>") ;;; Helm elisp package ;; ;; (defvar helm-el-package-help-message "\n* Helm elisp package\n \n** Helm elisp package tips: *** Upgrade elisp packages To see upgradables packages hit . Then you can install all upgradables packages with the upgrade all action, or upgrade only the specific packages by marking them (the new ones) and running the upgrade action (visible only when there is upgradables packages). Of course you can upgrade a single package by just running the upgrade action without marking it. *** Meaning of flags prefixing packages (Emacs-25) - The flag \"S\" that prefix package names mean that this package is one of `package-selected-packages'. This feature is only available with emacs-25. - The flag \"U\" that prefix package names mean that this package is no more needed. This feature is only available with emacs-25. \n** Specific commands for Helm elisp package:\n \\ \\[helm-el-package-show-all]\t->Show all packages. \\[helm-el-package-show-installed]\t->Show installed packages only. \\[helm-el-package-show-uninstalled]\t->Show not installed packages only. \\[helm-el-package-show-upgrade]\t->Show upgradable packages only. \\[helm-el-run-package-install]\t->Install package(s). \\[helm-el-run-package-reinstall]\t->Reinstall package(s). \\[helm-el-run-package-uninstall]\t->Uninstall package(s). \\[helm-el-run-package-upgrade]\t->Upgrade package(s). \\[helm-el-run-package-upgrade-all]\t->Upgrade all packages upgradables. \\[helm-el-run-visit-homepage]\t->Visit package homepage. \\[helm-el-package-help]\t->Show this help.") ;;; Helm M-x ;; ;; (defvar helm-M-x-help-message "\n* Helm M-x\n \n** Helm M-x tips: *** You can get help on any command with persistent action (C-j). *** All the prefix args passed BEFORE running `helm-M-x' are ignored, you should have an error message if you do so. When you want to pass prefix args, pass them AFTER starting `helm-M-x', you will have a prefix arg counter appearing in mode-line notifying you the amount of prefix args entered. \n** Specific commands for Helm M-x:\n \\ \\[helm-M-x-help]\t\t->Show this help.") ;;; helm-imenu ;; ;; (defvar helm-imenu-help-message "\n* Helm imenu\n \n** Helm imenu tips: \n** Specific commands for Helm imenu:\n \\ \\[helm-imenu-help]\t->Show this help.") ;;; helm-colors ;; ;; (defvar helm-colors-help-message "\n* Helm colors\n \n** Specific commands for Helm colors:\n \\ \\[helm-color-run-insert-name]\t\tInsert the entry'name. \\[helm-color-run-kill-name]\t\tKill the entry's name. \\[helm-color-run-insert-rgb]\t\tInsert entry in RGB format. \\[helm-color-run-kill-rgb]\t\tKill entry in RGB format. \\[helm-color-help]\t\tShow this help.") ;;; helm semantic ;; ;; (defvar helm-semantic-help-message "\n* Helm semantic\n \n** Helm semantic tips: \n** Specific commands for Helm semantic:\n \\ \\[helm-semantic-help]\t->Show this help.") ;;; helm kmacro ;; ;; (defvar helm-kmacro-help-message "\n* Helm kmacro\n \n** Helm kmacro tips: - Start recording some keys with `f3' - Record new kmacro with `f4' - Start `helm-execute-kmacro' to list all your macros. Use persistent action to run your kmacro as many time as needed, you can change of kmacro with `helm-next-line' `helm-previous-line'. NOTE: You can't record keys running helm commands except `helm-M-x' unless you don't choose from there a command using helm completion. \n** Specific commands for Helm kmacro:\n \\ \\[helm-kmacro-help]\t->Show this help.") ;;; Mode line strings ;; ;; ;;;###autoload (defvar helm-comp-read-mode-line "\ \\\ C/\\[helm-cr-empty-string]:Empty \ \\\ \\[helm-help]:Help \ \\[helm-select-action]:Act \ \\[helm-maybe-exit-minibuffer]/\ f1/f2/f-n:NthAct \ \\[helm-toggle-suspend-update]:Tog.suspend") ;;;###autoload (defvar helm-read-file-name-mode-line-string "\ \\\ \\[helm-help]:Help \ C/\\[helm-cr-empty-string]:Empty \ \\\ \\[helm-select-action]:Act \ \\[helm-maybe-exit-minibuffer]/\ f1/f2/f-n:NthAct \ \\[helm-toggle-suspend-update]:Tog.suspend" "String displayed in mode-line in `helm-source-find-files'.") ;;;###autoload (defvar helm-top-mode-line "\ \\\ \\[helm-help]:Help \ \\\ \\[helm-select-action]:Act \ \\[helm-maybe-exit-minibuffer]/\ f1/f2/f-n:NthAct \ \\[helm-toggle-suspend-update]:Tog.suspend") ;;; Attribute Documentation ;; ;; ;;;###autoload (defun helm-describe-helm-attribute (helm-attribute) "Display the full documentation of HELM-ATTRIBUTE. HELM-ATTRIBUTE should be a symbol." (interactive (list (intern (completing-read "Describe helm attribute: " (mapcar 'symbol-name helm-attributes) nil t)))) (with-output-to-temp-buffer "*Help*" (princ (get helm-attribute 'helm-attrdoc)))) (helm-document-attribute 'name "mandatory" " The name of the source. It is also the heading which appears above the list of matches from the source. Must be unique.") (helm-document-attribute 'header-name "optional" " A function returning the display string of the header. Its argument is the name of the source. This attribute is useful to add an additional information with the source name.") (helm-document-attribute 'candidates "mandatory if candidates-in-buffer attribute is not provided" " Specifies how to retrieve candidates from the source. It can either be a variable name, a function called with no parameters or the actual list of candidates. The list must be a list whose members are strings, symbols or (DISPLAY . REAL) pairs. In case of (DISPLAY . REAL) pairs, the DISPLAY string is shown in the Helm buffer, but the REAL one is used as action argument when the candidate is selected. This allows a more readable presentation for candidates which would otherwise be, for example, too long or have a common part shared with other candidates which can be safely replaced with an abbreviated string for display purposes. Note that if the (DISPLAY . REAL) form is used then pattern matching is done on the displayed string, not on the real value. If the candidates have to be retrieved asynchronously (for example, by an external command which takes a while to run) then the function should start the external command asynchronously and return the associated process object. Helm will take care of managing the process (receiving the output from it, killing it if necessary, etc.). The process should return candidates matching the current pattern (see variable `helm-pattern'.) You should use instead `candidates-process' attribute for async processes, a warning will popup when using async process in a `candidates' attribute. Note that currently results from asynchronous sources appear last in the helm buffer regardless of their position in `helm-sources'.") (helm-document-attribute 'candidates-process "Same as `candidates' attributes but for process function." " You should use this attribute when using a function involving an async process instead of `candidates'.") (helm-document-attribute 'action "mandatory if type attribute is not provided" " It is a list of (DISPLAY . FUNCTION) pairs or FUNCTION. FUNCTION is called with one parameter: the selected candidate. An action other than the default can be chosen from this list of actions for the currently selected candidate (by default with TAB). The DISPLAY string is shown in the completions buffer and the FUNCTION is invoked when an action is selected. The first action of the list is the default.") (helm-document-attribute 'coerce "optional" " It's a function called with one argument: the selected candidate. This function is intended for type convertion. In normal case, the selected candidate (string) is passed to action function. If coerce function is specified, it is called just before action function. Example: converting string to symbol (coerce . intern)") (helm-document-attribute 'type "optional if action attribute is provided" " Indicates the type of the items the source returns. Merge attributes not specified in the source itself from `helm-type-attributes'. This attribute is implemented by plug-in.") (helm-document-attribute 'init "optional" " Function called with no parameters when helm is started. It is useful for collecting current state information which can be used to create the list of candidates later. For example, if a source needs to work with the current directory then it can store its value here, because later helm does its job in the minibuffer and in the `helm-buffer' and the current directory can be different there.") (helm-document-attribute 'match "optional" " List of functions called with one parameter: a candidate. The function should return non-nil if the candidate matches the current pattern (see variable `helm-pattern'). This attribute allows the source to override the default pattern matching based on `string-match'. It can be used, for example, to implement a source for file names and do the pattern matching on the basename of files, since it's more likely one is typing part of the basename when searching for a file, instead of some string anywhere else in its path. If the list contains more than one function then the list of matching candidates from the source is constructed by appending the results after invoking the first function on all the potential candidates, then the next function, and so on. The matching candidates supplied by the first function appear first in the list of results and then results from the other functions, respectively. This attribute has no effect for asynchronous sources (see attribute `candidates'), since they perform pattern matching themselves.") (helm-document-attribute 'candidate-transformer "optional" " It's a function or a list of functions called with one argument when the completion list from the source is built. The argument is the list of candidates retrieved from the source. The function should return a transformed list of candidates which will be used for the actual completion. If it is a list of functions, it calls each function sequentially. This can be used to transform or remove items from the list of candidates. Note that `candidates' is run already, so the given transformer function should also be able to handle candidates with (DISPLAY . REAL) format.") (helm-document-attribute 'filtered-candidate-transformer "optional" " It has the same format as `candidate-transformer', except the function is called with two parameters: the candidate list and the source. This transformer is run on the candidate list which is already filtered by the current pattern. While `candidate-transformer' is run only once, it is run every time the input pattern is changed. It can be used to transform the candidate list dynamically, for example, based on the current pattern. In some cases it may also be more efficent to perform candidate transformation here, instead of with `candidate-transformer' even if this transformation is done every time the pattern is changed. For example, if a candidate set is very large then `candidate-transformer' transforms every candidate while only some of them will actually be dislpayed due to the limit imposed by `helm-candidate-number-limit'. Note that `candidates' and `candidate-transformer' is run already, so the given transformer function should also be able to handle candidates with (DISPLAY . REAL) format. This option has no effect for asynchronous sources. (Not yet, at least.") (helm-document-attribute 'action-transformer "optional" " It's a function or a list of functions called with two arguments when the action list from the source is assembled. The first argument is the list of actions, the second is the current selection. If it is a list of functions, it calls each function sequentially. The function should return a transformed action list. This can be used to customize the list of actions based on the currently selected candidate.") (helm-document-attribute 'pattern-transformer "optional" " It's a function or a list of functions called with one argument before computing matches. Its argument is `helm-pattern'. Functions should return transformed `helm-pattern'. It is useful to change interpretation of `helm-pattern'.") (helm-document-attribute 'delayed "optional" " Candidates from the source are shown only if the user stops typing and is idle for `helm-idle-delay' seconds. If a value is given to delayed attr, this value is used instead only if it is > to `helm-idle-delay'.") (helm-document-attribute 'volatile "optional" " Indicates the source assembles the candidate list dynamically, so it shouldn't be cached within a single Helm invocation. It is only applicable to synchronous sources, because asynchronous sources are not cached.") (helm-document-attribute 'requires-pattern "optional" " If present matches from the source are shown only if the pattern is not empty. Optionally, it can have an integer parameter specifying the required length of input which is useful in case of sources with lots of candidates.") (helm-document-attribute 'persistent-action "optional" " Can be a either a Function called with one parameter (the selected candidate) or a cons cell where first element is this same function and second element a symbol (e.g never-split) that inform `helm-execute-persistent-action'to not split his window to execute this persistent action.") (helm-document-attribute 'candidates-in-buffer "optional" " Shortcut attribute for making and narrowing candidates using buffers. This newly-introduced attribute prevents us from forgetting to add volatile and match attributes. See docstring of `helm-candidates-in-buffer'. (candidates-in-buffer) is equivalent of three attributes: (candidates . helm-candidates-in-buffer) (volatile) (match identity) (candidates-in-buffer . candidates-function) is equivalent of: (candidates . candidates-function) (volatile) (match identity) This attribute is implemented by plug-in.") (helm-document-attribute 'search "optional" " List of functions like `re-search-forward' or `search-forward'. Buffer search function used by `helm-candidates-in-buffer'. By default, `helm-candidates-in-buffer' uses `re-search-forward'. This attribute is meant to be used with (candidates . helm-candidates-in-buffer) or (candidates-in-buffer) in short.") (helm-document-attribute 'get-line "optional" " A function like `buffer-substring-no-properties' or `buffer-substring'. This function converts point of line-beginning and point of line-end, which represents a candidate computed by `helm-candidates-in-buffer'. By default, `helm-candidates-in-buffer' uses `buffer-substring-no-properties'.") (helm-document-attribute 'display-to-real "optional" " Function called with one parameter; the selected candidate. The function transforms the selected candidate, and the result is passed to the action function. The display-to-real attribute provides another way to pass other string than one shown in Helm buffer. Traditionally, it is possible to make candidates, candidate-transformer or filtered-candidate-transformer function return a list with (DISPLAY . REAL) pairs. But if REAL can be generated from DISPLAY, display-to-real is more convenient and faster.") (helm-document-attribute 'real-to-display "optional" " Function called with one parameter; the selected candidate. The inverse of display-to-real attribute. The function transforms the selected candidate, which is passed to the action function, for display. The real-to-display attribute provides the other way to pass other string than one shown in Helm buffer. Traditionally, it is possible to make candidates, candidate-transformer or filtered-candidate-transformer function return a list with (DISPLAY . REAL) pairs. But if DISPLAY can be generated from REAL, real-to-display is more convenient. Note that DISPLAY parts returned from candidates / candidate-transformer are IGNORED as the name `display-to-real' says.") (helm-document-attribute 'cleanup "optional" " Function called with no parameters when *helm* buffer is closed. It is useful for killing unneeded candidates buffer. Note that the function is executed BEFORE performing action.") (helm-document-attribute 'candidate-number-limit "optional" " Override `helm-candidate-number-limit' only for this source.") (helm-document-attribute 'accept-empty "optional" " Pass empty string \"\" to action function.") (helm-document-attribute 'dummy "optional" " Set `helm-pattern' to candidate. If this attribute is specified, The candidates attribute is ignored. This attribute is implemented by plug-in.") (helm-document-attribute 'multiline "optional" " Enable to selection multiline candidates.") (helm-document-attribute 'update "optional" (substitute-command-keys " Function called with no parameters at before \"init\" function when \ \\\\[helm-force-update] is pressed.")) (helm-document-attribute 'mode-line "optional" " Source local `helm-mode-line-string' (included in `mode-line-format'). It accepts also variable/function name.") (helm-document-attribute 'header-line "optional" " Source local `header-line-format'. It accepts also variable/function name. ") (helm-document-attribute 'resume "optional" " Function called with no parameters at end of initialization when `helm-resume' is started. If this function try to do something against `helm-buffer', \(e.g updating, searching etc...\) probably you should run it in a timer to ensure `helm-buffer' is ready.") (helm-document-attribute 'keymap "optional" " Specific keymap for this source. It is useful to have a keymap per source when using more than one source. Otherwise, a keymap can be set per command with `helm' argument KEYMAP. NOTE: when a source have `helm-map' as keymap attr, the global value of `helm-map' will override the actual local one.") (helm-document-attribute 'help-message "optional" " Help message for this source. If not present, `helm-help-message' value will be used.") (helm-document-attribute 'match-part "optional" " Allow matching candidate in the line with `candidates-in-buffer'. In candidates-in-buffer sources, match is done with `re-search-forward' which allow matching only a regexp on the `helm-buffer'; when this search is done, match-part allow matching only a specific part of the current line e.g with a line like this: filename:candidate-containing-the-word-filename What you want is to ignore \"filename\" part and match only \"candidate-containing-the-word-filename\" So give a function matching only the part of candidate after \":\" If source contain match-part attribute, match is computed only on part of candidate returned by the call of function provided by this attribute. The function should have one arg, candidate, and return only a specific part of candidate. NOTE: This have effect only on sources using `candidates-in-buffer'.") (helm-document-attribute 'match-strict "optional" " When specifying a match function within a source and helm-match-plugin is enabled, the result of all matching functions will be concatened, which in some cases is not what is wanted. When using `match-strict' only this or these functions will be used. You can specify those functions as a list of functions or a single symbol function. For anonymous function don't add the dot, e.g: \(match-strict (lambda () (foo))).") (helm-document-attribute 'nohighlight "optional" " Disable highlight match in this source.") (helm-document-attribute 'no-matchplugin "optional" " Disable matchplugin for this source.") (helm-document-attribute 'history "optional" " Allow passing history variable to helm from source. It should be a quoted symbol evaluated from source, i.e: (history . ,'history-var)") (helm-document-attribute 'follow "optional" " Enable `helm-follow-mode' for this source only. You must give it a value of 1 or -1, though giving a -1 value is surely not what you want, e.g: (follow . 1) See `helm-follow-mode' for more infos") (helm-document-attribute 'follow-delay "optional" " `helm-follow-mode' will execute persistent-action after this delay. Otherwise value of `helm-follow-input-idle-delay' is used if non--nil, If none of these are found fallback to `helm-input-idle-delay'.") (helm-document-attribute 'allow-dups "optional" " Allow helm collecting duplicates candidates.") (helm-document-attribute 'filter-one-by-one "optional" " A transformer function that treat candidates one by one. It is called with one arg the candidate. It is faster than `filtered-candidate-transformer' or `candidates-transformer', but should be used only in sources that recompute constantly their candidates, e.g `helm-source-find-files'. Filtering happen early and candidates are treated one by one instead of re-looping on the whole list. If used with `filtered-candidate-transformer' or `candidates-transformer' these functions should treat the candidates transformed by the `filter-one-by-one' function in consequence.") (helm-document-attribute 'nomark "optional" " Don't allow marking candidates when this attribute is present.") (provide 'helm-help) ;; Local Variables: ;; byte-compile-warnings: (not cl-functions obsolete) ;; coding: utf-8 ;; indent-tabs-mode: nil ;; End: ;;; helm-help.el ends here