summaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Collapse)Author
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'.
2019-10-18Fix documentation of delete_after in the getmail service.Florian Pelz
* doc/guix.texi (Getmail service): Remove the word `not'. * gnu/services/getmail.scm (getmail-options-configuration): Ditto.
2019-10-17doc: Remove 'maintainers' field from package documentation.Christopher Baines
The field itself was removed in 154f1f0937754fafac0c6288dd458b66b332e6bb. * doc/guix.texi (package Reference): Remove 'maintainers' field.
2019-10-11gnu: Add nsis-x86_64 and nsis-i686.Carl Dong
* guix/build-system/scons.scm (scons-build): Add build-targets and install-targets parameters. * guix/build/scons-build-system.scm (build, install): Adjust accordingly. * doc/guix.texi (Build Systems): Document it. * gnu/packages/installers.scm: New file, (make-nsis): New procedure, (nsis-x86_64, nsis-i686): New variables. * gnu/packages/patches/nsis-env-passthru.patch: New file. * gnu/local.mk (dist_patch_DATA, GNU_SYSTEM_MODULES): Adjust accordingly.
2019-10-06Merge branch 'master' into core-updatesRicardo Wurmus
2019-10-04services: httpd: Fix virtual-host doc and config.Jan Nieuwenhuizen
* doc/guix.texi (Web Services): Fix httpd-virtualhost examples. * gnu/services/web.scm (httpd-process-extensions): Add missing newline separator.
2019-10-01import: crate: Add '--recursive'.Martin Becze
* guix/scripts/import/crate.scm (show-help, guix-import-crate): Add '--recursive'. * doc/guix.texi (Invoking guix import): Mention '--recursive'. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
2019-10-01Merge branch 'master' into core-updatesLudovic Courtès
2019-09-29doc: Add a 'Upgrading Guix' section to the 'Installation' chapter.Maxim Cournoyer
This follows a discussion regarding issue #36785 (see: https://bugs.gnu.org/36785). * doc/guix.texi (Upgrading Guix): New section. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
2019-09-28doc: Don't support a risky mix of Guix & Nix.Tobias Geerinckx-Rice
* doc/guix.texi (Requirements): Remove instructions for sharing a store and/or a daemon with Nix.
2019-09-27Merge branch 'master' into core-updatesMarius Bakke
2019-09-26guix package: Add '--list-profiles'.Ludovic Courtès
* guix/scripts/package.scm (show-help, %options): Add '--list-profiles'. (process-query): Honor it. * tests/guix-package.sh: Add test.
2019-09-26doc: Do not comment out closing parens in Android examples.Ludovic Courtès
* doc/guix.texi (Base Services): Arrange so that closin parens are not commented out.
2019-09-26doc: Add missing paren in CPE example.Ludovic Courtès
* doc/guix.texi (Invoking guix lint): Add missing paren in 'cpe-name' example.
2019-09-26doc: Add missing parens in inetd example.Ludovic Courtès
* doc/guix.texi (Networking Services): Add missing parens in inetd service example.
2019-09-26doc: Fix syntax of Varnish example.Ludovic Courtès
* doc/guix.texi (Web Services): Escape nested string in '%gnu-mirror' variable definition. Adjust indentation.
2019-09-25doc: Avoid @verbatiminclude for Scheme snippets.Ludovic Courtès
* doc/guix.texi (Invoking guix package): Use @include instead of @verbatiminclude. (Additional Build Options): Likewise.
2019-09-25doc: Fix installing Guix in VMBrice Waegeneire
* doc/guix.texi (Installing Guix in a Virtual Machine): Pass "order=d" to '-boot' option. Use "-drive media=cdrom" for the ISO image. Remove paragraph about ordering and the boot menu. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2019-09-25doc: Support paren matching via CSS hover.Ludovic Courtès
* doc/build.scm (syntax-highlighted-html)[build](pair-open/close) (highlights->sxml*): New procedures. (syntax-highlight): Use 'highlights->sxml*'.
2019-09-25services: Add the Guix Data Service.Christopher Baines
* gnu/services/guix.scm: New file. * gnu/tests/guix.scm: New file. * gnu/local.mk (GNU_SYSTEM_MODULES): Add both new files. * doc/guix.texi (Guix Services): New section documenting the Guix Data Service.
2019-09-24Merge branch 'master' into core-updatesLudovic Courtès
2019-09-24doc: Remove more ‘guixsd’ remnants.Tobias Geerinckx-Rice
* doc/guix.texi (Installing Guix in a VM): Use ‘guix-system.img’ as image file name.
2019-09-23doc: Fix typo.Tobias Geerinckx-Rice
* doc/guix.texi (Build Systems): Fix/spoil ‘libary’ typo/joke.
2019-09-23doc: Explain that '--profile' expects a file name.Ludovic Courtès
* doc/guix.texi (Invoking guix package): Explain that the argument to --profile is a file name.
2019-09-23pull: Display channel news.Ludovic Courtès
* guix/scripts/pull.scm (display-news-entry) (display-channel-specific-news): New procedures. (display-channel-news): Call it. (display-new/upgraded-packages): Adjust hint message. * doc/guix.texi (Invoking guix pull): Mention it.
2019-09-23channels: Allow news entries to refer to a tag.Ludovic Courtès
Suggested by Ricardo Wurmus <rekado@elephly.net>. * guix/channels.scm (<channel-news-entry>)[tag]: New field. (sexp->channel-news-entry): Accept either 'commit' or 'tag' in 'entry' forms. (resolve-channel-news-entry-tag): New procedure. (channel-news-for-commit): Move 'with-repository' form one level higher. Call 'resolve-channel-news-entry-tag' on all the news entries. * guix/tests/git.scm (populate-git-repository): Add clause for 'tag'. * tests/channels.scm ("channel-news, one entry"): Create a tag and add an entry with a tag. Check that the tag is resolved and also visible in the <channel-news-entry> record. * doc/guix.texi (Channels): Mention tags in news entries.
2019-09-23channels: Add support for a news file.Ludovic Courtès
* guix/channels.scm (<channel-metadata>)[news-file]: New field. (read-channel-metadata): Set the 'news-file' field. (read-channel-metadata-from-source): Likewise. (<channel-news>, <channel-news-entry>): New record types. (sexp->channel-news-entry, read-channel-news) (channel-news-for-commit): New procedures. * guix/tests/git.scm (populate-git-repository): For 'add', allow CONTENTS to be a procedure. * tests/channels.scm ("channel-news, no news") ("channel-news, one entry"): New tests. * doc/guix.texi (Channels): Document it.
2019-09-21guix package: Add 'guix show' alias.zimoun
* guix/scripts/show.scm: New file. * Makefile.am (MODULES): Add it. * po/guix/POTFILES.in: Add it. * tests/guix-package-aliases.sh: Add test. * doc/guix.texi (Invoking guix package): Document it and use it in a example. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2019-09-18scripts: pull: Add options for generation managementKonrad Hinsen
* guix/scripts/pull.scm (%options) Add --roll-back, --switch-generation, --delete-generations (process-generation-change): New function (guix-pull): Execute generation management operations * doc/guix.texi: Document the generation management operations Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2019-09-18doc: Mention the "repository name" for 'guix pack -f docker'.Ludovic Courtès
This is a followup to 0074844366381e3056d09492b8b437836c7adb61. * doc/guix.texi (Invoking guix pack): Mention the repository name.
2019-09-18services: Add nftables-service-type.宋文武
* gnu/services/networking.scm (%default-nftables-ruleset): New variable. (<nftables-configuration>): New record type. (nftables-shepherd-service): New procedure. (nftables-service-type): New service type. * doc/guix.texi (Networking Services): Document it.
2019-09-18doc: Add Guix Cookbook.Ricardo Wurmus
* .gitignore: Update ignore list. * Makefile.am (assert-no-store-file-names): Exclude the cookbook. * bootstrap: Generate po files for cookbook translations. * doc/guix-cookbook.texi: New file. * doc/local.mk (info_TEXINFOS): Add it; add a rule to build cookbook translations. * po/doc/local.mk (DOC_COOKBOOK_PO_FILES): New variable. (EXTRA_DIST): Add cookbook pot file and po files. (doc-po-update-cookbook-%): New target. (doc-pot-update): Also update cookbook pot file. (doc-po-update): Also update cookbook po files.
2019-09-17Merge branch 'master' into core-updatesLudovic Courtès
2019-09-16services: certbot: Add --manual-public-ip-logging-ok for manual challengesCarlo Zancanaro
* gnu/services/certbot.scm (certbot-command): Add --manual-public-ip-logging-ok flag to the certbot command when doing a manual challenge. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2019-09-11doc: Actually suggest ‘fc-cache -r’.Tobias Geerinckx-Rice
A follow-up commit to 0cd3e99d64081e958919845ddd01ae8d2fb2d692. * doc/guix.texi (Application Setup): Fix my own typo.
2019-09-11doc: Run fc-cache verbosely and delete existing caches.Joshua Branson
* doc/guix.texi (Application Setup): Suggest ‘fc-cache -rv’ instead of ‘fc-cache -f’. Signed-off-by: Tobias Geerinckx-Rice <me@tobias.gr>
2019-09-10import: crate: Allow imports of a specific version.Martin Becze
* guix/import/crate.scm (crate->guix-package): Add optional 'version' argument and honor it. * guix/scripts/import/crate.scm (guix-import-crate): Assume the first argument is a spec and destructure it with 'package-name->name+version'. Pass both to 'crate->guix-package'. * doc/guix.texi (Invoking guix import): Document it. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
2019-09-08services: ntp: Support different NTP server types and options.Maxim Cournoyer
* gnu/services/networking.scm (ntp-server-types): New enum. (<ntp-server>): New record type. (ntp-server->string): New procedure. (%ntp-servers): Define in terms of <htp-server> records. Use the first entrypoint server as a pool instead of a list of static servers. This is more resilient since a new server of the pool can be interrogated on every request. Add the 'iburst' options. (ntp-configuration-servers): Define a custom accessor that warns but honors the now deprecated server format. (<ntp-configuration>): Use it. (%openntpd-servers): New variable, (<openntpd-configuration>): Use it, as a pool ('servers' field) instead of a regular server. * tests/networking.scm: New file. * Makefile.am (SCM_TESTS): Register it. * doc/guix.texi: Update documentation.
2019-09-08doc: Add index to find 'ntpd'.Maxim Cournoyer
* doc/guix.texi (Networking Services): Add @cindex to find 'ntpd'
2019-09-08services: ntp: Allow large adjustment by default.Maxim Cournoyer
This is documented as best practice in `man ntpd', and is required to allow the date to be set correctly when traveling (without having to manually update the hardware clock in the BIOS/UEFI). * gnu/services/networking.scm (<ntp-server>)[allow-large-adjustment?]: Set the default value to #t. * doc/guix.texi (Networking Services): Update documentation.
2019-09-08doc: Fix verb conjugation.Matthew Kraai
* doc/guix.texi (Invoking guix pull): Change "run" to "ran". Signed-off-by: Tobias Geerinckx-Rice <me@tobias.gr>