diff options
| author | Tsakiris Tryfon <tr.tsakiris@gmail.com> | 2022-12-28 15:49:57 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2022-12-28 14:49:57 +0100 |
| commit | a606bd10c79ec5989c76c49cc6f736e88b63f0da (patch) | |
| tree | 1a7cb5aabf8453140f52d381a77699d311405833 /lua | |
| parent | 01d92285ef4402b188fa583d57f5d1a18c889d22 (diff) | |
docs: fix typos/wording (#2283)
Diffstat (limited to 'lua')
| -rw-r--r-- | lua/telescope/make_entry.lua | 16 | ||||
| -rw-r--r-- | lua/telescope/pickers/entry_display.lua | 22 |
2 files changed, 19 insertions, 19 deletions
diff --git a/lua/telescope/make_entry.lua b/lua/telescope/make_entry.lua index 2532997..6b096da 100644 --- a/lua/telescope/make_entry.lua +++ b/lua/telescope/make_entry.lua @@ -4,23 +4,23 @@ --- --- Each picker has a finder made up of two parts, the results which are the --- data to be displayed, and the entry_maker. These entry_makers are functions ---- returned from make_entry functions. These will be referrd to as +--- returned from make_entry functions. These will be referred to as --- entry_makers in the following documentation. --- ---- Every entry maker returns a function which accepts the data to be used for +--- Every entry maker returns a function that accepts the data to be used for --- an entry. This function will return an entry table (or nil, meaning skip ---- this entry) which contains of the - following important keys: +--- this entry) which contains the following important keys: --- - value any: value key can be anything but still required --- - valid bool: is an optional key because it defaults to true but if the key ---- is set to false it will not be displayed by the picker. (optional) +--- is set to false it will not be displayed by the picker (optional) --- - ordinal string: is the text that is used for filtering (required) --- - display string|function: is either a string of the text that is being --- displayed or a function receiving the entry at a later stage, when the entry ---- is actually being displayed. A function can be useful here if complex ---- calculation have to be done. `make_entry` can also return a second value +--- is actually being displayed. A function can be useful here if a complex +--- calculation has to be done. `make_entry` can also return a second value --- a highlight array which will then apply to the line. Highlight entry in --- this array has the following signature `{ { start_col, end_col }, hl_group }` ---- (required). +--- (required) --- - filename string: will be interpreted by the default `<cr>` action as --- open this file (optional) --- - bufnr number: will be interpreted by the default `<cr>` action as open @@ -30,7 +30,7 @@ --- - col number: col value which will be interpreted by the default `<cr>` --- action as a jump to this column (optional) --- ---- More information on easier displaying, see |telescope.pickers.entry_display| +--- For more information on easier displaying, see |telescope.pickers.entry_display| --- --- TODO: Document something we call `entry_index` ---@brief ]] diff --git a/lua/telescope/pickers/entry_display.lua b/lua/telescope/pickers/entry_display.lua index 6e520f4..864e2b3 100644 --- a/lua/telescope/pickers/entry_display.lua +++ b/lua/telescope/pickers/entry_display.lua @@ -14,9 +14,9 @@ --- The create function will use the column widths passed to it in --- configaration.items. Each item in that table is the number of characters in --- the column. It's also possible for the final column to not have a fixed ---- width, this will be shown in the configuartion as 'remaining = true'. +--- width, this will be shown in the configuration as 'remaining = true'. --- ---- An example of this configuration is shown for the buffers picker +--- An example of this configuration is shown for the buffers picker: --- <code> --- local displayer = entry_display.create { --- separator = " ", @@ -30,10 +30,10 @@ --- </code> --- --- This shows 4 columns, the first is defined in the opts as the width we'll ---- use when display_string the number of the buffer. The second has a fixed ---- width of 4 and the 3rd column's widht will be decided by the width of the ---- icons we use. The fourth column will use the remaining space. Finally we ---- have also defined the seperator between each column will be the space " ". +--- use when display_string is the number of the buffer. The second has a fixed +--- width of 4 and the third column's width will be decided by the width of the +--- icons we use. The fourth column will use the remaining space. Finally, we +--- have also defined the separator between each column will be the space " ". --- --- An example of how the display reference will be used is shown, again for --- the buffers picker: @@ -49,12 +49,12 @@ --- There are two types of values each column can have. Either a simple String --- or a table containing the String as well as the hl_group. --- ---- The displayer can return values, string and an optional highlights. ---- String is all the text to be displayed for this entry as a single string. If ---- parts of the string are to be highlighted they will be described in the ---- highlights table. +--- The displayer can return values, string and an optional highlights. The string +--- is all the text to be displayed for this entry as a single string. If parts of +--- the string are to be highlighted they will be described in the highlights +--- table. --- ---- For better understanding of how create() and displayer are used it's best to look +--- For a better understanding of how create() and displayer are used it's best to look --- at the code in make_entry.lua. ---@brief ]] |
