e80e082be1
doc: cookbook: Document how to disable the Yubikey OTP application.
...
* doc/guix-cookbook.texi (Using security keys)
<Disabling OTP code generation for a Yubikey>: New subsection.
Reviewed-by: John Kehayias <john.kehayias@protonmail.com>
2023-08-17 00:01:45 -04:00
55f1c1c8a1
doc: cookbook: Document a dynamic DNS update mcron job.
...
* doc/guix-cookbook.texi (System Configuration)
<Dynamic DNS mcron job>: New subsection.
Reviewed-by: Ludovic Courtès <ludo@gnu.org>
2023-08-16 23:54:15 -04:00
c88fe11209
doc: Update Cookbook Texinfo menus.
...
Automated via C-c C-u C-a (M-x texinfo-all-menus-update) in Emacs.
2023-08-16 11:04:21 -04:00
d20a7da4a3
doc: cookbook: Mention common SRFI-1 procedures.
...
* doc/guix-cookbook.texi (A Scheme Crash Course): Add item about
SRFI-1.
2023-08-15 00:33:50 +02:00
3c7d465133
doc: cookbook: Add 'use-modules' in gexp example.
...
* doc/guix-cookbook.texi (A Scheme Crash Course): Add 'use-modules' line
in gexp example.
2023-08-15 00:33:50 +02:00
c3f6dd45d7
doc: cookbook: Link to "Package Modules".
...
* doc/guix-cookbook.texi (A Scheme Crash Course): Add link to "Package
Modules".
2023-08-15 00:33:50 +02:00
a33a335c89
doc: Mention gexps in the "Scheme Crash Course".
...
* doc/guix-cookbook.texi (A Scheme Crash Course): Add note on gexps.
2023-07-14 16:16:25 +02:00
5cf38fb6d6
doc: cookbook: Update example my-libgit2 package.
...
* doc/guix-cookbook.texi (Packaging Tutorial): Improve the code quality
of the example my-libgit2 package.
2023-06-05 21:36:06 +03:00
f4f5ee6ad6
services: screen-locker-service-type: Configurable PAM and setuid.
...
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>
2023-06-04 10:33:55 +02:00
8e9e6a6482
nls: Update translations.
...
* doc/guix-cookbook.texi (Top): Mention Slovak.
2023-05-31 17:23:21 +02:00
86bf0c5a3f
doc: cookbook: Remove outdated section about GUIX_PACKAGE_PATH.
...
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.
2023-05-06 18:01:16 +02:00
47c1de22df
doc: cookbook: Add "Installing Guix on a Cluster" chapter.
...
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.
2023-01-09 17:40:53 +01:00
efb0f8950f
doc: cookbook: Remove 404 link to mitpress.mit.edu.
...
* doc/guix-cookbook.texi (A Scheme Crash Course): Remove 404 link to
mitpress.mit.edu.
2023-01-06 23:46:31 +01:00
39f88ee29f
doc: cookbook: Fix commands in example.
...
Fixes <https://issues.guix.gnu.org/59463 >.
Reported by Luca Cirrottola <luca.cirrottola@inria.fr>.
* doc/guix-cookbook.texi (Reproducible profiles): Make it work.
2022-11-27 19:00:01 +01:00
d524ec6fb5
doc: Add a security keys section to the cookbook.
...
* doc/guix-cookbook.texi (Top): Register new menu.
(System Configuration): Likewise.
(Using security keys): New section.
2022-11-24 20:51:30 -05:00
b43200e5b1
doc: cookbook: Add section on MPD with bluealsa.
...
* doc/guix-cookbook.texi (Music Server with Bluetooth Audio): New section
under System Configuration.
2022-11-06 00:35:56 +01:00
769c5f563d
doc: cookbook: Update detailed menu for "System Configuration".
...
* doc/guix-cookbook.texi: Update menu.
2022-11-06 00:35:56 +01:00
56915dc275
doc: Add chapter on containers to Cookbook.
...
* doc/guix-cookbook.texi (Containers): New chapter.
2022-10-13 17:42:05 +02:00
9100acb6fb
doc: cookbook: Link to "A Scheme Primer".
...
* doc/guix-cookbook.texi (A Scheme Crash Course): Link to "A Scheme
Primer". Group references in @quotation for clarity.
2022-07-08 17:28:50 +02:00
da7bee91fa
doc: cookbook: Suggest 'guix shell'.
...
* doc/guix-cookbook.texi (A Scheme Crash Course): Suggest 'guix shell'
instead of 'guix environment'.
(Customizing the Kernel, The benefits of manifests): Likewise.
2022-07-08 17:28:50 +02:00
582b4bb4ce
doc: cookbook: Refer to the "Writing Manifests" manual node.
...
* doc/guix-cookbook.texi (Basic setup with manifests): Tweak
introductory paragraph. Refer to the new "Writing Manifests" node of
the manual.
2022-06-01 23:28:20 +02:00
6e747c3d50
doc: cookbook: Fix cross-reference to SICP.
...
Reported by Greg Hogan <code@greghogan.com>.
* doc/guix-cookbook.texi (A Scheme Crash Course): Fix xref to SICP.
2022-04-08 19:55:42 +02:00
63a11f92d1
doc: cookbook: Fix cross-reference to the manual.
...
Reported by Greg Hogan <code@greghogan.com>.
* doc/guix-cookbook.texi (Extended example): Fix node name in xref to
"package Reference".
2022-04-08 19:55:37 +02:00
27c273ec89
doc: cookbook: Update Tor onion service name.
...
* doc/guix-cookbook.texi: New variable.
(Getting substitutes from Tor): Use it.
2022-03-18 23:51:19 +01:00
c7d74a9bcc
doc: cookbook: Update custom kernel guide.
...
* doc/guix-cookbook.texi (Customizing the Kernel): Adjust to new interface.
2021-12-30 15:58:24 -05:00
e60f803b90
doc: cookbook: Simplify inputs in examples.
...
* doc/guix-cookbook.texi (Recursive importers, Inheritance): Use
the simplified input style.
2021-12-20 16:21:40 +01:00
a1eca979fb
Merge remote-tracking branch 'origin/master' into core-updates-frozen.
2021-10-12 17:46:23 +00:00
e0e65ed69d
doc: cookbook: Mention translations of the cookbook.
...
* doc/guix-cookbook.texi (Top): Add note about l10n.
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2021-10-04 16:36:58 +02:00
5c3cb22c9b
Merge branch 'master' into core-updates-frozen
...
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
2021-09-17 01:25:52 +02:00
de15397006
doc: add clarifications to Linode cookbook recipe
...
* 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>
2021-09-08 22:36:53 +02:00
d9dfbf886d
Merge branch 'master' into core-updates-frozen
2021-09-07 14:19:08 +02:00
da4e409483
Migrate to the new 'targets' field of bootloader-configuration.
...
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
2021-08-29 01:05:26 -04:00
9455143907
Update copyright/name notices for Christine Lemmer-Webber.
...
* 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.
2021-08-15 14:15:37 -04:00
a0fd46304e
doc: Fix typo.
...
* doc/guix-cookbook.texi (GUIX_PACKAGE_PATH): Fix typo in file name.
Reported-by: breathein on IRC.
2021-08-15 11:36:38 +02:00
0e47fcced4
Merge branch 'master' into core-updates
2021-07-18 19:50:01 +02:00
12c2648f4e
doc: cookbook: Adjust example to simplified input style.
...
* doc/guix-cookbook.texi (Extended example): Adjust example to new input
style and adjust "Inputs" section.
2021-07-12 10:59:36 +02:00
bc7dd3f713
doc: cookbook: Remove trailing #t from extended example.
...
* doc/guix-cookbook.texi (Extended example): Remove trailing #t from
snippet and phases.
2021-07-12 10:53:32 +02:00
c2ff06e5e4
doc: Add guide showing auto-login on a specific TTY to the cookbook.
...
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>
2021-07-07 11:13:38 +02:00
07ef129db3
doc: cookbook: Add "Guix System Image API" section.
...
* doc/guix-cookbook.texi (Guix System Image API): New section.
Signed-off-by: Mathieu Othacehe <othacehe@gnu.org>
2021-01-21 14:40:36 +01:00
2a9784ffa2
doc: Replace TP with Weblate mentions.
...
* 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.
2021-01-20 16:16:45 +01:00
af67e8d0b1
doc: cookbook: Fix "fiction-less" typo.
...
* doc/guix-cookbook.texi (Guix Profiles in Practice): Change "friction-less"
to "frictionless".
2020-12-23 11:45:06 +01:00
f54149062e
doc: cookbook: Balance parens in custom kernel examples.
...
* doc/guix-cookbook.texi (Customizing the Kernel): Add missing paren in
example. Remove extra parens in other example.
2020-10-17 22:40:18 +02:00
c0001b8bfc
doc: cookbook: Clarify what keywords are.
...
* doc/guix-cookbook.texi (A Scheme Crash Course): Clarify what keywords
are.
2020-10-15 23:51:04 +02:00
61263e1ba3
doc: Add "Build Utilities" section.
...
* doc/guix.texi (Build Utilities): New section.
(Defining Packages): Refer to it.
(Build Systems): Likewise.
* doc/guix-cookbook.texi (Extended example): Likewise.
2020-10-15 18:50:22 +02:00
48720afb32
doc: cookbook: Use @code for the identifiers of utility functions.
...
* doc/guix-cookbook.texi (Utility functions): Use @code instead of @asis.
2020-10-15 18:50:22 +02:00
3451368345
doc: cookbook: More "#true" and "#false".
...
* doc/guix-cookbook.texi (Extended example)
(Customizing the Kernel, Running Guix on a Linode Server): Use #true and #false.
2020-10-15 18:50:22 +02:00
51f34e21c6
doc: cookbook: Use @var for meta-syntactic variables.
...
* doc/guix-cookbook.texi (Extended example): Use @var for meta-syntactic
variables in 'modify-phases' description.
2020-10-15 18:50:22 +02:00
7802988201
doc: cookbook: Fix 'let' form in example.
...
* doc/guix-cookbook.texi (Extended example): Fix 'let' form in example.
2020-10-15 18:50:22 +02:00
00014f7692
services: nginx: Add lua module.
...
* 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.
2020-10-14 23:41:26 +03:00
cd958802f2
doc: cookbook: Mention "#true" and "#false".
...
* doc/guix-cookbook.texi (A Scheme Crash Course): Mention "#true" and
"#false".
(Extended example): Likewise.
2020-10-14 15:22:56 +02:00
Maxim Cournoyer
Ludovic Courtès
Efraim Flashner
muradm
Florian Pelz
Ludovic Courtès
Ricardo Wurmus
Leo Famulari
Mathieu Othacehe
Sarah Morgensen
Marius Bakke
Grant Shangreaux
Christopher Lemmer Webber
Joshua Branson
Joshua Branson
Julien Lepiller
Pierre Neidhardt
Oleg Pykhalov