chore: prepare for 8.0 release

Note that this led me to document `commandt.setup.height`, which in turn
led me to add validation for the value.

Author: wincent

CONTRIBUTING.md

@@ -10,12 +10,13 @@ For more details, see the "command-t-development" section in [the documentation]
 2. Edit metadata in `lua/wincent/commandt/version.lua` to reflect new `$VERSION`.
 3. Commit using `git commit -p -m "chore: prepare for $VERSION release"`.
 4. Create tag with `git tag -s $VERSION -m "$VERSION release"`.
-5. Check release readiness with `make check`.
-6. Produce ZIP archive with `bin/create-archive`.
-7. Upload new release to [vim.org](http://www.vim.org/scripts/script.php?script_id=3025).
-8. Push with `git push --follow-tags`.
-9. Update [release notes on GitHub](https://github.com/wincent/command-t/releases).
-10. Start a new entry under "command-t-history" in `doc/command-t.txt` for subsequent development.
+5. Fast-forward the `release` branch to match the tag.
+6. Check release readiness with `make check`.
+7. Produce ZIP archive with `bin/create-archive`.
+8. Upload new release to [vim.org](http://www.vim.org/scripts/script.php?script_id=3025).
+9. Push with `git push --follow-tags`.
+10. Update [release notes on GitHub](https://github.com/wincent/command-t/releases).
+11. Start a new entry under "command-t-history" in `doc/command-t.txt` for subsequent development.
 
 # Reproducing bugs
 

doc/command-t.txt

@@ -443,6 +443,7 @@ See below for description of specific properties that can be used in the table
 passed to |commandt.setup()|:
 
 - |commandt.setup.always_show_dot_files|
+- |commandt.setup.height|
 - |commandt.setup.ignore_case|
 - |commandt.setup.match_listing.border|
 - |commandt.setup.match_listing.icons|
@@ -485,6 +486,13 @@ whenever they match the search query.
 
 See also |commandt.setup.never_show_dot_files|.
 
+                                                        *commandt.setup.height*
+                                                         number (default: 15)
+
+Sets the desired height for the Command-T match listing. Must be an integer
+greater than 0. Set a very large value (eg. 10000) if you want Command-T to
+use all available space.
+
                                                    *commandt.setup.ignore_case*
                                           boolean or function (default: none)
 
@@ -812,26 +820,15 @@ the project issue tracker etc).
 As many users choose to track Command-T using Pathogen or similar, which often
 means running a version later than the last official release, the intention is
 that the "main" branch should be kept in a stable and reliable state as much
-as possible.
+as possible. For maximum safety, follow the "release" branch instead, which is
+fast-forwarded to point at the latest tagged version on each release.
 
 Riskier changes are first cooked on the "next" branch for a period before
 being merged into "main". You can track this branch if you're feeling wild
 and experimental, but note that the "next" branch may periodically be rewound
 (force-updated) to keep it in sync with the "main" branch after each official
 release.
 
-The release process is:
-
-1. Update the version in `lua/wincent/commandt/version.lua`.
-2. Update |command-t-history|.
-3. Commit with a message like "chore: prepare for 6.0.0 release".
-4. Create a signed tag with `git tag -s -m '6.0.0 release` (or similar).
-5. Publish with `git push origin --follow-tags` (or similar).
-6. Create GitHub release and publish release notes.
-7. Create archive (eg. `git archive -o command-t-6.0.0-b.1.zip HEAD -- .` or
-   similar).
-8. Upload to vim.org (http://www.vim.org/scripts/script.php?script_id=3025).
-
 
 WEBSITE                                                     *command-t-website*
 
@@ -904,9 +901,16 @@ POSSIBILITY OF SUCH DAMAGE.
 
 HISTORY                                                     *command-t-history*
 
-main (not yet released) ~
+8.0 (26 June 2025) ~
 
-- ...
+- Removed the Ruby implementation. Switch to the `7-x-release` branch if you
+  still need it.
+- Fixed possible missing results when |commandt.setup.height| was set to a
+  large value.
+- Improve performance when passing very large values for
+  |commandt.setup.height|.
+- Fixed a race that could cause some results to be omitted.
+- Improve performance of scoring code by about 4% (wall-time).
 
 7.0 (23 June 2025) ~
 

lua/wincent/commandt/init.lua

@@ -168,7 +168,15 @@ local options_spec = {
         return errors
       end,
     },
-    height = { kind = 'number' },
+    height = {
+      kind = 'number',
+      meta = function(context)
+        if not is_integer(context.height) or context.height < 1 then
+          context.height = 15
+          return { '`height` must be a positive integer' }
+        end
+      end,
+    },
     ignore_case = {
       kind = {
         one_of = {

lua/wincent/commandt/version.lua

@@ -2,9 +2,9 @@
 -- SPDX-License-Identifier: BSD-2-Clause
 
 return {
-  major = 7,
+  major = 8,
   minor = 0,
   patch = 0,
   prerelease = '',
-  version = '7.0',
+  version = '8.0',
 }