summary refs log tree commit diff
path: root/doc
AgeCommit message (Collapse)Author
2015-01-17doc: Document '%state-monad' and update '%store-monad' description.Ludovic Courtès
* doc/guix.texi (The Store Monad): Document '%state-monad' and related procedures. Describe '%store-monad' as an alias for '%state-monad'. * guix/monads.scm: Update commentary.
2015-01-17guix archive: Add -r/--recursive.Ludovic Courtès
* guix/scripts/archive.scm (show-help, %options): Add -r/--recursive. (export-from-store): Pass #:recursive? to 'export-paths'. * doc/guix.texi (Invoking guix archive): Add -r in Emacs example. Add example with ~/.guix-profile. Document -r/--recursive.
2015-01-17doc: Mention generation of ECDSA/Ed25519 keys when supported.Ludovic Courtès
* doc/guix.texi (Invoking guix archive): Mention ECDSA/Ed25519 as the default type of keys for libgcrypt >= 1.6.0.
2015-01-16Merge branch 'core-updates'Ludovic Courtès
Conflicts: gnu/packages/bootstrap.scm
2015-01-14monads: Move '%store-monad' and related procedures where they belong.Ludovic Courtès
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.
2015-01-14doc: Move 'text-file*' to the gexp section.Ludovic Courtès
This is a follow-up to commit 462a3fa. * doc/guix.texi (The Store Monad): Move 'text-file*'... (G-Expressions): ... to here.
2015-01-13Merge branch 'master' into core-updatesMark H Weaver
2015-01-13doc: Change some occurrences of "the GNU system" to "Guixotic".Ludovic Courtès
* doc/guix.texi (GNU Distribution): Explain what "Guixotic" is. (System Installation): Replace "the GNU system" by "Guixotic". (System Configuration): Likewise. (Invoking guix system): Likewise.
2015-01-11Merge branch 'master' into core-updatesMark H Weaver
2015-01-09import: Add CPAN importer.Eric Bavier
* 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.
2015-01-07gnu: Add bootstrap binaries for 'armhf-linux'.Mark H Weaver
* gnu/packages/bootstrap/armhf-linux/bash, gnu/packages/bootstrap/armhf-linux/mkdir, gnu/packages/bootstrap/armhf-linux/tar, gnu/packages/bootstrap/armhf-linux/xz: New files. * gnu-system.am (bootstrap_armhf_linuxdir, dist_bootstrap_armhf_linux_DATA) (nodist_bootstrap_armhf_linux_DATA): New variables. (DISTCLEANFILES): Add $(nodist_bootstrap_armhf_linux_DATA). (gnu/packages/bootstrap/armhf-linux/guile-2.0.11.tar.xz): New target. * build-aux/download.scm (file-name->uri): Use newer date in URI for armhf-linux. * gnu/packages/bootstrap.scm (raw-build): Use "guile-2.0.11.tar.xz" on armhf-linux. (glibc-dynamic-linker, %bootstrap-coreutils&co, %bootstrap-binutils) (%bootstrap-glibc, %bootstrap-gcc): Add armhf-linux cases. * m4/guix.m4 (GUIX_SYSTEM_TYPE): Add armhf case. (GUIX_ASSERT_SUPPORTED_SYSTEM): Add armhf-linux to list of supported systems. * doc/guix.texi (GNU Distribution): Add armhf-linux to the list of supported systems.
2015-01-04doc: guix-daemon now automatically creates '…/profiles/per-user'.Ludovic Courtès
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.
2014-12-14services: Make 'nscd-service' configurable; cache hosts/services by default.Ludovic Courtès
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'.
2014-12-09doc: Explain how to set the ownership and permissions of /gnu/store.Ludovic Courtès
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.
2014-12-07doc: Give example uses of 'deco'.Ludovic Courtès
Suggested by Sleep_Walker on #guix. * doc/guix.texi (Services): Add 'deco' examples.
2014-12-06guix: scripts: Parse $GUIX_BUILD_OPTIONS separately.nebuli
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>
2014-12-03doc: emacs: Fix typo.Alex Kost
Reported by Ludovic Courtès <ludo@gnu.org>. * doc/emacs.texi (Emacs Initial Setup): Replace "inbuilt" with "built-in".
2014-12-02doc: emacs: Document autoloading Emacs packages.Alex Kost
* doc/emacs.texi (Emacs Initial Setup): Describe how Emacs packages installed in a user profile are autoloaded by "guix.el"
2014-12-02doc: Adjust misleading 'user-account' example.Ludovic Courtès
Reported by Sleep_Walker on #guix. * doc/guix.texi (Using the Configuration System): Remove numeric UID and GID from example.
2014-12-01build-system/glib-or-gtk: Allow specific outputs to be excluded from wrapping.Ludovic Courtès
* 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.
2014-11-30guix: scripts: Add GUIX_BUILD_OPTIONS environment handling.nebuli
* 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>
2014-11-30daemon: Default to '--cores=0'.Ludovic Courtès
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.
2014-11-30doc: Explain that 'file-system' must refer to mapped devices by file name.Ludovic Courtès
* doc/guix.texi (File Systems): Clarify what to do when mapped devices are used.
2014-11-30Revert "system: Add a 'needed-for-boot?' field to 'mapped-device'."Ludovic Courtès
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.
2014-11-29doc: Improve porting instructions.Ludovic Courtès
* doc/guix.texi (Porting): Move 'glibc-dynamic-linker' paragraph above. Clarify what is meant by updating (gnu packages bootstrap). Mention 'gnu-system.am'.
2014-11-29system: Add a 'needed-for-boot?' field to 'mapped-device'.Ludovic Courtès
* 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?'.
2014-11-28doc: Update stale references in "Bootstrapping".Ludovic Courtès
* doc/guix.texi (Bootstrapping): Final definitions are in (gnu packages commencement). Change gnu-build-system xref to "Build Systems".
2014-11-27system: Build system-wide locale definitions.Ludovic Courtès
* 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.
2014-11-25guix build: Add '--max-jobs' option.Ludovic Courtès
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'.
2014-11-25doc: Fix syntax errors.Taylan Ulrich Bayırlı/Kammer
* doc/guix.texi (Package Naming): (Fonts): Remove space between '@foo' and '{'. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2014-11-24doc: Add detailed node listing.Ludovic Courtès
* doc/guix.texi (Top): Add @detailmenu.
2014-11-24doc: Add xrefs to the lsh manual.Ludovic Courtès
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.
2014-11-24doc: Fix typos.Alex Kost
* doc/guix.texi (Base Services): Fix 'lsh-service' name. (Networking Services): Fix (gnu services networking) module name.
2014-11-23install: Add Cryptsetup to the image.Ludovic Courtès
Reported by Nikita Karetnikov. * gnu/system/install.scm (installation-os)[packages]: Add CRYPTSETUP. * doc/guix.texi (System Installation): Mention it.
2014-11-23doc: Fix erroneous cross-manual references.Ludovic Courtès
* doc/guix.texi (User Accounts): Fix cross-references to libc and guile.
2014-11-23doc: Add a section on naming conventions for font packages.Andreas Enge
* doc/guix.texi (Fonts): New section. (Package naming): Reference the new section.
2014-11-21doc: Fix typos regarding 'lsh-service'.Ludovic Courtès
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.
2014-11-21guix system: Add '--share' and '--expose' options for 'vm'.Ludovic Courtès
* 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.
2014-11-17doc: Fix misuses of @ref.Ludovic Courtès
* 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.
2014-11-17doc: Suggest using 'guix pull' before 'guix system reconfigure'.Ludovic Courtès
* doc/guix.texi (Invoking guix system): Suggest running 'guix pull' before the first use of 'guix system reconfigure'.
2014-11-16doc: Document --key-download option of 'guix refresh'.Ludovic Courtès
* doc/guix.texi (Invoking guix refresh): Document --key-download.
2014-11-16doc: Document "guix import".Ludovic Courtès
* doc/guix.texi (Requirements): Add xref to "Invoking guix import". (Defining Packages): Likewise. Remove footnote about Nixpkgs imports. (Invoking guix import): New section.
2014-11-15doc: Fix Hydra URL.Ludovic Courtès
Reported by John Darrington <john@darrington.wattle.id.au>. * doc/guix.texi (Packaging Guidelines): Fix hydra.gnu.org URL.
2014-11-14doc: Clarify use of the 'password' field for user accounts.Ludovic Courtès
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.
2014-11-13doc: Improve acknowledgments.Ludovic Courtès
* doc/guix.texi (Acknowledgments): Expound a bit. * THANKS: Mention artwork; thank Felipe & Nikita.
2014-11-12gnu: xorg: Add SLiM theme based on work by Felipe López.Ludovic Courtès
* 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'.
2014-11-11activation: Set the firmware search path.Ludovic Courtès
* 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'.
2014-11-10doc: Mention 'guix environment' in "Features"; add index entries.Ludovic Courtès
* doc/guix.texi (Features): Add paragraph about 'guix environment'. (Build Systems): Add @cindex. (Invoking guix environment): Ditto.
2014-11-10doc: Add "GRUB Configuration".Ludovic Courtès
* doc/guix.texi (operating-system Reference): Add xref to "GRUB Configuration". (GRUB Configuration): New node.
2014-11-10doc: Avoid @indentedblock, which is not supported by Texinfo 4.Ludovic Courtès
Reported by Mark H Weaver. * doc/guix.texi (Security Updates): Use @quotation instead of @indentedblock; the latter is not supported by Texinfo 4.