From a606bd10c79ec5989c76c49cc6f736e88b63f0da Mon Sep 17 00:00:00 2001 From: Tsakiris Tryfon Date: Wed, 28 Dec 2022 15:49:57 +0200 Subject: docs: fix typos/wording (#2283) --- lua/telescope/make_entry.lua | 16 ++++++++-------- lua/telescope/pickers/entry_display.lua | 22 +++++++++++----------- 2 files changed, 19 insertions(+), 19 deletions(-) (limited to 'lua') 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 `` action as --- open this file (optional) --- - bufnr number: will be interpreted by the default `` action as open @@ -30,7 +30,7 @@ --- - col number: col value which will be interpreted by the default `` --- 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: --- --- local displayer = entry_display.create { --- separator = " ", @@ -30,10 +30,10 @@ --- --- --- 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 ]] -- cgit v1.2.3