Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[WIP] add full descriptions to options in nix help #6874

Closed
wants to merge 1 commit into from

Conversation

whentze
Copy link

@whentze whentze commented Aug 5, 2022

fixes #5545.

@thufschmitt
Copy link
Member

It's a bit of a shame that we can't have links in the help pages, having these flags just be a link to the doc of their respective option would be much nicer 🤔

I think the indentation of the descriptions might need fixing, but I couldn't figure out how the fmt machinery works yet.

I'm not sure you can do that with fmt, you might have to pre-process the interpolated string manually

@nixos-discourse
Copy link

This pull request has been mentioned on NixOS Discourse. There might be relevant details there:

https://discourse.nixos.org/t/summer-of-nix-documentation-stream/20351/2

@fricklerhandwerk
Copy link
Contributor

fricklerhandwerk commented Oct 10, 2022

@thufschmitt We can still have links in the HTML rendering.

@whentze are you still interested in pursuing this this? Documentation of configuration options is not great right now, and your PR looks like a potential quick win, given some polishing.

@iFreilicht
Copy link
Contributor

I rebased this PR and fixed the indentation issues in #8818.

@fricklerhandwerk
Copy link
Contributor

Superseded by #8931

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

better descriptions of options in nix help
5 participants