Age | Commit message (Collapse) | Author | |
---|---|---|---|
2023-09-06 | add anchors to option listings | Valentin Gagarin | |
2023-08-02 | Add infra for experimental store implemenations | John Ericson | |
This is analogous to that for experimental settings and flags that we have also added as of late. | |||
2023-05-03 | doc rendering: add functions to scope explicitly (#7378) | Valentin Gagarin | |
* doc rendering: add functions to scope explicitly this especially helps beginners with code readability, since the origin of names is always immediately visible. | |||
2023-04-16 | Add `optionalString` to manual Nix lang utilities | John Ericson | |
Use it everywhere it could be also. | |||
2023-04-14 | Start cross-referencing experimental features | John Ericson | |
- Create a glossary entry for experimental features. - Have the man page experimental feature notice link `nix-commmand`. (Eventually this should be programmed, based on whether the command is experimental, and if so what experimental feature does it depend on.) - Document which installables depend on which experimental features. I tried to use the same style (bold warning and block quote) that the top of the man page uses. Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io> | |||
2023-03-23 | Make useAnchors a named argument | Eelco Dolstra | |
2023-03-21 | Support per-store Markdown documentation | Eelco Dolstra | |
2023-03-21 | nix store --help: Include store type documentation | Eelco Dolstra | |
2023-03-21 | generate-manpage.nix: Make more readable | Eelco Dolstra | |
2022-11-30 | add missing newline, for consistent formatting | Valentin Gagarin | |
2022-10-07 | Print common flags in --help | Ana Hobden | |
2022-09-30 | bring back lost newline | Valentin Gagarin | |
2022-09-30 | use more self-explanatory names | Valentin Gagarin | |
2022-09-30 | move final template to the top | Valentin Gagarin | |
this allows readers to enter the code starting with what is visible from the outside, instead of working themselves up from purely technical details. | |||
2022-09-30 | remove superfluous let-in pair | Valentin Gagarin | |
2022-09-30 | refactor showOptions | Valentin Gagarin | |
it was quite a pain to manipulate strings just with `builtins` | |||
2022-09-30 | refactor rendering command documentation to markdown | Valentin Gagarin | |
idea: - make document structure visible, like in a template - order functions by descending abstraction - avoid nested let bindings | |||
2022-09-30 | use indented strings where appropriate | Valentin Gagarin | |
2022-08-26 | do not render relative links in help pages | Valentin Gagarin | |
this simplifies the setup a lot, and avoids weird looking `./file.md` links showing up. it also does not show regular URLs any more. currently the command reference only has few of them, and not showing them in the offline documentation is hopefully not a big deal. instead of building more special-case solutions, clumsily preprocessing the input, or issuing verbal rules on dealing with URLs, should better be solved sustainably by not rendering relative links in `lowdown`: https://github.com/kristapsdz/lowdown/issues/105 | |||
2021-10-06 | Remove links to .md files in help output | Eelco Dolstra | |
Fixes #5337. | |||
2021-09-13 | nix --help: Display help using lowdown instead of man | Eelco Dolstra | |
Fixes #4476. Fixes #5231. | |||
2021-02-17 | Restore warning about 'nix' being experimental | Eelco Dolstra | |
Fixes #4552. | |||
2021-01-25 | Group common options | Eelco Dolstra | |
2021-01-25 | Group subcommands by category | Eelco Dolstra | |
2020-12-23 | Command: Remove examples() | Eelco Dolstra | |
2020-12-21 | generate-manpage.nix: Fix short names | Eelco Dolstra | |
2020-12-03 | Make doc() return arbitrary Markdown rather than the contents of the ↵ | Eelco Dolstra | |
"Description" section Thus we can return the examples section (and any other sections) from doc() and don't need examples() anymore. | |||
2020-12-02 | Put examples first in the manpages | Eelco Dolstra | |
2020-12-02 | Generate separate manpages for each nix subcommand | Eelco Dolstra | |
2020-10-08 | Remove stray 'Title:' from the manual | Eelco Dolstra | |
Closes #4096. | |||
2020-09-16 | jq -> nix | Eelco Dolstra | |