index.md - sites - public wiki contents of suckless.org
(HTM) git clone git://git.suckless.org/sites
(DIR) Log
(DIR) Files
(DIR) Refs
---
index.md (3103B)
---
1 autocomplete
2 ============
3 urxvt's [autocomplete-ALL-the-things](https://github.com/Vifon/autocomplete-ALL-the-things) extension's port for st
4
5 Description
6 -----------
7
8 Completes the currently typed word using the other words visible in the st window.
9
10 For example the terminal looks like this:
11
12 
13
14 It was strongly inspired by `dabbrev` feature in GNU Emacs and later by
15 [skeleton-complete](https://github.com/baohaojun/skeleton-complete) by Bao
16 Haojun.
17
18 Basic usage
19 -----------
20
21 Just press the key bound (in the example above: Alt-Ctrl-slash) to
22 complete the word at point. Subsequent uses cycle through other
23 possible completions.
24
25 Advanced usage
26 --------------
27
28 For more advanced completions use `ACMPL_FUZZY_WORD` and `ACMPL_FUZZY`. It's
29 behavior is inspired by [skeleton-complete](https://github.com/baohaojun/skeleton-complete), please see [its readme](http://baohaojun.github.io/skeleton-complete.html) for a more detailed explanation.
30
31 Available commands
32 -------------------
33
34 * `ACMPL_WORD` -- classical prefix-based completion for words
35 * `ACMPL_WWORD` -- completion for WORDS (in the Vim meaning)
36 * `ACMPL_FUZZY_WORD` -- fuzzy completion for words
37 * `ACMPL_FUZZY_WWORD` -- fuzzy completion for WORDS
38 * `ACMPL_FUZZY` -- fuzzy completion for arbitrary strings
39 * `ACMPL_SUFFIX` -- fuzzy completion for suffixes, disrespecting
40 prefixes of both completion and given strings
41 * `ACMPL_SURROUND` -- fuzzy completion for surrounded by quotes or
42 braces strings, excluding surrounding
43 * `ACMPL_UNDO` -- undo the completion (must be used right after a completion)
44 * `ACMPL_DEACTIVATE` -- exit the autocompletion mode
45
46 Acknowledgments
47 ---------------
48
49 Thanks to Stanislav Seletskiy for various contributions.
50
51 Thanks to Bao Haojun for the great idea of [skeleton-complete](https://github.com/baohaojun/skeleton-complete).
52
53 Copyright
54 ---------
55
56 Copyright (C) 2012-2021 Wojciech Siewierski, Gaspar Vardanyan
57
58 This program is free software: you can redistribute it and/or modify
59 it under the terms of the GNU General Public License as published by
60 the Free Software Foundation, either version 3 of the License, or
61 (at your option) any later version.
62
63 This program is distributed in the hope that it will be useful,
64 but WITHOUT ANY WARRANTY; without even the implied warranty of
65 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
66 GNU General Public License for more details.
67
68 You should have received a copy of the GNU General Public License
69 along with this program. If not, see <http://www.gnu.org/licenses/>.
70
71 Download
72 --------
73 * [st-0.8.5-autocomplete-20220327-230120.diff](st-0.8.5-autocomplete-20220327-230120.diff)
74
75 The use of `tmpnam' is dangerous, better use `mkstemp'
76 * [st-autocomplete-20240703-6508693.diff](st-autocomplete-20240703-6508693.diff)
77
78 Contribution
79 ------------
80 You can create issues and do pull requests on [this gitlab repo](https://gitlab.com/GasparVardanyan/st-autocomplete).
81
82 Authors
83 -------
84 * [Wojciech Siewierski](https://github.com/vifon)
85 * [Gaspar Vardanyan](https://gitlab.com/GasparVardanyan)
86 * [El Bachir](https://github.com/elbachir-one)