sites

public wiki contents of suckless.org
git clone git://git.suckless.org/sites
Log | Files | 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 ![Preview](usage.gif)
     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)