summary refs log tree commit diff
path: root/doc/guix.texi
AgeCommit message (Collapse)Author
2019-05-04doc: Adjust cross-references for GNU triplets.Ludovic Courtès
* doc/guix.texi (Defining Packages): Reference to 'autoconf' instead of obsolete 'configure' manual for triplets. (Additional Build Options): Adjust 'autoconf' node name.
2019-05-04doc: Provide the actual URL to the VM image.Ludovic Courtès
Fixes <https://bugs.gnu.org/35537>. Reported by Andy Tai <atai@atai.org>. * doc/guix.texi (Running Guix in a VM): Use @url and provide the actual URL, without @var{system}.
2019-05-04doc: Add note about <https://bugs.gnu.org/35541>.Ludovic Courtès
* doc/guix.texi (Guided Graphical Installation): Add node about <https://bugs.gnu.org/35541>. (System Installation): Refer to it.
2019-05-01build: Change default substitute server to "ci.guix.gnu.org".Ludovic Courtès
* config-daemon.ac: Replace "ci.guix.info" with "ci.guix.gnu.org". * doc/guix.texi (SUBSTITUTE-SERVER): Likewise. * etc/substitutes/ci.guix.gnu.org.pub: New file. * Makefile.am (dist_pkgdata_DATA): Add it. * guix/scripts/build.scm (%default-log-urls): Update. * guix/scripts/substitute.scm (%default-substitute-urls): Likewise. * guix/store.scm (%default-substitute-urls): Likewise. * guix/self.scm (miscellaneous-files): Add "ci.guix.gnu.org".
2019-04-29guix package: Add 'guix search' alias.Ludovic Courtès
* guix/scripts/search.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 couple of examples.
2019-04-29file-systems: Support the 'no-atime' flag.rendaw
* guix/build/syscalls.scm (MS_NOATIME): New variable. * gnu/build/file-systems.scm (mount-flags->bit-mask): Support it. * doc/guix.texi (File Systems): Document it and add cross-references to the relevant documentation. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
2019-04-29doc: Remove traces of "Guix System Distribution".Ludovic Courtès
* doc/guix.texi (Invoking guix package) (Official Substitute Server, System Configuration): Replace "the Guix System Distribution" by "Guix System".
2019-04-29doc: Add 'SUBSTITUTE-URL' variable.Ludovic Courtès
* doc/guix.texi (SUBSTITUTE-SERVER): New variable. (Invoking guix weather): Use it.
2019-04-29guix package: Add 'install', 'remove', and 'upgrade' aliases.Ludovic Courtès
* guix/scripts/install.scm, guix/scripts/remove.scm, guix/scripts/upgrade.scm, tests/guix-package-aliases.sh: New files. * Makefile.am (MODULES, SH_TESTS): Add them. * po/guix/POTFILES.in: Add them. * guix/scripts/package.scm (guix-package): Split with... (guix-package*): ... this. New procedure. * doc/guix.texi (Invoking guix package): Document them. (Binary Installation, Application Setup, Package Management) (Packages with Multiple Outputs, Package Modules) (X.509 Certificates, Installing Debugging Files): Use 'guix install' in simple examples. * etc/completion/bash/guix (_guix_complete): Handle "install", "remove", and "upgrade".
2019-04-28doc: Duplicate recommendation about 'guix-install.sh'.Ludovic Courtès
Since our web site points to "Binary Installation", it's best to have that note there. * doc/guix.texi (Binary Installation): Add note about guix-install.sh.
2019-04-27doc: Remove outdated paragraph in "Binary Installation".Ludovic Courtès
This is a followup to e9926f80c6553fde50ce1fcfd38d6370f841efd2. * doc/guix.texi (Binary Installation): Remove paragraph about not removing 'guix' from root's profile.
2019-04-27doc: Suggest 1G of RAM for the VM image.Ludovic Courtès
* doc/guix.texi (Running Guix in a VM): Suggest -m 1024.
2019-04-27doc: Update bit about SSH in the VM.Ludovic Courtès
* doc/guix.texi (Running Guix in a VM): Remove mentions of 'lsh-server'; mention 'openssh-service-type' and add a cross-reference. * gnu/system/examples/vm-image.tmpl (services): Add a commented-out line for 'openssh-service-type'.
2019-04-27doc: Recommend virtio-blk to access the VM image.Ludovic Courtès
* doc/guix.texi (Running Guix in a VM): Recommend virtio-blk to access the image.
2019-04-27gnu: knot: Add configuration fields.Julien Lepiller
* gnu/services/dns.scm (knot-zone-configuration)[zonefile-load] [journal-content, max-journal-usage, max-journal-depth, max-zone-size]: New fields. (knot-zone-config): Serialize them. * doc/guix.texi (DNS Services): Document them.
2019-04-26doc: Use ftp.gnu.org for downloads.Ludovic Courtès
From now on, everything will be uploaded to ftp.gnu.org instead of alpha.gnu.org. * doc/guix.texi (BASE-URL): Switch to ftp.gnu.org.
2019-04-26doc: Add 'BASE-URL' variable.Ludovic Courtès
* doc/guix.texi (BASE-URL): New variable. (Binary Installation, USB Stick and DVD Installation) (Running Guix in a VM): Use it instead of hard-coded URL.
2019-04-26system: Provide a new VM image configuration.Ludovic Courtès
* gnu/system/examples/vm-image.tmpl: Rewrite. * doc/guix.texi (Running Guix in a VM): Adjust accordingly.
2019-04-25gnu: knot-service: Add includes field in configuration.Julien Lepiller
* gnu/services/dns.scm (knot-configuration): Add includes field. (verify-knot-configuration): Check includes content. (knot-config-file): Serialize includes. * doc/guix.texi (DNS Services): Document it.
2019-04-25gnu: certbot: Add support for manual plugin.Julien Lepiller
* gnu/services/certbot.scm (certificate-configuration): Add challenge, auth-hook and cleanup-hook fields. (certbot-command): Use them. * doc/guix.texi (Certificate Services): Document them.
2019-04-24doc: Refer to the es and zh_CN translations.Ludovic Courtès
* doc/guix.texi (Top): Mention Simplified Chinese and Spanish.
2019-04-23services: shepherd: Support one-shot services.Ludovic Courtès
* gnu/services/shepherd.scm (<shepherd-service>)[one-shot?]: New field. (shepherd-service-file): Pass #:one-shot? to the <service> constructor. * doc/guix.texi (Shepherd Services): Document it.
2019-04-22system: Change default kernel-arguments to '("quiet").Christopher Baines
This improves the readability of the boot process, especially when using full disk encryption where you're required to enter the passphrase at a particular point. * gnu/system.scm (<operating-system>)[kernel-arguments]: Change the default to '("quiet"). * doc/guix.texi (operating-system Reference): Document this change.
2019-04-22pull: Add '--news'.Ludovic Courtès
Suggested by Tobias Geerinckx-Rice <me@tobias.gr>. * guix/scripts/pull.scm (%options, show-help): Add '--news'. (display-profile-news): Add #:current-is-newer? and #:concise?. Honor them. (build-and-install): Pass #:concise? #t. (display-new/upgraded-packages)[concise/max-item-count]: New variable. Add call to 'display-hint'. (process-query): Add clause for 'display-news'. * doc/guix.texi (Invoking guix pull): Add '--news'.
2019-04-19guix build: Accept multiple '-s' options.Ludovic Courtès
* guix/scripts/build.scm (%default-options): Remove 'system'. (%options) <--system>: Keep previous occurrences of 'system in RESULT. (options->derivations)[system]: Remove. [systems, things-to-build]: New variables. [compute-derivation]: New procedure. Iterate on all of SYSTEMS to compute the derivations of THINGS-TO-BUILD. * tests/guix-build.sh: Add test for one and multiple '-s' flags. * doc/guix.texi (Additional Build Options): Document this behavior.
2019-04-17pull: '--url', '--commit', and '--branch' apply to the 'guix' channel.Ludovic Courtès
Suggested by pkill9 <pkill9@runbox.com>. * guix/scripts/pull.scm (channel-list): Apply REF and URL to the 'guix' channel. * doc/guix.texi (Invoking guix pull): Adjust accordingly.
2019-04-15doc: Replace misuses of @var by @code.Ludovic Courtès
* doc/guix.texi (Hardware Considerations, Service Types and Services) (Service Reference, Shepherd Services, Security Updates): Use @code instead of @var for things that are not meta-syntactic variables.
2019-04-15doc: Document 'this-package' and 'this-operating-system'.Ludovic Courtès
* doc/guix.texi (package Reference): Document 'this-package'. (operating-system Reference): Document 'this-operating-system'.
2019-04-15system: Add 'label' field to <operating-system>.Ludovic Courtès
* gnu/system.scm (<operating-system>)[label]: New field. (operating-system-default-label): New procedure. (operating-system-boot-parameters): Use it instead of 'kernel->boot-label'. * doc/guix.texi (operating-system Reference): Document it.
2019-04-14doc: Fix location of fprintd-service-type.Tobias Geerinckx-Rice
* doc/guix.texi (Miscellaneous Services): Correct module name.
2019-04-14doc: Fix typo.Danny Milosavljevic
Follow-up to 96ef8565281c511b119e0dd7799337d67f9efab3. * doc/guix.texi (Limitations): Fix typo.
2019-04-12doc: Strip the "Limitations" section.Ludovic Courtès
* doc/guix.texi (Limitations): Strip the paragraph about not being production-ready. Remove the number of packages.
2019-04-11Add (guix build-system linux-module).Danny Milosavljevic
* guix/build/linux-module-build-system.scm: New file. * guix/build-system/linux-module.scm: New file. * doc/guix.texi (Build Systems): Document it. * Makefile.am (MODULES): Add them.
2019-04-11doc: Fix typo.Tobias Geerinckx-Rice
* doc/guix.texi (Bootloader Configuration): Fix ‘fow now’.
2019-04-10guix gc: Add '--delete-generations'.Ludovic Courtès
* guix/scripts/gc.scm (show-help, %options): Add '--delete-generations'. Change '--delete' shorthand to '-D'. (delete-old-generations): New procedure. (guix-gc)[delete-generations]: New procedure. Call it when ACTION is 'collect-garbage' and OPTS contains 'delete-generations. * doc/guix.texi (Invoking guix gc): Document it.
2019-04-10guix gc: Add '--list-roots'.Ludovic Courtès
* guix/scripts/gc.scm (show-help, %options): Add '--list-roots'. (guix-gc)[list-roots]: New procedure. Handle '--list-roots'. * tests/guix-gc.sh: Test it. * doc/guix.texi (Invoking guix gc): Document it.
2019-04-07doc: Fix syntax of cross-manual references.Ludovic Courtès
This is a followup to 412e6396bbb8b398e8a94427db50271e47db610f. * doc/guix.texi (Mail Services): Fix syntax of cross-references to the Mailutils manual.
2019-04-07services: Add 'imap4d-service-type'.宋文武
* gnu/services/mail.scm (<imap4d-configuration>): New record type. (imap4d-shepherd-service): New procedure. (%default-imap4d-config-file, imap4d-service-type): New variables. * gnu/services/mail.scm (Mail Services): Document it.
2019-04-05services: console-keymap: Deprecate.Ludovic Courtès
* gnu/services/base.scm (console-keymap-service): Mark as deprecated. * doc/guix.texi (Base Services): Remove its documentation.
2019-04-05doc: Explain how to change the keyboard layout at run time.Ludovic Courtès
* doc/guix.texi (Keyboard Layout): Mention GNOME's "Region & Language", setxkbmap, and loadkeys.
2019-04-05services: xorg: Add 'set-xorg-configuration'.Ludovic Courtès
* gnu/services/xorg.scm (gdm-service-type)[compose, extend]: New fields. (set-xorg-configuration): New procedure. * doc/guix.texi (Keyboard Layout): Use it. (X Window): Document it. * gnu/system/examples/desktop.tmpl: Add 'keyboard-layout' fields.
2019-04-02environment: '-C' creates namespaces where the user is not root.Ludovic Courtès
* guix/scripts/environment.scm (launch-environment/container): Add UID and GID. Use them in PASSWD and GROUPS. Pass them as #:guest-uid and #:guest-gid to 'call-with-container'. * tests/guix-environment-container.sh: Test the inner UID. In '--user' test, replace hard-coded 0 with 1000. * doc/guix.texi (Invoking guix environment): Adjust accordingly.
2019-03-31doc: Document 'gdm-service-type'.Ludovic Courtès
* doc/guix.texi (X Window): Document 'gdm-service-type' and 'gdm-configuration'. Take description of '.desktop' files from the 'slim-service-type' description. * gnu/services/xorg.scm (gdm-service): Remove outdated comment.
2019-03-30packages: Remove 'self-native-input?' field.Ludovic Courtès
This field has become unnecessary with the addition of 'this-package'. * guix/packages.scm (<package>)[self-native-input?]: Remove. (package->bag): Adjust accordingly. * doc/guix.texi (package Reference): Remove 'self-native-input?'.
2019-03-29doc: Fix invalid uses of @ref.Ludovic Courtès
* doc/guix.texi (Invoking guix pull): Use @xref instead of @ref at the beginning of sentences.
2019-03-28services: desktop: Switch to GDM.Ludovic Courtès
* gnu/services/desktop.scm (%desktop-services): Replace SLIM-SERVICE-TYPE instance with an instance of GDM-SERVICE-TYPE. * doc/guix.texi (Keyboard Layout): Change example to mention GDM-SERVICE-TYPE. (X Window): Mention GDM. (Desktop Services): Adjust references to SLiM.
2019-03-27services: Deprecate 'xfce-desktop-service'.Ludovic Courtès
* gnu/services/desktop.scm (xfce-desktop-service-type)[default-value] [description]: New fields. (xfce-desktop-service): Deprecate. * gnu/system/examples/desktop.tmpl: Use the (service …) form. * gnu/installer/services.scm (%desktop-environments): Add TODO comment. * doc/guix.texi (Desktop Services): Adjust accordingly, and fix spelling of "Xfce" throughout.
2019-03-27services: Deprecate 'gnome-desktop-service'.Ludovic Courtès
* gnu/services/desktop.scm (gnome-desktop-service-type)[default-value]: New field. (gnome-desktop-service): Deprecate. * gnu/installer/services.scm (%desktop-environments): Use the (service …) form for GNOME. * gnu/system/examples/desktop.tmpl: Likewise. * doc/guix.texi (Desktop Services): Adjust accordingly.
2019-03-25system: Add 'essential-services' field to <operating-system>.Ludovic Courtès
* gnu/system.scm (<operating-system>)[essential-services]: New field. (operating-system-directory-base-entries): Remove #:container? keyword and keep only the not-container branch. (essential-services): Likewise. (operating-system-services): Likewise, and call 'operating-system-essential-services' instead of 'essential-services'. (operating-system-activation-script): Remove #:container?. (operating-system-boot-script): Likewise. (operating-system-derivation): Likewise. * gnu/system/linux-container.scm (container-essential-services): New procedure. (containerized-operating-system): Use it and set the 'essential-services' field. (container-script): Remove call to 'operating-system-derivation'. * gnu/system/vm.scm (system-docker-image): Likewise. * doc/guix.texi (operating-system Reference): Document 'essential-services'.
2019-03-25accounts: Add default value for the 'home-directory' field of <user-account>.Ludovic Courtès
* gnu/system/accounts.scm (<user-account>)[home-directory]: Mark as thunked and add a default value. (default-home-directory): New procedure. * doc/guix.texi (User Accounts): Remove 'home-directory' from example. * gnu/system/examples/bare-bones.tmpl: Likewise. * gnu/system/examples/beaglebone-black.tmpl: Likewise. * gnu/system/examples/desktop.tmpl: Likewise. * gnu/system/examples/docker-image.tmpl: Likewise. * gnu/system/examples/lightweight-desktop.tmpl: Likewise. * gnu/system/install.scm (installation-os): Likewise. * gnu/tests.scm (%simple-os): Likewise. * gnu/tests/install.scm (%minimal-os, %minimal-os-on-vda): (%separate-home-os, %encrypted-root-os, %btrfs-root-os): Likewise. * tests/accounts.scm ("allocate-passwd") ("allocate-passwd with previous state"): Likewise.