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

Document Aliases #2428

Merged
merged 1 commit into from Sep 18, 2018
Merged

Document Aliases #2428

merged 1 commit into from Sep 18, 2018

Conversation

grahamc
Copy link
Member

@grahamc grahamc commented Sep 17, 2018

Please also backport to 2.1.

@edolstra
Copy link
Member

I'm not sure we should document these, being deprecated and all. There are many more aliases BTW.

@grahamc
Copy link
Member Author

grahamc commented Sep 17, 2018

I think they should be documented as being aliased now, so people can find the relevant docs from their configuration. I've seen several people confused about undocumented (because they're aliased) options. Maybe not as a second <term> in the listing, but as a paragraph at the end of the entry?

@grahamc
Copy link
Member Author

grahamc commented Sep 17, 2018

Another option could be documenting them as separate options, with the body of the varlistentry being "Deprecated: now an alias to newthing"?

@grahamc grahamc changed the title Document Aliases for keep-outputs, keep-derivations Document Aliases Sep 18, 2018
@grahamc
Copy link
Member Author

grahamc commented Sep 18, 2018

I've now documented all aliases which exist, where the option the alias is for was already documented.

@edolstra edolstra merged commit 2ca6ef0 into NixOS:master Sep 18, 2018
@edolstra
Copy link
Member

Thanks!

@grahamc grahamc deleted the docs-aliases branch September 18, 2018 18:43
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.

None yet

3 participants