These two config settings are confusingly similar:

• show_completions_on_input
• show_inline_completions

The answers to the following questions should be obvious from reading the documentation...

• How do these two settings interact?
• Which is "dominant"?

... but they are not.

The core problem stems from their confusing names. Both have show_ and have to do with completions. So what is the difference between on_input and inline? Please clarify.

Even better, please rename one or both, since that is probably the only way to settle this confusion once and for all. If someone has to go to the documentation page just to get unconfused, that is a hint that current design choices are not working well enough.

Ideas to consider:

• Rename show_inline_completions to auto_show_completion_ghost_text?
• Rename show_completions_on_input to auto_trigger_completion_menu?

Current Documentation

From zed/docs/src/configuring-zed.md:

Show Inline Completions

• Description: Whether to show inline completions as you type or manually by triggering editor::ShowInlineCompletion.
• Setting: show_inline_completions
• Default: true
• Options: boolean values

Show Completions On Input

• Description: Whether or not to show completions as you type.
• Setting: show_completions_on_input
• Default: true
• Options: boolean values

Current Source Code

crates/language/src/language_settings.rs#L112

/// Controls whether inline completions
/// are shown immediately (true)
/// or manually by triggering
/// `editor::ShowInlineCompletion` (false).
pub show_inline_completions: bool,

crates/language/src/language_settings.rs#L141

/// Whether to pop the completions menu
/// while typing in an editor without
/// explicitly requesting it.
pub show_completions_on_input: bool,