about summary refs log tree commit diff
path: root/nixos/doc/manual/development
AgeCommit message (Collapse)AuthorFilesLines
2022-06-14lib.deferredModule: Make it properly singularRobert Hensing1-2/+3
2022-06-14lib.types: Add deferredModuleRobert Hensing1-0/+19
2022-06-12treewide: attempt at markdown option docspennae1-1/+8
2022-06-05Merge pull request #174441 from ↵Robert Hensing1-0/+22
tljuniper/172325-nixostest-override-python-pkgs-additional-param nixos/test-driver: additional Python packages in test driver
2022-06-04Merge master into haskell-updatesgithub-actions[bot]1-0/+13
2022-06-03Merge branch 'master' into ↵Robert Hensing2-0/+17
172325-nixostest-override-python-pkgs-additional-param
2022-06-03add opt out flag for type checkingMichael Schneider1-0/+13
2022-05-29nixos/manual: Add docs on extra python packages in teststljuniper1-0/+22
2022-05-28haskell.compiler: ghc922 -> ghc923sternenseemann1-2/+2
https://www.haskell.org/ghc/download_ghc_9_2_3.html Since the tarball is generated by Hadrian, neither autoreconf nor ./boot is executed so ./configure and ghc.mk is missing.
2022-05-27Merge pull request #167037 from schuelermine/patch-doc-submodule-defaultpennae1-0/+4
nixos/doc/types: note submodules’ default’s behaviour
2022-04-21nixos/manual: Clarify execute exit statustljuniper1-1/+1
Co-authored-by: Robert Hensing <roberth@users.noreply.github.com>
2022-04-21nixos/manual: Refine doc for `execute` et alAnna Gillert1-14/+25
- Clarify that shellopts are set in every `execute` call (rather than only `succeed`). - Add documentation for the `timeout` parameter and its default values.
2022-04-16nixos/doc: move "Building NixOS" into "Installation", not "Development"Florian Klink2-78/+0
This section mostly describes how to build various installer images, so it fits better in that chapter. Proposed in https://github.com/NixOS/nixpkgs/pull/168306#discussion_r848329534
2022-04-12nixos/doc: add notes on additional drivers or firmwareFlorian Klink1-0/+31
This describes how to build your own installer medium with some custom firmware/drivers, using an Intel MacBook as an example - on which WiFi doesn't work out of the box, due to it being nonfree. Fixes #15162. Co-authored-by: Lucas Hoffmann <lucc@users.noreply.github.com> Co-authored-by: Robert Hensing <roberth@users.noreply.github.com>
2022-04-03nixos/doc/types: note submodules’ default’s behaviourAnselm Schüler1-0/+4
2022-04-01formats.javaProperties: Add documentationRobert Hensing1-0/+14
2022-03-31Merge pull request #165035 from roberth/nixosTest-remove-machine-argRobert Hensing1-22/+14
nixosTest: remove `machine` syntax sugar
2022-03-28nixosTest: Simplify doc by deprecating syntax sugarRobert Hensing1-22/+14
2022-03-26Merge remote-tracking branch 'origin/master' into haskell-updatessternenseemann1-0/+13
2022-03-25nixos/test-runner: Allow writing to qemu stdinJanne Heß1-0/+13
2022-03-17Merge master into haskell-updatesgithub-actions[bot]1-3/+4
2022-03-16Merge pull request #162271 from Infinisil/warn-no-typeRobert Hensing1-3/+4
Throw an error for options without a type
2022-03-14Merge master into haskell-updatesgithub-actions[bot]2-1/+47
2022-03-13Merge pull request #154113 from pennae/systemd-escapingpennae1-0/+42
nixos: add functions and documentation for escaping systemd Exec* directives
2022-03-12nixos: add functions and documentation for escaping systemd Exec* directivespennae1-0/+42
it's really easy to accidentally write the wrong systemd Exec* directive, ones that works most of the time but fails when users include systemd metacharacters in arguments that are interpolated into an Exec* directive. add a few functions analogous to escapeShellArg{,s} and some documentation on how and when to use them.
2022-03-11Merge remote-tracking branch 'origin/master' into haskell-updatessternenseemann1-1/+2
2022-03-11nixos/switch-to-configuration: Fix reloading of stopped servicesJanne Heß1-0/+3
2022-03-11nixos/switch-to-configuration: Ignore some unit keysJanne Heß1-1/+2
Some unit keys don't need to restart the service to make them effective. Reduce the amount of service restarts by ignoring these keys
2022-03-11lib.types.package: only call toDerivation when necessaryNaïm Favier1-1/+2
The current logic assumes that everything that isn't a derivation is a store path, but it can also be something that's *coercible* to a store path, like a flake input. Unnecessary uses of `lib.toDerivation` result in errors in pure evaluation mode when `builtins.storePath` is disabled. Also document what a `package` is.
2022-03-09haskell.compiler: ghc921 -> ghc922sternenseemann1-2/+2
https://www.haskell.org/ghc/download_ghc_9_2_2.html
2022-03-05nixos/doc: improve wording in "Options Types" and "Option Declarations"Alexandru Scvortov2-16/+16
2022-03-03nixos/switch-to-configuration: Document and test socket-activated servicesJanne Heß1-7/+8
2022-03-01lib.types: Introduce `types.optionType`Silvan Mosberger1-0/+7
This type correctly merges multiple option types together while also annotating them with file information. In a future commit this will be used for `_module.freeformType`
2022-02-28lib/options: Throw error for options without a typeJanne Heß1-3/+4
Makes all options rendered in the manual throw an error if they don't have a type specified. This is a follow-up to #76184 Co-Authored-By: Silvan Mosberger <contact@infinisil.com>
2022-02-28pkgs-lib: Implement settings format for ElixirMinijackson1-0/+45
2022-02-22lib/types: Introduce types.raw for unprocessed valuesSilvan Mosberger1-0/+11
2022-02-20Merge pull request #154694 from winterqt/nixos-test-log-docMaximilian Bosch1-2/+2
nixos/doc: fix mention of reading test logs
2022-02-09nixos/doc: Document the activation scriptJanne Heß4-0/+183
This may be helpful to new module developers, curious users, and people who just need a reference without having to look at the implementation
2022-01-26update docsMarijan Petričević1-2/+2
2022-01-25Merge pull request #156503 from hercules-ci/nixos-add-system.build-optionsRobert Hensing1-0/+6
nixos: Add `system.build.`{`toplevel`,`installBootLoader`}, improve error message
2022-01-24nixos/doc: Document types.uniqueRobert Hensing1-0/+6
2022-01-23nixos/docs/option-declarations: Document mkEnableOption and mkPackageOptionAnselm Schüler1-0/+74
This is a squashed commit. These are the original commit messages: lib/option: Improve comment better comment Update documentation Updated nixos/doc/manual/development/options-declarations.md with info on mkEnableOption and mkPackageOption. Updated the comment on mkEnableOption in lib/options.nix remove trailing whitespace nixos/doc/option-declarations: Update IDs & formatting nixos/docs/option-declarations: Escape angle brackets Build DB from MD (Amended) Fix typo Co-authored-by: pennae <82953136+pennae@users.noreply.github.com> (Amended) Build DB from MD (again)
2022-01-11nixos/doc: fix mention of reading test logsWinter1-2/+2
2022-01-08Merge pull request #146905 from Synthetica9/failure_modeJacek Galowicz1-0/+51
nixos/test-driver: add polling_condition
2022-01-07Merge pull request #153273 from Synthetica9/passthru-driverInteractivePatrick Hilhorst1-7/+7
2022-01-04nixos/test-driver: also passthru driverInteractivePatrick Hilhorst1-7/+7
2022-01-02nixos/documentation: split options doc buildpennae1-1/+27
most modules can be evaluated for their documentation in a very restricted environment that doesn't include all of nixpkgs. this evaluation can then be cached and reused for subsequent builds, merging only documentation that has changed into the cached set. since nixos ships with a large number of modules of which only a few are used in any given config this can save evaluation a huge percentage of nixos options available in any given config. in tests of this caching, despite having to copy most of nixos/, saves about 80% of the time needed to build the system manual, or about two second on the machine used for testing. build time for a full system config shrank from 9.4s to 7.4s, while turning documentation off entirely shortened the build to 7.1s.
2022-01-01nixos/test-driver: add polling_conditionPatrick Hilhorst1-0/+51
2021-11-06nixosTest: Add xclip as example of stdout blockerRobert Hensing1-2/+5
2021-11-05nixosTest: Document stdout waiting behaviorRobert Hensing1-0/+6