Skip to content

Conversation

@gridbugs
Copy link
Contributor

No description provided.

Maintainers are expected to only modify flake.nix. While the url url of
the completion script isn't expected to change (unless Tarides adopts
the project), the goal of this change is to make it clear to maintainers
where the completion script comes from.

Signed-off-by: Stephen Sherratt <[email protected]>
Passing `completion = null;` to dune.nix causes the dune package to be
built without a completion script.

Signed-off-by: Stephen Sherratt <[email protected]>
Signed-off-by: Stephen Sherratt <[email protected]>
README.md Outdated
tag of Dune included in the release.

Dune does not contain a mechanism for generating its own completion script. The
completion script is generated using a semi-manual process. Dune use the
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
completion script is generated using a semi-manual process. Dune use the
completion script is generated using a semi-manual process. Dune uses the

README.md Outdated
completion script is generated using a semi-manual process. Dune use the
[cmdliner](https://github.com/dbuenzli/cmdliner) library for its CLI which
currently lacks the ability to generate shell completion scripts. To generate
shell completion scripts for Dune, replace its usage of cmdliner with an
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
shell completion scripts for Dune, replace its usage of cmdliner with an
shell completion scripts for Dune, we replace its usage of cmdliner with an

README.md Outdated

## Completion Script

[This repo](https://github.com/gridbugs/dune-completion-scripts) contains bash
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I initially thought 'this' referred to this repo, so

Suggested change
[This repo](https://github.com/gridbugs/dune-completion-scripts) contains bash
The [gridbugs/dune-completion-scripts repo](https://github.com/gridbugs/dune-completion-scripts) contains bash

Comment on lines +179 to +180
updated in place which is not ideal. Currently the install script doesn't
attempt to verify the checksum of the binary distro but if we ever add that
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I guess we should probably do this before long? It seems like best practice right? Maybe we could wait until someone asks for it tho?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It is the best practice, yes. The benefit of not doing it is that it gives the flexibility to make changes to the contents of the binary distro which is useful while we're still ironing out the kinks. I'm happy to wait until someone asks for it before doing it.

Signed-off-by: Stephen Sherratt <[email protected]>
@gridbugs gridbugs merged commit ccfa012 into ocaml-dune:main Aug 26, 2025
6 checks passed
@gridbugs gridbugs deleted the release-docs branch August 26, 2025 02:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants