aboutsummaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAge
* transformations: '--with-source' now operates in depth.Ludovic Courtès2022-09-29
| | | | | | | | | | | | | | | 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.
* doc: Tweak wsdd wording.Ludovic Courtès2022-09-28
| | | | | * doc/guix.texi (Samba Services)[Web Service Discovery Daemon]: Tweak wording.
* doc: Fix syntax for 'wsdd-configuration'.Ludovic Courtès2022-09-28
| | | | | * doc/guix.texi (Samba Services): Fix syntax of 'wsdd-configuration' data type definition.
* doc: Mention where one can learn more about the samba config file syntax.Maxim Cournoyer2022-09-28
| | | | | * doc/guix.texi (Samba Services): Refer users to "man smb.conf" to learn more about the Samba config file format.
* doc: Add a simple Samba share example.Maxim Cournoyer2022-09-28
| | | | * doc/guix.texi (Samba Services): Add a configuration example.
* doc: Clarify Samba Services configuration.Maxim Cournoyer2022-09-28
| | | | | * doc/guix.texi (Samba Services): Explicit the fact that no daemons are automatically run. Remove the word "Manually", that suggested otherwise.
* doc: Turn example to lisp.Mathieu Othacehe2022-09-25
| | | | * doc/guix.texi (System Images): Turn example snippets to lisp snippets.
* doc: Remove an extra dot.Mathieu Othacehe2022-09-25
| | | | * doc/guix.texi (System Images): Remove it.
* etc: teams: Add scope support.Mathieu Othacehe2022-09-25
| | | | | | | | | | | | | | | | 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.
* system: images: Add wsl2 module.Alex Griffin2022-09-24
| | | | | | | | * 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>
* system: image: Add tarball support.Alex Griffin2022-09-24
| | | | | | | | | | | * 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>
* doc: Add a "System Images" chapter.Mathieu Othacehe2022-09-24
| | | | * doc/guix.texi ("System Images"): New chapter.
* doc: Add a "Platforms" chapter.Mathieu Othacehe2022-09-24
| | | | | * doc/guix.texi ("Platforms"): New chapter. ("Porting"): Link it.
* services: Add wsdd service.Simon Streit2022-09-24
| | | | | | | | | | | | * 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>
* services: Add samba service.Simon Streit2022-09-24
| | | | | | | | | | * 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>
* import: gem: Support importing a specific version of a gem.Taiju HIGASHI2022-09-17
| | | | | | | | | | | | * 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>
* gnu: fail2ban-service-type: Improve extra-content fields.muradm2022-09-14
| | | | | | | | | | * 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>
* gnu: bootloader: Extend `<menu-entry>' for chain-loader.tiantian2022-09-08
| | | | | | | | | * 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>
* doc: Fix typo.Ricardo Wurmus2022-09-07
| | | | * doc/guix.texi (Miscellaneous Services): Fix typo.
* services: nginx: Add 'shepherd-requirement' configuration field.Ludovic Courtès2022-09-06
| | | | | | | * gnu/services/web.scm (<nginx-configuration>)[shepherd-requirement]: New field. (nginx-shepherd-service): Honor it. * doc/guix.texi (Web Services): Document it.
* doc: Add more info about commits signature local verification.Andrew Tropin2022-09-05
| | | | | * doc/contributing.texi (Commit Access): Add more info about commits signature local verification.
* services: upower: Default to a percentage-based policy.Ludovic Courtès2022-09-04
| | | | | | | | | | 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.
* services: upower: Update default percentage values.Ludovic Courtès2022-09-04
| | | | | | | | 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.
* doc: Link to the "Scheme Crash Course".Ludovic Courtès2022-09-02
| | | | | * doc/guix.texi (Defining Packages): Add @quotation block linking to "A Scheme Crash Course".
* doc: Suggest more RAM for "Running Guix in a VM".Ludovic Courtès2022-09-01
| | | | | | | | | | 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".
* gnu: fail2ban-service-type: Fix documentation typos.muradm2022-09-01
| | | | Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
* etc: Add tempel snippets.Nicolas Graves2022-08-30
| | | | | | | | | | | | | * 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>
* guix system: Use standard cross and native build options.Thiago Jung Bauermann2022-08-30
| | | | | | | | | | | | | | | | | | 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>
* bootloader: Add device-tree-support? option.Reza Alizadeh Majd2022-08-30
| | | | | | | | | | | | 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.
* services: Add lightdm-service-type.Maxim Cournoyer2022-08-28
| | | | | | | | | | * 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>
* gnu: security: Add fail2ban-service-type.muradm2022-08-28
| | | | | | | | | * 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>
* gnu: greetd-service-type: Add supplementary groups to greeter.muradm2022-08-26
| | | | | | | | | | | | | * 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.
* gnu: seatd-service-type: Use seat group.muradm2022-08-26
| | | | | | | | | | | | | | | | * 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.
* doc: Replace remaining 'unset mentions with %unset-value.Maxim Cournoyer2022-08-25
| | | | | | * doc/guix.texi (Networking Services): Replace 'unset with %unset-value. (Power Management Services): Likewise. (Complex Configurations): Likewise.
* services: configuration: Add a 'maybe-value-set?' procedure.Maxim Cournoyer2022-08-24
| | | | | | | | * 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>
* doc: Fix typos.Julien Lepiller2022-08-20
| | | | * doc/guix.texi: Fix various typos found by translators.
* doc: Add files, xdg-configuration and symlink-manager home services.Andrew Tropin2022-08-19
| | | | | * doc/guix.texi (Essential Home Services): Add files, xdg-configuration-files and symlink-manager home services.
* doc: Note the pitfalls of man 8 mount.Tobias Geerinckx-Rice2022-08-14
| | | | * doc/guix.texi (File Systems): Warn against flags presented as options.
* doc: Remove extraneous ‘Note…’.Tobias Geerinckx-Rice2022-08-14
| | | | | * doc/guix.texi (File Systems): Remove a ‘Note that’ & begin a new paragraph.
* services: elogind: Fix default behavior for lid close.Maxim Cournoyer2022-08-10
| | | | | | | | | | | | | 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>
* gnu: system: file-systems: Add shared flag.Oleg Pykhalov2022-08-10
| | | | | | | | | * 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.
* doc: Fix name of gdm-configuration x-session field.Maxim Cournoyer2022-08-09
| | | | | * doc/guix.texi (X Window): Correctly refer to 'x-session', not 'xsession', as the name of the field.
* linux-container: container-script: Parse command line options.Ricardo Wurmus2022-08-09
| | | | | | * gnu/system/linux-container.scm (container-script): Accept command line options to bind mount host directories into the container. * doc/guix.texi (Invoking guix system): Document options.
* build-system/channel: Accept a channel or instance as the source.Ludovic Courtès2022-08-09
| | | | | | | | | * guix/build-system/channel.scm (latest-channel-instances*): New variable. (build-channels): New procedure, with code formerly in 'channel-build-system', augmented with clauses for when SOURCE is a channel instance or a channel. * doc/guix.texi (Build Systems): Adjust accordingly.
* build-system: Add 'channel-build-system'.Ludovic Courtès2022-08-09
| | | | | | | | * gnu/ci.scm (channel-build-system, channel-source->package): Remove. * gnu/packages/package-management.scm (channel-source->package): New procedure, moved from (gnu ci). * guix/build-system/channel.scm: New file, with code moved from (gnu ci). * doc/guix.texi (Build Systems): Document it.
* style: Add '--whole-file' option.Ludovic Courtès2022-08-08
| | | | | | | | | * guix/scripts/style.scm (format-whole-file): New procedure. (%options, show-help): Add '--whole-file'. (guix-style): Honor it. * tests/guix-style.sh: New file. * Makefile.am (SH_TESTS): Add it. * doc/guix.texi (Invoking guix style): Document it.
* lint: Add '-e'.Ludovic Courtès2022-08-08
| | | | | | | * guix/scripts/lint.scm (show-help, %options): Add '-e'. (guix-lint): Call 'specification->package' while traversing OPTS. Add case for 'expression pair. Adjust 'for-each' loop to expect packages. * doc/guix.texi (Invoking guix lint): Document it.
* doc: Add reference to "Writing Manifests".Ludovic Courtès2022-08-06
| | | | | * doc/guix.texi (Defining Package Variants): Rewrite to "Writing Manifests" rather than the 'profile-manifest' anchor.
* doc: Fix typo.Tobias Geerinckx-Rice2022-07-31
| | | | * doc/guix.texi (X Window): Fix ‘string-apppend’ typo.
* doc: Fix Guix manual URLs in 'htmlxref.cnf'.Ludovic Courtès2022-08-05
| | | | | | | Fixes a regression introduced in 868da34d54365023223a4ff7520043ba55ad64e8. * doc/htmlxref.cnf (GUIX): Remove "/guix".