summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAge
* monads: Move '%store-monad' and related procedures where they belong.Ludovic Courtès2015-01-14
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This turns (guix monads) into a generic module for monads, and moves the store monad and related monadic procedures in their corresponding module. * guix/monads.scm (store-return, store-bind, %store-monad, store-lift, text-file, interned-file, package-file, package->derivation, package->cross-derivation, origin->derivation, imported-modules, compiled, modules, built-derivations, run-with-store): Move to... * guix/store.scm (store-return, store-bind, %store-monad, store-lift, text-file, interned-file): ... here. (%guile-for-build): New variable. (run-with-store): Moved from monads.scm. Remove default value for #:guile-for-build. * guix/packages.scm (default-guile): Export. (set-guile-for-build): New procedure. (package-file, package->derivation, package->cross-derivation, origin->derivation): Moved from monads.scm. * guix/derivations.scm (%guile-for-build): Remove. (imported-modules): Rename to... (%imported-modules): ... this. (compiled-modules): Rename to... (%compiled-modules): ... this. (built-derivations, imported-modules, compiled-modules): New procedures. * gnu/services/avahi.scm, gnu/services/base.scm, gnu/services/dbus.scm, gnu/services/dmd.scm, gnu/services/networking.scm, gnu/services/ssh.scm, gnu/services/xorg.scm, gnu/system/install.scm, gnu/system/linux-initrd.scm, gnu/system/shadow.scm, guix/download.scm, guix/gexp.scm, guix/git-download.scm, guix/profiles.scm, guix/svn-download.scm, tests/monads.scm: Adjust imports accordingly. * guix/monad-repl.scm (default-guile-derivation): New procedure. (store-monad-language, run-in-store): Use it. * build-aux/hydra/gnu-system.scm (qemu-jobs): Add explicit 'set-guile-for-build' call. * guix/scripts/archive.scm (derivation-from-expression): Likewise. * guix/scripts/build.scm (options/resolve-packages): Likewise. * guix/scripts/environment.scm (guix-environment): Likewise. * guix/scripts/system.scm (guix-system): Likewise. * doc/guix.texi (The Store Monad): Adjust module names accordingly.
* doc: Move 'text-file*' to the gexp section.Ludovic Courtès2015-01-14
| | | | | | | This is a follow-up to commit 462a3fa. * doc/guix.texi (The Store Monad): Move 'text-file*'... (G-Expressions): ... to here.
* doc: Change some occurrences of "the GNU system" to "Guixotic".Ludovic Courtès2015-01-13
| | | | | | | * doc/guix.texi (GNU Distribution): Explain what "Guixotic" is. (System Installation): Replace "the GNU system" by "Guixotic". (System Configuration): Likewise. (Invoking guix system): Likewise.
* import: Add CPAN importer.Eric Bavier2015-01-09
| | | | | | | | | | * guix/import/cpan.scm, guix/scripts/import/cpan.scm, tests/cpan.scm: New files. * Makefile.am (MODULE)[HAVE_GUILE_JSON]: Add them. * guix/scripts/import.scm (importers): Add cpan. * doc/guix.texi (Requirements): Mention `guix import cpan` as a user of guile-json. (Invoking guix import): Document new `guix import cpan` command.
* doc: guix-daemon now automatically creates '…/profiles/per-user'.Ludovic Courtès2015-01-04
| | | | | | | | Fixes <http://bugs.gnu.org/19315>. Reported by rekado <rekado@elephly.net>. * doc/guix.texi (Invoking guix package): Adjust text to new guix-daemon behavior introduced in commit 15ddeff.
* 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: emacs: Fix typo.Alex Kost2014-12-03
| | | | | | Reported by Ludovic Courtès <ludo@gnu.org>. * doc/emacs.texi (Emacs Initial Setup): Replace "inbuilt" with "built-in".
* doc: emacs: Document autoloading Emacs packages.Alex Kost2014-12-02
| | | | | * doc/emacs.texi (Emacs Initial Setup): Describe how Emacs packages installed in a user profile are autoloaded by "guix.el"
* 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.
* emacs: Add "c" key binding to copy a button link.Alex Kost2014-11-10
| | | | | | | * emacs/guix-info.el (guix-info-button-map): New variable. (guix-info-button-copy-label): New procedure. * doc/emacs.texi (Emacs Info buffer): Mention a "c" key binding. (Emacs Keymaps): Add 'guix-info-button-map'.
* 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.