From 1554a487c72f84c03766072c8fcad8a4629dd52c Mon Sep 17 00:00:00 2001 From: cskksc Date: Tue, 14 Jun 2016 20:31:33 +0530 Subject: [#1782] Customizable appearance of a multiline docstring --- doc/configuration.md | 44 ++++++++++++++++++++++++++++---------------- 1 file changed, 28 insertions(+), 16 deletions(-) (limited to 'doc') diff --git a/doc/configuration.md b/doc/configuration.md index 2fd6722b..15cb0b05 100644 --- a/doc/configuration.md +++ b/doc/configuration.md @@ -4,22 +4,6 @@ experience. ## Basic configuration -* Enable `eldoc` in Clojure buffers: - -```el -(add-hook 'cider-mode-hook #'eldoc-mode) -``` - -![Eldoc](images/eldoc.png) - -CIDER also would show the eldoc for the symbol at point. So in (map inc ...) -when the cursor is over inc its eldoc would be displayed. You can turn off this -behaviour by: - -```el -(setq cider-eldoc-display-for-symbol-at-point nil) -``` - * Suppress auto-enabling of `cider-mode` in `clojure-mode` buffers, when starting CIDER: @@ -140,6 +124,34 @@ More details can be found [here](https://github.com/clojure-emacs/cider/issues/9 (setq cider-filter-regexps '(".*nrepl")) ``` +## Configuring eldoc + +* Enable `eldoc` in Clojure buffers: + +```el +(add-hook 'cider-mode-hook #'eldoc-mode) +``` + +![Eldoc](images/eldoc.png) + +* CIDER also would show the eldoc for the symbol at point. So in (map inc ...) +when the cursor is over inc its eldoc would be displayed. You can turn off this +behaviour by: + +```el +(setq cider-eldoc-display-for-symbol-at-point nil) +``` + +* CIDER respects the value of `eldoc-echo-area-use-multiline-p` when +displaying documentation in the minibuffer. You can customize this variable to change +its behaviour. + +| eldoc-echo-area-use-multiline-p | Behaviour | +| ------------- | ------------- | +| `t` | Never attempt to truncate messages. Complete symbol name and function arglist or variable documentation will be displayed even if echo area must be resized to fit.| +| `nil` | Messages are always truncated to fit in a single line of display in the echo area. | +| `truncate-sym-name-if-fit` or anything non-nil | Symbol name may be truncated if it will enable the function arglist or documentation string to fit on a single line. Otherwise, behavior is just like `t` case. | + ## Overlays When you evaluate code in Clojure files, the result is displayed in the buffer -- cgit v1.2.3