aboutsummaryrefslogtreecommitdiff
path: root/doc/guix.texi
AgeCommit message (Collapse)Author
2019-06-12doc: Improve tarball extraction example.Julien Lepiller
2019-06-11doc: Update cargo-build-system parameter docs.Ivan Petkov
* doc/guix.texi: (Build Systems)[cargo-build-system]: Add references to the #:rust, #:cargo-inputs, and #:cargo-development-inputs parameters. Remove reference to installing crate sources. Signed-off-by: Chris Marusich <cmmarusich@gmail.com>
2019-06-10store: 'build-things' accepts derivation/output pairs.Ludovic Courtès
This allows callers to request the substitution of a single derivation output. * guix/store.scm (build-things): Accept derivation/output pairs among THINGS. * guix/derivations.scm (build-derivations): Likewise. * tests/store.scm ("substitute + build-things with specific output"): New test. * tests/derivations.scm ("build-derivations with specific output"): New test. * doc/guix.texi (The Store): Adjust accordingly.
2019-06-10doc: Work around a po4a bug.Julien Lepiller
* doc/guix.texi: Work around a po4a bug that prevents `guix pull` from completing.
2019-06-10services: Add 'nix-service-type'.Oleg Pykhalov
* gnu/services/nix.scm: New file. * gnu/local.mk: Add this. * doc/guix.texi (Miscellaneous Services): Document this.
2019-06-09doc: Fix typos.Tobias Geerinckx-Rice
* doc/guix.texi (Version Control Services): Fix typos & edit surrounding text.
2019-06-07pack: Add '--entry-point'.Ludovic Courtès
* guix/scripts/pack.scm (self-contained-tarball): Add #:entry-point and warn when it's true. (squashfs-image): Add #:entry-point and honor it. (docker-image): Add #:entry-point and honor it. (%options, show-help): Add '--entry-point'. (guix-pack): Honor '--entry-point' and pass #:entry-point to BUILD-IMAGE. * gnu/tests/docker.scm (run-docker-test): Test 'docker run' with the default entry point. (build-tarball&run-docker-test): Pass #:entry-point to 'docker-image'. * doc/guix.texi (Invoking guix pack): Document it. * gnu/tests/singularity.scm (run-singularity-test)["singularity run"]: New test. (build-tarball&run-singularity-test): Pass #:entry-point to 'squashfs-image'.
2019-06-07services: Add Singularity.Ludovic Courtès
* gnu/packages/linux.scm (singularity)[source](snippet): Change file name of setuid helpers in libexec/cli/*.exec. [arguments]: Remove "--disable-suid". * gnu/services/docker.scm (%singularity-activation): New variable. (singularity-setuid-programs): New procedure. (singularity-service-type): New variable. * gnu/tests/singularity.scm: New file. * gnu/local.mk (GNU_SYSTEM_MODULES): Add it. * doc/guix.texi (Miscellaneous Services): Document it.
2019-06-06services: Add auditd.Danny Milosavljevic
* gnu/services/auditd.scm: New file. * gnu/local.mk (GNU_SYSTEM_MODULES): Add it. * doc/guix.texi (Miscellaneous Services): Document it.
2019-06-05doc: Fix typo.Diego Nicola Barbato
* doc/guix.texi (Invoking guix archive): Remove spurious hyphen in example. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2019-06-03services: guix-publish: Allow for multi-compression.Ludovic Courtès
This is a followup to b8fa86adfc01205f1d942af8cb57515eb3726c52. * guix/deprecation.scm (warn-about-deprecation): Make public. * gnu/services/base.scm (<guix-publish-configuration>)[compression]: New field. [compression-level]: Default to #f. Add '%' to getter name. (guix-publish-configuration-compression-level): Define as deprecated. (default-compression): New procedure. (guix-publish-shepherd-service)[config->compression-options]: New procedure. Use 'match-record' instead of 'match'. * doc/guix.texi (Base Services): Remove 'compression-level' and document 'compression'.
2019-06-02publish: '--compression' can be repeated.Ludovic Courtès
This allows 'guix publish' to compress and advertise multiple compression methods from which users can choose. * guix/scripts/publish.scm (actual-compression): Rename to... (actual-compressions): ... this. Expect REQUESTED to be a list, and always return a list. (%default-options): Remove 'compression. (store-item->recutils): New procedure. (narinfo-string): Change #:compression to #:compressions (plural). Adjust accordingly. (render-narinfo, render-narinfo/cached): Likewise. (bake-narinfo+nar): Change #:compression to #:compressions. [compressed-nar-size]: New procedure. Call 'compress-nar' for each item returned by 'actual-compressions'. Create a narinfo for each compression. (effective-compression): New procedure. (make-request-handler): Change #:compression to #:compressions. Use 'effective-compression' to determine the applicable compression. (guix-publish): Adjust handling of '--compression'. Print a message for each compression that is enabled. * tests/publish.scm ("/*.narinfo"): Adjust to new narinfo field ordering. ("/*.narinfo with properly encoded '+' sign"): Likewise. ("/*.narinfo with lzip + gzip"): New test. ("with cache, lzip + gzip"): New test. * doc/guix.texi (Invoking guix publish): Document it.
2019-05-31services: Add patchwork.Christopher Baines
* gnu/service/web.scm (<patchwork-database-configuration> <patchwork-settings-module>, <patchwork-configuration>): New record types. (patchwork-virtualhost): New procedure. (patchwork-service-type): New variable. * gnu/tests/web.scm (%test-patchwork): New variable. * doc/guix.text (Web Services): Document it.
2019-05-31services: Add getmail.Christopher Baines
Getmail is a mail retriever written in Python, this commit adds a service-type to run getmail. I'm looking at this, as it's a convinient way of getting mailing list messages in to Patchwork. I initially tried putting this in the (gnu services mail) module, but due to also trying to use the define-configuration pattern, it conflicted with the dovecot service. * gnu/services/getmail.scm: New file. * gnu/local.mk: Add it. * gnu/tests/mail.scm (%getmail-os, %test-getmail): New variables. (run-getmail-test): New procedure.
2019-05-27publish: Add support for lzip.Ludovic Courtès
* guix/scripts/publish.scm (show-help, %options): Support '-C METHOD' and '-C METHOD:LEVEL'. (default-compression): New procedure. (bake-narinfo+nar): Add lzip. (nar-response-port): Likewise. (string->compression-type): New procedure. (make-request-handler): Generalize /nar/gzip handler to handle /nar/lzip as well. * tests/publish.scm ("/nar/lzip/*"): New test. ("/*.narinfo with lzip compression"): New test. * doc/guix.texi (Invoking guix publish): Document it. (Requirements): Mention lzlib.
2019-05-27doc: Update default value of terminal-outputs.Jakob L. Kreuze
* doc/guix.texi: (terminal-outputs) Update default value. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2019-05-26services: sddm: Fix root login failure issue.Reza Alizadeh Majd
* gnu/services/sddm.scm (sdm-pam-service): Set uid from CONFIG. (sdm-autologin-pam-service): Set uid from CONFIG. (sdm-pam-services): Pass CONFIG to 'sddm-pam-service' and 'sddm-autologin-pam-service'. * doc/guix.texi (X Window): Adjust 'minimum-uid' documentation. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
2019-05-22doc: Murmur: Fix typo "authentication".Vagrant Cascadian
* doc/guix.texi (Murmur): Fix typo.
2019-05-22weather: Accept package specs on the command line.Ludovic Courtès
Previously, non-option arguments would be ignored. Now it puts them to good use. * guix/scripts/weather.scm (guix-weather)[package-list]: New procedure. Use it. * doc/guix.texi (Invoking guix weather): Adjust accordingly.
2019-05-22pack: Add '--root'.Ludovic Courtès
* guix/scripts/pack.scm (%options, show-help): Add "--root". (guix-pack): Honor it. * tests/guix-pack.sh: Test it. * doc/guix.texi (Invoking guix pack): Document it.
2019-05-15vm: 'system-docker-image' provides an entry point.Ludovic Courtès
This simplifies use of images created with 'guix system docker-image'. * gnu/system/vm.scm (system-docker-image)[boot-program]: New variable. [os]: Add it to the GC roots. [build]: Pass #:entry-point to 'build-docker-image'. * gnu/tests/docker.scm (run-docker-system-test): New procedure. (%test-docker-system): New variable. * doc/guix.texi (Invoking guix system): Remove GUIX_NEW_SYSTEM hack and '--entrypoint' from the example. Mention 'docker create', 'docker start', and 'docker exec'.
2019-05-15doc: Mention ModemManager.Florian Pelz
* doc/guix.texi (Desktop Services): Mention ModemManager here. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2019-05-14linux-container: Support container network sharing.Arun Isaac
* gnu/system/linux-container.scm (container-essential-services): If network is to be shared with the host, remove network configuration files from etc service. (containerized-operating-system): If network is to be shared with the host, remove nscd service and map host's /var/run/nscd if it exists. (container-script): If network is to be shared with the host, do not create network namespace. * guix/scripts/system.scm (system-derivation-for-action): Add #:container-shared-network? argument. (perform-action): Add #:container-shared-network? argument. (show-help): Add "-N, --network" help information. (%options): Add network option. (process-action): Call perform-action with #container-shared-network? argument. * doc/guix.texi (Invoking guix system): Document the "-N, --network" option. Co-authored-by: Christopher Baines <mail@cbaines.net>
2019-05-13doc: Mention the Russian translation.Ludovic Courtès
* doc/guix.texi (Top): Mention the Russian translation.
2019-05-13doc: Update list of supported architectures.Ludovic Courtès
* doc/guix.texi (GNU Distribution): Remove "experimental" bit for AArch64. Mark "mips64el-linux" as "no longer fully supported."
2019-05-12doc: Document 'auto-start?' field of 'shepherd-service'.Diego Nicola Barbato
* doc/guix.texi (shepherd-service): Document 'auto-start?' field. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2019-05-11doc: Fix typo.Diego Nicola Barbato
* doc/guix.texi (shepherd-service): Replace 'requirements' with 'requirement'. Signed-off-by: Arun Isaac <arunisaac@systemreboot.net>
2019-05-09doc: Fix typo.Josh Holland
* doc/guix.texi (cargo-build-system): Correct Carto.toml. Signed-off-by: Arun Isaac <arunisaac@systemreboot.net>
2019-05-07services: dovecot: Rename auth-verbose-passwords?.Christopher Baines
* gnu/services/mail.scm (dovecot-configuration)[auth-verbose-passwords?]: Rename to auth-verbose-passwords, and change the type to a string, as this parameter can take one of three string values. * doc/guix.texi (Dovecot service): Update the corresponding documentation.
2019-05-07doc: Document 'display' and 'vt' fields of 'slim-configuration'.Diego Nicola Barbato
* doc/guix.texi (X Window): Mention 'display' and 'vt' fields of 'slim-configuration' and explain how to use them to add multiple SLiM services to system services. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2019-05-05doc: Fix typo.Miguel
* doc/guix.texi (VM): Add missing dot. Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>
2019-05-05doc: Fix typo.Miguel
* doc/guix.texi (xfce-desktop-service-type): Fix sentence. Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>
2019-05-05doc: Fix typo.Miguel
* doc/guix.texi (page-log@files-configuration@CUPS): "Page log" instead of "access log". Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>
2019-05-05doc: Fix typos.Miguel
* doc/guix.texi (set-xorg-configuration): Add missing @code tag. (error-log@files-configuration@CUPS): "Error log" instead of "access log". Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>
2019-05-05doc: Fix typo.Miguel
* doc/guix.texi (rsync-service-type): Add missing sentence. Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>
2019-05-05doc: Fix typo.Miguel
* doc/guix.texi (openntpd-configuration): Fix spelling issues. Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>
2019-05-05doc: Fix typos.Miguel
* doc/guix.texi (rakudo-build-system, libvirt-configuration, pam-krb5): Missing period between sentences. (gnu services vpn): Fix server spelling. (agetty-configuration): Add missing subject in the sentence. (udev-service): Fix markup for Scheme procedures. ({gnome,xfce,mate}-desktop-service): Add missing colon after default. Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>
2019-05-04doc: Adjust cross-references for GNU triplets.Ludovic Courtès
* doc/guix.texi (Defining Packages): Reference to 'autoconf' instead of obsolete 'configure' manual for triplets. (Additional Build Options): Adjust 'autoconf' node name.
2019-05-04doc: Provide the actual URL to the VM image.Ludovic Courtès
Fixes <https://bugs.gnu.org/35537>. Reported by Andy Tai <atai@atai.org>. * doc/guix.texi (Running Guix in a VM): Use @url and provide the actual URL, without @var{system}.
2019-05-04doc: Use HTTPS URLs.Marius Bakke
* doc/guix.texi: Use HTTPS where possible.
2019-05-01build: Change default substitute server to "ci.guix.gnu.org".Ludovic Courtès
* config-daemon.ac: Replace "ci.guix.info" with "ci.guix.gnu.org". * doc/guix.texi (SUBSTITUTE-SERVER): Likewise. * etc/substitutes/ci.guix.gnu.org.pub: New file. * Makefile.am (dist_pkgdata_DATA): Add it. * guix/scripts/build.scm (%default-log-urls): Update. * guix/scripts/substitute.scm (%default-substitute-urls): Likewise. * guix/store.scm (%default-substitute-urls): Likewise. * guix/self.scm (miscellaneous-files): Add "ci.guix.gnu.org".
2019-04-29guix package: Add 'guix search' alias.Ludovic Courtès
* guix/scripts/search.scm: New file. * Makefile.am (MODULES): Add it. * po/guix/POTFILES.in: Add it. * tests/guix-package-aliases.sh: Add test. * doc/guix.texi (Invoking guix package): Document it and use it in a couple of examples.
2019-04-29file-systems: Support the 'no-atime' flag.rendaw
* guix/build/syscalls.scm (MS_NOATIME): New variable. * gnu/build/file-systems.scm (mount-flags->bit-mask): Support it. * doc/guix.texi (File Systems): Document it and add cross-references to the relevant documentation. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
2019-04-29doc: Remove traces of "Guix System Distribution".Ludovic Courtès
* doc/guix.texi (Invoking guix package) (Official Substitute Server, System Configuration): Replace "the Guix System Distribution" by "Guix System".
2019-04-29doc: Add 'SUBSTITUTE-URL' variable.Ludovic Courtès
* doc/guix.texi (SUBSTITUTE-SERVER): New variable. (Invoking guix weather): Use it.
2019-04-29guix package: Add 'install', 'remove', and 'upgrade' aliases.Ludovic Courtès
* guix/scripts/install.scm, guix/scripts/remove.scm, guix/scripts/upgrade.scm, tests/guix-package-aliases.sh: New files. * Makefile.am (MODULES, SH_TESTS): Add them. * po/guix/POTFILES.in: Add them. * guix/scripts/package.scm (guix-package): Split with... (guix-package*): ... this. New procedure. * doc/guix.texi (Invoking guix package): Document them. (Binary Installation, Application Setup, Package Management) (Packages with Multiple Outputs, Package Modules) (X.509 Certificates, Installing Debugging Files): Use 'guix install' in simple examples. * etc/completion/bash/guix (_guix_complete): Handle "install", "remove", and "upgrade".
2019-04-28doc: Duplicate recommendation about 'guix-install.sh'.Ludovic Courtès
Since our web site points to "Binary Installation", it's best to have that note there. * doc/guix.texi (Binary Installation): Add note about guix-install.sh.
2019-04-27doc: Remove outdated paragraph in "Binary Installation".Ludovic Courtès
This is a followup to e9926f80c6553fde50ce1fcfd38d6370f841efd2. * doc/guix.texi (Binary Installation): Remove paragraph about not removing 'guix' from root's profile.
2019-04-27doc: Suggest 1G of RAM for the VM image.Ludovic Courtès
* doc/guix.texi (Running Guix in a VM): Suggest -m 1024.
2019-04-27doc: Update bit about SSH in the VM.Ludovic Courtès
* doc/guix.texi (Running Guix in a VM): Remove mentions of 'lsh-server'; mention 'openssh-service-type' and add a cross-reference. * gnu/system/examples/vm-image.tmpl (services): Add a commented-out line for 'openssh-service-type'.
generated by cgit