summaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Collapse)Author
2022-10-17channels: Interpret the 'commit' field of channel as a tag or commit.Ludovic Courtès
Previously the 'commit' field would always be interpreted as a commit ID. This change adds flexibility, allowing for things like: guix time-machine --commit=v1.2.0 -- describe * guix/channels.scm (channel-reference): Use 'tag-or-commit' rather than 'commit'. * guix/inferior.scm (channel-full-commit): Likewise. * doc/guix.texi (Invoking guix pull): Document it. (Invoking guix time-machine): Likewise.
2022-10-17doc: Fix typos.Julien Lepiller
These typos were found and reported on weblate. * doc/guix.texi: Fix typos.
2022-10-15doc: Explain Emacs native-compilation.zimoun
* doc/guix.texi ("Application Setup")["Emacs Packages"]: Add a note explaining that Emacs can compile packages to native code now. Signed-off-by: Liliana Marie Prikler <liliana.prikler@gmail.com>
2022-10-13doc: Add chapter on containers to Cookbook.Ricardo Wurmus
* doc/guix-cookbook.texi (Containers): New chapter.
2022-10-13environment: Add '--emulate-fhs'.John Kehayias
* guix/scripts/environment.scm (show-environment-options-help, %options): Add '--emulate-fhs'. (setup-fhs): New procedure. Setup for the Filesystem Hierarchy Standard (FHS) container. Defines and uses FHS-SYMLINKS and LINK-CONTENTS to create FHS expected directories and creates /etc/ld.so.conf. (launch-environment): Add 'emulate-fhs?' key and implement it to set $PATH and generate /etc/ld.so.cache before calling COMMAND. (launch-environment/container): Add 'emulate-fhs?' and 'setup-hook' keys and implement them. Define and use FHS-MAPPINGS, to set up additional bind mounts in the container to follow FHS expectations. (guix-environment*): Add glibc-for-fhs to the container packages when 'emulate-fhs?' key is in OPTS. * doc/guix.texi (Invoking guix shell): Document '--emulate-fhs'. (Invoking guix environment): Document '--emulate-fhs'. * tests/guix-environment-container.sh: Add tests for '--emulate-fhs'. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
2022-10-13gnu: home: Add home-dbus-service-type.( via Guix-patches via
* gnu/home/services/desktop.scm (home-dbus-service-type): New variable. (home-dbus-configuration): New record type. * doc/guix.texi: Document them. Signed-off-by: Andrew Tropin <andrew@trop.in>
2022-10-11system: operating-system: Make the timezone field default to Etc/UTC.Maxim Cournoyer
* gnu/system.scm (<operating-system>) [timezone]: Default to "Etc/UTC".
2022-10-11gnu: base: Add greetd-wlgreet-sway-session.(
* gnu/services/base.scm (greetd-wlgreet-session): New data type. (greetd-wlgreet-sway-session): Likewise. * doc/guix.texi ("Base Services")[greetd-service-type]: Document them. Signed-off-by: Christopher Baines <mail@cbaines.net>
2022-10-11services: guix: Include max-allocated-builds gbc agent option.Christopher Baines
* gnu/services/guix.scm (guix-build-coordinator-agent-configuration-max-allocated-builds): New procedure. (guix-build-coordinator-agent-shepherd-services): Use max-allocated-builds. * doc/guix.texi (Guix Build Coordinator): Document this new field.
2022-10-07Revert "Revert "services: Add xvnc-service-type.""Maxim Cournoyer
This reverts commit 0c4966160054bc50e6ab3a4ac9c9a6a1826ab5a0. The fix appears in the subsequent commit, for clarity.
2022-10-07Revert "services: Add xvnc-service-type."Maxim Cournoyer
This reverts commit 1c528a95cb92b7808e6603d7956185005583629f. This broke 'guix pull', for (yet) unknown reasons.
2022-10-07services: Add xvnc-service-type.Maxim Cournoyer
* gnu/services/vnc.scm: New file. * gnu/tests/vnc.scm: Likewise. * gnu/local.mk: Register them.
2022-10-07services: xorg: Add auto-suspend? field to <gdm-configuration>.Maxim Cournoyer
* gnu/services/xorg.scm (<gdm-configuration>) <auto-suspend?>: New field. (gdm-dconf-profiles): New variable. * gnu/services/xorg.scm (gdm-shepherd-service) <environment-variables> [!auto-suspend?]: Specify DCONF_PROFILE. (gdm-service-type): Extend DCONF-SERVICE-TYPE. * doc/guix.texi (X Window): Document the new field.
2022-10-07services: gdm: Add a configuration field to enable XDMCP.Maxim Cournoyer
* gnu/services/xorg.scm (<gdm-configuration>)[xdmcp?]: New field. * gnu/services/xorg.scm (gdm-configuration-file): Use it. Use (ice-9 format) to serialize boolean. (gdm-polkit-rules): New variable. (gdm-service-type): Use it to extend polkit. * doc/guix.texi (X Window): Document it.
2022-10-07doc: Add git send-email tip in 'Submitting Patches' section.Maxim Cournoyer
* doc/contributing.texi (Submitting Patches): Add a tip detailing how to prefix the subject line with the branch name the change should be installed to.
2022-10-06doc: Fix missing package name.Taiju HIGASHI
* doc/guix.texi (Invoking guix import): Fix missing package name for gem importer. Signed-off-by: Christopher Baines <mail@cbaines.net>
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".