aboutsummaryrefslogtreecommitdiff
path: root/doc/guix.texi
Commit message (Collapse)AuthorAge
* services: Make 'nscd-service' configurable; cache hosts/services by default.Ludovic Courtès2014-12-14
| | | | | | | | | | | | | | | Before that, as it was given an empty configuration file, nscd would actually have all its caches disabled. * gnu/services/base.scm (<nscd-configuration>, <nscd-cache>): New record types. (%nscd-default-caches, %nscd-default-configuration): New variables. (nscd.conf-file): New procedure. (nscd-service): Add 'config' parameter. Use 'nscd.conf-file', and pass its result as the '-f' parameter of nscd. * doc/guix.texi (Base Services): Update 'nscd-service' documentation accordingly. Document 'nscd-configuration', 'nscd-cache', '%nscd-default-configuration', and '%nscd-default-caches'.
* doc: Explain how to set the ownership and permissions of /gnu/store.Ludovic Courtès2014-12-09
| | | | | | | | Fixes <http://bugs.gnu.org/19316>. Reported by rekado <rekado@elephly.net>. * doc/guix.texi (Build Environment Setup): Show commands to set the ownership and permissions of /gnu/store.
* doc: Give example uses of 'deco'.Ludovic Courtès2014-12-07
| | | | | | Suggested by Sleep_Walker on #guix. * doc/guix.texi (Services): Add 'deco' examples.
* guix: scripts: Parse $GUIX_BUILD_OPTIONS separately.nebuli2014-12-06
| | | | | | | | | | | | | | | | | | | | Appending to "raw" args broke optional parameters in 'guix package -I' and 'guix package -A', and possibly other places. Therefore, switch to parsing each set of options on its own and append resulting alists together afterwards. * guix/scripts/archive.scm (parse-options-from): Rename from (parse-options) and add explicit argument. New form of (parse-options) using its old algorithm via -from function. * guix/scripts/build.scm: Ditto. * guix/scripts/environment.scm: Ditto. * guix/scripts/package.scm: Ditto. * guix/scripts/system.scm: Ditto. * tests/guix-package.sh: Add test. * doc/guix.texi (Invoking guix build): Make it clear that the options are parsed independently. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
* doc: Adjust misleading 'user-account' example.Ludovic Courtès2014-12-02
| | | | | | | Reported by Sleep_Walker on #guix. * doc/guix.texi (Using the Configuration System): Remove numeric UID and GID from example.
* build-system/glib-or-gtk: Allow specific outputs to be excluded from wrapping.Ludovic Courtès2014-12-01
| | | | | | | | * guix/build/glib-or-gtk-build-system.scm (wrap-all-programs): Add #:glib-or-gtk-wrap-excluded-outputs parameter and honor it. * guix/build-system/glib-or-gtk.scm (glib-or-gtk-build): Add #:glib-or-gtk-wrap-excluded-outputs parameter and pass it in BUILDER. * doc/guix.texi (Build Systems): Mention it.
* guix: scripts: Add GUIX_BUILD_OPTIONS environment handling.nebuli2014-11-30
| | | | | | | | | | | | | | | * doc/guix.texi (Invoking guix build): Mention 'GUIX_BUILD_OPTIONS'. * guix/scripts/archive.scm: (append args (environment-build-options)). * guix/scripts/build.scm: Ditto. * guix/scripts/environment.scm: Ditto. * guix/scripts/package.scm: Ditto. * guix/scripts/system.scm: Ditto. * guix/ui.scm (environment-build-options): New function. * guix/utils.scm (arguments-from-environment-variable): New function. * tests/guix-build.sh: Add tests. * test-env.in: Unset GUIX_BUILD_OPTIONS. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
* daemon: Default to '--cores=0'.Ludovic Courtès2014-11-30
| | | | | | | Suggested by Deck Pickard <deck.r.pickard@gmail.com>. * nix/nix-daemon/guix-daemon.cc (main): Set 'settings.buildCores' to 0. * doc/guix.texi (Invoking guix-daemon): Adjust accordingly.
* doc: Explain that 'file-system' must refer to mapped devices by file name.Ludovic Courtès2014-11-30
| | | | | * doc/guix.texi (File Systems): Clarify what to do when mapped devices are used.
* Revert "system: Add a 'needed-for-boot?' field to 'mapped-device'."Ludovic Courtès2014-11-30
| | | | | | | This reverts commit 3b09332adf7ce8e976a4d117a62c586a53af04aa, which turned out to be a bad idea because we need to have dependency information between the device-mapping service and the file-system service that uses it.
* doc: Improve porting instructions.Ludovic Courtès2014-11-29
| | | | | | * doc/guix.texi (Porting): Move 'glibc-dynamic-linker' paragraph above. Clarify what is meant by updating (gnu packages bootstrap). Mention 'gnu-system.am'.
* system: Add a 'needed-for-boot?' field to 'mapped-device'.Ludovic Courtès2014-11-29
| | | | | | | | | | * gnu/system/file-systems.scm (<mapped-device>)[needed-for-boot?]: New field. * gnu/system.scm (operating-system-user-mapped-devices, operating-system-boot-mapped-devices): Use it instead of trying to guess. Guessing doesn't work when one refers to a partition using its label, for instance. * doc/guix.texi (Mapped Devices): Document 'needed-for-boot?'.
* doc: Update stale references in "Bootstrapping".Ludovic Courtès2014-11-28
| | | | | | * doc/guix.texi (Bootstrapping): Final definitions are in (gnu packages commencement). Change gnu-build-system xref to "Build Systems".
* system: Build system-wide locale definitions.Ludovic Courtès2014-11-27
| | | | | | | | | | | | | | | * gnu/system/locale.scm: New file. * gnu-system.am (GNU_SYSTEM_MODULES): Add it. * gnu/system.scm (<operating-system>)[locale]: Change the default to "en_US.utf8". (operating-system-locale-directory): New procecure. (operating-system-derivation): Use it. * doc/guix.texi (Using the Configuration System): Change example locale to "fr_FR.utf8". (operating-system Reference): Add xref to "Locales". Document 'locale-definitions'. (Locales): New section. * po/guix/POTFILES.in: Add gnu/system.scm.
* guix build: Add '--max-jobs' option.Ludovic Courtès2014-11-25
| | | | | | | | | | | | | Suggested by Deck Pickard <deck.r.pickard@gmail.com>. * guix/scripts/build.scm (show-build-options-help): Document --max-jobs. (set-build-options-from-command-line): Pass #:max-build-jobs. (%standard-build-options): Add --max-jobs. * doc/guix.texi (Invoking guix-daemon): Document the meaning of '--max-jobs 0'. (Invoking guix build): Document --max-jobs, with a reference to "Invoking guix-daemon'.
* doc: Fix syntax errors.Taylan Ulrich Bayırlı/Kammer2014-11-25
| | | | | | | * doc/guix.texi (Package Naming): (Fonts): Remove space between '@foo' and '{'. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: Add detailed node listing.Ludovic Courtès2014-11-24
| | | | * doc/guix.texi (Top): Add @detailmenu.
* doc: Add xrefs to the lsh manual.Ludovic Courtès2014-11-24
| | | | | | | | Suggested by Adam Pribyl <pribyl@lowlevel.cz>. * gnu/services/ssh.scm (lsh-service): Update docstring with xrefs to the lsh manual. Fix typos. * doc/guix.texi (Networking Services): Synchronize.
* doc: Fix typos.Alex Kost2014-11-24
| | | | | * doc/guix.texi (Base Services): Fix 'lsh-service' name. (Networking Services): Fix (gnu services networking) module name.
* install: Add Cryptsetup to the image.Ludovic Courtès2014-11-23
| | | | | | | Reported by Nikita Karetnikov. * gnu/system/install.scm (installation-os)[packages]: Add CRYPTSETUP. * doc/guix.texi (System Installation): Mention it.
* doc: Fix erroneous cross-manual references.Ludovic Courtès2014-11-23
| | | | * doc/guix.texi (User Accounts): Fix cross-references to libc and guile.
* doc: Add a section on naming conventions for font packages.Andreas Enge2014-11-23
| | | | | * doc/guix.texi (Fonts): New section. (Package naming): Reference the new section.
* doc: Fix typos regarding 'lsh-service'.Ludovic Courtès2014-11-21
| | | | | | | | Reported by Adam Pribyl <pribyl@lowlevel.cz>. * doc/guix.texi (Using the Configuration System): Use #:root-login?, not #:allow-root-login?, in example. (Networking Services): Fix module name for ssh.
* guix system: Add '--share' and '--expose' options for 'vm'.Ludovic Courtès2014-11-21
| | | | | | | | | | | * guix/scripts/system.scm (system-derivation-for-action): Add #:mappings parameter. Pass it to 'system-qemu-image/shared-store-script'. (perform-action): Likewise. (show-help): Document --share and --expose. (specification->file-system-mapping): New procedure. (%options): Add --share and --expose. (guix-system): Pass #:mapping to 'perform-action'. * doc/guix.texi (Invoking guix system): Document it.
* doc: Fix misuses of @ref.Ludovic Courtès2014-11-17
| | | | | | | * doc/guix.texi (Invoking guix-daemon, Features, Invoking guix download, Invoking guix refresh, GNU Distribution, Package Modules, Packaging Guidelines, Package Naming): Replace misuses of @ref with @xref or @pxref.
* doc: Suggest using 'guix pull' before 'guix system reconfigure'.Ludovic Courtès2014-11-17
| | | | | * doc/guix.texi (Invoking guix system): Suggest running 'guix pull' before the first use of 'guix system reconfigure'.
* doc: Document --key-download option of 'guix refresh'.Ludovic Courtès2014-11-16
| | | | * doc/guix.texi (Invoking guix refresh): Document --key-download.
* doc: Document "guix import".Ludovic Courtès2014-11-16
| | | | | | | * doc/guix.texi (Requirements): Add xref to "Invoking guix import". (Defining Packages): Likewise. Remove footnote about Nixpkgs imports. (Invoking guix import): New section.
* doc: Fix Hydra URL.Ludovic Courtès2014-11-15
| | | | | | Reported by John Darrington <john@darrington.wattle.id.au>. * doc/guix.texi (Packaging Guidelines): Fix hydra.gnu.org URL.
* doc: Clarify use of the 'password' field for user accounts.Ludovic Courtès2014-11-14
| | | | | | | | | Suggested by Alex Sassmannshausen <alex.sassmannshausen@gmail.com>. * doc/guix.texi (Using the Configuration System): Remove 'password' field in the example. (User Accounts): Clarify use of the 'password' field, with links to the libc and Guile manuals.
* doc: Improve acknowledgments.Ludovic Courtès2014-11-13
| | | | | * doc/guix.texi (Acknowledgments): Expound a bit. * THANKS: Mention artwork; thank Felipe & Nikita.
* gnu: xorg: Add SLiM theme based on work by Felipe López.Ludovic Courtès2014-11-12
| | | | | | | | | | | * gnu/services/xorg.scm (%artwork-repository, %default-slim-theme, %default-slim-theme-name): New variables. (slim-service): Add #:theme and #:theme-name parameters. [slim.cfg]: Honor #:theme-name. Honor #:theme by setting the "SLIM_THEMESDIR" environment variable. * doc/guix.texi (X Window): Adjust 'slim-service' documentation accordingly. Document '%default-slim-theme' and '%default-slim-theme-name'.
* activation: Set the firmware search path.Ludovic Courtès2014-11-11
| | | | | | | | | | * gnu/build/activation.scm (activate-firmware): New procedure. * gnu/system.scm (<operating-system>)[firmware]: New field. (directory-union): New procedure. (%base-firmware): New variable. (operating-system-activation-script): Use 'directory-union', and call 'activate-firmware'. * doc/guix.texi (operating-system Reference): Document 'firmware'.
* doc: Mention 'guix environment' in "Features"; add index entries.Ludovic Courtès2014-11-10
| | | | | | * doc/guix.texi (Features): Add paragraph about 'guix environment'. (Build Systems): Add @cindex. (Invoking guix environment): Ditto.
* doc: Add "GRUB Configuration".Ludovic Courtès2014-11-10
| | | | | | * doc/guix.texi (operating-system Reference): Add xref to "GRUB Configuration". (GRUB Configuration): New node.
* doc: Avoid @indentedblock, which is not supported by Texinfo 4.Ludovic Courtès2014-11-10
| | | | | | | Reported by Mark H Weaver. * doc/guix.texi (Security Updates): Use @quotation instead of @indentedblock; the latter is not supported by Texinfo 4.
* gexp: Add #:module-path parameter to 'gexp->derivation'.Ludovic Courtès2014-11-09
| | | | | | * guix/gexp.scm (gexp->derivation): Add #:module-path parameter, and pass it to 'imported-modules' and 'compiled-modules'. * doc/guix.texi (G-Expressions): Adjust accordingly.
* vm: The 'run-vm' scripts now passes its arguments to QEMU.Ludovic Courtès2014-11-08
| | | | | | | * gnu/system/vm.scm (system-qemu-image/shared-store-script): Add "$@" at the end of the script. (common-qemu-options): Remove trailing newline. * doc/guix.texi (Invoking guix system): Document it.
* vm: Fix 'vm --full-boot' to produce a sufficient disk image.Ludovic Courtès2014-11-08
| | | | | | | | | | * gnu/system/vm.scm (system-qemu-image/shared-store): Add #:disk-image-size and #:full-boot? parameters and honor them. Pass '#:copy-inputs? full-boot?', and change #:inputs argument. * guix/scripts/system.scm (system-derivation-for-action): Pass #:disk-image-size to 'system-qemu-image/shared-store'. * doc/guix.texi (Invoking guix system): Mention use of '--image-size' in conjunction with '--full-boot'.
* vm: Support 'guix system vm --full-boot'.Ludovic Courtès2014-11-08
| | | | | | | | | | | * gnu/system/vm.scm (system-qemu-image/shared-store-script): Add #:full-boot? parameter and honor it. * guix/scripts/system.scm (system-derivation-for-action): Likewise. (perform-action): Likewise. (show-help): Document '--full-boot'. (%options): Add '--full-boot'. (guix-system): Add #:full-boot? argument in call to 'perform-action'. * doc/guix.texi (Invoking guix system): Document it.
* doc: Emphasize the availability of two user interfaces.Ludovic Courtès2014-11-08
| | | | | * doc/guix.texi (Package Management): Add a word about the two user interfaces.
* emacs: Add 'guix-prettify'.Alex Kost2014-11-07
| | | | | | | * emacs/guix-prettify.el: New file. * emacs.am (ELFILES): Add it. * doc/emacs.texi (Emacs Prettify): New node. * doc/guix.texi (Features): Mention it.
* services: xorg: Allow users to specify a list of resolutions.Ludovic Courtès2014-11-07
| | | | | | * gnu/services/xorg.scm (xorg-start-command): Add #:resolutions parameter and 'screen-section' procedure. Use it. * doc/guix.texi (X Window): Adjust accordingly.
* services: xorg: Allow users to specify the drivers to use.Ludovic Courtès2014-11-07
| | | | | | * gnu/services/xorg.scm (xorg-start-command): Add #:drivers parameter. Add 'device-section' procedure, and use it in 'xserver.conf'. * doc/guix.texi (X Window): Document it.
* services: Add NTP service.Ludovic Courtès2014-11-05
| | | | | * gnu/services/networking.scm (ntp-service): New procedure. * doc/guix.texi (Networking Services): Document it.
* packages: Implement grafts.Ludovic Courtès2014-11-02
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Thanks to Mark H. Weaver <mhw@netris.org> for insightful discussions and suggestions. * guix/packages.scm (<package>)[graft]: New field. (patch-and-repack): Invoke 'package-derivation' with #:graft? #f. (package-source-derivation): Likewise. Do not use (%guile-for-build) in call to 'patch-and-repack', and we could end up using a grafted Guile. (expand-input): Likewise, also for 'package-cross-derivation' call. (package->bag): Add #:graft? parameter. Honor it. Use 'strip-append' instead of 'package-full-name'. (input-graft, input-cross-graft, bag-grafts, package-grafts): New procedures. (package-derivation, package-cross-derivation): Add #:graft? parameter and honor it. * gnu/packages/bootstrap.scm (package-with-bootstrap-guile): Add recursive call on 'graft'. * guix/build-system/gnu.scm (package-with-explicit-inputs, package-with-extra-configure-variable, static-package): Likewise. (gnu-build): Use the ungrafted Guile to avoid full rebuilds. (gnu-cross-build): Likewise. * guix/build-system/cmake.scm (cmake-build): Likewise. * guix/build-system/glib-or-gtk.scm (glib-or-gtk-build): Likewise. * guix/build-system/perl.scm (perl-build): Likewise. * guix/build-system/python.scm (python-build): Likewise. * guix/build-system/ruby.scm (ruby-build): Likewise. * guix/build-system/trivial.scm (guile-for-build): Likewise. * tests/packages.scm ("package-derivation, direct graft", "package-cross-derivation, direct graft", "package-grafts, indirect grafts", "package-grafts, indirect grafts, cross", "package-grafts, indirect grafts, propagated inputs", "package-derivation, indirect grafts"): New tests. ("bag->derivation", "bag->derivation, cross-compilation"): Wrap in 'parameterize'. * doc/guix.texi (Security Updates): New node. (Invoking guix build): Document --no-graft.
* doc: Add a note about optional GnuTLS dependency.Ian Denhardt2014-10-27
| | | | | | | * README (Requirements): add a note about 'guix download''s GnuTLS dependency. * doc/guix.texi (Requirements): Likewise. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
* doc: Add cross-reference to the gnutls-guile manual.Ludovic Courtès2014-10-27
| | | | | * doc/guix.texi (Invoking guix download): Add cross-reference to the gnutls-guile manual.
* guix lint: add the --checkers option.Cyril Roelandt2014-10-16
| | | | | | | * guix/scripts/lint.scm: add the "--checkers" option. * doc/guix.texi (Invoking guix lint): Document it. * tests/guix-lint.sh: New file * Makefile.am (SCM_TESTS): Add it.
* guix package: Add '--switch-generation' option.Alex Kost2014-10-12
| | | | | | | | * guix/scripts/package.scm (switch-to-generation): New procedure. (switch-to-previous-generation): Use it. (guix-package): Adjust for '--switch-generation' option. * tests/guix-package.sh: Test it. * doc/guix.texi (Invoking guix package): Document it.