nixpkgs/doc
Jonas Chevalier 1e910209ae
mkShell: make it buildable (#153194)
When I designed `mkShell`, I didn't have a good idea of what the output
should look like and so decided to make the build fail. In practice,
this causes quite a bit of confusion and complications because now the
shell cannot be part of a normal package set without failing the CI as
well.

This commit changes that build phase to record all the build inputs in a
file. That way it becomes possible to build it, makes sure that all the
build inputs get built as well, and also can be used as a GC root.
(by applying the same trick as #95536).

The documentation has also been improved to better describe what mkShell
does and how to use it.
2022-01-08 01:54:04 +01:00
..
build-aux/pandoc-filters doc: remove reference to unix-man-urls.lua 2021-12-28 13:26:35 +01:00
builders mkShell: make it buildable (#153194) 2022-01-08 01:54:04 +01:00
contributing Merge pull request #152451 from ncfavier/unix-man-urls 2022-01-03 16:05:37 +01:00
doc-support lib.sources: Generate docs 2021-05-29 16:03:54 +02:00
functions doc: Fix xref in functions description 2021-11-14 22:30:07 +01:00
languages-frameworks buildGoModule: use proxyVendor instead of runVend 2022-01-06 14:00:58 +10:00
old doc/*: editorconfig fixes 2020-07-31 15:06:53 +10:00
stdenv Merge pull request #124556 from bergkvist/bergkvist/make-c-wrapper 2021-12-10 00:45:30 +01:00
using treewide: Fix unsafe concatenation of $LD_LIBRARY_PATH, round 2 2021-11-04 16:15:05 -07:00
.gitignore
default.nix doc: Fix make in nix-shell 2021-06-05 13:25:48 +02:00
functions.xml doc/functions/generators: convert to CommonMark 2021-06-11 06:06:42 -07:00
Makefile doc: Add helper for converting DocBook files to Markdown 2021-07-13 02:21:22 +02:00
manual.xml doc/using: convert to markdown 2021-04-23 12:02:07 +02:00
overrides.css doc: Make callout marks in code unselectable 2020-01-14 15:24:57 +01:00
preface.chapter.md doc: prepare for commonmark 2021-06-07 06:34:59 +02:00
README.md doc/README.md: Add more links 2021-03-06 12:35:33 +01:00
release-notes.xml treewide: use https for nixos.org and hydra.nixos.org 2020-05-03 22:14:21 -07:00
shell.nix doc: fix shell.nix (#109816) 2021-01-19 12:46:51 -05:00
style.css

Nixpkgs/doc

This directory houses the sources files for the Nixpkgs manual.

You can find the rendered documentation for Nixpkgs unstable on nixos.org.

Docs for Nixpkgs stable are also available.

If you want to contribute to the documentation, here's how to do it.

If you're only getting started with Nix, go to nixos.org/learn.