aboutsummaryrefslogtreecommitdiff
path: root/doc/guix.texi
AgeCommit message (Collapse)Author
2016-03-30doc: Small fixes for typos and missing words.Roel Janssen
* 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>
2016-03-30doc: Clarify how to use the '#:python' parameter.Chris Marusich
* 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>
2016-03-28doc: We have even more than 3,000 packages.Ludovic Courtès
Suggested by Chris Marusich <cmmarusich@gmail.com>. * doc/guix.texi (Limitations): Increase package count.
2016-03-28doc: Explain why the config file should be stored on the target.Ludovic Courtès
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.
2016-03-28doc: Suggest 'dhclient -v'.Ludovic Courtès
Suggested by Chris Marusich <cmmarusich@gmail.com>. * doc/guix.texi (Preparing for Installation): Add "-v" for dhclient.
2016-03-28doc: Suggest running "info info" during system installation.Ludovic Courtès
Based on a suggestion by Chris Marusich <cmmarusich@gmail.com>. * doc/guix.texi (System Installation): Suggest running "info info".
2016-03-28doc: Clarify 'cow-store'.Ludovic Courtès
Suggested by Chris Marusich <cmmarusich@gmail.com>. * doc/guix.texi (Proceeding with the Installation): Clarify what 'cow-store' is about.
2016-03-28doc: Make it clear that networking is needed for GuixSD installation.Ludovic Courtès
Suggested by Jan Nieuwenhuizen <janneke@gnu.org>. * doc/guix.texi (Preparing for Installation): Make it clear that networking is required.
2016-03-28doc: Augment documentation about security updates.Ludovic Courtès
* doc/guix.texi (Security Updates): Add paragraph on the big picture of security updates. Cross-reference 'guix lint'. (Invoking guix lint): Add CVE URLs.
2016-03-26doc: Fix typo: "wpa_supplication" --> "wpa_supplicant".Mark H Weaver
* doc/guix.texi (Preparing for Installation): Fix typo.
2016-03-26environment: container: Create dummy home directory and /etc/passwd.David Thompson
* 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.
2016-03-25doc: Mention 'guix challenge' in "Features".Ludovic Courtès
* doc/guix.texi (Features): Mention trust and 'guix challenge'.
2016-03-25doc: Rephrase introduction to give a better overview.Ludovic Courtès
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.
2016-03-24doc: We now need 1 GiB for the installation USB image.Ludovic Courtès
* doc/guix.texi (Building the Installation Image): Change image size to 1G. * build-aux/hydra/gnu-system.scm (qemu-jobs): Likewise.
2016-03-24doc: Update reference to the Info reader's manual.Ludovic Courtès
* doc/guix.texi (System Installation): Refer to 'info-stnd' instead of 'info'. (Preparing for Installation): Likewise.
2016-03-23doc: Add "lightweight desktop" OS config example.Ludovic Courtès
* 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.
2016-03-20gexp: Add #:disallowed-references.Ludovic Courtès
* 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.
2016-03-20derivations: Add #:disallowed-references.Ludovic Courtès
* 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.
2016-03-19build: Protect against misconfiguration of localstatedir.Ludovic Courtès
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.
2016-03-17doc: Add missing comma after @xref.Ludovic Courtès
Reported by Alex Kost <alezost@gmail.com>. * doc/guix.texi (Service Reference): Add comma after @xref.
2016-03-17doc: GNOME is now available.Ludovic Courtès
* doc/guix.texi (Limitations): Rephrase item about GNOME and KDE.
2016-03-16substitute: Honor client-provided empty URL list.Ludovic Courtès
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.
2016-03-16build: Default to "https://mirror.hydra.gnu.org/" for substitutes.Ludovic Courtès
* 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.
2016-03-15gnu: services: Add GNOME and XFCE desktop services.Andy Wingo
* 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.
2016-03-15doc: Clarify and consolidate modify-services documentation.Chris Marusich
* 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>
2016-03-15doc: Add "Hardware Considerations" node.Ludovic Courtès
Suggested by Nils Gillmann <niasterisk@grrlz.net>. * doc/guix.texi (Hardware Considerations): New node. (operating-system Reference): Mention it.
2016-03-14doc: Fix incorrect use of @xref.Andreas Enge
This is a follow-up to commit 1068f26b797ed7c1475d93cab6eed53c9097c7f6. Reported by Alex Kost <alezost@gmail.com>. * doc/guix.texi (Building the Installation Image): Replace @xref by @ref.
2016-03-14build: Add Ant build system.Ricardo Wurmus
* guix/build-system/ant.scm: New file. * guix/build/ant-build-system: New file. * Makefile.am (MODULES): Add new files. * doc/guix.texi (Build Systems): Document ant-build-system.
2016-03-11doc: Suggest `guix.scm' for upstream maintainers.Jan Nieuwenhuizen
* doc/guix.texi (Invoking guix package): Suggest `guix.scm'. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2016-03-10substitute: Add HTTPS support.Ludovic Courtès
Fixes <http://bugs.gnu.org/22937>. Reported by Chris Marusich <cmmarusich@gmail.com>. * guix/scripts/substitute.scm (fetch): Add 'https' alongside 'http'. Use 'open-connection-for-uri' instead of 'open-socket-for-uri'. Call 'setvbuf' only when PORT matches 'file-port?'. (http-multiple-get): Likewise. Change 'base-url' parameter to 'base-uri'. (fetch-narinfos)[do-fetch]: Add 'https' case alongside 'http'. Pass URI instead of URL to 'http-multiple-get'. * doc/guix.texi (Requirements): Move GnuTLS one level higher and mention HTTPS substitutes. (Substitutes): Mention HTTPS and recommend it. Explain why servers are not authenticated. Add "On Trusting Binaries" subsection.
2016-03-09doc: Add note on store immutability.Ludovic Courtès
* doc/guix.texi (The Store): Mention "store items" and the database location. Add note on the store's immutability.
2016-03-08guix build: Add '--quiet'.Ludovic Courtès
Fixes <http://bugs.gnu.org/19772>. Reported by Andrei Osipov <andrspv@gmail.com>. * guix/scripts/build.scm (show-help, %options): Add --quiet. (guix-build): Parameterize 'current-build-output-port' accordingly. * doc/guix.texi (Invoking guix build): Use it in example. (Additional Build Options): Document it.
2016-03-05doc: Explain how to check whether security updates are used.Ludovic Courtès
Based on <https://lists.gnu.org/archive/html/guix-devel/2016-03/msg00009.html>. * doc/guix.texi (Security Updates): Explain how to check whether we're using a grafted version.
2016-03-05doc: Typos and small stylistic changes.Andreas Enge
* guix.texi: Correct typos and make minor changes.
2016-03-04doc: Mention syslogd configuration.Ludovic Courtès
* gnu/services/base.scm (syslog-service): Add xref to Inetutils in the docstring. (%default-syslog.conf): Export. * doc/guix.texi (Base Services): Update accordingly.
2016-03-03doc: Improve Info categories.Ludovic Courtès
* doc/guix.texi: Change main category to "System administration". Fix syntax of subnodes. Add entries for 'guix pull' and 'guix gc'. Add "Emacs" category.
2016-03-02utils: Use '@' for separating package names and version numbers.Mathieu Lirzin
This provides the ability to use numbers in package names. Fixes <http://bugs.gnu.org/19219>. * guix/utils.scm (package-name->name+version): New procedure. * gnu/packages.scm (%find-package): Add a FALLBACK? keyword argument. Use the previous method when no package is found. (specification->package+output, specification->package): Adapt documentation to new syntax. * doc/guix.texi (Invoking guix package, Invoking guix import): Likewise. * guix/ui.scm (package-specification->name+version+output): Likewise. * guix/scripts/import/hackage.scm (show-help): Likewise. * tests/guix-build.sh: Adapt to new syntax. * tests/guix-lint.sh: Likewise. * tests/guix-package.sh: Likewise. * tests/ui.scm ("package-specification->name+version+output"): Likewise. * tests/utils.scm ("package-name->name+version"): Likewise. * NEWS: Mention new syntax.
2016-03-02guix build: Move '--no-grafts' to the common build options.Ludovic Courtès
* guix/scripts/build.scm (%options): Move --no-grafts to... (%standard-build-options): ... here. (show-help, show-build-options-help): Adjust accordingly. * guix/scripts/archive.scm (%default-options): Add 'graft?'. (guix-archive): Parametrize '%graft?'. * guix/scripts/environment.scm (%default-options): Add 'graft?'. (guix-environment): Parametrize '%graft?'. * guix/scripts/package.scm (%default-options): Add 'graft?'. (guix-package): Parametrize '%graft?'. * guix/scripts/system.scm (%default-options): Add 'graft?'. (guix-system): Parametrize 'graft?'. * doc/guix.texi (Additional Build Options): Move --no-grafts to... (Common Build Options): ... here.
2016-03-01grafts: Graft recursively.Ludovic Courtès
Fixes <http://bugs.gnu.org/22139>. * guix/grafts.scm (graft-derivation): Rename to... (graft-derivation/shallow): ... this. (graft-origin-file-name, item->deriver, non-self-references) (cumulative-grafts, graft-derivation): New procedures * tests/grafts.scm ("graft-derivation, grafted item is a direct dependency"): Clarify title. Use 'grafted' instead of 'graft' to refer to the grafted derivation. ("graft-derivation, grafted item is an indirect dependency") ("graft-derivation, no dependencies on grafted output"): New tests. * guix/packages.scm (input-graft): Change to take a package instead of an input. (input-cross-graft): Likewise. (fold-bag-dependencies): New procedure. (bag-grafts): Rewrite in terms of 'fold-bag-dependencies'. * tests/packages.scm ("package-derivation, indirect grafts"): Comment out. * doc/guix.texi (Security Updates): Mention run-time dependencies and recursive grafting.
2016-02-26import: Add github-updater.Ben Woodcroft
* guix/import/github.scm: New file. * guix/scripts/refresh.scm (%updaters): Add %GITHUB-UPDATER. * doc/guix.texi (Invoking guix refresh): Mention it. * Makefile.am (MODULES): Add gnu/import/github.scm.
2016-02-26doc: Capitalize section title.Ludovic Courtès
* doc/guix.texi (Running GuixSD in a VM): Capitalize section title.
2016-02-25Merge branch 'media-updates'Mark H Weaver
2016-02-25doc: Clarify the form of UUIDs we expect.Ludovic Courtès
Fixes <http://bugs.gnu.org/22797>. Reported by Alex Kost <alezost@gmail.com>. * doc/guix.texi (File Systems): Clarify which UUIDs we're talking about.
2016-02-25store: Clarify documentation of 'valid-path?'.Ludovic Courtès
* guix/store.scm (valid-path?): Improve docstring. * doc/guix.texi (The Store): Update accordingly.
2016-02-24doc: Improve recent changes in "Binary Installation".Ludovic Courtès
This amends part of c8e2688. * doc/guix.texi (Binary Installation): Improve wording of some parts. Fix Upstart example. Remove incorrect paragraph about locales. Reinstate bit about reproducing the binary tarball.
2016-02-24doc: Clarify who can run 'guix pull'.Ludovic Courtès
Suggested by Chris Marusich <cmmarusich@gmail.com>. * doc/guix.texi (Invoking guix pull): Add paragraph explaining that any user can run 'guix pull'.
2016-02-24doc: Add details for binary installation.George Clemmer
* doc/guix.texi (Binary Installation): Provide some more details for binary installation, in particular automatic starting of the daemon. Signed-off-by: Andreas Enge <andreas@enge.fr>
2016-02-24doc: Fix minor typos and add missing words.Chris Marusich
* doc/guix.texi (Shepherd Services): Add missing words. (Invoking guix system): Fix typo. (Service Types and Services): Fix typo. * doc/contributing.texi (Submitting Patches): Fix typo. Signed-off-by: Andreas Enge <andreas@enge.fr>
2016-02-24gnu-maintenance: Add X.org updater.Andy Wingo
* guix/gnu-maintenance.scm (xorg-package?, latest-xorg-release): New private functions. (%xorg-updater): New public variable. * guix/scripts/refresh.scm (%updaters): Add %xorg-updater. * doc/guix.texi (Invoking guix refresh): Mention the new updater.
2016-02-23doc: Add example of VCS-snapshot version numbers.Ludovic Courtès
* doc/guix.texi (Version Numbers): Add example for VCS version numbers.
generated by cgit