summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* machine: ssh: <machine-ssh-configuration> can include the host key.Ludovic Courtès2019-12-041-0/+12
| | | | | | * gnu/machine/ssh.scm (<machine-ssh-configuration>)[host-key]: New field. (machine-ssh-session): Pass #:host-key to 'open-ssh-session'. * doc/guix.texi (Invoking guix deploy): Document it.
* services: Add GNOME Keyring service.Leo Prikler2019-12-041-0/+35
| | | | | | | | | * gnu/services/desktop.scm: (<gnome-keyring-configuration>): New record type. (pam-gnome-keyring): New procedure. (gnome-keyring-service-type): New variable. * doc/guix.texi (Desktop Services): Document it. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* Revert "doc: Fix typo in example."Efraim Flashner2019-12-031-1/+1
| | | | This reverts commit 7b40d59114e1462d6d8140f325a66b12e91db667.
* guix: Add the 'qt' build system.Hartmut Goebel2019-12-011-1/+20
| | | | | | * guix/build-system/qt.scm, guix/build/qt-build-system.scm: New files. * Makefile.am (MODULES): Add them. * doc/guix.texi (Buiild systems): Add the new build system.
* services: Add polkit-wheel-service.Leo Prikler2019-11-301-0/+7
| | | | | | | | * gnu/services/desktop.scm: (polkit-wheel): New variable. (polkit-wheel-service): New service. * doc/guix.texi: Document polkit-wheel-service. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* gexp: 'local-file' properly resolves non-literal relative file names.Ludovic Courtès2019-11-301-4/+7
| | | | | | | | * guix/gexp.scm (local-file): Distinguish the case where FILE is a literal string and when it's not. Add a clause for when FILE is not a literal string. * tests/gexp.scm ("local-file, non-literal relative file name"): New test. * doc/guix.texi (G-Expressions): Update accordingly.
* doc: Link to Guile's SXML section.Ludovic Courtès2019-11-281-2/+3
| | | | | * doc/guix.texi (PAM Mount Service): Add xref to the "SXML" section of the Guile manual.
* services: Add pam-mount.Guillaume Le Vaillant2019-11-281-0/+85
| | | | | | | | * gnu/services/pam-mount.scm: New file. * gnu/local.mk (GNU_SYSTEM_MODULES): Add it. * doc/guix.texi (PAM Mount Service): New subsection. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: Handle right arrows in 'syntax-highlighted-html'.Ludovic Courtès2019-11-281-0/+1
| | | | * doc/build.scm (syntax-highlighted-html)[build](entity->string): Add "rarr".
* doc: Fix typo.Efraim Flashner2019-11-261-1/+1
| | | | | * doc/guix.texi (php-fpm-service-type): Note that the socket-group default is "nagios" and not "php-fpm".
* guix build: '--keep-failed' implies '--no-offload'.Ludovic Courtès2019-11-261-3/+3
| | | | | | * guix/scripts/build.scm (set-build-options-from-command-line): Pass #:offload? #f when 'keep-failed? is true. * doc/guix.texi (Common Build Options): Document it.
* guix build, daemon: Rename "--no-build-hook" to "--no-offload".Ludovic Courtès2019-11-261-11/+9
| | | | | | | | | | | | | | | | This is a followup to bc69ea2d605810cc32e13ed03d5848b8dc358b61. * guix/scripts/build.scm (show-build-options-help): Rename "--no-build-hook" to "--no-offload". (%standard-build-options): Likewise, and warn when "--no-build-hook" is passed. * nix/nix-daemon/guix-daemon.cc (options): Add "--no-offload" and mark "--no-build-hook" as hidden. * guix/scripts/offload.scm: Adjust comment. * doc/guix.texi (Invoking guix-daemon, Common Build Options): Replace "--no-build-hook" with "--no-offload". * etc/completion/fish/guix.fish, etc/completion/zsh/_guix: Adjust accordingly.
* doc: cookbook: Add cross-references to the Guile manual.Ludovic Courtès2019-11-261-8/+11
| | | | | * doc/guix-cookbook.texi (A Scheme Crash Course): Add cross-reference to the Guile manual.
* doc: cookbook: Use @result{} & co. instead of a '>' prompt.Ludovic Courtès2019-11-261-41/+48
| | | | | * doc/guix-cookbook.texi (A Scheme Crash Course) (Extended example): Use @result{}, @print{}, and @error{}.
* doc: cookbook: Use Texinfo quotes.Ludovic Courtès2019-11-261-23/+21
| | | | | * doc/guix-cookbook.texi: Use Texinfo quotes ``like this'' instead of straight quotes or curly quotes.
* doc: cookbook: Add cross-reference about ./pre-inst-env.Ludovic Courtès2019-11-261-2/+3
| | | | | * doc/guix-cookbook.texi (Direct checkout hacking): Refer to "Running Guix Before It Is Installed".
* doc: cookbook: Use @lisp for Scheme snippets.Ludovic Courtès2019-11-261-24/+24
| | | | | * doc/guix-cookbook.texi: Use @lisp instead of @example where appropriate.
* pack: Allow multiple '--manifest' options.Ludovic Courtès2019-11-221-1/+2
| | | | | | | * guix/scripts/pack.scm (guix-pack): Collect 'manifest' options, and concatenate the resulting manifests. * tests/guix-pack.sh: Test it. * doc/guix.texi (Invoking guix pack): Document it.
* package: Allow multiple '--manifest' options.Ludovic Courtès2019-11-221-1/+2
| | | | | | | | | | | * guix/scripts/package.scm (manifest-action): Remove. (%actions): Remove it. (load-manifest): New procedure. (process-actions): Handle 'manifest' options. Define 'files' from 'manifest' options. Define 'manifest' based on FILES. Define 'trans' to represent the final transaction. * tests/guix-package.sh: Test it. * doc/guix.texi (Invoking guix package): Mention
* environment: Document that '--manifest' can be repeated.Ludovic Courtès2019-11-221-1/+2
| | | | | | * tests/guix-environment.sh: Test 'guix environment' with two '-m' options. * doc/guix.texi (Invoking guix environment): Explain that '-m' can be passed multiple times.
* doc: fcgiwrap-configuration: Remove stray period.Efraim Flashner2019-11-211-1/+1
| | | | | * doc/guix.texi (Web Services)[fcgiwrap-configuration]: Remove a stray period.
* pack: Add "--derivation".Ludovic Courtès2019-11-211-0/+4
| | | | | | | * guix/scripts/pack.scm (%options, show-help): Add "--derivation". (guix-pack): Honor it. * tests/guix-pack.sh: Test it. * doc/guix.texi (Invoking guix pack): Document it.
* doc: Fix typo in example.Efraim Flashner2019-11-191-1/+1
| | | | | * doc/guix.texi (Web Services)[nginx-php-fpm-location]: Fix example to actually use nginx-php-fpm-location.
* doc: Fix typo.Efraim Flashner2019-11-191-1/+1
| | | | | * doc/guix.texi (Web Services)[php-fpm-configuration]: Change language to suggest there are more than two options.
* doc: Clarify the "system type" for 'machine-ssh-configuration'.Ludovic Courtès2019-11-191-2/+2
| | | | | * doc/guix.texi (Invoking guix deploy): Replace "Nix system type" with "system type" for consistency.
* time-machine: Honor the standard build options.Ludovic Courtès2019-11-151-0/+4
| | | | | | | | | | | * guix/scripts/time-machine.scm (show-help): Call 'show-build-options-help'. (%options): Add %STANDARD-BUILD-OPTIONS. (%default-options): New variable. (parse-args): Pass (list %default-options) to 'parse-command-line' and remove #:build-options? parameter. (guix-time-machine): Call 'set-build-options-from-command-line' and wrap 'cached-channel-instance' call in 'with-status-verbosity'. * doc/guix.texi (Invoking guix time-machine): Mention common build options.
* Add 'guix time-machine'.Konrad Hinsen2019-11-151-2/+57
| | | | | | | | | | | | * guix/scripts/time-machine.scm: New file. * Makefile.am: (MODULES): Add it. * guix/scripts/pull.scm (channel-list): Export. * guix/inferior.scm (cached-channel-instance): New procedure. (inferior-for-channels): Use it. * doc/guix.texi (Invoking guix time-machine): New section. (Channels): Cross-reference it. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: Drop stray quotation mark.Kyle Meyer2019-11-131-1/+1
| | | | | | * doc/guix.texi (Invoking guix publish): Drop stray quotation mark. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* services: Add pagekite-service-type.Alex Griffin2019-11-111-0/+47
| | | | | | | * gnu/services/networking.scm (pagekite-service-type): New service type. (<pagekite-configuration>): New record type. (pagekite-shepherd-service): New procedure. * doc/guix.texi (Networking Services): Document it.
* services: Add knot-resolver-service-type.宋文武2019-11-111-0/+38
| | | | | | | | * gnu/services/dns.scm (<knot-resolver-configuration>): New record type. (knot-resolver-activation, knot-resolver-shpherd-services): New procedures. (%knot-resolver-accounts, %kresd.conf, knot-resolver-service-type): New variables. * doc/guix.texi (DNS Services): Document it.
* doc: Mention value /var to localstatedir option.zimoun2019-11-092-3/+5
| | | | | | | | * README (Installing Guix from Guix): Mention value /var to localstatedir option. * doc/contributing.texi (Building from Git): Likewise. * doc/guix.texi (Requirements): Likewise. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: Add clarification on the '--source' build option.Florian Pelz2019-11-071-0/+5
| | | | | | | Emphasize that what the '--source' build option downloads is insufficient for reproducing the packages. * doc/guix.texi (Additional Build Options): Explain more.
* services: Make it possible to include dynamic modules in nginx.Florian Pelz2019-11-071-0/+11
| | | | | | | | * gnu/services/web.scm (<nginx-configuration>): Add modules field. (nginx-configuration-modules): New field accessor. (emit-load-module): New procedure. (default-nginx-config): Add support for the modules field. * doc/guix.texi (NGINX): Document it.
* graph: Support package transformation options.Ludovic Courtès2019-11-071-0/+11
| | | | | | | | * guix/scripts/graph.scm (%options): Append %TRANSFORMATION-OPTIONS. (show-help): Call 'show-transformation-options-help'. (guix-graph): Call 'options->transformation' and use it. * tests/guix-graph.sh: Add test. * doc/guix.texi (Invoking guix graph): Document it.
* doc: Clarify uses of the 'ip' command.Kyle Andrews2019-11-041-1/+9
| | | | | | | * doc/guix.texi (Keyboard Layout and Networking and Partitioning): Use human readable arguments for 'ip' command. Mention 'ip link set'. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* services: colord: Deprecate 'colord-service' procedure.Ludovic Courtès2019-11-011-2/+3
| | | | | | | * gnu/services/desktop.scm (colord-service-type)[default-value]: New field. (colord-service): Define with 'define-deprecated'. (%desktop-services): Use 'colord-service-type' instead of 'colord-service'. * doc/guix.texi (Desktop Services): Adjust accordingly.
* doc: Explain how to switch profile from empty shell in "Profiles in Practice".Pierre Neidhardt2019-10-301-0/+8
| | | | * doc/guix-cookbook.texi (Profiles in Practice): Add example.
* gnu: mpd-service-type: Support configuration of outputs.Ricardo Wurmus2019-10-291-0/+60
| | | | | | | | * gnu/services/audio.scm (<mpd-output>): New record type. (<mpd-configuration>)[outputs]: New field. (mpd-output, mpd-output?, mpd-output->string): New procedures. (mpd-config->file): Use mpd-output->string. * doc/guix.texi (Audio Services): Document mpd-output fields.
* doc: Link to SICP Info page in "A Scheme Crash Course".Pierre Neidhardt2019-10-281-1/+1
| | | | | * doc/guix-cookbook.texi (Scheme tutorials): Replace Emacs Info reader hint with more useful interactive link to SICP Info page.
* doc: Finish importing the "Packaging Tutorial".Pierre Neidhardt2019-10-281-1/+779
| | | | | * doc/guix-cookbook.texi (Packaging Tutorial): Import all sections after the Scheme crash course.
* doc: Fix some typos in "Guix Profiles in Practice".Pierre Neidhardt2019-10-281-5/+7
| | | | * doc/guix-cookbook.texi (Guix Profiles in Practice): Fix typos.
* pull: Honor '/etc/guix/channels.scm'.Ludovic Courtès2019-10-271-1/+17
| | | | | | * guix/scripts/pull.scm (channel-list)[global-file]: New variable. [channels]: Honor it. * doc/guix.texi (Invoking guix pull): Document it.
* services: gdm: Add 'debug?' configuration field.Timothy Sample2019-10-261-0/+3
| | | | | | * gnu/services/xorg.scm (<gdm-configuration>)[debug?]: New field. (gdm-configuration-file): Use it. * doc/guix.texi: Document it.
* doc: cookbook: Use "@lisp" for Scheme snippets.Ludovic Courtès2019-10-251-43/+43
| | | | | | * doc/guix-cookbook.texi: Use @lisp for Scheme snippets instead of "@example scheme". This allows for syntax highlighting of the HTML output.
* doc: Add "Guix Profiles in Practice" to the cookbook.Pierre Neidhardt2019-10-241-0/+389
| | | | | * doc/guix-cookbook.texi (Advanced package management): New chapter. * doc/guix-cookbook.texi (Guix Profiles in Practice): New section.
* cve: Rewrite to read the JSON feed instead of the XML feed.Ludovic Courtès2019-10-231-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The XML feed was discontinued on Oct. 16th, 2019: <https://nvd.nist.gov/General/News/XML-Vulnerability-Feed-Retirement-Phase-3> * guix/cve.scm (string->date*): New procedure. (<cve-item>, <cve>, <cve-reference>): New record types. (cpe-match->cve-configuration, configuration-data->cve-configurations) (json->cve-items, version-matches?): New procedures. (yearly-feed-uri): Change URL to refer to JSON feed. (cpe->product-alist, %parse-vulnerability-feed) (xml->vulnerabilities): Remove. (cve-configuration->package-list, merge-package-lists) (cve-item->vulnerability, json->vulnerabilities): New procedures. (write-cache): Use 'json->vulnerabilities' instead of 'xml->vulnerabilities', and remove 'parameterize'. (vulnerabilities->lookup-proc): Use 'version-matches?' when VERSION is true. * tests/cve.scm (%sample): Use 'tests/cve-sample.json'. (%expected-vulnerabilities): Rewrite accordingly. ("json->cve-items", "cve-item-published-date") ("json->vulnerabilities"): New tests. ("xml->vulnerabilities"): Remove. ("vulnerabilities->lookup-proc"): Adjust to new vulnerabilities. * tests/cve-sample.json: New file. * tests/cve-sample.xml: Remove. * Makefile.am (EXTRA_DIST): Adjust accordingly. * doc/guix.texi (Invoking guix lint): Update nist.gov URLs.
* machine: digital-ocean: Rename 'enable-ipv6' to 'enable-ipv6?'.Ludovic Courtès2019-10-221-1/+1
| | | | | | | | * gnu/machine/digital-ocean.scm (<digital-ocean-configuration>)[enable-ipv6]: Rename to... [enable-ipv6?]: ... this. (deploy-digital-ocean): Adjust accordingly. * doc/guix.texi (Invoking guix deploy): Adjust accordingly.
* machine: Implement 'digital-ocean-environment-type'.Jakob L. Kreuze2019-10-221-3/+21
| | | | | | | | | * gnu/machine/digital-ocean.scm: New file. * gnu/local.mk (GNU_SYSTEM_MODULES): Add it. * doc/guix.texi (Invoking guix deploy): Add documentation for 'digital-ocean-configuration'. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: Use the right title in HTML indices for the cookbook.Ludovic Courtès2019-10-221-4/+6
| | | | | * doc/build.scm (html-manual-indexes): Add #:title. [build]: Replace "GNU Guix Reference Manual" by references to TITLE.
* services: inputattach: Add 'baud-rate' parameter.Tim Gesthuizen2019-10-211-0/+4
| | | | | | | | | * gnu/services/desktop.scm (inputattach-configuration): Add baud-rate field. (inputattach-shepherd-service): Add baud-rate to parameters when specified. * doc/guix.texi (Miscellaneous Services): [inputattach Service] Document baud-rate parameter. Signed-off-by: Ludovic Courtès <ludo@gnu.org>