summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAge
* build: Move 'Makefile' fragments to subdirectories.Mathieu Lirzin2016-04-21
| | | | | | | | | | | | | | | | | | This follows a convention used by some other GNU packages like Autoconf, Bison, Coreutils, and Gnulib. * doc.am: Rename to ... * doc/local.mk: ... this. * emacs.am: Rename to ... * emacs/local.mk: ... this. * gnu-system.am: Rename to ... * gnu/local.mk: ... this. * daemon.am: Rename to ... * nix/local.mk: ... this. * Makefile.am: Adapt to them. * doc/guix.texi (Porting to a New Platform): Adapt documentation. * guix/config.scm.in (%state-directory, %config-directory): Adapt comments. * emacs/guix-config.el.in (guix-config-state-directory): Likewise.
* doc: Add "X.509 Certificates" section under "Application Setup".Ludovic Courtès2016-04-20
| | | | | | | Reported by Roel Janssen <roel@gnu.org>. * doc/guix.texi (Application Setup)[X.509 Certificates]: New section. (X.509 Certificates): Add an example of certificates in the profile.
* doc: Add specification for Java packagesHartmut Goebel2016-04-19
| | | | * doc/guix.texi (Java Packages): New subsection.
* doc: Mention 'mkswap' during installation.Ludovic Courtès2016-04-19
| | | | | | Reported by Thierry Micoud <thierrymicoud@gmail.com>. * doc/guix.texi (Preparing for Installation): Mention 'mkswap'.
* emacs: Add interface for package locations.Alex Kost2016-04-18
| | | | | | | | | * emacs/guix-main.scm (%package-location-param-alist): New variable. (package-location->sexp, package-location-entries): New procedures. * emacs/guix-ui-location.el: New file. * emacs.am (ELFILES): Add it. * doc/emacs.texi (Emacs Package Locations): Document 'guix-locations'. * NEWS: Mention it.
* doc: emacs: Add "Package Source Locations" section.Alex Kost2016-04-18
| | | | | | | | * doc/emacs.texi (Emacs Commands): Move description of 'guix-edit' command to... (Emacs Package Locations): ... here. Document 'guix-find-location'. New node. * doc/guix.texi (Top): Add it.
* emacs: Add 'guix-packages-by-location' command.Alex Kost2016-04-18
| | | | | | | | | | | | | | * emacs/guix-main.scm (packages-by-location-file, package-location-files): New procedures. (%patterns-makers): Add 'location' search type. * emacs/guix-messages.el (guix-message-packages-by-location): New procedure. (guix-messages): Use it. * emacs/guix-read.el (guix-package-locations) (guix-read-package-location): New procedures. * emacs/guix-ui-package.el (guix-packages-by-location): New command. * doc/emacs.texi (Emacs Commands): Document it. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
* mapped-devices: LUKS partitions can be designated by their UUID.Ludovic Courtès2016-04-18
| | | | | | | | | | * gnu/system/mapped-devices.scm (device-mapping-service-type): Add 'modules' and 'imported-modules' fields to 'shepherd-service'. (open-luks-device): Use 'find-partition-by-luks-uuid' to lookup the partition when SOURCE is a bytevector. * gnu/system/linux-initrd.scm (base-initrd): Augment 'use-modules' form. * doc/guix.texi (Mapped Devices): Give example with a UUID.
* services: 'console-keymap-service' takes multiple files.Alex Kost2016-04-17
| | | | | | | | * gnu/services/base.scm (console-keymap-service-type): Type procedure takes a list of files instead of a single file. (console-keymap-service): Take 'files' as rest arguments. * doc/guix.texi (Base Services): Improve documentation of 'console-keymap-service'.
* doc: Update 'skeletons' field documentation.Ludovic Courtès2016-04-17
| | | | | * doc/guix.texi (operating-system Reference): Update documentation of 'skeletons' as a followup to e79467f63a06811ba5dd8c8b0cc79553c5dd4e3a.
* doc: Use new PACKAGE@VERSION syntax in example.Ludovic Courtès2016-04-17
| | | | | * doc/guix.texi (Using the Configuration System): Use PACKAGE@VERSION syntax.
* doc: Mention --localstatedir for when building from Git.Ludovic Courtès2016-04-16
| | | | | | Reported by Hartmut Goebel <h.goebel@crazy-compilers.com>. * doc/contributing.texi (Building from Git): Mention --localstatedir.
* doc: Fix typos.Ludovic Courtès2016-04-16
| | | | * doc/guix.texi (Hardware Considerations): Fix typos.
* doc: Remove mention of GNU release freshness checks.Ludovic Courtès2016-04-16
| | | | | | * doc/guix.texi (Invoking guix package): Remove paragraph about automatic check for latest GNU releases, which was removed in 6caa4dfa37e9b87336908e188500c14b402a0090.
* doc: Add a reference to 'Invoking guix archive'.Mathieu Lirzin2016-04-15
| | | | | * doc/guix.texi (Common Build Options): Add a reference to 'Invoking guix archive'.
* doc: Update reproducible-builds.org URL.Ludovic Courtès2016-04-06
| | | | | * doc/guix.texi (Invoking guix challenge): Update reproducible-builds URL.
* doc: Use more https URLs.Ludovic Courtès2016-04-06
| | | | * doc/guix.texi (Invoking guix challenge): Use https instead of http.
* challenge: Really exit with non-zero upon hash mismatch.Ludovic Courtès2016-04-06
| | | | | | | | | | Reported by John Darrington. * guix/scripts/challenge.scm (guix-challenge): Add an explicit 'exit' call when ISSUES is empty. * scripts/guix.in: Add comment about 'exit'. * doc/guix.texi (Invoking guix challenge): Mention the behavior and exit code.
* doc: Update use of old "PACKAGE-VERSION" syntax.Ludovic Courtès2016-04-06
| | | | * doc/guix.texi (Invoking guix edit): Use the @ syntax for versions.
* build: Add a Guile custom test driver using SRFI-64.Mathieu Lirzin2016-04-03
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Before that '.log' files for scheme tests were fragmented and not included in test-suite.log. This unifies the semantics of SRFI-64 API with Automake test suite. * build-aux/test-driver.scm: New file. * Makefile.am (SCM_LOG_DRIVER, AM_SCM_LOG_DRIVER_FLAGS): New variables. (SCM_LOG_COMPILER, AM_SCM_LOG_FLAGS): Delete variables. (AM_TESTS_ENVIRONMENT): Set GUILE_AUTO_COMPILE to 0. * test-env.in: Silence guix-daemon. * doc/guix.texi (Running the Test Suite): Describe how to display the detailed results. Bug reports require only 'test-suite.log' file. * tests/base32.scm, tests/build-utils.scm, tests/builders.scm, tests/challenge.scm, tests/cpan.scm, tests/cpio.scm, tests/cran.scm, tests/cve.scm, tests/derivations.scm, tests/elpa.scm, tests/file-systems.scm, tests/gem.scm, tests/gexp.scm, tests/gnu-maintenance.scm, tests/grafts.scm, tests/graph.scm, tests/gremlin.scm, tests/hackage.scm, tests/hash.scm, tests/import-utils.scm, tests/lint.scm, tests/monads.scm, tests/nar.scm, tests/packages.scm, tests/pk-crypto.scm, tests/pki.scm, tests/profiles.scm, tests/publish.scm, tests/pypi.scm, tests/records.scm, tests/scripts-build.scm, tests/scripts.scm, tests/services.scm, tests/sets.scm, tests/size.scm, tests/snix.scm, tests/store.scm, tests/substitute.scm, tests/syscalls.scm, tests/system.scm, tests/ui.scm, tests/union.scm, tests/upstream.scm, tests/utils.scm: Don't exit at the end of test groups. * tests/containers.scm: Likewise. Use 'test-skip' instead of exiting with error code 77.
* import: Add Hackage updater.Eric Bavier2016-03-30
| | | | | | | | * guix/import/hackage.scm (guix-package->hackage-name, hackage-package?) (latest-release): New procedures. (%hackage-updater): New variable. * guix/scripts/refresh.scm (%updaters): Add it. * doc/guix.texi (Invoking guix refresh): Mention it.
* doc: Small fixes for typos and missing words.Roel Janssen2016-03-30
| | | | | | | | * doc/guix.texi (The Store Monad): Add a dot at the end of a sentence. (The Store Monad): Add "are" to make a complete sentence. (G-Expressions): Fix typo. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: Clarify how to use the '#:python' parameter.Chris Marusich2016-03-30
| | | | | | | | * doc/guix.texi (Build Systems): Clearly distinguish between the package that provides the Python interpreter for the build and the package that is to be built. Also, mention why one might want to use a specific Python version. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: Fix URL of gnutls-guile one-page-per-node manual.Ludovic Courtès2016-03-30
| | | | * doc/htmlxref.cnf: Fix gnutls-guile 'node' URL.
* doc: We have even more than 3,000 packages.Ludovic Courtès2016-03-28
| | | | | | Suggested by Chris Marusich <cmmarusich@gmail.com>. * doc/guix.texi (Limitations): Increase package count.
* doc: Explain why the config file should be stored on the target.Ludovic Courtès2016-03-28
| | | | | | | Suggested by Chris Marusich <cmmarusich@gmail.com>. * doc/guix.texi (Proceeding with the Installation): Explain why the config file should be on the target file system.
* doc: Suggest 'dhclient -v'.Ludovic Courtès2016-03-28
| | | | | | Suggested by Chris Marusich <cmmarusich@gmail.com>. * doc/guix.texi (Preparing for Installation): Add "-v" for dhclient.
* doc: Suggest running "info info" during system installation.Ludovic Courtès2016-03-28
| | | | | | Based on a suggestion by Chris Marusich <cmmarusich@gmail.com>. * doc/guix.texi (System Installation): Suggest running "info info".
* doc: Clarify 'cow-store'.Ludovic Courtès2016-03-28
| | | | | | | Suggested by Chris Marusich <cmmarusich@gmail.com>. * doc/guix.texi (Proceeding with the Installation): Clarify what 'cow-store' is about.
* doc: Make it clear that networking is needed for GuixSD installation.Ludovic Courtès2016-03-28
| | | | | | | Suggested by Jan Nieuwenhuizen <janneke@gnu.org>. * doc/guix.texi (Preparing for Installation): Make it clear that networking is required.
* doc: Augment documentation about security updates.Ludovic Courtès2016-03-28
| | | | | | * doc/guix.texi (Security Updates): Add paragraph on the big picture of security updates. Cross-reference 'guix lint'. (Invoking guix lint): Add CVE URLs.
* doc: Fix typo: "wpa_supplication" --> "wpa_supplicant".Mark H Weaver2016-03-26
| | | | * doc/guix.texi (Preparing for Installation): Fix typo.
* environment: container: Create dummy home directory and /etc/passwd.David Thompson2016-03-26
| | | | | | | | | * guix/scripts/environment.scm (launch-environment/container): Change $HOME to the current user's home directory instead of /homeless-shelter. Create a dummy /etc/passwd with a single entry for the current user. * doc/guix.texi ("invoking guix environment"): Add a note about the dummy home directory and /etc/passwd.
* doc: Mention 'guix challenge' in "Features".Ludovic Courtès2016-03-25
| | | | * doc/guix.texi (Features): Mention trust and 'guix challenge'.
* doc: Rephrase introduction to give a better overview.Ludovic Courtès2016-03-25
| | | | | | | | | Suggested by myglc2 <myglc2@gmail.com>. * doc/guix.texi (Introduction): Rephrase to mention features and use cases first, and foundations last. (Features): Mention "GuixSD". (Utilities): Change intro: not all the tools are for packagers.
* doc: We now need 1 GiB for the installation USB image.Ludovic Courtès2016-03-24
| | | | | * doc/guix.texi (Building the Installation Image): Change image size to 1G. * build-aux/hydra/gnu-system.scm (qemu-jobs): Likewise.
* doc: Update reference to the Info reader's manual.Ludovic Courtès2016-03-24
| | | | | | * doc/guix.texi (System Installation): Refer to 'info-stnd' instead of 'info'. (Preparing for Installation): Likewise.
* doc: Clarify installation instructions for "guix.el".Alex Kost2016-03-24
| | | | | | * doc/emacs.texi (Emacs Initial Setup): Mention that "guix package -i guix" is an easy way. Warn that "make install" may lead to an outdated code.
* emacs: Deprecate "guix-init.el".Alex Kost2016-03-24
| | | | | | | | | | | | | | | | 'guix-init' served 2 purposes: - to autoload guix commands (by requiring 'guix-autoloads'); - and to autoload Emacs packages installed with Guix (by requiring 'guix-emacs'). The second purpose is not actual anymore, as Emacs package handles this task now, so there is no need in 'guix-init' anymore. * emacs/guix-init.el: Do not require 'guix-emacs'. Add a deprecation message. * doc/emacs.texi (Emacs Initial Setup): Recommend to use 'guix-autoloads' instead of 'guix-init'.
* doc: Add "lightweight desktop" OS config example.Ludovic Courtès2016-03-23
| | | | | | | | | | | | * gnu/system/examples/desktop.tmpl (packages): Remove XFCE and RATPOISON. (services): Add 'gnome-desktop-service' and 'xfce-desktop-service'. * gnu/system/examples/lightweight-desktop.tmpl: New file. * Makefile.am (EXAMPLES): Add it. * doc.am (OS_CONFIG_EXAMPLES_TEXI): Add doc/os-config-lightweight-desktop.texi. * gnu/system/install.scm (/etc/configuration-files)[directory]: Add lightweight-desktop.tmpl.
* gexp: Add #:disallowed-references.Ludovic Courtès2016-03-20
| | | | | | | | * guix/gexp.scm (gexp->derivation): Add #:disallowed-references and honor it. * tests/gexp.scm ("gexp->derivation #:disallowed-references, allowed") ("gexp->derivation #:disallowed-references"): New tests. * doc/guix.texi (G-Expressions): Adjust accordingly.
* derivations: Add #:disallowed-references.Ludovic Courtès2016-03-20
| | | | | | | | | * guix/derivations.scm (derivation): Add #:disallowed-references. [user+system-env-vars]: Honor it. (build-expression->derivation): Likewise. * tests/derivations.scm ("derivation #:disallowed-references, ok") ("derivation #:disallowed-references, not ok"): New tests. * doc/guix.texi (Derivations): Adjust accordingly.
* build: Protect against misconfiguration of localstatedir.Ludovic Courtès2016-03-19
| | | | | | | | | | | Suggested by Jookia <166291@gmail.com>. * m4/guix.m4 (GUIX_CURRENT_LOCALSTATEDIR, GUIX_CHECK_LOCALSTATEDIR): New macros. * config-daemon.ac: Use 'GUIX_CHECK_LOCALSTATEDIR'. * Makefile.am (DISTCHECK_CONFIGURE_FLAGS): Add --localstatedir. * doc/guix.texi (Requirements): Mention --localstatedir. (The Store): Mention LOCALSTATEDIR as such.
* doc: Add missing comma after @xref.Ludovic Courtès2016-03-17
| | | | | | Reported by Alex Kost <alezost@gmail.com>. * doc/guix.texi (Service Reference): Add comma after @xref.
* doc: GNOME is now available.Ludovic Courtès2016-03-17
| | | | * doc/guix.texi (Limitations): Rephrase item about GNOME and KDE.
* substitute: Honor client-provided empty URL list.Ludovic Courtès2016-03-16
| | | | | | | | | | | | | | | Before that, 'guix build --substitute-urls=""' would lead to using the daemon's own URL list instead of the empty list. The 'or*' hack, which is to blame, had become unnecessary since commit fb4bf72be3fbc23bca35ba4b842b7e1517ef0e3a. Reported by Mark H Weaver <mhw@netris.org>. * guix/scripts/substitute.scm (or*): Remove. (%cache-urls): Use 'or' instead of 'or*'. * tests/store.scm ("substitute query, alternating URLs"): Add test with empty URL list. * doc/guix.texi (Common Build Options): Mention the empty string.
* build: Default to "https://mirror.hydra.gnu.org/" for substitutes.Ludovic Courtès2016-03-16
| | | | | | | | | | | * config-daemon.ac: Check for (gnutls) and define 'GUIX_SUBSTITUTE_URLS'. * nix/nix-daemon/guix-daemon.cc (main): Use GUIX_SUBSTITUTE_URLS. * guix/store.scm (%default-substitute-urls): Use 'https' when (gnutls) is available. * doc/guix.texi (Binary Installation): Mention mirrors (Invoking guix-daemon): Mention mirror.hydra.gnu.org. (Substitutes): Mention mirrors. (Invoking guix archive): Show https URLs.
* gnu: services: Add GNOME and XFCE desktop services.Andy Wingo2016-03-15
| | | | | | | | | | | * gnu/services/desktop.scm (package-direct-input-selector): New function. (<gnome-desktop-configuration>, gnome-desktop-service-type) (<xfce-desktop-configuration>, xfce-desktop-service-type): New variables. (gnome-desktop-service, xfce-desktop-service): New public variables. * doc/guix.texi (Desktop Services): Document new variables.
* doc: Clarify and consolidate modify-services documentation.Chris Marusich2016-03-15
| | | | | | | | | * doc/guix.texi ("Using the Configuration System"): Move the example... ("Service Reference"): ...to here, and clarify more. * gnu/services.scm (modify-services): Update docstring to mention the return type. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
* doc: Add "Hardware Considerations" node.Ludovic Courtès2016-03-15
| | | | | | | Suggested by Nils Gillmann <niasterisk@grrlz.net>. * doc/guix.texi (Hardware Considerations): New node. (operating-system Reference): Mention it.