search

scalacenter / bloop

Bloop is a build server and CLI tool to compile, test and run Scala fast from any editor or build tool.
https://scalacenter.github.io/bloop/
Apache License 2.0
907 stars 202 forks source link

Autocompletion instructions don't explain how to get autocomplete scripts #1551

Open shonfeder opened 3 years ago

shonfeder commented 3 years ago

I've run through the steps for installing bloop, but the instructions for command completions seem to be missing any info explaining how to actually get the scripts downloaded or initialized in ~/.bloop.

Currently, on https://scalacenter.github.io/bloop/setup#command-line-completions, it says:

Command-Line Completions

Bloop supports command-line completions in bash, zsh and fish. The use of command-line autocompletions is recommended as it significantly improves the user experience. The installation of autocompletions via curl requires you to configure the completions manually.

    Note that the following instructions assume that the bloop installation directory is the default $HOME/.bloop.

And then gives instructions for how to source the relevant rc files. But this .bloop directory has not been created automatically for me, and I've not been able to find any instructions explaining where the completions should be curled from etc.

This is my first issue on this repo, so I'd like to also note that finding bloop has been a life saver: It's reduced the pain of working on our codebase by at least %70. Many thanks for for your work!

Arthurm1 commented 3 years ago

I seem to remember something about these not being included in every release or not in every installation method.

For bash you can create a blank file ~/.bloop/bash/bloop and copy the contents of bash-completions into it. Then add to your ~/.bash_profile as it says. The other completions seem to be in that same repo dir but I haven't tried them

shonfeder commented 3 years ago

Thank you for the tip! This will help me, and likely will help others until the solution is documented :)