summary refs log tree commit diff
path: root/doc/guix.texi
AgeCommit message (Collapse)Author
2015-06-11guix build: Allow directories to be passed to --with-source.Ludovic Courtès
* guix/scripts/build.scm (package-with-source)[tarball-base-name]: Gracefully handle file names that lack an extension. Pass #:recursive? #t to 'download-to-store'. * guix/download.scm (download-to-store): Add #:recursive? parameter and pass it to 'add-to-store'. * doc/guix.texi (Invoking guix build): Add an example of --with-source with a directory.
2015-06-09import: hackage: Refactor parsing code and add new options.Federico Beffa
* guix/import/cabal.scm: New file. * guix/import/hackage.scm: Update to use the new Cabal parsing module. * tests/hackage.scm: Update tests. * guix/scripts/import/hackage.scm: Add new '--cabal-environment' and '--stdin' options. * doc/guix.texi: ... and document them. * Makefile.am (MODULES): Add 'guix/import/cabal.scm', 'guix/import/hackage.scm' and 'guix/scripts/import/hackage.scm'. (SCM_TESTS): Add 'tests/hackage.scm'.
2015-06-08doc: Suggest unpacking the binary tarball in /tmp.Ludovic Courtès
Suggested by Thomas Schwinge <thomas@codesourcery.com> and others. * doc/guix.texi (Binary Installation): Suggest unpacking in /tmp rather than /.
2015-06-08install: Omit /root from the binary tarball.Ludovic Courtès
Suggested by Thomas Schwinge <thomas@codesourcery.com>. * gnu/system/install.scm (self-contained-tarball): Remove "/root/.guix-profile" from the 'tar' arguments. * doc/guix.texi (Binary Installation): Add a step to create ~root/.guix-profile.
2015-06-08monads: Allow n-ary '>>=' expressions.Ludovic Courtès
Suggested by Federico Beffa <beffa@fbengineering.ch>. * guix/monads.scm (bind-syntax): New macro. (with-monad): Use it instead of 'identifier-syntax'. * tests/monads.scm (">>= with more than two arguments"): New test. * doc/guix.texi (The Store Monad): Explain that there can be several MPROC. Add an example.
2015-06-07doc: Explain where the number of build users comes from.Ludovic Courtès
Suggested by Thomas Schwinge <thomas@codesourcery.com>. * doc/guix.texi (Build Environment Setup): Explain where the number of build users comes from.
2015-06-06guix gc: Add '--verify'.Ludovic Courtès
* guix/scripts/gc.scm (show-help, %options): Add --verify. (guix-gc): Handle it. * doc/guix.texi (Invoking guix gc): Document --verify, and move --optimize description right below it.
2015-06-05system: 'hosts-file' is now a file-like object.Ludovic Courtès
Partly fixes <http://bugs.gnu.org/20720>. Reported by Alex Kost <alezost@gmail.com>. * gnu/system.scm (default-/etc/hosts): Change 'text-file' to 'plain-file'. (maybe-file->monadic): New procedure. (operating-system-etc-directory): Use it. * doc/guix.texi (operating-system Reference, Networking Services): Adjust accordingly.
2015-06-05system: 'sudoers' is now a file-like object.Ludovic Courtès
Partly fixes <http://bugs.gnu.org/20720> Reported by Alex Kost <alezost@gmail.com>. * gnu/system.scm (etc-directory): Change default #:sudoers value to a 'plain-file'. Don't bind it. Remove #~#$. (maybe-string->file): New procedure. (operating-system-etc-directory): Use it. (%sudoers-specification): Use 'plain-file'. * doc/guix.texi (operating-system Reference): Adjust accordingly.
2015-06-05doc: Explain "file-like objects".Ludovic Courtès
* doc/guix.texi (G-Expressions): Mention "file-like objects" and explain more.
2015-06-03gexp: Add 'plain-file'.Ludovic Courtès
* guix/gexp.scm (<plain-file>): New type. (plain-file, plain-file-compiler): New procedures. * tests/gexp.scm ("one plain file"): New test. * doc/guix.texi (G-Expressions): Document 'plain-file'.
2015-05-28guix environment: Add --ad-hoc option.David Thompson
* guix/scripts/environment.scm (%options): Add "ad-hoc" option. (show-help): Display help for "--ad-hoc". (packages+propagated-inputs): New procedure. (guix-environment): Create ad hoc environment when asked. * doc/guix.texi ("invoking guix environment"): Document it.
2015-05-27doc: Clarify that --disable-chroot is needed for non-root users.Ludovic Courtès
* doc/guix.texi (Build Environment Setup, Invoking guix-daemon): Mention --disable-chroot as needed for non-root users.
2015-05-25guix system: Add '--on-error'.Ludovic Courtès
* guix/ui.scm (load*): Add #:on-error parameter. [tag, error-string]: New variables. Wrap 'load' call in 'call-with-prompt'. Pass TAG to 'make-stack'. Honor ON-ERROR after 'report-load-error' call. (report-load-error): Change to not exit on error. Make private. * guix/scripts/system.scm (show-help, %options): Add --on-error. (guix-system): Use 'load*' and pass it #:on-error.
2015-05-25doc: Fix inaccurate wording in "operating-system Reference".Ludovic Courtès
* doc/guix.texi (operating-system Reference): Add missing "kernel".
2015-05-25system: Define '%base-user-accounts'.Ludovic Courtès
* gnu/system/shadow.scm (%base-user-accounts): New variable. * gnu/system.scm (<operating-system>)[users]: Use it as the default value. * gnu/system/examples/bare-bones.tmpl (users): Use it. * gnu/system/examples/desktop.tmpl (users): Likewise. * doc/guix.texi (operating-system Reference, User Accounts): Adjust accordingly.
2015-05-23doc: Add "Running Guix Before It Is Installed".Ludovic Courtès
* doc/guix.texi (Running Guix Before It Is Installed): New node. (Packaging Guidelines): Refer to it.
2015-05-23doc: Update detailed node list.Ludovic Courtès
* doc/guix.texi (Top): Add "package Reference" and "origin Reference" in detailed node list.
2015-05-22doc: Clarify the module file name convention.Ludovic Courtès
* doc/guix.texi (Package Modules): Clarify the footnote about the module file names convention. Tweak the wording.
2015-05-22doc: More cross-references.Ludovic Courtès
* doc/guix.texi (Invoking guix package): Add xref to "package Reference". (package Reference): Add xref to "Invoking guix package". Expound 'native-inputs' example, and add xref to "Invoking guix lint".
2015-05-22doc: Add a cross-reference to "origin Reference".Ludovic Courtès
* doc/guix.texi (Defining Packages): Add xref to "origin Reference".
2015-05-22doc: Make '--manifest' more visible.Ludovic Courtès
* doc/guix.texi (Invoking guix package): Mention the declarative approach and --manifest in the intro. And an anchor for --manifest. Explain why/how it can be used. Tweak wording.
2015-05-21services: xorg: Allow extra config text to be added verbatim.Ludovic Courtès
* gnu/services/xorg.scm (xorg-configuration-file): Add #:extra-config and honor it. * doc/guix.texi (X Window): Adjust accordingly.
2015-05-21services: xorg: Make 'xorg-configuration-file' public.Ludovic Courtès
* gnu/services/xorg.scm (xorg-configuration-file): New procedure, with code formerly in 'xorg-start-command'. (xorg-start-command): Remove #:drivers and #:resolutions; add #:configuration-file; use it as well as 'xorg-configuration-file'.
2015-05-20Revert "doc: Suggest how to preserve /var and /root owner and permissions."Mark H Weaver
This reverts commit 8c3a5d7059a24e9c6d7bf14be296169cdcf06ad6, which is no longer needed due to commit b2a5fa594e66b9d929df11fc7a38e4b367a00a5e.
2015-05-20package: Add --manifest option.David Thompson
* guix/scripts/package.scm (show-help): Add help text. (%options): Add manifest option. (guix-package): Add manifest option handler. * doc/guix.texi ("Invoking guix package"): Document it. * tests/guix-package.sh: Add test.
2015-05-20guix package: Add optional argument to --search-paths.Ludovic Courtès
* guix/scripts/package.scm (search-path-environment-variables): Add #:kind parameter. Pass it to 'environment-variable-definition'. (display-search-paths): Add #:kind parameter and pass it to 'search-path-environment-variables'. (%options): Add an optional parameter for "--search-paths". (guix-package)[process-query]: Handle it. * tests/guix-package-net.sh: Adjust existing test. * tests/guix-package.sh: Adjust existing tests and add new test. * doc/guix.texi (Invoking guix package): Document it.
2015-05-19doc: Add "package Reference" and "origin Reference" sections.Taylan Ulrich Bayırlı/Kammer
* doc/guix.texi (Defining Packages): Link to "package Reference". Add menu. (package Reference, origin Reference): New subsections.
2015-05-19guix gc: Add '--optimize'.Ludovic Courtès
* guix/scripts/gc.scm (show-help, %options): Add --optimize. (guix-gc): Handle it.
2015-05-19build: Make sure $CXX supports C++11.Ludovic Courtès
* m4/guix.m4 (GUIX_CHECK_CXX11, GUIX_ASSERT_CXX11): New macros. * config-daemon.ac: Use 'AC_LANG([C++])' and 'GUIX_ASSERT_CXX11'.C * doc/guix.texi (Requirements): Mention C++11 support.
2015-05-18doc: Re-generate detailed node listing.Ludovic Courtès
* doc/guix.texi (Top): Update detailed node listing.
2015-05-18install: Files in the tarball are all root-owned.Ludovic Courtès
Fixes a thinko introduced in 175ced4. * gnu/system/install.scm (self-contained-tarball): Use "root:0" as the owner and group. * doc/guix.texi (Binary Installation): Revert 175ced4.
2015-05-18install: Use the right user and group name for files in the binary tarball.Ludovic Courtès
Suggested by Andreas Enge <andreas@enge.fr> at <http://lists.gnu.org/archive/html/guix-devel/2015-05/msg00220.html>. * gnu/system/install.scm (self-contained-tarball): Pass --owner and --group to 'tar'. * doc/guix.texi (Binary Installation): Move group and account creation before extraction. Make "run the daemon" a separate step.
2015-05-18doc: Suggest the same build user and group names as on GuixSD.Ludovic Courtès
* doc/guix.texi (Build Environment Setup): Suggest the user and group names as used on GuixSD. (Binary Installation): Adjust accordingly.
2015-05-17doc: Better suggestion for the /usr/local/bin/guix symlink.Ludovic Courtès
Suggested by Andreas Enge <andreas@enge.fr> at <http://lists.gnu.org/archive/html/guix-devel/2015-05/msg00220.html>. * doc/guix.texi (Binary Installation): Use the longer 'guix' file name.
2015-05-17doc: Document 'ifconfig eno1 up' before running 'dhclient'.Ludovic Courtès
Reported by Scott McDonough <smcdonough1@gmail.com> in <http://bugs.gnu.org/20582>. * doc/guix.texi (System Installation): Suggested setting the interface up before running 'dhclient'.
2015-05-17doc: Suggest how to preserve /var and /root owner and permissions.Ludovic Courtès
Reported by Andreas Enge <andreas@enge.fr>. * doc/guix.texi (Binary Installation): Suggest --skip-old-files when extracting the archive.
2015-05-13doc: Increase package count.Ludovic Courtès
* doc/guix.texi (System Installation): Increase package count.
2015-05-12publish: Add '--listen'.Ludovic Courtès
* guix/scripts/publish.scm (show-help, %options): Add --listen. (getaddrinfo*): New procedure. (%default-options): Add 'address'. (open-server-socket): Replace 'addr' and 'port' with 'address', a sockaddr. (guix-publish): Adjust accordingly. Augment "publishing" message with the actual address. * doc/guix.texi (Invoking guix publish): Document it.
2015-05-12publish: Add '--user' option.Ludovic Courtès
* guix/scripts/publish.scm (show-help): Add --user. (%options): Likewise. (run-publish-server): Change 'port' parameter to 'socket'. Pass #:socket instead of #:addr and #:port to 'run-server'. Update caller accordingly. (open-server-socket, gather-user-privileges): New procedures. (guix-publish): Use them. Force %PRIVATE-KEY and %PUBLIC-KEY early on. Warn when running as root. * doc/guix.texi (Invoking guix publish): Document --user.
2015-05-12doc: Make 'guix publish' more visible.Ludovic Courtès
* doc/guix.texi (Substitutes): Add xref to "Invoking guix publish". (Invoking guix publish): Add xref to "Substitutes". Explain what Hydra is.
2015-05-12doc: "GSD" -> "GuixSD".Ludovic Courtès
* doc/guix.texi: Replace "GSD" with "GuixSD".
2015-05-12doc: Use @indicateurl where appropriate.Ludovic Courtès
* doc/guix.texi (Binary Installation, Invoking guix-daemon, System Installation): Use @indicateurl instead of @code where appropriate.
2015-05-11doc: Document X.509 certificates.Ludovic Courtès
* doc/guix.texi (Using the Configuration System): Add xref to "X.509 Certificates". (X.509 Certificates): New section. * gnu/system/examples/desktop.tmpl: Use NSS-CERTS.
2015-05-10doc: Mention GNU Make as a requirement.Ludovic Courtès
* README (Requirements): Add GNU Make. * doc/guix.texi (Requirements): Likewise.
2015-05-10build: Require Guile >= 2.0.7.Ludovic Courtès
* configure.ac: Require guile-2.0 >= 2.0.7. * README: Adjust accordingly. * doc/guix.texi (Requirements): Likewise.
2015-05-09doc: Show both the "bare-bones" and the "desktop" configurations.Ludovic Courtès
* doc/guix.texi (System Installation): Add xref to "Using the Configuration System" instead of including one here. (Using the Configuration System): Remove first example, and include os-config-bare-bones.texi instead. Include os-config-desktop.texi as a second example. * doc.am (OS_CONFIG_EXAMPLES_TEXI): New variable. (BUILT_SOURCES, EXTRA_DIST, MAINTAINERCLEANFILES): Use it. (doc/os-config.texi): Remove. (doc/os-config-%.texi): New target.
2015-05-09install: Have several OS config templates under /etc/configuration.Ludovic Courtès
* gnu/system/install.scm (configuration-template-service): Remove 'local-template' and 'template'. Add 'search' and 'templates'. [activate]: Copy all of TEMPLATES to /etc/configuration. * doc/guix.texi (System Installation): Adjust file name accordingly.
2015-05-08doc: Document 'avahi-service'.Ludovic Courtès
* gnu/services/avahi.scm (avahi-service): Add URL in docstring. * doc/guix.texi (Networking Services): Document it. (Name Service Switch): Fix cross-reference.
2015-05-08doc: Document sessions and ~/.xsession for SLiM.Ludovic Courtès
* gnu/services/xorg.scm (slim-service): Document session types and ~/.xsession. * doc/guix.texi (X Window): Adjust accordingly.