summaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Collapse)Author
2019-12-01guix: Add the 'qt' build system.Hartmut Goebel
* 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.
2019-11-30services: Add polkit-wheel-service.Leo Prikler
* 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>
2019-11-30gexp: 'local-file' properly resolves non-literal relative file names.Ludovic Courtès
* 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.
2019-11-28doc: Link to Guile's SXML section.Ludovic Courtès
* doc/guix.texi (PAM Mount Service): Add xref to the "SXML" section of the Guile manual.
2019-11-28services: Add pam-mount.Guillaume Le Vaillant
* 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>
2019-11-28doc: Handle right arrows in 'syntax-highlighted-html'.Ludovic Courtès
* doc/build.scm (syntax-highlighted-html)[build](entity->string): Add "rarr".
2019-11-26doc: Fix typo.Efraim Flashner
* doc/guix.texi (php-fpm-service-type): Note that the socket-group default is "nagios" and not "php-fpm".
2019-11-26guix build: '--keep-failed' implies '--no-offload'.Ludovic Courtès
* 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.
2019-11-26guix build, daemon: Rename "--no-build-hook" to "--no-offload".Ludovic Courtès
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.
2019-11-26doc: cookbook: Add cross-references to the Guile manual.Ludovic Courtès
* doc/guix-cookbook.texi (A Scheme Crash Course): Add cross-reference to the Guile manual.
2019-11-26doc: cookbook: Use @result{} & co. instead of a '>' prompt.Ludovic Courtès
* doc/guix-cookbook.texi (A Scheme Crash Course) (Extended example): Use @result{}, @print{}, and @error{}.
2019-11-26doc: cookbook: Use Texinfo quotes.Ludovic Courtès
* doc/guix-cookbook.texi: Use Texinfo quotes ``like this'' instead of straight quotes or curly quotes.
2019-11-26doc: cookbook: Add cross-reference about ./pre-inst-env.Ludovic Courtès
* doc/guix-cookbook.texi (Direct checkout hacking): Refer to "Running Guix Before It Is Installed".
2019-11-26doc: cookbook: Use @lisp for Scheme snippets.Ludovic Courtès
* doc/guix-cookbook.texi: Use @lisp instead of @example where appropriate.
2019-11-22pack: Allow multiple '--manifest' options.Ludovic Courtès
* 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.
2019-11-22package: Allow multiple '--manifest' options.Ludovic Courtès
* 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
2019-11-22environment: Document that '--manifest' can be repeated.Ludovic Courtès
* 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.
2019-11-21doc: fcgiwrap-configuration: Remove stray period.Efraim Flashner
* doc/guix.texi (Web Services)[fcgiwrap-configuration]: Remove a stray period.
2019-11-21pack: Add "--derivation".Ludovic Courtès
* 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.
2019-11-19doc: Fix typo in example.Efraim Flashner
* doc/guix.texi (Web Services)[nginx-php-fpm-location]: Fix example to actually use nginx-php-fpm-location.
2019-11-19doc: Fix typo.Efraim Flashner
* doc/guix.texi (Web Services)[php-fpm-configuration]: Change language to suggest there are more than two options.
2019-11-19doc: Clarify the "system type" for 'machine-ssh-configuration'.Ludovic Courtès
* doc/guix.texi (Invoking guix deploy): Replace "Nix system type" with "system type" for consistency.
2019-11-15time-machine: Honor the standard build options.Ludovic Courtès
* 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.
2019-11-15Add 'guix time-machine'.Konrad Hinsen
* 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>
2019-11-13doc: Drop stray quotation mark.Kyle Meyer
* doc/guix.texi (Invoking guix publish): Drop stray quotation mark. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2019-11-11services: Add pagekite-service-type.Alex Griffin
* 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.
2019-11-11services: Add knot-resolver-service-type.宋文武
* 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.
2019-11-09doc: Mention value /var to localstatedir option.zimoun
* 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>
2019-11-07doc: Add clarification on the '--source' build option.Florian Pelz
Emphasize that what the '--source' build option downloads is insufficient for reproducing the packages. * doc/guix.texi (Additional Build Options): Explain more.
2019-11-07services: Make it possible to include dynamic modules in nginx.Florian Pelz
* 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.
2019-11-07graph: Support package transformation options.Ludovic Courtès
* 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.
2019-11-04doc: Clarify uses of the 'ip' command.Kyle Andrews
* 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>
2019-11-01services: colord: Deprecate 'colord-service' procedure.Ludovic Courtès
* 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.
2019-10-30doc: Explain how to switch profile from empty shell in "Profiles in Practice".Pierre Neidhardt
* doc/guix-cookbook.texi (Profiles in Practice): Add example.
2019-10-29gnu: mpd-service-type: Support configuration of outputs.Ricardo Wurmus
* 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.
2019-10-28doc: Link to SICP Info page in "A Scheme Crash Course".Pierre Neidhardt
* doc/guix-cookbook.texi (Scheme tutorials): Replace Emacs Info reader hint with more useful interactive link to SICP Info page.
2019-10-28doc: Finish importing the "Packaging Tutorial".Pierre Neidhardt
* doc/guix-cookbook.texi (Packaging Tutorial): Import all sections after the Scheme crash course.
2019-10-28doc: Fix some typos in "Guix Profiles in Practice".Pierre Neidhardt
* doc/guix-cookbook.texi (Guix Profiles in Practice): Fix typos.
2019-10-27pull: Honor '/etc/guix/channels.scm'.Ludovic Courtès
* guix/scripts/pull.scm (channel-list)[global-file]: New variable. [channels]: Honor it. * doc/guix.texi (Invoking guix pull): Document it.
2019-10-26services: gdm: Add 'debug?' configuration field.Timothy Sample
* gnu/services/xorg.scm (<gdm-configuration>)[debug?]: New field. (gdm-configuration-file): Use it. * doc/guix.texi: Document it.
2019-10-25doc: cookbook: Use "@lisp" for Scheme snippets.Ludovic Courtès
* doc/guix-cookbook.texi: Use @lisp for Scheme snippets instead of "@example scheme". This allows for syntax highlighting of the HTML output.
2019-10-24doc: Add "Guix Profiles in Practice" to the cookbook.Pierre Neidhardt
* doc/guix-cookbook.texi (Advanced package management): New chapter. * doc/guix-cookbook.texi (Guix Profiles in Practice): New section.
2019-10-23cve: Rewrite to read the JSON feed instead of the XML feed.Ludovic Courtès
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.
2019-10-22machine: digital-ocean: Rename 'enable-ipv6' to 'enable-ipv6?'.Ludovic Courtès
* 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.
2019-10-22machine: Implement 'digital-ocean-environment-type'.Jakob L. Kreuze
* 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>
2019-10-22doc: Use the right title in HTML indices for the cookbook.Ludovic Courtès
* doc/build.scm (html-manual-indexes): Add #:title. [build]: Replace "GNU Guix Reference Manual" by references to TITLE.
2019-10-21services: inputattach: Add 'baud-rate' parameter.Tim Gesthuizen
* 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>
2019-10-21doc: More responsive online manual.Julien Lepiller
* doc/build.scm (%makeinfo-html-options): Add viewport to all generated html pages for better mobile device support.
2019-10-21doc: Add support for "guix-cookbook.texi" to 'build.scm'.Ludovic Courtès
* doc/build.scm (%manual): New variable. (html-manual): #:manual now defaults to %MANUAL. [build]: Define 'language->texi-file-name' and use it. Filter out items of LANGUAGES that lack a .texi file. (pdf-manual, html-manual-indexes, pdf+html-manual): #:manual now defaults to %MANUAL.
2019-10-21services: sddm: Deprecate 'sddm-service' procedure.Ludovic Courtès
* gnu/services/sddm.scm (sddm-service): Mark as deprecated. * doc/guix.texi (X Window): Document 'sddm-service-type' and 'sddm-configuration'.