update packages

This commit is contained in:
2025-03-11 21:14:26 +01:00
parent 45d49daef0
commit 14dcaaddde
440 changed files with 13229 additions and 8718 deletions

View File

@@ -238,7 +238,8 @@ so we can't just use the preceding variable instead.")
(defun company-capf--post-completion (arg)
(let* ((res company-capf--current-completion-data)
(exit-function (plist-get (nthcdr 4 res) :exit-function))
(table (nth 3 res)))
(table (nth 3 res))
(prefix (nth 0 (company-capf--prefix))))
(if exit-function
;; Follow the example of `completion--done'.
(funcall exit-function arg
@@ -247,8 +248,8 @@ so we can't just use the preceding variable instead.")
;; particular candidate explicitly (it only checks whether
;; further completions exist). Whereas company user can press
;; RET (or use implicit completion with company-tng).
(if (= (car (completion-boundaries arg table nil ""))
(length arg))
(if (= (car (completion-boundaries prefix table nil ""))
(length prefix))
'exact
'finished)))))

View File

@@ -1,6 +1,6 @@
(define-package "company" "20250223.352" "Modular text completion framework"
(define-package "company" "20250228.258" "Modular text completion framework"
'((emacs "26.1"))
:commit "5bb6f6d3d44ed919378e6968a06feed442165545" :maintainers
:commit "8d599ebc8a9aca27c0a6157aeb31c5b7f05ed0a3" :maintainers
'(("Dmitry Gutov" . "dmitry@gutov.dev"))
:maintainer
'("Dmitry Gutov" . "dmitry@gutov.dev")

View File

@@ -1,4 +1,4 @@
This is company.info, produced by makeinfo version 6.8 from
This is company.info, produced by makeinfo version 7.1.1 from
company.texi.
This user manual is for Company version 1.0.3-snapshot
@@ -47,7 +47,7 @@ Copyright © 2021-2024 Free Software Foundation, Inc.
* Troubleshooting:: When Something Goes Wrong
* Index::
The Detailed Node Listing
-- The Detailed Node Listing --
Overview
@@ -122,8 +122,8 @@ configurable through the user option completion-styles, which see.
For illustrations on how Company visualizes the matches, *note
Frontends::.
The packages name Company is based on the combination of the two
words: Complete and Anything. These words reflect the packages
The package's name Company is based on the combination of the two
words: Complete and Anything. These words reflect the package's
commitment to handling completion candidates and its extensible nature
allowing it to cover a wide range of usage scenarios.
@@ -154,10 +154,10 @@ commands for the user to operate with. For more details, *note
Customization:: and *note Commands::.
Also, Company is bundled with an alternative workflow configuration
“company-tng” defining company-tng-frontend, company-tng-mode, and
company-tng-map that allows performing completion with just <TAB>.
To enable this configuration, add the following line to the Emacs
initialization file (*note (emacs)Init File::):
“company-tng” -- defining company-tng-frontend, company-tng-mode,
and company-tng-map -- that allows performing completion with just
<TAB>. To enable this configuration, add the following line to the
Emacs initialization file (*note (emacs)Init File::):
(add-hook 'after-init-hook 'company-tng-mode)
@@ -216,7 +216,7 @@ File: company.info, Node: Usage Basics, Next: Commands, Prev: Initial Setup,
2.3 Usage Basics
================
By default having _company-mode_ enabled (*note Initial Setup::) a
By default -- having _company-mode_ enabled (*note Initial Setup::) -- a
tooltip with completion candidates is shown when the user types a few
characters.
@@ -228,7 +228,7 @@ respectively key bindings C-n and C-p, then do one of the following:
• Hit <RET> to choose a selected candidate for completion.
• Hit <TAB> to expand the “common part” of all completions. Exactly
what that means, can vary by backend. In the simplest case its
what that means, can vary by backend. In the simplest case it's
the longest string that all completion start with, but when a
backend returns _non-prefix matches_, it can implement the same
kind of expansion logic for the input string.
@@ -261,8 +261,8 @@ commands of the out-of-the-box Company.
TAB
<tab>
Insert the _common part_ of all completion candidates or if no
_common part_ is present select the next candidate
Insert the _common part_ of all completion candidates or -- if no
_common part_ is present -- select the next candidate
(company-complete-common-or-cycle). In the latter case,
wraparound is implicitly enabled (*note
company-selection-wrap-around::).
@@ -360,7 +360,7 @@ core settings that influence its overall behavior.
than the default value of 3.
-- User Option: company-idle-delay
This is the second of the options that configure Companys
This is the second of the options that configure Company's
auto-start behavior (together with
company-minimum-prefix-length). The value of this option defines
how fast Company is going to react to the typed input, such that
@@ -390,7 +390,7 @@ core settings that influence its overall behavior.
(setq company-global-modes '(not erc-mode message-mode eshell-mode))
-- User Option: company-selection-wrap-around
Enable this option to loop (cycle) the candidates selection: after
Enable this option to loop (cycle) the candidates' selection: after
selecting the last candidate on the list, a command to select the
next candidate does so with the first candidate. By default, this
option is disabled, which means the selection of the next candidate
@@ -398,7 +398,7 @@ core settings that influence its overall behavior.
influenced by this option similarly.
-- User Option: company-require-match
To allow typing in characters that dont match the candidates, set
To allow typing in characters that don't match the candidates, set
the value of this option to nil. For an opposite behavior (that
is, to disallow non-matching input), set it to t. By default,
Company is configured to require a matching input only if the user
@@ -484,7 +484,7 @@ listed below.
-- Function: company-pseudo-tooltip-unless-just-one-frontend
This is one of the default frontends. It starts displaying a
tooltip only if more than one completion candidate is available,
which nicely combines and it is done so by default with
which nicely combines -- and it is done so by default -- with
company-preview-if-just-one-frontend, *note Preview Frontends::.
-- Function: company-pseudo-tooltip-frontend
@@ -535,7 +535,7 @@ user options.
[image src="./images/small/tooltip-annotations.png"]
-- User Option: company-tooltip-annotation-padding
Adds left padding to the candidates annotations. It is disabled
Adds left padding to the candidates' annotations. It is disabled
by default. If company-tooltip-align-annotations is enabled,
company-tooltip-annotation-padding defines the minimum spacing
between a candidate and annotation, with the default value of 1.
@@ -545,7 +545,7 @@ user options.
-- User Option: company-tooltip-limit
Controls the maximum number of the candidates shown simultaneously
in the tooltip (the default value is 10). When the number of the
available candidates is larger than this options value, Company
available candidates is larger than this option's value, Company
paginates the results.
(setq company-tooltip-limit 4)
@@ -622,7 +622,7 @@ user options.
Candidates Icons
----------------
An “icon” is an image or a text that represents a candidates kind; it
An “icon” is an image or a text that represents a candidate's kind; it
is displayed in front of a candidate. The term “kind” here stands for a
high-level category a candidate fits into. (Such as array,
function, file, string, color, etc. For an extended list of the
@@ -631,7 +631,7 @@ the variable company-vscode-icons-mapping.)
-- User Option: company-format-margin-function
Allows setting a function to format the left margin of a tooltip
inner area; namely, to output candidates _icons_. The predefined
inner area; namely, to output candidate's _icons_. The predefined
formatting functions are listed below. The user may also set this
option to a custom function. To disable left margin formatting,
set the value of the option to nil (this way control over the
@@ -664,7 +664,7 @@ The following user options influence appearance of the _text_ and _dot_
_icons_.
-- User Option: company-text-icons-mapping
Lists candidates _kinds_ with their corresponding _icons_
Lists candidates' _kinds_ with their corresponding _icons_
configurations.
-- User Option: company-text-face-extra-attributes
@@ -676,7 +676,7 @@ _icons_.
[image src="./images/small/tooltip-icon-face.png"]
-- User Option: company-text-icons-add-background
If this option is enabled, when an _icon_ doesnt have a background
If this option is enabled, when an _icon_ doesn't have a background
configured by company-text-icons-mapping, then a generated
background is applied.
@@ -696,8 +696,8 @@ Faces
Out-of-the-box Company defines and configures distinguished faces (*note
(emacs)Faces::) for light and dark themes. Moreover, some of the
built-in and third-party themes fine-tune Company to fit their palettes.
That is why theres often no real need to make such adjustments on the
users side. However, this chapter presents some hints on where to
That is why there's often no real need to make such adjustments on the
user's side. However, this chapter presents some hints on where to
start customizing Company interface.
Namely, the look of a tooltip is controlled by the company-tooltip*
@@ -770,7 +770,7 @@ File: company.info, Node: Echo Frontends, Next: Candidates Search, Prev: Prev
4.3 Echo Frontends
==================
The frontends listed in this section display information in the Emacss
The frontends listed in this section display information in the Emacs's
echo area, *note (emacs)Echo Area::.
-- Function: company-echo-metadata-frontend
@@ -781,7 +781,7 @@ echo area, *note (emacs)Echo Area::.
[image src="./images/small/echo-meta.png"]
The last pair of the built-in frontends isnt that commonly used and not
The last pair of the built-in frontends isn't that commonly used and not
as full-featured as the previously reviewed _tooltip-_ and _preview-_
frontends, but still, feel free to play with them and have some fun!
@@ -814,7 +814,7 @@ File: company.info, Node: Candidates Search, Next: Filter Candidates, Prev: E
By default, when _company-mode_ is in action, a key binding C-s starts
looking for matches to additionally typed characters among the displayed
candidates. When a search is initiated, an indicator
Search: CHARACTERS is shown in the Emacss mode line.
Search: CHARACTERS is shown in the Emacs's mode line.
To quit the search mode, hit C-g.
@@ -1016,7 +1016,7 @@ roughly outlined groups of the backends.
Some of the backends expose user options for customization; a few of
these options are introduced below. For those who would like to fetch
the full list of a backends user options, we suggest doing one of the
the full list of a backend's user options, we suggest doing one of the
following:
• Execute command M-x customize-group <RET> <backend-name>.
@@ -1041,7 +1041,7 @@ File: company.info, Node: Code Completion, Next: Text Completion, Up: Package
---------------------
-- Function: company-capf
The current trend in the Emacss world is to delegate completion
The current trend in the Emacs's world is to delegate completion
logic to the hook completion-at-point-functions (CAPF) assigned
to by the major or minor modes. It supports a common subset of
features which is well-supported across different completion UIs.
@@ -1063,8 +1063,8 @@ File: company.info, Node: Code Completion, Next: Text Completion, Up: Package
-- User Option: company-capf-disabled-functions
List of completion functions which should be ignored by this
backend. By default it contains the functions that duplicate the
built-in backends but dont support the corresponding configuration
options and/or alter the intended priority of the default backends
built-in backends but don't support the corresponding configuration
options and/or alter the intended priority of the default backends'
configuration.
-- Function: company-dabbrev-code
@@ -1113,7 +1113,7 @@ File: company.info, Node: Code Completion, Next: Text Completion, Up: Package
interface of the program clang, but without any advanced caching
across calls, or automatic detection of the project structure.
Which makes it more suitable for small to medium projects,
especially if youre willing to customize
especially if you're willing to customize
company-clang-arguments. Otherwise we recommend using one of the
LSP clients available for Emacs, together with the backend
company-capf.
@@ -1137,7 +1137,7 @@ File: company.info, Node: Code Completion, Next: Text Completion, Up: Package
program _etags_, *note (emacs)Tags Tables::.
-- User Option: company-etags-ignore-case
Non-nil to ignore case in this backends completions.
Non-nil to ignore case in this backend's completions.
-- User Option: company-etags-everywhere
Non-nil to offer completions in comments and strings. It can also
@@ -1159,7 +1159,7 @@ File: company.info, Node: Text Completion, Next: File Name Completion, Prev:
This backend works similarly to the built-in Emacs package
_dabbrev_, searching for completion candidates inside the contents
of the open buffer(s). It is one of the often used backends, and
it has several interesting options for configuration. Lets review
it has several interesting options for configuration. Let's review
a few of them.
-- User Option: company-dabbrev-minimum-length
@@ -1202,7 +1202,7 @@ File: company.info, Node: Text Completion, Next: File Name Completion, Prev:
nil, Enjoy is suggested as a completion candidate for the
typed Enj letters, but not for enj. When the option is
set to t, Enjoy is suggested as a candidate for both Enj
and enj input; note that enj prefix is overwritten by
and enj input; note that enj prefix is "overwritten" by
completing with the Enjoy candidate. The third, default,
type of behavior solves this issue, keeping the case of the
typed prefix (and still collecting candidates
@@ -1221,7 +1221,7 @@ File: company.info, Node: Text Completion, Next: File Name Completion, Prev:
being suggested. When the option is set to t, the
down-cased candidate enjoy is suggested. By default, this
option is set to case-replace, meaning taking a value of the
Emacss variable case-replace (t is the current default).
Emacs's variable case-replace (t is the current default).
-- Function: company-ispell
@@ -1231,7 +1231,7 @@ File: company.info, Node: Text Completion, Next: File Name Completion, Prev:
_Ispell_ uses only one dictionary at a time (combining several
dictionaries into one file is an accepted practice). By default,
_company-ispell_ suggests candidates from a dictionary specified by
the Emacss setting ispell-complete-word-dict.
the Emacs's setting ispell-complete-word-dict.
-- User Option: company-ispell-dictionary
Optionally, set a file path for _company-ispell_ to use
@@ -1252,7 +1252,7 @@ File: company.info, Node: File Name Completion, Next: Template Expansion, Pre
-- User Option: company-files-exclusions
It may be desirable to exclude directories or files from the
list of suggested completion candidates. For example,
someones setup might look this way:
someone's setup might look this way:
(setq company-files-exclusions '(".git/" ".DS_Store"))
@@ -1378,7 +1378,7 @@ Based on the value of the Used backend in the output of the command
caused by a function listed there. To identify to which package it
belongs, type M-x find-function <RET> <function-name> <RET>.
If the aforementioned steps didnt help to find the cause of the issue,
If the aforementioned steps didn't help to find the cause of the issue,
then file a bug report to
the Company Issue Tracker (https://github.com/company-mode/company-mode/issues),
attaching the following information:
@@ -1775,45 +1775,45 @@ Concept Index

Tag Table:
Node: Top573
Node: Top575
Node: Overview2002
Node: Terminology2410
Node: Structure3717
Node: Getting Started5208
Node: Installation5486
Node: Initial Setup5869
Node: Usage Basics6717
Node: Commands7695
Ref: Commands-Footnote-110093
Node: Customization10260
Node: Customization Interface10732
Node: Configuration File11265
Ref: company-selection-wrap-around13579
Node: Frontends16072
Node: Tooltip Frontends17041
Ref: Tooltip Frontends-Footnote-127755
Node: Preview Frontends27992
Ref: Preview Frontends-Footnote-129250
Node: Echo Frontends29377
Node: Candidates Search30910
Node: Filter Candidates32244
Node: Quick Access a Candidate33024
Node: Backends34642
Node: Backends Usage Basics35672
Ref: Backends Usage Basics-Footnote-137104
Node: Grouped Backends37188
Node: Package Backends38699
Node: Code Completion39628
Node: Text Completion45155
Node: File Name Completion49589
Node: Template Expansion51137
Node: Candidates Post-Processing51856
Node: Troubleshooting54433
Node: Index56106
Node: Key Index56269
Node: Variable Index57768
Node: Function Index62621
Node: Concept Index67321
Node: Structure3713
Node: Getting Started5203
Node: Installation5481
Node: Initial Setup5864
Node: Usage Basics6712
Node: Commands7686
Ref: Commands-Footnote-110082
Node: Customization10249
Node: Customization Interface10721
Node: Configuration File11254
Ref: company-selection-wrap-around13566
Node: Frontends16055
Node: Tooltip Frontends17024
Ref: Tooltip Frontends-Footnote-127720
Node: Preview Frontends27957
Ref: Preview Frontends-Footnote-129215
Node: Echo Frontends29342
Node: Candidates Search30871
Node: Filter Candidates32203
Node: Quick Access a Candidate32983
Node: Backends34601
Node: Backends Usage Basics35631
Ref: Backends Usage Basics-Footnote-137063
Node: Grouped Backends37147
Node: Package Backends38658
Node: Code Completion39585
Node: Text Completion45102
Node: File Name Completion49526
Node: Template Expansion51072
Node: Candidates Post-Processing51791
Node: Troubleshooting54368
Node: Index56039
Node: Key Index56202
Node: Variable Index57701
Node: Function Index62554
Node: Concept Index67254

End Tag Table