summaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Expand)Author
2020-05-06doc: Clarify 'git-http-configuration' description....Fix <https://issues.guix.info/31780>. * doc/guix.texi (Version Control Service): Extend 'git-http-configuration' description. Brice Waegeneire
2020-05-05doc: cookbook: Fix sbcl-ttf-fonts package name....* doc/guix-cookbook.texi (StumpWM): Adjust sbcl-ttf-fonts package name. Signed-off-by: Marius Bakke <mbakke@fastmail.com> Jean-Baptiste Note
2020-05-05doc: Typographic improvements....* doc/guix.texi (Networking Services): Use @var, @option, and @command when appropriate. Add two spaces after sentences. Nicolas Goaziou
2020-05-05gnu: Add AutoSSH service....* 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> pinoaffe
2020-05-04doc: Remove prompt from X.509 examples....* doc/guix.texi (X.509 Certificates): Remove leading "$". Ludovic Courtès
2020-05-04doc: Add "Packages for C Development" section....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. Ludovic Courtès
2020-05-04doc: Recommend against SHA1 OpenPGP signatures....* doc/contributing.texi (Commit Access): Recommend against SHA1 signatures. Ludovic Courtès
2020-05-04doc: Document committer authorization....* doc/contributing.texi (Commit Access): Add instructions for authorizing committers. Ludovic Courtès
2020-05-02doc: Fix building the cookbook....Fixes <https://debbugs.gnu.org/cgi/bugreport.cgi?bug=40803>. Reported by "operator.name" <operator.name@protonmail.com>. * doc/build.scm (%languages): Add smaller list for the cookbook. (syntax-highlighted-html): Adapt regexp for mono-node files to include the cookbook. Björn Höfling
2020-05-02services: dnsmasq: Support the --address flag....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> Pierre Langlois
2020-05-01doc: Move 'Dictionary Service' under 'Miscellaneous Services'....* doc/guix.texi (Dictionary Service): Renamed to singular and changed from 'subsubsection' to 'subheading'. Signed-off-by: Mathieu Othacehe <m.othacehe@gmail.com> Brice Waegeneire
2020-05-01doc: Replace section 'Early OOM service' by 'Linux Services'....* 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> Brice Waegeneire
2020-05-01system: Blacklist usbmouse kernel module in default kernel-arguments....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. Florian Pelz
2020-04-30doc: Bootloader Configuration: Fix an obsolete example....Reported by rawmat on #guix. * doc/guix.texi (Bootloader Configuration): Replace 'grub-configuration' with 'bootloader-configuration'. Leo Famulari
2020-04-30doc: cookbook: Rename stumpwm package to current state....* doc/guix-cookbook.texi (StumpWM): Rename STUMPWM package to current state. Signed-off-by: Oleg Pykhalov <go.wigust@gmail.com> Marcin Karpezo
2020-04-28doc: Mention that PulseAudio service overrides user configuration....* 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> Diego Nicola Barbato
2020-04-27doc: Update url to singularity before link rot occurs....* doc/guix.texi: Update url to singularity before link rot occurs. Signed-off-by: Ludovic Courtès <ludo@gnu.org> operator.name
2020-04-27doc: guix: Fix grammar in "Debugging Build Failures"...* doc/guix.texi (Debugging Build Failures): Fix grammar. Signed-off-by: Jakub Kądziołka <kuba@kadziolka.net> TomZ
2020-04-25doc: guix: Fix some markup....* 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. Nicolas Goaziou
2020-04-25doc: cookbook: Fix quotes....* doc/guix-cookbook.texi (Basic setup with manifests): (Default profile): (The benefits of manifests): Use proper quotes in regular texts. Nicolas Goaziou
2020-04-24doc: cookbook: Use @file for file names and extensions....* doc/guix-cookbook.texi (@samp{GUIX_PACKAGE_PATH}): (Extended example): (Setting up a bind mount): (Basic setup with manifests): (Default profile): Use @file instead of @samp or @code for file names and extensions. Nicolas Goaziou
2020-04-24doc: cookbook: Fix misuses of double spacing....* doc/guix-cookbook.texi (Extended example): (StumpWM): (Basic setup with manifests): Prevent Texinfo from ending a sentence where it should not. (Setting up a bind mount): Add two spaces where needed. Nicolas Goaziou
2020-04-24doc: Ensure guix-daemon is built before creating guix-daemon.1....* doc/local.mk ($(srcdir)/%D%/guix-daemon.1): Depend on guix-daemon$(EXEEXT) instead of its source code. Marius Bakke
2020-04-23build: Don't build man pages when cross-compiling....* configure.ac: Define 'CROSS_COMPILING' Automake conditional. * doc/local.mk (dist_man1_MANS): Wrap in "if !CROSS_COMPILING". Ludovic Courtès
2020-04-23doc: Build more man pages....* doc/local.mk (sub_commands_mans): Add guix-deploy.1, guix-time-machine.1, and guix-weather.1. Ludovic Courtès
2020-04-22gnu: font-gnu-freefont: Add otf and woff font types....* 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> Raghav Gururajan
2020-04-22doc: cookbook: Explain how to use bind mounts....* doc/guix-cookbook.texi (Setting up a bind mount): Add example. Signed-off-by: Leo Famulari <leo@famulari.name> Matthew Brooks
2020-04-22doc: Adjust @var vs. @code....* doc/guix.texi (Base Services): Adjust @var vs. @code. Use 'cons' instead of 'cons*' in example. Ludovic Courtès
2020-04-22services: Add udev-rules-service helper....* 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> Brice Waegeneire
2020-04-22gexp: Add 'load-path?' field to <scheme-file>....* 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. Ludovic Courtès
2020-04-21doc: Include *.json files in the source....This is a followup to c9f321e52a99dea93fcc099372ea0167150b9aac. * doc/build.scm (texinfo-manual-source)[build]: Add *.json to #$output. Ludovic Courtès
2020-04-21packages: Recommend against the use of 'package-file'....* guix/packages.scm (package-file): Recommend against its use in the docstring. * doc/guix.texi (The Store Monad): Likewise. Ludovic Courtès
2020-04-19services: Add 'simulated-wifi-service-type'....* gnu/services/networking.scm (simulated-wifi-shepherd-services): New procedure. (simulated-wifi-service-type): New variable. * doc/guix.texi (Networking Services): Document it. Ludovic Courtès
2020-04-19services: Add 'hostapd-service-type'....* 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. Ludovic Courtès
2020-04-19doc: Make install script more prominent....Suggested by Steven vanZyl <rushsteve1@rushsteve1.us>. * doc/guix.texi (Binary Installation): Add @example showing how to download the script. Use "systemctl enable --now". Ludovic Courtès
2020-04-17doc: Update nar decompression examples....* 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> mikadoZero
2020-04-17maint: Provide the configuration file in the VM image....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. Ludovic Courtès
2020-04-17doc: Replace incorrect uses of @var with @code....@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. Ludovic Courtès
2020-04-16doc: Document building and installing from JSON files....* 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. Ricardo Wurmus
2020-04-16doc: Add dicod-service-type in Dictionary Services....* doc/guix.texi (Miscellaneous Services): Add dicod-service-type in Dictionary Services. Signed-off-by: Ludovic Courtès <ludo@gnu.org> R Veera Kumar
2020-04-16doc: Remove bogus index entry....* doc/guix.texi (Build Systems): Remove bogus and redundant entry for 'copy-build-system'. Ludovic Courtès
2020-04-15doc: Fix typo....* doc/guix.texi (Running Guix in a VM): Add missing reference to `spice-vdagent-service' and misuse of @pxref. Nicolas Goaziou
2020-04-14doc: Fix typo....* 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> Brice Waegeneire
2020-04-13doc: Improve anchor collection....This allows us to catch "operating_002dsystem-1", for instance. * doc/build.scm (syntax-highlighted-html)[build](anchor-id->key): Drop "-1" & co. from ID. Ludovic Courtès
2020-04-13doc: Avoid invalid 'match' pattern in 'syntax-highlighted-html'....This is a followup to da9deba13d551e316f5a99a614834efa27ddc7d1. Last-minute modification of the 'match' pattern would lead to an error: "multiple ellipsis patterns not allowed at same level" * doc/build.scm (syntax-highlighted-html)[build](collect-anchors): Add 'worthy-entry?' procedure and use it instead of the unsupported pattern for ('dt ...). Ludovic Courtès
2020-04-13doc: Emit hyperlinks in HTML output for @lisp snippets....This makes it easier to jump to the definition of a procedure or variable when looking at a code snippet. There can be false-positive because scoping rules are ignored, for example, but it should be a good approximation. * doc/build.scm (syntax-highlighted-html)[build](highlights->sxml*): Add 'anchors' parameter. Add clause for ('symbol text). (syntax-highlight): Add 'anchors' parameter. Wrap body in named let and use it in recursive calls. Pass ANCHORS to 'highlights->sxml*'. (underscore-decode, anchor-id->key, collect-anchors, html?): New procedures. (process-file): Add 'anchors' parameter. and honor it. Rewrite mono-node and multi-node HTML files separately. Ludovic Courtès
2020-04-08doc: Mention HTTP/HTTPS proxy in the system installation instructions....* doc/guix.texi (Keyboard Layout and Networking and Partitioning): Mention 'herd set-http-proxy guix-daemon'. Ludovic Courtès
2020-04-07services: guix: Add 'set-http-proxy' action....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. Ludovic Courtès
2020-04-06services: Add 'rottlog-service-type' to '%base-services'....* 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. Ludovic Courtès
2020-04-06doc: Make 'fc-cache -rv' instructions more prominent....* doc/guix.texi (Application Setup): Move the "fc-cache" instructions next to the Fontconfig paragraph and make the command more visible. Ludovic Courtès