aboutsummaryrefslogtreecommitdiff
path: root/doc/guix.texi
Commit message (Collapse)AuthorAge
* guix package: Add 'guix search' alias.Ludovic Courtès2019-04-29
| | | | | | | | | * 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.
* file-systems: Support the 'no-atime' flag.rendaw2019-04-29
| | | | | | | | | * 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>
* doc: Remove traces of "Guix System Distribution".Ludovic Courtès2019-04-29
| | | | | | * doc/guix.texi (Invoking guix package) (Official Substitute Server, System Configuration): Replace "the Guix System Distribution" by "Guix System".
* doc: Add 'SUBSTITUTE-URL' variable.Ludovic Courtès2019-04-29
| | | | | * doc/guix.texi (SUBSTITUTE-SERVER): New variable. (Invoking guix weather): Use it.
* guix package: Add 'install', 'remove', and 'upgrade' aliases.Ludovic Courtès2019-04-29
| | | | | | | | | | | | | | | | * 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".
* doc: Duplicate recommendation about 'guix-install.sh'.Ludovic Courtès2019-04-28
| | | | | | | 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.
* doc: Remove outdated paragraph in "Binary Installation".Ludovic Courtès2019-04-27
| | | | | | | This is a followup to e9926f80c6553fde50ce1fcfd38d6370f841efd2. * doc/guix.texi (Binary Installation): Remove paragraph about not removing 'guix' from root's profile.
* doc: Suggest 1G of RAM for the VM image.Ludovic Courtès2019-04-27
| | | | * doc/guix.texi (Running Guix in a VM): Suggest -m 1024.
* doc: Update bit about SSH in the VM.Ludovic Courtès2019-04-27
| | | | | | | * 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'.
* doc: Recommend virtio-blk to access the VM image.Ludovic Courtès2019-04-27
| | | | | * doc/guix.texi (Running Guix in a VM): Recommend virtio-blk to access the image.
* gnu: knot: Add configuration fields.Julien Lepiller2019-04-27
| | | | | | | | * 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.
* doc: Use ftp.gnu.org for downloads.Ludovic Courtès2019-04-26
| | | | | | | 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.
* doc: Add 'BASE-URL' variable.Ludovic Courtès2019-04-26
| | | | | | * 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.
* system: Provide a new VM image configuration.Ludovic Courtès2019-04-26
| | | | | * gnu/system/examples/vm-image.tmpl: Rewrite. * doc/guix.texi (Running Guix in a VM): Adjust accordingly.
* gnu: knot-service: Add includes field in configuration.Julien Lepiller2019-04-25
| | | | | | | * 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.
* gnu: certbot: Add support for manual plugin.Julien Lepiller2019-04-25
| | | | | | | * 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.
* doc: Refer to the es and zh_CN translations.Ludovic Courtès2019-04-24
| | | | * doc/guix.texi (Top): Mention Simplified Chinese and Spanish.
* services: shepherd: Support one-shot services.Ludovic Courtès2019-04-23
| | | | | | * 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.
* system: Change default kernel-arguments to '("quiet").Christopher Baines2019-04-22
| | | | | | | | | | 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.
* pull: Add '--news'.Ludovic Courtès2019-04-22
| | | | | | | | | | | | | 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'.
* guix build: Accept multiple '-s' options.Ludovic Courtès2019-04-19
| | | | | | | | | | | * 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.
* pull: '--url', '--commit', and '--branch' apply to the 'guix' channel.Ludovic Courtès2019-04-17
| | | | | | | | 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.
* doc: Replace misuses of @var by @code.Ludovic Courtès2019-04-15
| | | | | | * 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.
* doc: Document 'this-package' and 'this-operating-system'.Ludovic Courtès2019-04-15
| | | | | * doc/guix.texi (package Reference): Document 'this-package'. (operating-system Reference): Document 'this-operating-system'.
* system: Add 'label' field to <operating-system>.Ludovic Courtès2019-04-15
| | | | | | | | * 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.
* doc: Fix location of fprintd-service-type.Tobias Geerinckx-Rice2019-04-14
| | | | * doc/guix.texi (Miscellaneous Services): Correct module name.
* doc: Fix typo.Danny Milosavljevic2019-04-14
| | | | | | Follow-up to 96ef8565281c511b119e0dd7799337d67f9efab3. * doc/guix.texi (Limitations): Fix typo.
* doc: Strip the "Limitations" section.Ludovic Courtès2019-04-12
| | | | | * doc/guix.texi (Limitations): Strip the paragraph about not being production-ready. Remove the number of packages.
* Add (guix build-system linux-module).Danny Milosavljevic2019-04-11
| | | | | | | * 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.
* doc: Fix typo.Tobias Geerinckx-Rice2019-04-11
| | | | * doc/guix.texi (Bootloader Configuration): Fix ‘fow now’.
* guix gc: Add '--delete-generations'.Ludovic Courtès2019-04-10
| | | | | | | | | | * 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.
* guix gc: Add '--list-roots'.Ludovic Courtès2019-04-10
| | | | | | | | * 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.
* doc: Fix syntax of cross-manual references.Ludovic Courtès2019-04-07
| | | | | | | This is a followup to 412e6396bbb8b398e8a94427db50271e47db610f. * doc/guix.texi (Mail Services): Fix syntax of cross-references to the Mailutils manual.
* services: Add 'imap4d-service-type'.宋文武2019-04-07
| | | | | | | * 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.
* services: console-keymap: Deprecate.Ludovic Courtès2019-04-05
| | | | | * gnu/services/base.scm (console-keymap-service): Mark as deprecated. * doc/guix.texi (Base Services): Remove its documentation.
* doc: Explain how to change the keyboard layout at run time.Ludovic Courtès2019-04-05
| | | | | * doc/guix.texi (Keyboard Layout): Mention GNOME's "Region & Language", setxkbmap, and loadkeys.
* services: xorg: Add 'set-xorg-configuration'.Ludovic Courtès2019-04-05
| | | | | | | | * 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.
* environment: '-C' creates namespaces where the user is not root.Ludovic Courtès2019-04-02
| | | | | | | | | * 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.
* doc: Document 'gdm-service-type'.Ludovic Courtès2019-03-31
| | | | | | | * 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.
* packages: Remove 'self-native-input?' field.Ludovic Courtès2019-03-30
| | | | | | | | 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?'.
* doc: Fix invalid uses of @ref.Ludovic Courtès2019-03-29
| | | | | * doc/guix.texi (Invoking guix pull): Use @xref instead of @ref at the beginning of sentences.
* services: desktop: Switch to GDM.Ludovic Courtès2019-03-28
| | | | | | | | | * 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.
* services: Deprecate 'xfce-desktop-service'.Ludovic Courtès2019-03-27
| | | | | | | | | | * 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.
* services: Deprecate 'gnome-desktop-service'.Ludovic Courtès2019-03-27
| | | | | | | | | | * 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.
* system: Add 'essential-services' field to <operating-system>.Ludovic Courtès2019-03-25
| | | | | | | | | | | | | | | | | | * 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'.
* accounts: Add default value for the 'home-directory' field of <user-account>.Ludovic Courtès2019-03-25
| | | | | | | | | | | | | | | | | | * 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.
* doc: Document keyboard layout.Ludovic Courtès2019-03-24
| | | | | | * doc/guix.texi (Keyboard Layout): New node. (Bootloader Configuration): Remove examples and refer to it. (X Window): Add cross-reference.
* system: Initialize console keyboard layout in the initrd.Ludovic Courtès2019-03-24
| | | | | | | | | | | | | | | | | Partially fixes <https://bugs.gnu.org/25453>. * gnu/system.scm (<operating-system>)[keyboard-layout]: New field. (operating-system-initrd-file): Pass #:keyboard-layout to MAKE-INITRD. * gnu/system/linux-initrd.scm (raw-initrd): Add #:keyboard-layout. Pass #:keymap-file to 'boot-system'. (base-initrd): Add #:keyboard-layout. [helper-packages]: Add LOADKEYS-STATIC when KEYBOARD-LAYOUT is true. Pass #:keyboard-layout to 'raw-initrd'. * gnu/build/linux-boot.scm (boot-system): Add #:keymap-file and honor it. * doc/guix.texi (operating-system Reference): Document the 'keyboard-layout' field. (Initial RAM Disk): Update 'raw-initrd' and 'base-initrd' documentation.
* services: xorg: Add a 'keyboard-layout' field in <xorg-configuration>.Ludovic Courtès2019-03-24
| | | | | | | | | | * gnu/services/xorg.scm (<xorg-configuration>)[keyboard-layout]: New field. (xorg-configuration->file)[input-class-section]: New procedure. Use it. * doc/guix.texi (X Window): Document 'keyboard-layout' field. Co-authored-by: nee <nee-git@hidamari.blue>
* services: sddm, slim, gdm: Take an <xorg-configuration> record.Ludovic Courtès2019-03-24
| | | | | | | | | | | | | | * gnu/services/sddm.scm (<sddm-configuration>)[xorg-server-path] [xserver-arguments]: Remove. [xorg-configuration]: New field. (sddm-configuration-file): Adjust accordingly. * gnu/services/xorg.scm (<slim-configuration>)[startx]: Remove. [xorg-configuration]: New field. (slim-shepherd-service, slim-service): Adjust accordingly. (<gdm-configuration>)[x-server]: Remove. [xorg-configuration]: New field. (gdm-shepherd-service, gdm-service): Adjust accordingly. * doc/guix.texi (X Window): Update accordingly.