1 # History of user-visible changes
5 * Group of backends can now contain keyword `:separate`, which makes candidates
6 from different backends sorted separately in the combined list.
7 * New frontend `company-pseudo-tooltip-unless-just-one-frontend-with-delay`.
8 * New transformer `company-sort-prefer-same-case-prefix`.
9 * The value of `company-dabbrev-ignore-buffers` can also be a function.
10 * `company-files` has been moved to right after `company-capf` in
12 ([#463](https://github.com/company-mode/company-mode/issues/463)).
13 * `company-semantic-insert-arguments`: New option. Like in `company-clang`.
14 * `company-semantic-begin-after-member-access`: New option. Similar to the one
16 * `company-capf` accepts `:company-prefix-length` property value.
17 * New face `company-tooltip-annotation-selection`, used for the annotation in
18 the selected tooltip line.
19 * `company-clang-objc-templatify` has been renamed to
20 `company-template-objc-templatify`.
21 * New user option `company-etags-everywhere`.
22 * `company-yasnippet` supports `yas-key-syntaxes` better. But we use them in the
23 reverse order, preferring the longest key prefix that matches anything. And we
24 only consider trigger key prefixes that are at least as long as the symbol at
25 point, which effectively means skipping the `"w"` element
26 ([#422](https://github.com/company-mode/company-mode/issues/422)).
27 * New user option `company-search-regexp-function`.
28 * Completion is not started automatically when a keyboard macro is being
29 recorded ([#374](https://github.com/company-mode/company-mode/issues/374)).
30 * New command `company-indent-or-complete-common`.
31 * Backend command `doc-buffer` now can also return a cons of buffer and window
33 * Backend command `ignore-case` has been documented.
34 * `company-template-c-like-templatify` does not replace the default argument
35 values with `argN` anymore
36 ([#336](https://github.com/company-mode/company-mode/issues/336)). This
37 affects `company-clang` and all third-party backends that use this function.
38 * Likewise for `company-clang-objc-templatify`.
39 * `company-template-add-field` calling convention has changed.
40 * New user option `company-dabbrev-ignore-invisible`.
41 * `company-ropemacs` was removed. `ropemacs` supports completion via
42 `completion-at-point-functions` starting with version 0.8.
43 * `company-pysmell` was removed.
44 * `company-select-next`, `company-select-previous`,
45 `company-select-next-or-abort`, `company-select-previous-or-abort` and
46 `company-complete-common-or-cycle` accept a numeric argument.
47 * The documentation buffer window can be scrolled with the mouse wheel.
48 * New command `company-diag`. Use it in bug reports.
50 ## 2015-02-02 (0.8.10)
52 * New variable `company-lighter-base`.
53 * Better tracking of the current selection.
54 * Pressing `M-0`...`M-9` works in the search mode.
55 * Pressing `<up>` or `<down>` doesn't quit the search mode.
59 * New commands `company-next-page` and `company-previous-page`, remapping
60 `scroll-up-command` and `scroll-down-command` during completion.
64 * Pressing `M-n` or `M-p` doesn't quit the search mode.
65 * New command `company-complete-common-or-cycle`. No default binding.
66 * `company-search-toggle-filtering` replaced `company-search-kill-others`.
67 * Quitting the search mode resets the filtering.
68 * Pressing `backspace` in the search mode deletes the character at the end of
70 * `company-semantic` displays function arguments as annotations.
71 * New user option, `company-bbdb-modes`.
72 * `company-show-numbers` and `company-complete-number` now use visual numbering
73 of the candidates, taking into account only the ones currently displayed.
74 * `company-complete-number` can be bound to keypad numbers directly, with or
76 * `company-cmake` expands `<LANG>` and `<CONFIG>` placeholders inside variable
81 * `company-clang` and `company-template-c-like-templatify` support templated
82 functions and arguments.
83 * `company-dabbrev` ignores "uninteresting" buffers by default. Depends on the
84 new user option, `company-dabbrev-ignore-buffers`.
85 * `company-files` checks directory's last modification time.
86 * `company-files` supports relative paths and Windows drive letters.
90 * `company-ropemacs` is only used when `ropemacs-mode` is on.
91 * `company-gtags` is enabled in all `prog-mode` derivatives by default.
92 * `company-end-of-buffer-workaround` is not used anymore.
93 * `company-begin-commands` includes some of `cc-mode` commands.
97 * On Emacs 24.4 or newer, tooltip positioning takes line-spacing into account.
98 * New face `company-tooltip-search`, used for the search string in the tooltip.
99 * The default value of `company-dabbrev-minimum-length` is set to 4, independent
100 of the `company-minimum-prefix-length` value.
102 ## 2014-07-26 (0.8.2)
104 * New user option `company-occurrence-weight-function`, allowing to tweak the
105 behavior of the transformer `company-sort-by-occurrence`.
106 * Setting `company-idle-delay` to `t` is deprecated. Use the value 0 instead.
108 ## 2014-07-01 (0.8.1)
110 * `company-require-match` is not in effect when the new input doesn't continue
111 the previous prefix, and that prefix was a match.
112 * The meaning of `company-begin-commands` value t has slightly changed.
113 * New transformer, `company-sort-by-backend-importance`.
114 * When grouped back-ends are used, the back-end of the current candidate is
115 indicated in the mode-line, enclosed in angle brackets.
116 * New user option `company-gtags-insert-arguments`, t by default.
117 * `company-css` knows about CSS3.
118 * `company-gtags` supports `meta` and `annotation`.
119 * User option `company-dabbrev-code-other-buffers` can have a new value: `code`.
120 * New user option `company-tooltip-flip-when-above`.
121 * `company-clang` uses the standard header search paths by default.
122 * `C-h` is bound to `company-show-doc-buffer` (like `f1`).
124 ## 2014-04-19 (0.8.0)
126 * `company-capf` is included in `company-backends` in any supported Emacs
127 version (>= 24.1). `company-elisp` goes before it if Emacs version is < 24.4.
128 * New user option `company-clang-insert-arguments`, by default t.
129 * Default value of `company-idle-delay` lowered to `0.5`.
130 * New user option `company-tooltip-minimum-width`, by default 0.
131 * New function `company-grab-symbol-cons`.
132 * `company-clang` fetches completion candidates asynchronously.
133 * Added support for asynchronous back-ends (experimental).
134 * Support for back-end command `crop` dropped (it was never documented).
135 * Support for Emacs 23 dropped.
136 * New user option `company-abort-manual-when-too-short`.
138 ## 2014-03-25 (0.7.3)
140 * New user option `company-etags-ignore-case`.
142 ## 2014-03-19 (0.7.2)
144 * Support for Emacs 22 officially dropped.
145 * `company-clang` supports `indent-tabs-mode` and multibyte chars before point.
147 ## 2014-03-18 (0.7.1)
149 * Group of back-ends can now contain keyword `:with`, which makes all back-ends
150 after it to be skipped for prefix calculation.
151 * New function `company-version`.
152 * New bundled back-end `company-yasnippet`.
153 * Completion candidates returned from grouped back-ends are tagged to remember
154 which back-end each came from.
155 * New user option `company-tooltip-align-annotations`, off by default.
156 * New bundled back-end `company-bbdb`.
160 * New back-end command, `match`, for non-prefix completion.
161 * New user option `company-continue-commands`. The default value aborts
162 completion on buffer saving commands.
163 * New back-end command, `annotation`, for text displayed inline in the popup
164 that's not a part of completion candidate.
165 * `company-capf`, `company-clang` and `company-eclim` use `annotation`.
166 * `company-preview*` faces inherit from `company-tooltip-selection` and
167 `company-tooltip-common-selection` on light themes.
168 * New user option `company-transformers`.
169 * First transformer, `company-sort-by-occurrence`.
170 * New user options controlling `company-dabbrev` and `company-dabbrev-code`.
172 ## 2014-01-25 (0.6.14)
174 * The tooltip front-end is rendered with scrollbar, controlled by the user
175 option `company-tooltip-offset-display`.
176 * The tooltip front-end is rendered with margins, controlled by the user option
177 `company-tooltip-margin`.
179 ## 2014-01-14 (0.6.13)
181 * Experimental support for non-prefix completion.
182 * Starting with Emacs version 24.4, `company-capf` is included in
183 `company-backends` and replaces `company-elisp`.
184 * `company-capf` supports completion tables that return non-default boundaries.
185 * `company-elisp` is enabled in `inferior-emacs-lisp-mode`.
187 ## 2013-09-28 (0.6.12)
189 * Default value of `company-begin-commands` changed to `(self-insert-command)`.
190 * Futher improvement in `org-indent-mode` compatibility.
192 ## 2013-08-18 (0.6.11)
194 * `company-template-c-like-templatify` removes all text after closing paren, for
195 use in backends that display additional info there.
196 * `company-cmake` is now bundled.
197 * Better `linum` compatibility in Emacs <= 24.2.
198 * `company-global-modes`: New option.
200 ## 2013-05-26 (0.6.10)
202 * Plays nicer with `org-indent-mode`.
203 * Works in horizontally scrolled windows.
205 ## 2013-05-10 (0.6.9)
207 * `company-capf` respects `:exit-function` completion property.
208 * `company-backends`: `prefix` command can return `t` in the cdr.
209 * `company-clang-begin-after-member-access`: New option.
210 * Mouse click outside the tooltip aborts completion.
211 * `company-clang` uses standard input to pass the contents of current buffer to
212 Clang 2.9+, otherwise saves the buffer and passes the path to the file.
213 * `company-clang-auto-save` option has been removed.
214 * Better interaction with `outline-minor-mode`.
215 * `company-dabbrev-code` supports all `prog-mode` derivatives.
217 ## 2013-04-16 (0.6.8)
219 * `company-auto-complete` is disabled by default.
220 * `company-auto-complete-chars` default value includes fewer syntax classes.
221 * In expanded function calls, arguments skipped by the user default to "argN".
222 * `company-eclim` and `company-clang` do not strip argument types from fields.
223 * `company-clang` expands function calls for all three modes now.
224 * `company-clang` supports `c++-mode` by default.
226 ## 2013-04-05 (0.6.7)
228 * Two `company-elisp` tweaks.
230 ## 2013-04-01 (0.6.6)
232 * `company-elisp` doesn't offer completions when typing the name and the
233 arguments of a new function or macro definition, allowing to fall back to
234 other back-ends like `company-dabbrev-code`.
236 ## 2013-03-30 (0.6.5)
238 * Fixed keybindings when running in a terminal.
239 * `company-elisp-show-locals-first`: new customizable variable.
240 * `company-elisp` shows more accurate and comprehensive candidates list.
242 ## 2013-03-26 (0.6.4)
244 * `company-eclim` shows valid completions after an opening paren.
245 * Expanded template does not get removed until the point leaves it. After your
246 input the last argument in a method call expanded by `company-eclim`, you can
247 press `<tab>` once more, to jump after the closing paren. No other bundled
248 back-ends are affected.
250 ## 2013-03-25 (0.6.3)
252 * New tooltip face colors used on themes with light background.
253 * Pseudo-tooltip stays up-to-date when text is inserted after the point.
254 * Fixed `company-require-match` mechanics.
256 ## 2013-03-24 (0.6.2)
258 * `global-company-mode` is now autoloaded.
260 ## 2013-03-23 (0.6.1)
262 * Documented `init` and `post-completion` back-end commands.
263 * `company-eclim` and `company-clang` only expand the template on explicit user
264 action (such as `company-complete-{selection,number,mouse}`).
265 * `company-template` has some breaking changes. When point is at one of the
266 fields, it's displayed at the beginning, not right after it; `<tab>` jumps to
267 the next field, `forward-word` and `subword-forward` remappings are removed;
268 when you jump to the next field, if the current one hasn't been edited, the
269 overlay gets removed but the text remains.
270 * `company-eclim` shows method overloads and expands templates for calls.
271 * `company-clang-objc-templatify` does not insert spaces after colons anymore.
272 * `company-clang` is now only initialized in supported buffers.
273 So, no error messages if you don't have Clang until you open a C file.
274 * `company-clang` recognizes Clang included in recent Xcode.
275 * New commands `company-select-previous-or-abort` and
276 `company-select-next-or-abort`, bound to `<up>` and `<down>`.
280 * Across-the-board bugfixing.
281 * `company-pysmell` is not used by default anymore.
282 * Loading of `nxml`, `semantic`, `pymacs` and `ropemacs` is now deferred.
283 * Candidates from grouped back-ends are merged more conservatively: only
284 back-ends that return the same prefix at point are used.
285 * `company-clang` now shows meta information, too.
286 * Some performance improvements.
287 * Fixed two old tooltip annoyances.
288 * Instead of `overrriding-terminal-local-map`, we're now using
289 `emulation-mode-map-alists` (experimental). This largely means that when the
290 completion keymap is active, other minor modes' keymaps are still used, so,
291 for example, it's not as easy to accidentally circumvent `paredit-mode`
293 * `company-elisp` has seen some improvements.
294 * Added `company-capf`: completion adapter using
295 `completion-at-point-functions`. (Stefan Monnier)
296 * Clang completions now include macros and are case-sensitive.
297 * Switching between tag files now works correctly with `company-etags`.
301 * `company-ropemacs` now provides location and docs. (Fernando H. Silva)
302 * Added `company-with-candidate-inserted` macro.
303 * Added `company-clang` back-end.
304 * Added new mechanism for non-consecutive insertion.
305 (So far only used by clang for ObjC.)
306 * The semantic back-end now shows meta information for local symbols.
307 * Added compatibility for CEDET in Emacs 23.2 and from CVS. (Oleg Andreev)
309 ## 2009-05-07 (0.4.3)
311 * Added `company-other-backend`.
312 * Idle completion no longer interrupts multi-key command input.
313 * Added `company-ropemacs` and `company-pysmell` back-ends.
315 ## 2009-04-25 (0.4.2)
317 * In C modes . and -> now count towards `company-minimum-prefix-length`.
318 * Reverted default front-end back to `company-preview-if-just-one-frontend`.
319 * The pseudo tooltip will no longer be clipped at the right window edge.
320 * Added `company-tooltip-minimum`.
321 * Windows compatibility fixes.
323 ## 2009-04-19 (0.4.1)
325 * Added `global-company-mode`.
326 * Performance enhancements.
327 * Added `company-eclim` back-end.
328 * Added safer workaround for Emacs `posn-col-row` bug.
332 * Automatic completion is now aborted if the prefix gets too short.
333 * Added option `company-dabbrev-time-limit`.
334 * `company-backends` now supports merging back-ends.
335 * Added back-end `company-dabbrev-code` for generic code.
336 * Fixed `company-begin-with`.
338 ## 2009-04-15 (0.3.1)
340 * Added 'stop prefix to prevent dabbrev from completing inside of symbols.
341 * Fixed issues with tabbar-mode and line-spacing.
342 * Performance enhancements.
346 * Added `company-begin-commands` option.
347 * Added abbrev, tempo and Xcode back-ends.
348 * Back-ends are now interactive. You can start them with M-x backend-name.
349 * Added `company-begin-with` for starting company from elisp-code.
351 * Added `company-require-match` and `company-auto-complete` options.
353 ## 2009-04-05 (0.2.1)
355 * Improved Emacs Lisp back-end behavior for local variables.
356 * Added `company-elisp-detect-function-context` option.
357 * The mouse can now be used for selection.
361 * Added `company-show-location`.
362 * Added etags back-end.
363 * Added work-around for end-of-buffer bug.
364 * Added `company-filter-candidates`.
365 * More local Lisp variables are now included in the candidates.
367 ## 2009-03-21 (0.1.5)
369 * Fixed elisp documentation buffer always showing the same doc.
370 * Added `company-echo-strip-common-frontend`.
371 * Added `company-show-numbers` option and M-0 ... M-9 default bindings.
372 * Don't hide the echo message if it isn't shown.