summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
...
* | | | | doc: Clarify reference.Hartmut Goebel2017-03-181-1/+3
| | | | | | | | | | | | | | | | | | | | | | | | | * doc/guix.texi (Invoking guix environment): Explicitly name "guix environment".
* | | | | doc: Fix examples.Hartmut Goebel2017-03-181-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | To "spawns a Guile REPL", --ad-hoc is required. * doc/guix.texi (Invoking guix environment): Add "--ad-hoc" to container examples.
* | | | | doc: Make "Application Setup" slightly more visible.Ludovic Courtès2017-03-181-3/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Suggested by Arne Babenhauserheide. * doc/guix.texi (Binary Installation): Make the "Application Setup" reference an 8th item in the list.
* | | | | build: Require Guile >= 2.0.9.Ludovic Courtès2017-03-181-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * configure.ac: Bump requirement to 2.0.9. * doc/guix.texi (Requirements): Adjust accordingly. * README (Requirements): Likewise. * build-aux/download.scm: Remove workaround for <http://bugs.gnu.org/13095>. * guix/build/download.scm: Likewise. (http-fetch)[post-2.0.7?]: Remove. Remove conditional code for not POST-2.0.7?. * guix/http-client.scm: Remove workaround for <http://bugs.gnu.org/13095>. (http-fetch)[post-2.0.7?]: Remove. Remove conditional code for not POST-2.0.7?. * guix/serialization.scm (read-latin1-string): Remove mention of 2.0.9. * tests/nar.scm: Use (ice-9 control). (let/ec): Remove.
* | | | | pack: Add '--target'.Ludovic Courtès2017-03-181-2/+8
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * guix/scripts/pack.scm (self-contained-tarball): Add #:target. (docker-image): Add #:target. [build]: Pass it to 'build-docker-image'. (%options, show-help): Add '--target'. (guix-pack): Pass TARGET to 'profile-derivation' and to 'build-image'. * guix/docker.scm (build-docker-image): Add #:system parameter and honor it. * doc/guix.texi (Invoking guix pack): Document '--target'. (Additional Build Options): Refer to the Autoconf manual instead of the obsolete 'configure.info' for cross-compilation.
* | | | | doc: Really document 'guix pack --format'.Ludovic Courtès2017-03-171-5/+19
| | | | | | | | | | | | | | | | | | | | * doc/guix.texi (Invoking guix pack): Properly document --format.
* | | | | doc: Reorganize categories.Ludovic Courtès2017-03-161-1/+2
| | | | | | | | | | | | | | | | | | | | | | | | | * doc/guix.texi: Move "guix build" to the "Software Development" category; add "guix pack".
* | | | | doc: Mention 'guix pack' reproducibility.Ludovic Courtès2017-03-161-1/+3
| | | | | | | | | | | | | | | | | | | | * doc/guix.texi (Invoking guix pack): Mention reproducibility.
* | | | | pack: Add '--format' option and Docker output support.Ludovic Courtès2017-03-161-17/+17
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * guix/docker.scm: Remove dependency on (guix store) and (guix utils). Use (guix build store-copy). Load (json) lazily. (build-docker-image): Remove #:system. Add #:closure, #:compressor, and 'image' parameters. Use 'uname' to determine the architecture. Remove use of 'call-with-temporary-directory'. Use 'read-reference-graph' to compute ITEMS. Honor #:compressor. * guix/scripts/pack.scm (docker-image): New procedure. (%default-options): Add 'format'. (%formats): New variable. (%options, show-help): Add '--format'. (guix-pack): Honor '--format'. * guix/scripts/archive.scm: Remove '--format' option. This reverts commits 1545a012cb7cd78e25ed99ecee26df457be590e9, 01445711db6771cea6122859c3f717f130359f55, and 03476a23ff2d4175b7d3c808726178f764359bec. * doc/guix.texi (Invoking guix pack): Document '--format'. (Invoking guix archive): Remove documentation of '--format'.
* | | | | services: connman: Rework service.Mathieu Othacehe2017-03-161-8/+26
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * gnu/services/networking.scm (connman-service): Remove. (<connman-configuration>): New record specifying the package to be used (connman) and whether vpn plugin shall be disabled (disable-vpn?). (connman-configuration): New exported variable. (connman-configuration?): New exported variable. (connman-service-type): Export it. * doc/guix.texi (Networking Services): Adjust accordingly. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* | | | | gexp: Add '=>' syntax to import computed modules.Ludovic Courtès2017-03-161-2/+16
| |_|_|/ |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * guix/gexp.scm (imported-files)[file-pair]: Add case for pairs where the cdr is not a string. (imported-modules): Support '=>' syntax in MODULES. * tests/gexp.scm ("imported-files with file-like objects") ("gexp->derivation & with-imported-module & computed module"): New tests. * doc/guix.texi (G-Expressions): Document '=>' syntax for 'with-imported-modules'.
* | | | build: Prefer Guile 2.2 over 2.0.Ludovic Courtès2017-03-151-1/+2
| | | | | | | | | | | | | | | | | | | | | | | | * configure.ac: In 'GUILE_PKG', prefer 2.2 over 2.0. Remove warning about 2.2 not being fully supported. * doc/guix.texi (Requirements): Mention Guile 2.2.x.
* | | | pack: Add '--symlink'.Ludovic Courtès2017-03-141-0/+24
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * guix/scripts/pack.scm (self-contained-tarball): Add #:symlinks parameter. [build](symlink->directives): New procedure (directives): New variable. Add call to 'evaluate-populate-directive'. Pass the directories among DIRECTIVES to 'tar'. (%default-options): Add 'symlinks'. (%options, show-help): Add '--symlink'. (guix-pack): Honor it. * gnu/build/install.scm (evaluate-populate-directive): Export. * doc/guix.texi (Invoking guix pack): Document it.
* | | | pack: Add '--localstatedir' option.Ludovic Courtès2017-03-141-1/+14
| |_|/ |/| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * guix/scripts/pack.scm (self-contained-tarball): Add #:localstatedir? parameter and honor it. (%options, show-help): Add '--localstatedir'. (guix-pack): Honor it. * gnu/build/install.scm (populate-single-profile-directory): Add #:register? parameter and honor it. * doc/guix.texi (Binary Installation): Use '--localstatedir' in example. (Invoking guix pack): Document it.
* | | Add 'guix pack'.Ludovic Courtès2017-03-121-0/+64
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * gnu/system/install.scm (self-contained-tarball): Move to... * guix/scripts/pack.scm: ... here. New file. * doc/guix.texi (Binary Installation): Mention 'guix pack'. (Invoking guix pack): New node. * build-aux/make-binary-tarball.scm: Remove. * Makefile.am (MODULES): Add guix/scripts/pack.scm. (EXTRA_DIST): Remove build-aux/make-binary-tarball.scm. (guix-binary.%.tar.xz): Rewrite using 'guix pack'. * build-aux/hydra/gnu-system.scm (tarball-jobs): Adjust accordingly.
* | | services: dovecot: Fix unix_listeners and fifo_listeners path types.Clément Lassieur2017-03-121-4/+6
| | | | | | | | | | | | | | | | | | | | | | | | * gnu/services/mail.scm (unix-listener-configuration)[path] (fifo-listener-configuration)[path]: Change type from 'file-name' to 'string'. * doc/guix.texi (Mail Services): Document it. Signed-off-by: Clément Lassieur <clement@lassieur.org>
* | | build: GnuTLS is now a hard dependency.Ludovic Courtès2017-03-121-11/+5
| | | | | | | | | | | | | | | | | | | | | | | | Discussed as part of <https://bugs.gnu.org/25975>. * configure.ac: Check for (gnutls) and error out if it's missing. * doc/guix.texi (Requirements): Move GnuTLS from optional to required. (Substitutes): Remove footnote about the need for GnuTLS.
* | | linux-initrd: Add a raw-initrd and use it to define base-initrd.Mathieu Othacehe2017-03-111-12/+35
| | | | | | | | | | | | | | | | | | | | | | | | * gnu/system/linux-initrd.scm (raw-initrd): New exported variable. (base-initrd): Use raw-initrd to build the initrd. * doc/guix.texi (Initial RAM Disk): Document it. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* | | doc: Update the package count.John Darrington2017-03-111-1/+1
| | | | | | | | | | | | * doc/guix.texi: Update the number of packages available.
* | | services: openssh: Fix 'PrintLastLog' default behaviour.Clément Lassieur2017-03-101-0/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * gnu/services/ssh.scm (openssh-config-file): Add 'print-last-log?' option. (<openssh-configuration>)[print-last-log?]: Add it. (openssh-activation): Touch /var/log/lastlog. * doc/guix.texi (Networking Services): Document 'print-last-log?'. Before that, the service did not work as expected because /var/log/lastlog did not exist. Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>
* | | services: openssh: Remove deprecated options.Clément Lassieur2017-03-101-8/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | * gnu/services/ssh.scm (openssh-config-file): Remove them. (<openssh-configuration>)[rsa-authentication?]: Remove it. (<openssh-configuration>)[protocol-number]: Remove it. * doc/guix.texi (Networking Services): Remove them. Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>
* | | services: openssh: Enable PAM.Clément Lassieur2017-03-101-0/+16
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * gnu/services/ssh.scm: (openssh-pam-services): New procedure. (openssh-service-type): Use it to extend PAM-ROOT-SERVICE-TYPE. (<openssh-configuration>)[challenge-response-authentication?]: New field. (<openssh-configuration>)[use-pam?]: New field. (openssh-config-file): Add them. * doc/guix.texi (Networking Services): Document them. Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>
* | | services: Add exim-service-type.Carlo Zancanaro2017-03-101-1/+41
| |/ |/| | | | | | | | | | | | | | | | | * gnu/services/mail.scm (<exim-configuration>): New record type. (exim-computed-config-file, exim-shepherd-service, exim-activation, exim-etc, exim-profile): New procedures. (exim-service-type, %exim-accounts): New variables. * doc/guix.text (Mail Services): Document it. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* | Revert "doc: Symlink daemon start-up files."Leo Famulari2017-03-061-2/+9
| | | | | | | | | | | | | | | | | | | | This reverts commit b7230de54b493da5a78922b4226255763b525a98. Versions of systemd that supported symlinked service files are not yet widely deployed. See this thread for more information: http://lists.gnu.org/archive/html/guix-devel/2017-01/msg01199.html
* | services: Add agetty service.Leo Famulari2017-03-051-2/+168
| | | | | | | | | | | | | | | | | | * gnu/services/base.scm (<agetty-configuration>): New record type. (agetty-shepherd-service, agetty-service): New procedures. (agetty-service-type): New variable. * doc/guix.texi (Base Services): Document it. [mingetty-configuration],[kmscon-configuration]: Specify the types of supported consoles.
* | services: guix: Support building in a directory besides '/tmp'.Leo Famulari2017-02-231-0/+3
| | | | | | | | | | | | * gnu/services/base.scm (<guix-configuration>)[tmpdir]: New field. (guix-shepherd-service): Use 'tmpdir' in #:environment-variables. * doc/guix.texi (Base Services)[guix-configuration]: Document it.
* | services: guix: Support using an HTTP proxy.Leo Famulari2017-02-221-0/+4
|/ | | | | | * gnu/services/base.scm (<guix-configuration>)[http-proxy]: New field. (guix-shepherd-service): Use 'http-proxy' in #:environment-variables. * doc/guix.texi (Base Services)[guix-configuration]: Document it.
* doc: Update patch submission instructions.Ludovic Courtès2017-02-131-1/+13
| | | | | * doc/contributing.texi (Submitting Patches): Add paragraph on guix-patches@gnu.org.
* services: Add openvswitch-service-type.宋文武2017-02-121-0/+17
| | | | | | | * gnu/services/networking.scm (<openvswitch-configuration>): New record type. (openvswitch-activation, openvswitch-shepherd-service): New procedures. (openvswitch-service-type): New variable. * doc/guix.texi (Networking Services): Document it.
* gnu: Add dub-build-system.Danny Milosavljevic2017-02-101-0/+10
| | | | | | | * guix/build-system/dub.scm: New file. * guix/build/dub-build-system.scm: New file. * Makefile.am (MODULES): Add them. * doc/guix.texi: Add section for dub-build-system.
* import: Add stackage importer and updater.Federico Beffa2017-02-091-1/+32
| | | | | | | | | | | | * guix/import/stackage.scm: New file. * guix/scripts/import/stackage.scm: New file. * Makefile.am (MODULES): Add new files. * guix/scripts/import.scm (importers): Add "stackage". * guix/scripts/refresh.scm (%updaters): Add %stackage-updater. * doc/guix.texi (Invoking 'guix import'): Document the importer. (Invoking 'guix refresh'): Add stackage to option --type valid values. * guix/import/hackage.scm (guix-package->hackage-name, hackage-fetch, hackage-source-url, hackage-cabal-url, hackage-package?): Export them.
* services: Add 'special-files-service-type'.Ludovic Courtès2017-02-081-0/+44
| | | | | | | | | | | | | * gnu/build/activation.scm (activate-/bin/sh): Remove. (activate-special-files): New procedure. * gnu/services.scm (activation-script): Remove call to 'activate-/bin/sh'. (special-files-service-type): New variable. (extra-special-file): New procedure. * gnu/services/base.scm (%base-services): Add SPECIAL-FILES-SERVICE-TYPE instance. * gnu/tests/base.scm (run-basic-test)[special-files]: New variables. ["special files"]: New test.
* services: cuirass: Add load-path to cuirass configurationMathieu Othacehe2017-02-021-0/+4
| | | | | | | | * gnu/services/cuirass.scm (<cuirass-configuration>): Add load-path field. (cuirass-shepherd-service): Honor it. * doc/guix.texi (Continuous Integration): Document it. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: Discuss encrypted swap space.Chris Marusich2017-02-011-3/+33
| | | | | | | | | | | * doc/guix.texi (Preparing for Installation): Provide an example of how to set up (encrypted) swap space using a swap file. (operating-system Reference)[swap-devices]: Clarify that swap files are supported, too. (Mapped Devices): Explain how to use a mapped device with a swap file to encrypt swap space. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: Clarify that 'guix pull' can't be easily rolled back.Chris Marusich2017-02-011-1/+3
| | | | | | | * doc/guix.texi (Invoking guix pull): Clarify that 'guix pull' can't be easily rolled back. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* services: Make 'static-networking' extensible.Ludovic Courtès2017-02-011-0/+10
| | | | | | | | | | | | | | | | | This allows users to statically define several interfaces. * gnu/services/networking.scm (<static-networking>)[provision] [name-servers]: Add default values. (static-networking-shepherd-service) (static-networking-etc-files) (static-networking-shepherd-services): New procedures. (static-networking-service-type): Change to extend both SHEPHERD-ROOT-SERVICE-TYPE and ETC-SERVICE-TYPE. (static-networking-service): Remove default value of #:provision. Implement using 'simple-service'. * gnu/services/base.scm (%base-services): Replace 'static-networking-service' call with 'service' form. * doc/guix.texi (Networking Services): Update documentation.
* doc: Fix typo.Julien Lepiller2017-01-291-2/+2
| | | | * doc/guix.texi (ocaml-build-system): Replace ocaml with OCaml.
* doc: Document ocaml-build-system.Julien Lepiller2017-01-291-0/+43
| | | | * doc/guix.texi (Build Systems) [ocaml-build-system]: New definition.
* doc: Fix typos.Alex Kost2017-01-281-2/+2
| | | | | | | | | Fixes a regression introduced in commit f31f1acac2efb4bc6558b604a07b56f826423177. Reported-by roptat on #guix. * doc/guix.texi (Invoking guix build): Use "@@" instead of "@".
* doc: Fix typos.Alex Kost2017-01-281-2/+2
| | | | * doc/guix.texi: Use "@" for package specifications.
* doc: Clarify "Installing GuixSD in a VM".Leo Famulari2017-01-281-2/+2
| | | | | * doc/guix.texi (Installing GuixSD in a VM): Mention decompressing the installation image.
* doc: Fix networking instructions in "Installing GuixSD in a VM".Leo Famulari2017-01-281-1/+1
| | | | | | This is a followup to commit c8b543741f422ecf41e7635c6a1c40b3bd55947a. * doc/guix.texi (Installing GuixSD in a VM): Fix typo.
* doc: Add missing Upstart command for the binary installation.Ludovic Courtès2017-01-281-0/+1
| | | | | | | | Fixes <http://bugs.gnu.org/25551>. Reported by Jason Self <jason@bluehome.net>. * doc/guix.texi (Binary Installation): Add 'initctl reload-configuration' command for Upstart.
* doc: Add 'cups-configuration' example with 'hplip'.Ludovic Courtès2017-01-281-3/+8
| | | | * doc/guix.texi (Printing Services): Add example with 'hplip'.
* doc: Mention the need of a BIOS boot partition when using GPT.宋文武2017-01-231-0/+5
| | | | | | * doc/guix.text (Preparing for Installation)[Disk Partitioning]: Mention the need of a BIOS boot partition when using GPT with the defualt GRUB.
* doc: Fix a typo in guix.texi.Maxim Cournoyer2017-01-231-1/+1
| | | | | | * doc/guix.texi (Invoking guix environment): s/the use/use the/ Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* services: cuirass: Add port to cuirass configurationMathieu Othacehe2017-01-221-1/+5
| | | | | | | | * gnu/services/cuirass.scm (<cuirass-configuration>): Add port field. (cuirass-shepherd-service): Honor it. * doc/guix.texi (Continuous Integration): Document it. Signed-off-by: Mathieu Lirzin <mthl@gnu.org>
* services: network-manager: Use record for configuration.Christopher Baines2017-01-201-5/+35
| | | | | | | | | | | | | | | | | | | * gnu/services/network-manager.scm (<network-manager-configuration>): New record type. (network-manager-shpeherd-service): Change to use the network-manager-configuration record, rather than a package. Generate a simple configuration file from the network-manager-configuration record. (network-manager-service-type): Update extensions to take the network-manager-configuration rather than a package. (network-manager-service): Remove function, the network-manager-service-type can be used instead, and this avoids keeping the function signature and value coresponding to the service type in sync. * doc/guix.texi (Networking Services): Remove documentation for the removed network-manager-service procedure, and add documentation of the network-manager-service-type variable and network-manager-configuration record. Signed-off-by: 宋文武 <iyzsong@member.fsf.org>
* services: nginx: Add support for 'location' blocks.Christopher Baines2017-01-191-0/+43
| | | | | | | | | | | | | * gnu/services/web.scm (<nginx-server-configuration>): Add field 'locations'. (<nginx-location-configuration>): New record type. (<nginx-named-location-configuration>): New record type. (nginx-location-config): New function. (default-nginx-server-config): Include locations. * doc/guix.texi (Web Services): Document the new nginx-location-configuration and nginx-named-location-configuration data types, as well as the changes to the nginx-server-configuration. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* services: nginx: Add support the 'upstream' module.Christopher Baines2017-01-191-2/+24
| | | | | | | | | | | | * gnu/services/web.scm (<nginx-upstream-configuration>): New record type. (<nginx-configuration>): Add new field upstream-blocks. (nginx-upstream): New function. (default-nginx-config): Add upstream-list parameter. (nginx-service): Add optional upstream list keyword argument. * doc/guix.texi (Web Services): Document the new nginx-upstream-configuration data type and changes to the nginx function. Signed-off-by: Ludovic Courtès <ludo@gnu.org>