2016-09-20 16:31:23 +02:00
|
|
|
ifeq ($(doc_generate),yes)
|
|
|
|
|
|
2020-07-22 20:27:23 +02:00
|
|
|
MANUAL_SRCS := $(call rwildcard, $(d)/src, *.md)
|
2014-02-01 11:30:21 +01:00
|
|
|
|
|
|
|
|
# Generate man pages.
|
|
|
|
|
man-pages := $(foreach n, \
|
2020-08-17 19:33:18 +02:00
|
|
|
nix-env.1 nix-build.1 nix-shell.1 nix-store.1 nix-instantiate.1 nix.1 \
|
2020-07-23 13:09:30 +02:00
|
|
|
nix-collect-garbage.1 \
|
|
|
|
|
nix-prefetch-url.1 nix-channel.1 \
|
|
|
|
|
nix-hash.1 nix-copy-closure.1 \
|
|
|
|
|
nix.conf.5 nix-daemon.8, \
|
2014-02-01 11:30:21 +01:00
|
|
|
$(d)/$(n))
|
2014-09-16 15:29:55 +02:00
|
|
|
|
2014-02-01 12:23:14 +01:00
|
|
|
clean-files += $(d)/*.1 $(d)/*.5 $(d)/*.8
|
2014-02-01 11:30:21 +01:00
|
|
|
|
2014-02-01 16:30:24 +01:00
|
|
|
dist-files += $(man-pages)
|
2014-02-01 15:18:48 +01:00
|
|
|
|
2020-07-23 13:09:30 +02:00
|
|
|
$(d)/%.1: $(d)/src/command-ref/%.md
|
|
|
|
|
$(trace-gen) lowdown -sT man $^ -o $@
|
|
|
|
|
|
|
|
|
|
$(d)/%.8: $(d)/src/command-ref/%.md
|
2020-07-22 20:27:23 +02:00
|
|
|
$(trace-gen) lowdown -sT man $^ -o $@
|
2014-02-01 11:30:21 +01:00
|
|
|
|
2020-07-23 10:56:15 +02:00
|
|
|
$(d)/nix.conf.5: $(d)/src/command-ref/conf-file.md
|
|
|
|
|
$(trace-gen) lowdown -sT man $^ -o $@
|
|
|
|
|
|
2020-09-16 14:55:24 +02:00
|
|
|
$(d)/src/command-ref/nix.md: $(d)/nix.json $(d)/generate-manpage.nix $(bindir)/nix
|
|
|
|
|
$(trace-gen) $(bindir)/nix eval --experimental-features nix-command --impure --raw --expr 'import doc/manual/generate-manpage.nix (builtins.fromJSON (builtins.readFile $<))' > $@
|
2020-08-17 19:33:18 +02:00
|
|
|
|
2020-09-16 14:55:24 +02:00
|
|
|
$(d)/src/command-ref/conf-file.md: $(d)/conf-file.json $(d)/generate-options.nix $(d)/src/command-ref/conf-file-prefix.md $(bindir)/nix
|
|
|
|
|
@cat doc/manual/src/command-ref/conf-file-prefix.md > $@
|
|
|
|
|
$(trace-gen) $(bindir)/nix eval --experimental-features nix-command --impure --raw --expr 'import doc/manual/generate-options.nix (builtins.fromJSON (builtins.readFile $<))' >> $@
|
2020-08-19 18:28:04 +02:00
|
|
|
|
2020-08-17 19:33:18 +02:00
|
|
|
$(d)/nix.json: $(bindir)/nix
|
2020-08-24 14:49:30 +02:00
|
|
|
$(trace-gen) $(bindir)/nix __dump-args > $@
|
2020-08-17 19:33:18 +02:00
|
|
|
|
2020-08-19 18:28:04 +02:00
|
|
|
$(d)/conf-file.json: $(bindir)/nix
|
|
|
|
|
$(trace-gen) env -i NIX_CONF_DIR=/dummy HOME=/dummy $(bindir)/nix show-config --json --experimental-features nix-command > $@
|
|
|
|
|
|
2020-09-16 14:55:24 +02:00
|
|
|
$(d)/src/expressions/builtins.md: $(d)/builtins.json $(d)/generate-builtins.nix $(d)/src/expressions/builtins-prefix.md $(bindir)/nix
|
|
|
|
|
@cat doc/manual/src/expressions/builtins-prefix.md > $@
|
|
|
|
|
$(trace-gen) $(bindir)/nix eval --experimental-features nix-command --impure --raw --expr 'import doc/manual/generate-builtins.nix (builtins.fromJSON (builtins.readFile $<))' >> $@
|
2020-08-24 14:49:30 +02:00
|
|
|
|
|
|
|
|
$(d)/builtins.json: $(bindir)/nix
|
|
|
|
|
$(trace-gen) $(bindir)/nix __dump-builtins > $@
|
|
|
|
|
|
2020-07-22 20:27:23 +02:00
|
|
|
# Generate the HTML manual.
|
|
|
|
|
install: $(docdir)/manual/index.html
|
2014-02-01 11:30:21 +01:00
|
|
|
|
2020-08-24 14:49:30 +02:00
|
|
|
$(docdir)/manual/index.html: $(MANUAL_SRCS) $(d)/book.toml $(d)/custom.css $(d)/src/command-ref/nix.md $(d)/src/command-ref/conf-file.md $(d)/src/expressions/builtins.md
|
2020-07-22 20:27:23 +02:00
|
|
|
$(trace-gen) mdbook build doc/manual -d $(docdir)/manual
|
2020-07-31 15:43:25 +02:00
|
|
|
@cp doc/manual/highlight.pack.js $(docdir)/manual/highlight.js
|
2016-09-20 16:31:23 +02:00
|
|
|
|
|
|
|
|
endif
|
