summary refs log tree commit diff
path: root/doc
AgeCommit message (Collapse)Author
2022-10-06doc: Add terms to concept index for "guix style".Ricardo Wurmus
* doc/guix.texi (Invoking guix style): Add terms to concept index.
2022-10-06doc: Add concept index terms for "guix archive".Ricardo Wurmus
* doc/guix.texi (Invoking guix archive): Add terms to concept index.
2022-10-06doc: Add every command name to concept index.Ricardo Wurmus
* doc/guix.texi: Add an entry for each Guix command to the concept index.
2022-10-06doc: Use @command instead of @code.Ricardo Wurmus
* doc/guix.texi: Use @command to refer to Guix commands.
2022-10-06services: dhcp-client: Implement and use a configuration record.Alexey Abramov
* gnu/services/networking.scm (dhcp-client-configuration): New record configuration. (dhcp-client-shepherd-service): Implement a shepher service. Provide a deprication message for legacy configurations. (dhcp-client-service-type): Use dhcp-client-shepherd-service. * doc/guix.texi (Networking Setup): Update. * po/guix/POTFILES.in: Add 'gnu/services/networking.scm'. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
2022-10-04home: Add home-batsignal-service-type.( via Guix-patches via
* gnu/home/services/pm.scm (home-batsignal-service-type): New variable. (home-batsignal-configuration): New record type. * doc/guix.texi: Document them. * gnu/local.mk: Add gnu/home/services/pm.scm.
2022-10-04doc: Mention network mask in network-route.Andrew Tropin
* doc/guix.texi (Networking Setup): Mention network mask in network-route.
2022-10-03doc: Mention sourcing system profile when chrooting.Maxim Cournoyer
* doc/guix.texi (Chrooting into an existing system): Add sourcing of system profile along user profile.
2022-10-02doc: Update the URL of ISC DHCP.Ludovic Courtès
* doc/guix.texi (Networking Services): Update ISC DHCP URL.
2022-09-29transformations: '--with-source' now operates in depth.Ludovic Courtès
The '--with-source' option is the first one that was implemented, and it's the only one that would operate only on leaf packages rather than traversing the dependency graph. This change makes it consistent with the rest of the transformation options. * guix/transformations.scm (evaluate-source-replacement-specs): New procedure. (transform-package-source): Rewrite using it. * tests/transformations.scm ("options->transformation, with-source, no matches"): Rewrite since we no longer get a warning. ("options->transformation, with-source, in depth"): New test. * doc/guix.texi (Package Transformation Options): Adjust examples.
2022-09-28doc: Tweak wsdd wording.Ludovic Courtès
* doc/guix.texi (Samba Services)[Web Service Discovery Daemon]: Tweak wording.
2022-09-28doc: Fix syntax for 'wsdd-configuration'.Ludovic Courtès
* doc/guix.texi (Samba Services): Fix syntax of 'wsdd-configuration' data type definition.
2022-09-28doc: Mention where one can learn more about the samba config file syntax.Maxim Cournoyer
* doc/guix.texi (Samba Services): Refer users to "man smb.conf" to learn more about the Samba config file format.
2022-09-28doc: Add a simple Samba share example.Maxim Cournoyer
* doc/guix.texi (Samba Services): Add a configuration example.
2022-09-28doc: Clarify Samba Services configuration.Maxim Cournoyer
* doc/guix.texi (Samba Services): Explicit the fact that no daemons are automatically run. Remove the word "Manually", that suggested otherwise.
2022-09-25doc: Turn example to lisp.Mathieu Othacehe
* doc/guix.texi (System Images): Turn example snippets to lisp snippets.
2022-09-25doc: Remove an extra dot.Mathieu Othacehe
* doc/guix.texi (System Images): Remove it.
2022-09-25etc: teams: Add scope support.Mathieu Othacehe
Add a scope list to each team. This list defines all the files and directories that are mentored by the team. Also add a cc-members command that takes two Git revision strings as input, add returns the members that should be CC'ed given the files impacted between the two revisions. * etc/teams.scm.in (<team>)[scope]: New field. (team, list-teams): Adapt those procedures. (find-team-by-scope, diff-revisions): New procedures. (main): Add a "cc-members" command. * doc/contributing.texi ("Teams"): Document it. ("Sending a Patch Series"): Adapt it.
2022-09-24system: images: Add wsl2 module.Alex Griffin
* gnu/system/images/wsl2.scm: New file. * gnu/local.mk (GNU_SYSTEM_MODULES): Add it. * doc/guix.texi ("System Images"): Document it. Signed-off-by: Mathieu Othacehe <othacehe@gnu.org>
2022-09-24system: image: Add tarball support.Alex Griffin
* gnu/image.scm (<image>)[fields]: Add tarball to the supported formats. * gnu/system/image.scm (tarball-image, tarball-image-type): New variables. (system-tarball-image): New procedure. (image->root-file-system): Add tarball image support. (system-image): Ditto. * doc/guix.texi ("System Images"): Document it. Signed-off-by: Mathieu Othacehe <othacehe@gnu.org>
2022-09-24doc: Add a "System Images" chapter.Mathieu Othacehe
* doc/guix.texi ("System Images"): New chapter.
2022-09-24doc: Add a "Platforms" chapter.Mathieu Othacehe
* doc/guix.texi ("Platforms"): New chapter. ("Porting"): Link it.
2022-09-24services: Add wsdd service.Simon Streit
* doc/guix.texi: Add documentation for wsdd service. * gnu/services/samba.scm (<wsdd-configuration>): New record. (wsdd-service-type): New variable. (wsdd-shepherd-services): New procedure. * gnu/tests/samba.scm (%wsdd-os): Add variable. (run-wsdd-test): New procedure. (%test-wsdd): New variable. Signed-off-by: Lars-Dominik Braun <lars@6xq.net>
2022-09-24services: Add samba service.Simon Streit
* gnu/services/samba.scm: New file. * gnu/tests/samba.scm: New file. * gnu/local.mk (GNU_SYSTEM_MODULES): Add them. * po/guix/POTFILES.in Add 'gnu/services/samba.scm'. * doc/guix.texi: Document it. Signed-off-by: Lars-Dominik Braun <lars@6xq.net>
2022-09-17import: gem: Support importing a specific version of a gem.Taiju HIGASHI
* guix/import/gem.scm: (rubygems-fetch, gem->guix-package) (gem-recursive-import): Fix to fetch the specified version of the gem. * guix/scripts/import/gem.scm (show-help): Update the help message. (guix-import-gem): Modify so the version number to be passed to subsequent procedures. * tests/gem.scm: Add tests. * doc/guix.texi (Invoking guix import): Document. Signed-off-by: Christopher Baines <mail@cbaines.net>
2022-09-14gnu: fail2ban-service-type: Improve extra-content fields.muradm
* gnu/services/security.scm (fail2ban-jail-configuration)[extra-content]: Change to text-config. (fail2ban-configuration)[extra-content]: Change to text-config. * gnu/doc/guix.texi: Update type of extra-content fields. Modified-by: Maxim Cournoyer <maxim.cournoyer@gmail.com> Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
2022-09-08gnu: bootloader: Extend `<menu-entry>' for chain-loader.tiantian
* gnu/bootloader.scm (<menu-entry>)[chain-loader]: New field. (menu-entry->sexp, sexp->menu-entry): Support chain-loader. * doc/guix.texi (Bootloader Configuration): Document it. Co-Authored-By: Julien Lepiller <julien@lepiller.eu> Signed-off-by: Julien Lepiller <julien@lepiller.eu>
2022-09-07doc: Fix typo.Ricardo Wurmus
* doc/guix.texi (Miscellaneous Services): Fix typo.
2022-09-06services: nginx: Add 'shepherd-requirement' configuration field.Ludovic Courtès
* gnu/services/web.scm (<nginx-configuration>)[shepherd-requirement]: New field. (nginx-shepherd-service): Honor it. * doc/guix.texi (Web Services): Document it.
2022-09-05doc: Add more info about commits signature local verification.Andrew Tropin
* doc/contributing.texi (Commit Access): Add more info about commits signature local verification.
2022-09-04services: upower: Default to a percentage-based policy.Ludovic Courtès
This is the documented default of UPower 0.99.15 (the actual default appears to be #f though). * gnu/services/desktop.scm (<upower-configuration>) [use-percentage-for-policy?]: Default to #t. * doc/guix.texi (Desktop Services): Adjust accordingly. Explain the tradeoff.
2022-09-04services: upower: Update default percentage values.Ludovic Courtès
These values are those used by default by UPower 0.99.15. * gnu/services/desktop.scm (<upower-configuration>)[percentage-low] [percentage-critical]: Increase. * doc/guix.texi (Desktop Services): Update accordingly.
2022-09-02doc: Link to the "Scheme Crash Course".Ludovic Courtès
* doc/guix.texi (Defining Packages): Add @quotation block linking to "A Scheme Crash Course".
2022-09-01doc: Suggest more RAM for "Running Guix in a VM".Ludovic Courtès
Fixes <https://issues.guix.gnu.org/57474>. Reported by Michael F. Lamb <mike@orbital.rodeo>. Running 'guix pull' to target current revisions would lead to memory exhaustion. Bumping the memory size works around that. * doc/guix.texi (Running Guix in a VM): Change "-m 1024" to "-m 2048".
2022-09-01gnu: fail2ban-service-type: Fix documentation typos.muradm
Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
2022-08-30etc: Add tempel snippets.Nicolas Graves
* etc/snippets/tempel/scheme-mode: New file. * etc/snippets/tempel/text-mode: New file. * etc/snippets/scheme-mode: Moved from here... * etc/snippets/yas/scheme-mode: ... to here. * etc/snippets/text-mode: Moved from here... * etc/snippets/yas/text-mode: ... to here. * doc/contributing.texi ("The Perfect Setup"): Adjust yasnippet setup accordingly. Add tempel setup. Signed-off-by: Liliana Marie Prikler <liliana.prikler@gmail.com>
2022-08-30guix system: Use standard cross and native build options.Thiago Jung Bauermann
This change prevents guix system from erroring out with an ugly backtrace when it's passed an invalid value to the “--system” or “--target” option. It also adds the “--list-systems” and “--list-targets” options. The manual section about guix system doesn't mention the “--target” option, so add it there. * guix/scripts/system (show-help): Call show-cross-build-options-help and show-native-build-options-help. (%options): Remove own implementation of “system” and “target” options and use the ones in %standard-cross-build-options and %standard-native-build-options. * doc/guix.texi (Invoking guix system): Document “--target” option. Signed-off-by: Mathieu Othacehe <othacehe@gnu.org>
2022-08-30bootloader: Add device-tree-support? option.Reza Alizadeh Majd
In some specific cases where the device tree file is already loaded in RAM, it can be preferable that the bootloader does not try to use a device tree from the Linux kernel tree. * gnu/bootloader.scm (<bootloader-configuration>)[device-tree-support?]: New field. * gnu/bootloader/extlinux.scm (extlinux-configuration-file): Add FDTDIR line based on <device-tree-support?> field of <bootloader-configuration>. * doc/guix.texi (Bootloader Configuration)[device-tree-support?]: Add documentation for the new field.
2022-08-28services: Add lightdm-service-type.Maxim Cournoyer
* gnu/services/lightdm.scm: New service. * tests/services/lightdm.scm: Test it. * doc/guix.texi (X Window): Document it. * gnu/local.mk (GNU_SYSTEM_MODULES): Register it. Co-authored-by: L p R n d n <guix@lprndn.info> Co-authored-by: Ricardo Wurmus <rekado@elephly.net>
2022-08-28gnu: security: Add fail2ban-service-type.muradm
* gnu/services/security.scm: New module. * gnu/tests/security.scm: New module. * gnu/local.mk: Add new security module and tests. * doc/guix.text: Add fail2ban-service-type documentation. Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
2022-08-26gnu: greetd-service-type: Add supplementary groups to greeter.muradm
* gnu/services/base.scm (<greetd-configuration>) [greeter-supplementary-groups]: New field. (%greetd-accounts): Rename to... (greetd-accounts): ... this. Convert to a function that takes a config argument. Use greeter-supplementary-groups. (greetd-service-type): Adjust accordingly. * gnu/tests/desktop.scm (%minimal-services): Add test for greeter-supplementary-groups. * doc/guix.texi ("Base Services")[greetd-service-type]: Document greeter-supplementary-groups.
2022-08-26gnu: seatd-service-type: Use seat group.muradm
* gnu/services/desktop.scm (seatd-group-sanitizer): New variable. (<seatd-configuration>)[user]: Removed field. [group]: Changed to "seat". Sanitize via seatd-group-sanitizer. (seatd-accounts): New variable. (seatd-environment): Adjust to <seatd-configuration> ABI. (seatd-service-type)[extensions]: Add account-service-type with seatd-accounts. * gnu/tests/desktop.scm (run-minimal-desktop-test): Check for correct ownership of $SEATD_SOCK. * doc/guix.texi ("Desktop Services")[seatd-service-type]: Mention that users may need to become members of the "seat" group. Update default value for group field. Add explanation on seatd.sock file. Remove dropped user field.
2022-08-25doc: Replace remaining 'unset mentions with %unset-value.Maxim Cournoyer
* doc/guix.texi (Networking Services): Replace 'unset with %unset-value. (Power Management Services): Likewise. (Complex Configurations): Likewise.
2022-08-24services: configuration: Add a 'maybe-value-set?' procedure.Maxim Cournoyer
* gnu/services/configuration.scm (maybe-value-set?): New procedure. * doc/guix.texi (Complex Configurations): Document it. Remove comment showing usage of 'maybe-string' with a default value, which doesn't make sense. Co-authored-by: Attila Lendvai <attila@lendvai.name>
2022-08-20doc: Fix typos.Julien Lepiller
* doc/guix.texi: Fix various typos found by translators.
2022-08-19doc: Add files, xdg-configuration and symlink-manager home services.Andrew Tropin
* doc/guix.texi (Essential Home Services): Add files, xdg-configuration-files and symlink-manager home services.
2022-08-14doc: Note the pitfalls of man 8 mount.Tobias Geerinckx-Rice
* doc/guix.texi (File Systems): Warn against flags presented as options.
2022-08-14doc: Remove extraneous ‘Note…’.Tobias Geerinckx-Rice
* doc/guix.texi (File Systems): Remove a ‘Note that’ & begin a new paragraph.
2022-08-10services: elogind: Fix default behavior for lid close.Maxim Cournoyer
Fixes <https://issues.guix.gnu.org/57052>, which was a behavior change introduced inadvertently in 4c698cd51209a0102477478b026ea04bd7e45908. * gnu/services/desktop.scm (<elogind-configuration>) [handle-lid-switch-external-power]: Default to *unspecified*, which serializes to nothing. This matches upstream behavior, meaning that even when plugged to a power cord, a laptop will suspend when the lid is closed. * doc/guix.texi (Desktop Services): Update doc. Reported-by: Cairn <cairn@pm.me>
2022-08-10gnu: system: file-systems: Add shared flag.Oleg Pykhalov
* gnu/build/file-systems.scm (mount-flags->bit-mask, mount-file-system): Handle shared flag. * gnu/system/file-systems.scm (invalid-file-system-flags): Add shared to known flags. * guix/build/syscalls.scm (MS_SHARED): New variable. * doc/guix.texi (File Systems): Document shared flag.