zsh completion: show arg help in completion #910

New issue

Closed

opened 2025-07-08 20:05:38 +00:00 by jade · 2 comments

jade commented 2025-07-08 20:05:38 +00:00

Owner

Copy link

We have the data to do this, we just don't do this at present, so e.g. nix path-info -<tab> will not tell you the meaning of the single character options as you would hope it might.

We have the data to do this, we just don't do this at present, so e.g. `nix path-info -<tab>` will not tell you the meaning of the single character options as you would hope it might.

jade added the

E/help wanted

ux

Area/cli

labels 2025-07-08 20:05:38 +00:00

jade commented 2025-07-08 20:06:31 +00:00

Author

Owner

Copy link

Compare:

Compare:  

image.png

52 KiB

image.png

20 KiB

lix-bot commented 2025-07-10 23:36:31 +00:00

Member

Copy link

This issue was mentioned on Gerrit on the following CLs:

• commit message in cl/3632 ("completions: Show description in zsh completions")

<!-- GERRIT_LINKBOT: {"cls": [{"backlink": "https://gerrit.lix.systems/c/lix/+/3632", "number": 3632, "kind": "commit message"}], "cl_meta": {"3632": {"change_title": "completions: Show description in zsh completions"}}} --> This issue was mentioned on Gerrit on the following CLs: * commit message in [cl/3632](https://gerrit.lix.systems/c/lix/+/3632) ("completions: Show description in zsh completions")

lix-project referenced this issue from a commit 2025-07-11 03:37:29 +00:00

completions: Show description in zsh completions

lix-project closed this issue 2025-07-11 03:37:29 +00:00

Sign in to join this conversation.

No Branch/Tag specified

Branches Tags

main

release-2.93

release-2.94

ci-config

sb/pennae/ci-config

release-2.91

release-2.92

sb/raito/darwin-kqueue-disablement

sb/raito/hydra-merge

sb/raito/phantom-referrers-gc

repl-overlay-example

reuse-compliance

release-2.90

sb/pennae/io-rewrite

git-series/activity-cleanup

sb/tom-hubrecht/primops.cc-v2

sb/bacchanalia/cache-strlen%topic=substr-perf

sb/qyriad/beta-1

sb/qyriad/2.90-beta.0

sb/rbt/test-branch

sb/rbt/justfile

sb/rbt/repl-overlays

sb/qyriad/maint-meson

sb/qyriad/maint/meson

sb/puck/meson-c-api

sb/jade/burn-it-all

dependabot/github_actions/zeebe-io/backport-action-2.4.1

dependabot/github_actions/cachix/install-nix-action-25

dependabot/github_actions/actions/labeler-5

dependabot/github_actions/cachix/cachix-action-14

2.94.0

2.93.3

2.92.3

2.93.2

2.91.3

2.92.2

2.91.2

2.93.1

2.93.0

2.92.0

2.91.1

2.91.0

2.90.0

2.90.0-rc1

2.90-beta.1

2.90-beta.0

Labels

Clear labels   

Affects/CppNix

Probably affects CppNix. This is a best-effort tag for troubles in old code; it exists to inform the CppNix team about problems they might care about also.

  

Affects/Nightly

Found in Lix nightly.

  

Affects/Only nightly

Tag for regressions in Lix nightly. We intend to fix all of these prior to releases.

  

Affects/Stable

Affects the stable release of Lix. Usually such issues affect nightly too but there is no guarantee.

  

Area/build-packaging

regarding the building or packaging of Lix itself

  

Area/cli

The command line interface of Lix

  

Area/evaluator

libexpr and anything else related to the evaluation of Nix expressions

  

Area/fetching

Fetching sources or other materials from the World Wide Web in Lix

  

Area/flakes

  

Area/language

language design, features, extensions, etc

  

Area/lix ci

Lix's own CI and deployment pipeline

  

Area/nix-eval-jobs

nix-eval-jobs for Lix

  

Area/profiles

profiles: nix-env, nix profile, and installer flavors all alike

  

Area/protocol

The protocol, used for communicating between the client and the daemon

  

Area/releng

Release engineering

  

Area/remote-builds

remote builds

  

Area/repl

nix repl

  

Area/repl/debugger

The --debugger that brings up a Lix repl

  

Area/store

libstore and anything else relating to the Nix store

  

bug

it's a bug

  

Context

contributors

This issue might require some context that isn't written down. It might be possible to handle as a person who already worked on this area.

  

Context

drive-by

This issue contains all the necessary information to do a drive-by contribution: that is, you don't have to talk with anyone at all to successfully solve it!

  

Context

maintainers

This issue requires a lot of know-how. Attention from maintainers is needed to proceed.

  

Context

RFD

This issue needs discussion from multiple maintainers and interested parties: it's a Request For Discussion.

  

crash 💥

Lix crashes (possibly bad error handling)

  

Cross Compilation

  

devx

development experience issues

  

docs

requires or is about documentation changes

  

Downstream Dependents

regarding an external tool's usage with Lix (e.g. nix-eval-jobs)

  

E/easy

bug is relatively simple and could simply be fixed with some minor effort

  

E/hard

this issue should probably be solved with close involvement of an expert

  

E/help wanted

maintainers may not get to this soon, but we want it fixed

  

E/reproducible

This bug is reproducible and obvious.

  

E/requires rearchitecture

this bug cannot be fixed properly without fixing a known architectural flaw

  

Feature/S3

S3 support in Lix

  

imported

Issue imported from upstream nix (please do not remove this label, it will cause dupes if import is rerun)

  

Language/Bash

  

Language/C++

  

Language/NixLang

  

Language/Python

  

Language/Rust

  

Needs Langver

We can't get to this until we implement language versioning

  

OS/Linux

Affects specifically Lix on Linux

  

OS/macOS

Affects specifically Lix on macOS

  

performance

make lix go faster

  

regression

This is a regression since some previous version of Lix

  

release-blocker

Blocks public release

  

stability

Fixing this makes the software more stable

  

Status

blocked

Blocked on something

  

Status

invalid

not our bug, duplicate, similar

  

Status

postponed

closed but should maybe look at later (generally with S-wontfix)

  

Status

wontfix

We chose not to change this (see issue comments for more detail).

  

testing

Tests that should be added

  

testing/flakey

Tests that are unreliable/flakey (not to be confused with flakes that test)

  

Topic/Large Scale Installations

Large scale installations of Lix, e.g. NixOS Hydra, Lix CI, big corporate installations etc.

  

ux

makes the user experience better :)

No labels

Affects/CppNix

Affects/Nightly

Affects/Only nightly

Affects/Stable

Area/build-packaging

Area/cli

Area/evaluator

Area/fetching

Area/flakes

Area/language

Area/lix ci

Area/nix-eval-jobs

Area/profiles

Area/protocol

Area/releng

Area/remote-builds

Area/repl

Area/repl/debugger

Area/store

bug

Context

contributors

Context

drive-by

Context

maintainers

Context

RFD

crash 💥

Cross Compilation

devx

docs

Downstream Dependents

E/easy

E/hard

E/help wanted

E/reproducible

E/requires rearchitecture

Feature/S3

imported

Language/Bash

Language/C++

Language/NixLang

Language/Python

Language/Rust

Needs Langver

OS/Linux

OS/macOS

performance

regression

release-blocker

stability

Status

blocked

Status

invalid

Status

postponed

Status

wontfix

testing

testing/flakey

Topic/Large Scale Installations

ux

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

2 participants

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

lix-project/lix#910

No description provided.