aboutsummaryrefslogtreecommitdiff
path: root/doc/guix-cookbook.texi
Commit message (Collapse)AuthorAge
* doc: cookbook: Update example my-libgit2 package.Efraim Flashner2023-06-05
| | | | | * doc/guix-cookbook.texi (Packaging Tutorial): Improve the code quality of the example my-libgit2 package.
* services: screen-locker-service-type: Configurable PAM and setuid.muradm2023-06-04
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | screen-locker-service-type by default does both define PAM entry and make program setuid binary. Normally both methods are mutually exclusive, if binary has setuid set it does not really needs PAM, otherway around also similar, if PAM is enabled binary should not relay on setuid. Recent swaylock package now compiled with PAM support. When PAM support is compiled in, swaylock rejects executing if binary is also setuid program. This change turns screen-locker-configuration from strict PAM AND setuid to more flexible PAM AND/OR setuid. Allowing swaylock to be configured properly while supporting other screen locker preferences. * gnu/services/xorg.scm (screen-locker-configuration): Switch from define-record-type to define-configuration. [using-pam?]: New field to control PAM entry existence. [using-setuid?]: New field to control setuid binary existence. (screen-locker-pam-services): Should not make unix-pam-service if using-pam? is set to #f. (screen-locker-setuid-programs): Should not make program setuid program if using-setuid? is set to #f. (screen-locker-generate-doc): Internal function to generate configuration documentation. (screen-locker-service): Adapt to new screen-locker-configuration. * gnu/services/desktop.scm (desktop-services-for-system): Adapt to new screen-locker-configuration. * doc/guix.texi: Reflect new changes to screen-locker-configuration. Signed-off-by: Josselin Poiret <dev@jpoiret.xyz>
* nls: Update translations.Florian Pelz2023-05-31
| | | | * doc/guix-cookbook.texi (Top): Mention Slovak.
* doc: cookbook: Remove outdated section about GUIX_PACKAGE_PATH.Ludovic Courtès2023-05-06
| | | | | | | | | | | The section insisted on GUIX_PACKAGE_PATH, mentioned version 0.16, and didn't say much about channels, which made it look obsolete. * doc/guix-cookbook.texi (GUIX_PACKAGE_PATH): Remove section. (Guix channels): Rename to... (Channels): ... this. Merge most of the explanations previously in the GUIX_PACKAGE_PATH section. Say more about channels and add cross-references.
* doc: cookbook: Add "Installing Guix on a Cluster" chapter.Ludovic Courtès2023-01-09
| | | | | | | | This is derived from the article at <https://hpc.guix.info/blog/2017/11/installing-guix-on-a-cluster/>, with clarifications and updates. * doc/guix-cookbook.texi (Installing Guix on a Cluster): New chapter.
* doc: cookbook: Remove 404 link to mitpress.mit.edu.Ludovic Courtès2023-01-06
| | | | | * doc/guix-cookbook.texi (A Scheme Crash Course): Remove 404 link to mitpress.mit.edu.
* doc: cookbook: Fix commands in example.Florian Pelz2022-11-27
| | | | | | | Fixes <https://issues.guix.gnu.org/59463>. Reported by Luca Cirrottola <luca.cirrottola@inria.fr>. * doc/guix-cookbook.texi (Reproducible profiles): Make it work.
* doc: Add a security keys section to the cookbook.Maxim Cournoyer2022-11-24
| | | | | | * doc/guix-cookbook.texi (Top): Register new menu. (System Configuration): Likewise. (Using security keys): New section.
* doc: cookbook: Add section on MPD with bluealsa.Ricardo Wurmus2022-11-06
| | | | | * doc/guix-cookbook.texi (Music Server with Bluetooth Audio): New section under System Configuration.
* doc: cookbook: Update detailed menu for "System Configuration".Ricardo Wurmus2022-11-06
| | | | * doc/guix-cookbook.texi: Update menu.
* doc: Add chapter on containers to Cookbook.Ricardo Wurmus2022-10-13
| | | | * doc/guix-cookbook.texi (Containers): New chapter.
* doc: cookbook: Link to "A Scheme Primer".Ludovic Courtès2022-07-08
| | | | | * doc/guix-cookbook.texi (A Scheme Crash Course): Link to "A Scheme Primer". Group references in @quotation for clarity.
* doc: cookbook: Suggest 'guix shell'.Ludovic Courtès2022-07-08
| | | | | | * doc/guix-cookbook.texi (A Scheme Crash Course): Suggest 'guix shell' instead of 'guix environment'. (Customizing the Kernel, The benefits of manifests): Likewise.
* doc: cookbook: Refer to the "Writing Manifests" manual node.Ludovic Courtès2022-06-01
| | | | | | * doc/guix-cookbook.texi (Basic setup with manifests): Tweak introductory paragraph. Refer to the new "Writing Manifests" node of the manual.
* doc: cookbook: Fix cross-reference to SICP.Ludovic Courtès2022-04-08
| | | | | | Reported by Greg Hogan <code@greghogan.com>. * doc/guix-cookbook.texi (A Scheme Crash Course): Fix xref to SICP.
* doc: cookbook: Fix cross-reference to the manual.Ludovic Courtès2022-04-08
| | | | | | | Reported by Greg Hogan <code@greghogan.com>. * doc/guix-cookbook.texi (Extended example): Fix node name in xref to "package Reference".
* doc: cookbook: Update Tor onion service name.Ludovic Courtès2022-03-18
| | | | | * doc/guix-cookbook.texi: New variable. (Getting substitutes from Tor): Use it.
* doc: cookbook: Update custom kernel guide.Leo Famulari2021-12-30
| | | | * doc/guix-cookbook.texi (Customizing the Kernel): Adjust to new interface.
* doc: cookbook: Simplify inputs in examples.Ludovic Courtès2021-12-20
| | | | | * doc/guix-cookbook.texi (Recursive importers, Inheritance): Use the simplified input style.
* Merge remote-tracking branch 'origin/master' into core-updates-frozen.Mathieu Othacehe2021-10-12
|\
| * doc: cookbook: Mention translations of the cookbook.Sarah Morgensen2021-10-04
| | | | | | | | | | | | * doc/guix-cookbook.texi (Top): Add note about l10n. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* | Merge branch 'master' into core-updates-frozenMarius Bakke2021-09-17
|\| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Conflicts: gnu/packages/bioinformatics.scm gnu/packages/chez.scm gnu/packages/docbook.scm gnu/packages/ebook.scm gnu/packages/gnome.scm gnu/packages/linux.scm gnu/packages/networking.scm gnu/packages/python-web.scm gnu/packages/python-xyz.scm gnu/packages/tex.scm gnu/packages/version-control.scm gnu/packages/xml.scm guix/build-system/dune.scm guix/build-system/go.scm guix/build-system/linux-module.scm guix/packages.scm
| * doc: add clarifications to Linode cookbook recipeGrant Shangreaux2021-09-08
| | | | | | | | | | | | | | | | | | | | * doc/guix-cookbook.texi: clarify Linode recipe Reword paragraph about adding the Guix device disk to Debian config. Improve example commands for sftp-ing files to the server. Minor wording fixes Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* | Merge branch 'master' into core-updates-frozenLudovic Courtès2021-09-07
|\|
| * Migrate to the new 'targets' field of bootloader-configuration.Maxim Cournoyer2021-08-29
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | The old 'target' field is deprecated; adjust the sources to use the new 'targets' one instead. * doc/guix-cookbook.texi<target>: Replace by 'targets'. * gnu/bootloader/grub.scm: Likewise. * gnu/installer/parted.scm: Likewise. * gnu/machine/digital-ocean.scm: Likewise. * gnu/system/examples/asus-c201.tmpl: Likewise * gnu/system/examples/bare-bones.tmpl: Likewise * gnu/system/examples/bare-hurd.tmpl: Likewise * gnu/system/examples/beaglebone-black.tmpl: Likewise * gnu/system/examples/desktop.tmpl: Likewise * gnu/system/examples/docker-image.tmpl: Likewise * gnu/system/examples/lightweight-desktop.tmpl: Likewise * gnu/system/examples/vm-image.tmpl: Likewise * gnu/system/examples/yggdrasil.tmpl: Likewise * gnu/system/hurd.scm: Likewise * gnu/system/images/hurd.scm: Likewise * gnu/system/images/novena.scm: Likewise * gnu/system/images/pine64.scm: Likewise * gnu/system/images/pinebook-pro.scm: Likewise * gnu/system/images/rock64.scm: Likewise * gnu/system/install.scm: Likewise * gnu/system/vm.scm: Likewise * gnu/tests.scm: Likewise * gnu/tests/ganeti.scm: Likewise * gnu/tests/install.scm: Likewise * gnu/tests/nfs.scm: Likewise * gnu/tests/telephony.scm: Likewise * tests/boot-parameters.scm: Likewise * tests/system.scm: Likewise
| * Update copyright/name notices for Christine Lemmer-Webber.Christopher Lemmer Webber2021-08-15
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/guix-cookbook.texi: Update copyright/name for Christine Lemmer-Webber. * gnu/build/image.scm: Likewise. * gnu/build/vm.scm: Likewise. * gnu/packages/admin.scm: Likewise. * gnu/packages/assembly.scm: Likewise. * gnu/packages/audio.scm: Likewise. * gnu/packages/backup.scm: Likewise. * gnu/packages/check.scm: Likewise. * gnu/packages/databases.scm: Likewise. * gnu/packages/emacs-xyz.scm: Likewise. * gnu/packages/finance.scm: Likewise. * gnu/packages/gnupg.scm: Likewise. * gnu/packages/guile-xyz.scm: Likewise. * gnu/packages/guile.scm: Likewise. * gnu/packages/haskell-xyz.scm: Likewise. * gnu/packages/linux.scm: Likewise. * gnu/packages/mail.scm: Likewise. * gnu/packages/password-utils.scm: Likewise. * gnu/packages/perl.scm: Likewise. * gnu/packages/python-web.scm: Likewise. * gnu/packages/python-xyz.scm: Likewise. * gnu/packages/python.scm: Likewise. * gnu/packages/sphinx.scm: Likewise. * gnu/packages/ssh.scm: Likewise. * gnu/packages/xdisorg.scm: Likewise. * gnu/services/networking.scm: Likewise. * gnu/system/vm.scm: Likewise.
| * doc: Fix typo.Ricardo Wurmus2021-08-15
| | | | | | | | | | | | * doc/guix-cookbook.texi (GUIX_PACKAGE_PATH): Fix typo in file name. Reported-by: breathein on IRC.
* | Merge branch 'master' into core-updatesLudovic Courtès2021-07-18
|\|
| * doc: Add guide showing auto-login on a specific TTY to the cookbook.Joshua Branson2021-07-07
| | | | | | | | | | | | | | | | | | | | | | | | | | | | This is a follow-up to the discussion in <https://bugs.gnu.org/48974>. * doc/guix-cookbook.texi (System Configuration): Add a brief guide that explains auto login a user to one TTY. * doc/guix.texi (System Services): Add an texinfo anchor, so that the cookbook entry "Auto Login a User to a Specific TTY" can refer back to the precise point that the GNU Guix Reference manual. Also add a reference to the cookbook that shows how to auto login a specific user to one TTY. Signed-off-by: Leo Prikler <leo.prikler@student.tugraz.at>
* | doc: cookbook: Adjust example to simplified input style.Ludovic Courtès2021-07-12
| | | | | | | | | | * doc/guix-cookbook.texi (Extended example): Adjust example to new input style and adjust "Inputs" section.
* | doc: cookbook: Remove trailing #t from extended example.Ludovic Courtès2021-07-12
|/ | | | | * doc/guix-cookbook.texi (Extended example): Remove trailing #t from snippet and phases.
* doc: cookbook: Add "Guix System Image API" section.Joshua Branson2021-01-21
| | | | | | * doc/guix-cookbook.texi (Guix System Image API): New section. Signed-off-by: Mathieu Othacehe <othacehe@gnu.org>
* doc: Replace TP with Weblate mentions.Julien Lepiller2021-01-20
| | | | | | * doc/contributing.texi: Replace link to TP with a link to Weblate. * doc/guix.texi: Replace link to TP with a link to Weblate. * doc/guix-cookbook.texi: Replace link to TP with a link to Weblate.
* doc: cookbook: Fix "fiction-less" typo.Pierre Neidhardt2020-12-23
| | | | | * doc/guix-cookbook.texi (Guix Profiles in Practice): Change "friction-less" to "frictionless".
* doc: cookbook: Balance parens in custom kernel examples.Ludovic Courtès2020-10-17
| | | | | * doc/guix-cookbook.texi (Customizing the Kernel): Add missing paren in example. Remove extra parens in other example.
* doc: cookbook: Clarify what keywords are.Ludovic Courtès2020-10-15
| | | | | * doc/guix-cookbook.texi (A Scheme Crash Course): Clarify what keywords are.
* doc: Add "Build Utilities" section.Ludovic Courtès2020-10-15
| | | | | | | * doc/guix.texi (Build Utilities): New section. (Defining Packages): Refer to it. (Build Systems): Likewise. * doc/guix-cookbook.texi (Extended example): Likewise.
* doc: cookbook: Use @code for the identifiers of utility functions.Ludovic Courtès2020-10-15
| | | | * doc/guix-cookbook.texi (Utility functions): Use @code instead of @asis.
* doc: cookbook: More "#true" and "#false".Ludovic Courtès2020-10-15
| | | | | * doc/guix-cookbook.texi (Extended example) (Customizing the Kernel, Running Guix on a Linode Server): Use #true and #false.
* doc: cookbook: Use @var for meta-syntactic variables.Ludovic Courtès2020-10-15
| | | | | * doc/guix-cookbook.texi (Extended example): Use @var for meta-syntactic variables in 'modify-phases' description.
* doc: cookbook: Fix 'let' form in example.Ludovic Courtès2020-10-15
| | | | * doc/guix-cookbook.texi (Extended example): Fix 'let' form in example.
* services: nginx: Add lua module.Oleg Pykhalov2020-10-14
| | | | | | | | * gnu/services/web.scm (<nginx-configuration>) [lua-package-path, lua-package-cpath]: New record types. * gnu/services/web.scm (default-nginx-config): Use them. * doc/guix.texi (Web Services): Document this. * doc/guix-cookbook.texi (System Configuration): Document this.
* doc: cookbook: Mention "#true" and "#false".Ludovic Courtès2020-10-14
| | | | | | * doc/guix-cookbook.texi (A Scheme Crash Course): Mention "#true" and "#false". (Extended example): Likewise.
* doc: cookbook: Adding a section "Running Guix on a Linode Server"Joshua Branson2020-09-09
| | | | | | | | * doc/guix-cookbook.texi (Running Guix on a Linode Server): I added a section that explains how to run guix on a linode server. Thanks Chris Webber! Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: cookbook: Add chapter about Guix environment.Oleg Pykhalov2020-08-23
| | | | * doc/guix-cookbook.texi (Environment management): New chapter.
* doc: cookbook: Fix ‘file system’ spelling.Tobias Geerinckx-Rice2020-07-09
| | | | | * doc/guix-cookbook.texi (Getting help, Customizing the Kernel): Fix ‘file system’ spelling.
* doc: cookbook: Fix encoding of "André".Ludovic Courtès2020-06-28
| | | | | | This is a followup to f8945734a5abff69644284231cc47fb67456657b. * doc/guix-cookbook.texi: Encode "André" as UTF-8, not ISO-8859-1.
* doc: cookbook: Update entry about getting substitutes through Tor.André Batista2020-06-28
| | | | | * doc/guix-cookbook.texi (Getting substitutes from Tor): Update section warning to mention the use of torsocks when pulling.
* doc: cookbook: Fix typos.Ludovic Courtès2020-06-23
| | | | * doc/guix-cookbook.texi (Extended example): Fix typos.
* doc: cookbook: Tweak intro to the REPL.Ludovic Courtès2020-06-23
| | | | | * doc/guix-cookbook.texi (A Scheme Crash Course): Reword first paragraph. Remove extra paren.