aboutsummaryrefslogtreecommitdiff
path: root/doc/manual
AgeCommit message (Collapse)Author
2023-06-14Improve `nix-env --delete-generations` docsJohn Ericson
Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2023-06-14Merge pull request #8488 from Mic92/update-requirementsJohn Ericson
nix actually needs c++20 now
2023-06-14Merge pull request #4803 from ShamrockLee/nix-channel-list-generationsJohn Ericson
Add `nix-channel --list-generations`
2023-06-10nix actually needs c++20 nowJörg Thalheim
2023-06-02Merge pull request #8317 from fricklerhandwerk/doc-identifierThéophane Hufschmitt
document identifier syntax for attribute sets
2023-06-02Add a release note for `nix-channel --list-generations`Théophane Hufschmitt
2023-06-02Add nix-channel --list-generationsShamrock Lee
Add support to --list-generations as another way to say nix-env --profile /nix/var/nix/profiles/per-user/$USER/channels --list-generations the way we did for nix-channel --rollback [generation id]
2023-05-31TypoEelco Dolstra
2023-05-31Release notesEelco Dolstra
2023-05-31Merge pull request #8421 from fricklerhandwerk/doc-replaceStringsEelco Dolstra
update documentation according to release notes
2023-05-31Merge pull request #8318 from fricklerhandwerk/doc-currentTimeValentin Gagarin
document `builtins.currentTime`
2023-05-31Merge pull request #8413 from doronbehar/doc/distributed-builds/clearer-warningValentin Gagarin
distributed-builds.md: Clarify warning ssh access requirements
2023-05-31rewrap lines to use one line per sentenceValentin Gagarin
this makes future reviews easier as it reduces diff noise
2023-05-31distributed-builds.md: Clarify warning ssh access requirementsDoron Behar
2023-05-30link to mentioned builtinValentin Gagarin
2023-05-25primops: lazy evaluation of replaceStrings replacementspolykernel
The primop `builtins.replaceStrings` currently always strictly evaluates the replacement strings, however time and space are wasted for their computation if the corresponding pattern do not occur in the input string. This commit makes the evaluation of the replacement strings lazy by deferring their evaluation to when the corresponding pattern are matched and memoize the result for efficient retrieval on subsequent matches. The testcases for replaceStrings was updated to check for lazy evaluation of the replacements. A note was also added in the release notes to document the behavior change.
2023-05-17Merge pull request #8337 from fricklerhandwerk/channel-filesJohn Ericson
list files used by `nix-channel` on its own man page
2023-05-17Merge pull request #8358 from fricklerhandwerk/output-addressed-referencesJohn Ericson
fix wording on output-addressed store objects
2023-05-17fix wording on output-addressed store objectsValentin Gagarin
hashing is an implementation detail. add references to the other terms.
2023-05-17add cross-references to pure evaluation modeValentin Gagarin
use consistent wording everywhere. add some details on the configuration option documentation.
2023-05-17document `builtins.currentTime`Valentin Gagarin
2023-05-17document identifier syntax for attribute setsValentin Gagarin
it's more likely for readers to find it right there. this also slightly rewords examples to make them stand out better. in the long run there probably needs to be a dedicated section on formal syntax, and better highlighting of examples.
2023-05-17Convert short nix options to long onesAlexander Schmolck
e.g. nix-env -e subversion => nix-env --uninstall subversion The aim is to make the documentation less cryptic for newcomers and the long options are more self-documenting. The change was made with the following script: <https://github.com/aschmolck/convert-short-nix-opts-to-long-ones> and sanity checked visually.
2023-05-15Reword info on XDG base dirs (#8338)Valentin Gagarin
This gives some more context and should clarify why it works that way. Also link it from the section on `NIX_USER_CONF_FILES`. Co-authored-by: John Ericson <git@JohnEricson.me>
2023-05-15list files used by `nix-channel`Valentin Gagarin
2023-05-15Merge pull request #8141 from tweag/user-files-docJohn Ericson
Document user files of nix
2023-05-15refactor: Join commands to remove filesVictor Engmark
2023-05-15docs: Mention more files referenced by the installerVictor Engmark
`/etc/bash.bashrc` is backed up as `/etc/bash.bashrc.backup-before-nix`, but since other changes might have been introduced in the meantime we can't just tell the user to revert.
2023-05-15docs: Remove references to non-existing filesVictor Engmark
At least on Ubuntu 22.04, these files are not created as part of a multi- user installation.
2023-05-15docs: Sort files by nameVictor Engmark
2023-05-15docs: Remove Nix profile content from correct directoryVictor Engmark
At least on Ubuntu 22.04, the Nix installer creates `/etc/profile.d/nix.sh`, not `/etc/profile/nix.sh`.
2023-05-15docs: Remove redundant uninstall commandVictor Engmark
`sudo systemctl disable nix-daemon.socket nix-daemon.service` removes these files already.
2023-05-14Merge pull request #8328 from urbas/max-substitution-jobsValentin Gagarin
2023-05-14`max-substitution-jobs` release note entryMatej Urbas
2023-05-12Describe the or operation on attribute sets slightly moreAna Hobden
2023-05-12Update doc/manual/src/SUMMARY.md.inAlexander Bantyev
Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2023-05-11reword introduction to built-in functionsValentin Gagarin
add anchor to `builtins.derivation` and list some built-in functions that are exposed in the global scope. I decided not to list everything, because we probably don't want to encourage people using them that way.
2023-05-11reword documentation on `builtins`Valentin Gagarin
- add anchor to `builtins` - add type information - reword description of `builtins` to offer more information concisely
2023-05-11do not indent markdown listValentin Gagarin
2023-05-03add redirect to track moved uninstall sectionValentin Gagarin
2023-05-03doc 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-28display documentation on manifest files separatelyValentin Gagarin
it's probably better not to show the manifest file documentation in the command-specific pages, because these are implementation details that are not really practically useful. this means no additional hassle for building the manual, but clutters the table of contents a bit.
2023-04-28move uninstall instructions to a separate pageValentin Gagarin
placed in a subsection of the binary install, the instructions are hard to find. putting them in a separate page that is shown in the table of contents should make it easier for users to find what they need when they need it.
2023-04-26move manifest information to the bottom of the pageValentin Gagarin
2023-04-26move compatibility info to `nix profile` docsValentin Gagarin
2023-04-26increase heading level Valentin Gagarin
otherwise the headings won't match at the point where they are included. this is a bit hacky and brittle, but works for now.
2023-04-26update description on how profiles work Valentin Gagarin
adapt to the example listing
2023-04-26fix typos and wordingValentin Gagarin
2023-04-26add colons to connect listings with descriptionsValentin Gagarin
2023-04-26list information regular users firstValentin Gagarin
this is to make it consistent everywhere