summaryrefslogtreecommitdiff
path: root/doc/guix.texi
Commit message (Collapse)AuthorAge
* doc: Use @option for command-line optionsNicolas Goaziou2020-05-07
| | | | * doc/guix.texi (Invoking guix system): Use @option instead of @code.
* guix system: 'docker-image' honors '--network'.Ludovic Courtès2020-05-07
| | | | | | | | | * gnu/system/vm.scm (system-docker-image): Add #:shared-network? and pass it to 'containerized-operating-system'. (qemu-image): * guix/scripts/system.scm (system-derivation-for-action): Pass #:shared-network? to 'system-docker-image'. * doc/guix.texi (Invoking guix system): Document it.
* doc: Tiny markup fix.Nicolas Goaziou2020-05-07
| | | | | * doc/guix.texi (Substitute Authentication): Use @samp instead of @code for pseudo-code.
* doc: Remove markup for external package names.Nicolas Goaziou2020-05-07
| | | | | * doc/guix.texi (Invoking guix import): Remove markup, which is not warranted here.
* doc: Use @file instead of @code also for file extensions.Nicolas Goaziou2020-05-07
| | | | | | | | | | * doc/guix.texi (Defining Packages): (Build Systems): (Derivations): (Invoking guix import): (Printing Services): (Installing Debugging Files): (Preparing to Use the Bootstrap Binaries): Use @file instead of @code.
* doc: Use @env for environment variables.Nicolas Goaziou2020-05-07
| | | | | | | | | | | | | | | | | | | | | | | | | | * doc/guix.texi (Binary Installation): (Build Environment Setup): (Invoking guix-daemon): (Application Setup): (After System Installation): (Invoking guix package): (Proxy Settings): (Invoking guix environment): (Packages for C Development): (Package Modules): (Build Systems): (The Store): (Common Build Options): (Invoking guix download): (Invoking guix refresh): (Using the Configuration System): (Locales): (Base Services): (Networking Services): (Sound Services): (Continuous Integration): (PAM Mount Service): (X.509 Certificates): Use @env instead of @code for environment variables.
* doc: Use @option instead of @code.Nicolas Goaziou2020-05-07
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/guix.texi (Binary Installation): (Requirements): (Build Environment Setup): (Invoking guix-daemon): (Application Setup): (Invoking guix package): (Substitute Server Authorization): (Substitution Failure): (Invoking guix gc): (Invoking guix pull): (Invoking guix archive): (Invoking guix environment): (Invoking guix pack): (Defining Packages): (Build Systems): (The Store): (Invoking guix build): (Common Build Options): (Package Transformation Options): (Additional Build Options): (Debugging Build Failures): (Invoking guix edit): (Invoking guix import): (Invoking guix refresh): (Invoking guix lint): (Invoking guix publish): (Invoking guix challenge): (Base Services): (Virtualization Services): (Initial RAM Disk): (Invoking guix system): (Preparing to Use the Bootstrap Binaries): (Porting): Use @option instead of @code for command-line options.
* doc: Fix typo in container example.Pierre Neidhardt2020-05-07
| | | | * doc/guix.texi (Invoking `guix environment'): Fix sll -> ssl typo.
* doc: Add container example to run a web browser.Pierre Neidhardt2020-05-07
| | | | | | | * doc/guix.texi (Invoking `guix environment'): Add paragraph and example to run Eolie in a guix environment container. Add `container' cindex for the first container example, and the `certificates' cindex for the web browser example.
* doc: Clarify 'git-http-configuration' description.Brice Waegeneire2020-05-06
| | | | | | | Fix <https://issues.guix.info/31780>. * doc/guix.texi (Version Control Service): Extend 'git-http-configuration' description.
* doc: Typographic improvements.Nicolas Goaziou2020-05-05
| | | | | * doc/guix.texi (Networking Services): Use @var, @option, and @command when appropriate. Add two spaces after sentences.
* gnu: Add AutoSSH service.pinoaffe2020-05-05
| | | | | | | | | * gnu/services/ssh.scm (<autossh-configuration>): New record type. (autossh-service-type): New variable. (autossh-service-activation, autossh-file-name): New procedures. * doc/guix.texi (Networking Services): Document this. Signed-off-by: Oleg Pykhalov <go.wigust@gmail.com>
* doc: Remove prompt from X.509 examples.Ludovic Courtès2020-05-04
| | | | * doc/guix.texi (X.509 Certificates): Remove leading "$".
* doc: Add "Packages for C Development" section.Ludovic Courtès2020-05-04
| | | | | | | | Suggested by Bruno Haible <bruno@clisp.org> in <https://bugs.gnu.org/41038>. * doc/guix.texi (Packages for C Development): New node. (Application Setup)[The GCC toolchain]: Empty and refer to it.
* services: dnsmasq: Support the --address flag.Pierre Langlois2020-05-02
| | | | | | | | | | | | Introduce a new `addresses' field that translates to passing `--address=' multiple times to dnsmasq. * gnu/services/dns.scm (<dnsmasq-configuration>): Add an addresses field. (dnsmasq-shepherd-service): Match the addresses field and translate it to multiple '--address=' flags. * doc/guix.texi (DNS Services): Document it. Signed-off-by: 宋文武 <iyzsong@member.fsf.org>
* doc: Move 'Dictionary Service' under 'Miscellaneous Services'.Brice Waegeneire2020-05-01
| | | | | | | * doc/guix.texi (Dictionary Service): Renamed to singular and changed from 'subsubsection' to 'subheading'. Signed-off-by: Mathieu Othacehe <m.othacehe@gmail.com>
* doc: Replace section 'Early OOM service' by 'Linux Services'.Brice Waegeneire2020-05-01
| | | | | | | | | * doc/guix.texi (Linux Services): Changed from 'subsubheading' to 'subsection'. (Early OOM Service, Kernel Module Loader Service): Moved under 'Linux Services'. Signed-off-by: Mathieu Othacehe <m.othacehe@gmail.com>
* system: Blacklist usbmouse kernel module in default kernel-arguments.Florian Pelz2020-05-01
| | | | | | | | | | This avoids a race with the bcm5974 kernel module. Fixes <https://bugs.gnu.org/35574>. * gnu/system.scm (%default-modprobe-blacklist): New variable. (<operating-system>)[kernel-arguments]: Default to ... (%default-kernel-arguments): ... this new variable. * doc/guix.texi (operating-system Reference): Document the change.
* doc: Bootloader Configuration: Fix an obsolete example.Leo Famulari2020-04-30
| | | | | | | Reported by rawmat on #guix. * doc/guix.texi (Bootloader Configuration): Replace 'grub-configuration' with 'bootloader-configuration'.
* doc: Mention that PulseAudio service overrides user configuration.Diego Nicola Barbato2020-04-28
| | | | | | | * doc/guix.texi (Sound Services): Add a warning that 'pulseaudio-service-type' overrides per-user configuration files in '~/.config/pulse'. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: Update url to singularity before link rot occurs.operator.name2020-04-27
| | | | | | * doc/guix.texi: Update url to singularity before link rot occurs. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: guix: Fix grammar in "Debugging Build Failures"TomZ2020-04-27
| | | | | | * doc/guix.texi (Debugging Build Failures): Fix grammar. Signed-off-by: Jakub Kądziołka <kuba@kadziolka.net>
* doc: guix: Fix some markup.Nicolas Goaziou2020-04-25
| | | | | | | | | | | | | * doc/guix.texi (Build Systems): (Base Services): (X Window): (Printing Services): (Mail Services): (Messaging Services): (LDAP Services): (Virtualization Services): (Version Control Services): Use @samp, @code and double quotes where appropriate.
* gnu: font-gnu-freefont: Add otf and woff font types.Raghav Gururajan2020-04-22
| | | | | | | | | * gnu/packages/fonts.scm (font-gnu-freefont): Add otf and woff font types. * gnu/packages/genealogy.scm (gramps)[inputs]: Replace font-gnu-freefont-tff with font-gnu-freefont. * doc/guix.texi: Adjust a reference to the package. Signed-off-by: Leo Famulari <leo@famulari.name>
* doc: Adjust @var vs. @code.base-for-series-3632base-for-series-3631Ludovic Courtès2020-04-22
| | | | | * doc/guix.texi (Base Services): Adjust @var vs. @code. Use 'cons' instead of 'cons*' in example.
* services: Add udev-rules-service helper.Brice Waegeneire2020-04-22
| | | | | | | | | * doc/guix.texi (Base services): Add documentation for 'udev-rules-service'. Replace examples of 'udev-service-type' extension with 'udev-rules-service'. * gnu/services/base.scm (udev-rules-service): New procedure. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* gexp: Add 'load-path?' field to <scheme-file>.Ludovic Courtès2020-04-22
| | | | | | | * guix/gexp.scm (<scheme-file>)[load-path?]: New field. (scheme-file): Add #:set-load-path? and honor it. (scheme-file-compiler): Pass #:set-load-path? to 'gexp->file'. * doc/guix.texi (G-Expressions): Document it.
* packages: Recommend against the use of 'package-file'.Ludovic Courtès2020-04-21
| | | | | | * guix/packages.scm (package-file): Recommend against its use in the docstring. * doc/guix.texi (The Store Monad): Likewise.
* services: Add 'simulated-wifi-service-type'.Ludovic Courtès2020-04-19
| | | | | | | * gnu/services/networking.scm (simulated-wifi-shepherd-services): New procedure. (simulated-wifi-service-type): New variable. * doc/guix.texi (Networking Services): Document it.
* services: Add 'hostapd-service-type'.Ludovic Courtès2020-04-19
| | | | | | | | | * gnu/services/networking.scm (<hostapd-configuration>): New record type. (hostapd-configuration-file, hostapd-shepherd-services): New procedures. (hostapd-service-type): New variable. * doc/guix.texi (Networking Services): Document it.
* doc: Make install script more prominent.Ludovic Courtès2020-04-19
| | | | | | | Suggested by Steven vanZyl <rushsteve1@rushsteve1.us>. * doc/guix.texi (Binary Installation): Add @example showing how to download the script. Use "systemctl enable --now".
* doc: Update nar decompression examples.mikadoZero2020-04-17
| | | | | | | | * doc/guix.texi (Invoking guix archive): Show /gzip URL. Add cross-reference to "Invoking guix challenge". (Invoking guix challenge): Show /lzip URL. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* maint: Provide the configuration file in the VM image.Ludovic Courtès2020-04-17
| | | | | | | | | | | | This fixes a bug introduced in 362bcdb1b076c8c46f71781add56dfbe532736dc whereby the VM image would no longer contain /etc/config.scm, contrary to what the manual says. Reported by dbdude on #guix. * Makefile.am (release): Pass '--save-provenance' to 'guix system vm-image'. * doc/guix.texi (Running Guix in a VM): Adjust file name accordingly.
* doc: Replace incorrect uses of @var with @code.Ludovic Courtès2020-04-17
| | | | | | | | | | | | @var is for meta-syntactic variables but it is used in some places for mere variables, which is incorrect and leads to inconsistent layout in PDF and HTML. * doc/guix.texi (package Reference, The Store Monad) (G-Expressions, operating-system Reference) (File Systems, Base Services, Log Rotation) (Networking Services, Invoking guix deploy): Replace incorrect uses of @var with @code.
* doc: Document building and installing from JSON files.Ricardo Wurmus2020-04-16
| | | | | | | | * doc/guix.texi (Invoking guix package): Augment pargraphs for "--install-from-file". (Invoking guix build): Document building from JSON files. * doc/package-hello.json: New file. * doc/local.mk (EXTRA_DIST): Add it.
* doc: Add dicod-service-type in Dictionary Services.R Veera Kumar2020-04-16
| | | | | | | * doc/guix.texi (Miscellaneous Services): Add dicod-service-type in Dictionary Services. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: Remove bogus index entry.Ludovic Courtès2020-04-16
| | | | | * doc/guix.texi (Build Systems): Remove bogus and redundant entry for 'copy-build-system'.
* doc: Fix typo.Nicolas Goaziou2020-04-15
| | | | | * doc/guix.texi (Running Guix in a VM): Add missing reference to `spice-vdagent-service' and misuse of @pxref.
* doc: Fix typo.Brice Waegeneire2020-04-14
| | | | | | | * doc/guix.texi (Web Services)[nginx-php-fpm-location]: Replace 'nginx-php-fpm-location' by 'nginx-php-location'. Signed-off-by: Christopher Baines <mail@cbaines.net>
* doc: Mention HTTP/HTTPS proxy in the system installation instructions.Ludovic Courtès2020-04-08
| | | | | * doc/guix.texi (Keyboard Layout and Networking and Partitioning): Mention 'herd set-http-proxy guix-daemon'.
* services: guix: Add 'set-http-proxy' action.Ludovic Courtès2020-04-07
| | | | | | | | | | | | | | Fixes <https://bugs.gnu.org/25569>. Reported by Divan Santana <divan@santanas.co.za>. * gnu/services/base.scm (shepherd-set-http-proxy-action): New procedure. (guix-shepherd-service): Add 'actions' field. Change 'start' to a lambda; check the value of the "http_proxy" environment variable and add "http_proxy" and "https_proxy" to #:environment-variables as a function of that. * gnu/tests/base.scm (run-basic-test)["guix-daemon set-http-proxy action", "guix-daemon set-http-proxy action, clear"]: New tests. * doc/guix.texi (Base Services): Document it.
* services: Add 'rottlog-service-type' to '%base-services'.Ludovic Courtès2020-04-06
| | | | | | | * gnu/services/base.scm (%base-services): Add an instance of ROTTLOG-SERVICE-TYPE. * doc/guix.texi (Log Rotation): Mention that it's part of %BASE-SERVICES and change example.
* doc: Make 'fc-cache -rv' instructions more prominent.Ludovic Courtès2020-04-06
| | | | | * doc/guix.texi (Application Setup): Move the "fc-cache" instructions next to the Fontconfig paragraph and make the command more visible.
* gnu: mumi: Update to 0.0.0-12.bb2fe92.Ricardo Wurmus2020-04-06
| | | | | | | | | | | | | * gnu/packages/mail.scm (mumi): Update to 0.0.0-12.bb2fe92. [inputs]: Add guile-gcrypt, guile-redis, guile-webutils, mailutils. * gnu/services/web.scm (<mumi-configuration>): New record type. (mumi-configuration, mumi-configuration?, mumi-configuration-mumi, mumi-configuration-mailer?, mumi-configuration-sender, mumi-configuration-smtp): New procedures. (mumi-shepherd-services): Accept configuration; adjust start commands; add Shepherd service for mumi mailer. (mumi-service-type): Pass default configuration. * doc/guix.texi (Web Services): Update documentation.
* system: Allow for comma-separated keyboard layouts.Ludovic Courtès2020-04-06
| | | | | | | | | Reported by Florian Pelz <pelzflorian@pelzflorian.de>. * gnu/bootloader/grub.scm (keyboard-layout-file): Replace commas with hyphens in the first argument to 'computed-file'. * gnu/system/keyboard.scm (keyboard-layout->console-keymap): Likewise. * doc/guix.texi (Keyboard Layout): Add example.
* gnu: Add kernel-module-loader-service.Brice Waegeneire2020-04-05
| | | | | | | | | | | | | | | * doc/guix.texi (Linux Services): Add a new subsection and document the new service and its configuration. * gnu/services/linux.scm (kernel-module-loader-service-type): New type. (kernel-module-loader-shepherd-service): New procedure. * gnu/tests/linux-modules.scm (module-loader-program): Procedure removed. (modules-loaded?-program): New procedure. (run-loadable-kernel-modules-test): 'module-loader-program' procedure replaced by the new one. [os]: Use 'kernel-module-loader-service'. Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>
* services/nfs: Replace nfs-version with nfs-versions.base-for-series-3308Ricardo Wurmus2020-03-27
| | | | | | | | | | | | Instead of accepting a string for just one protocol version accept a list of supported versions. * gnu/services/nfs.scm (<nfs-configuration>)[nfs-version]: Remove field and replace... [nfs-versions]: ...with this new field. (nfs-shepherd-services): Pass as many "--nfs-version" options as there are supported versions. * doc/guix.texi (Network File System): Document nfs-versions.
* doc: Document that a working environment for building Guix requires "--pure".base-for-series-3284Danny Milosavljevic2020-03-24
| | | | | * doc/guix.texi (Invoking guix environment): Document that a working environment for building Guix requires "--pure".
* doc: Fix typo in example.Naga Malleswari2020-03-24
| | | | | | | * doc/guix.texi (Base Services)[file->udev-rule]: Correct misspelt "user-account". Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>
* doc: Fix typo.Naga Malleswari2020-03-24
| | | | | | * doc/guix.texi (Invoking guix time-machine): Fix typo. Signed-off-by: Danny Milosavljevic <dannym@scratchpost.org>