Commit graph

3643 commits

Author SHA1 Message Date
aurtzy
ab80403eea
doc: Fix `copy-recursively' arguments.
The `select?' keyword is part of the description instead of immediately
following `keep-permissions?' in the arguments list for `copy-recursively'.
This adds a missing '@' to fix that.

* doc/guix.texi (Build Utilities): Fix `copy-recursively' arguments.

Change-Id: If6802490a6afebc884b039d84f1fe4f9202a1151
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2024-11-12 23:29:09 +01:00
Ludovic Courtès
dabbf71aa7
doc: Adjust stale reference to quote instead of gexp.
* doc/guix.texi (Build Phases): Mention hash-tilde, not apostrophe.

Change-Id: I8dca74da46d35692be122fb3e8e3ab40dd70606e
2024-11-12 23:27:09 +01:00
Efraim Flashner
922d017081
build/go: Replace symlinks with a copy of the file.
* guix/build/go-build-system.scm (fix-embed-files): New procedure.
(%standard-phases): Add 'fix-embed-files after 'unpack.
* guix/build-system/go.scm (#:embed-files): New key parameter.
* doc/guix.texi: (go-build-system): Document a new key.

Co-authored-by: Sharlatan Hellseher <sharlatanus@gmail.com>
Change-Id: I27bc46fa1a3f4675ff73b6cba4ef5c3d177c22b1
2024-11-09 21:33:51 +00:00
Troy Figiel
56cc37bfb2
build-system/go: Allow providing additional test flags.
By allowing the use of test flags, we can more precisely skip failing tests
(for go version >=1.20), disable the vetting stage or select a subset of tests
(e.g. if an upstream flag is provided to skip tests which require a network
connection).  At the moment, the only way around these test failures is to
remove the test file completely or patch the code ourselves.

* guix/build-system/go.scm (go-build): Add test-flags variable.
(go-cross-build): Add test-flags variable.
* guix/build/go-build-system.scm (check): Pass the additional test flags to the invoke call.
* doc/guix.texi (go-build-system): Document <#:test-flags> parameter.

Signed-off-by: Sharlatan Hellseher <sharlatanus@gmail.com>
Change-Id: I4015870fbbc15503cb405fe9ef6032953a5ff17f
2024-11-09 21:33:39 +00:00
Arun Isaac
2fa6f985a3
doc: Explicitly mention --localstatedir and --sysconfdir configure flags.
Prior to this commit, the terms localstatedir and sysconfdir were used without
being defined earlier in this section. This commit clarifies that they are
configure flags.

* doc/contributing.texi (Building from Git): Explicitly mention
--localstatedir and --sysconfdir configure flags.

Change-Id: I3e6edbbc1f2a342196e732e14257dbdf9a3f4303
2024-11-05 22:46:20 +00:00
Reepca Russelstein
6a8a6171a7
services: guix: Add access control to daemon socket.
* gnu/services/base.scm
  (guix-configuration-socket-directory-{permissions,group,user}): New fields.
  (guix-shepherd-service): Use them.
* doc/guix.texi (Base Services): Document them.

Change-Id: I8f4c2e20392ced47c09812e62903c87cc0f4a97a
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2024-11-03 23:05:06 +01:00
Ludovic Courtès
cf46aa7192
doc: Promote “Teams” section.
Suggested by Simon Tournier <zimon.toutoune@gmail.com>.

* doc/contributing.texi (Teams): Move from subsection of “Submitting
Patches” to section of “Contributing”.

Reviewed-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
Change-Id: Id21be29380fc981e74a5025b1467eebde8566726
2024-11-03 22:48:09 +01:00
Ludovic Courtès
cf2dfdcb44
doc: Add “Making Decisions” section.
Suggested by Simon Tournier <zimon.toutoune@gmail.com>.

* doc/contributing.texi (Making Decisions): New section, with paragraphs
moved from…
(Commit Access): … here.  Cross-reference it.
(Teams): Likewise.

Reviewed-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
Change-Id: Ib276242e0ec7598a1b60dacdde8647bd3d3b85d3
2024-11-03 22:47:56 +01:00
Maxim Cournoyer
2c322884b4
services: anonip: Add 'debug?' configuration field.
* gnu/services/web.scm (<anonip-configuration>) [debug?]: New field.
(anonip-shepherd-service): Honor it.
* doc/guix.texi (Log Rotation) <anonip-configuration>: Document it.

Change-Id: Iaf57b5992808374b069a55c34a9adfdfe52b046c
2024-11-01 23:15:20 +09:00
Maxim Cournoyer
ab554d6048
doc: Use @table @code for anonip-configuration doc.
* doc/guix.texi (Log Rotation): Use @table @code for anonip-configuration doc.

Change-Id: Ib6f8136715ecabc81d53dc13a14f4b111302c5c9
2024-11-01 23:14:46 +09:00
Florian Pelz
1f5b18262d
doc: Fix typos.
* doc/guix.texi (Sway window manager): Fix typo.
* doc/guix-cookbook.texi (Top): Rename Portuguese cookbook.

Change-Id: I61569aa882862871d9bf02fa1a97f3f3b902b494
2024-10-31 17:09:29 +01:00
Florian Pelz
781fd49949
doc: Fix markup.
* doc/contributing.texi (Source Tree Structure, Submitting Patches,
Translating Guix): Write @command instead of @code when invoking guix.
(Submitting Patches): Write @code instead of @command for a field name.
* doc/guix-cookbook.texi (A ``Hello World'' package): Use @xref at the
beginning of a sentence.
(Auto-Login to a Specific TTY): Remove a space before @pxref.
(Basic setup with manifests): Write @ref instead of (@pxref) after ``see''.

Change-Id: I1ced2ebc4062b3a80878a7e0eea8f7a3d4baf7da
2024-10-31 17:09:09 +01:00
Nicolas Graves
351fdf69f7
gnu: postgresql: Deprecate unsupported versions.
Versions 10 and 11 are unsupported according to
https://www.postgresql.org/support/versioning/

postgresql-10 also has a CVE.

* doc/guix.texi: Change default value of postgresql-service-type's
postgresql field.
* gnu/packages/databases.scm (postresql-10, postgresql-11): Use
define-deprecated/public to warn users.
* gnu/services/databases.scm (postgresql-configuration): Change the
default value of postgresql-configuration-postgresql.
* gnu/tests/guix.scm (%guix-data-service-os): Change the default value
of postgresql.

Signed-off-by: Andreas Enge <andreas@enge.fr>
Change-Id: Ie8744c8e1f246e9b45ff5e29d4e98214de3ca66a
2024-10-28 10:41:27 +01:00
Arun Isaac
cf33081e18
doc: Do not use numeric values in readymedia extra-config.
* doc/guix.texi (Miscellaneous Services)[DLNA/UPnP Services]: Use string value
"60" instead of numeric value 60 in extra-config.

Change-Id: Iea05409bb2f36fc4d0caafa375f0307bfae64a08
2024-10-20 12:26:39 +01:00
Arun Isaac
9b835aae10
doc: Fix typo in readymedia example configuration.
* doc/guix.texi (Miscellaneous Services)[DLNA/UPnP Services]: Change
media-directoriess to media-directories.

Change-Id: Iea05409bb2f36fc4d0caafa375f0307bfae64a08
2024-10-20 12:26:39 +01:00
Fabio Natali
8c6d24d388
gnu: services: Add readymedia service.
* gnu/services/upnp.scm, gnu/tests/upnp.scm: New files.
* gnu/local.mk (GNU_SYSTEM_MODULES): Add them.
* doc/guix.texi (Miscellaneous Services): Document the service.

Change-Id: I6a3c9db9e7504df308038343ed48e4409a323581
Signed-off-by: Arun Isaac <arunisaac@systemreboot.net>
2024-10-18 20:56:02 +01:00
Nigko Yerden
f8777ceca5
Add copyright lines.
They are related to commit eb1515849e.

* doc/guix.texi: Add copyright message.
* gnu/services/networking.scm: Add copyright message.

Change-Id: Ica510fd6e80228f124f0c084403e1dea7c9baa1b
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2024-10-16 19:07:55 +02:00
Ludovic Courtès
6757bfdfc0
doc: Define the purpose, membership, and creation of teams.
* doc/contributing.texi (Teams): Define the purpose of teams; provide
example; clarify membership and team creation.
(Reviewing the Work of Others): Link to “Teams”.

Change-Id: I5d75f69bc4653eb9da9c1d1f920718238ea83b9d
2024-10-14 14:08:44 +02:00
Nigko Yerden
eb1515849e
services: tor: Add support for pluggable transports.
Pluggable transports are programs that disguise Tor traffic, which
can be useful in case Tor is censored.  Pluggable transports
cannot be configured by #:config-file file exclusively because Tor
process is run via 'least-authority-wrapper' and cannot have access
to transport plugin, which is a separate executable (Bug#70302,
Bug#70332).

* doc/guix.texi (Networking Services): Document 'tor-transport-plugin'
data type and 'transport-plugins' option for 'tor-configuration.
* gnu/services/networking.scm: Export
'tor-configuration-transport-plugins', 'tor-transport-plugin',
'tor-transport-plugin?', 'tor-plugin-role',
'tor-plugin-protocol', and 'tor-plugin-program'.
(<tor-configuration>): Add 'transport-plugins' field.
(<tor-transport-plugin>): New variable.
(tor-configuration->torrc): Add content to 'torrc' computed-file.
(tor-shepherd-service): Add file-system-mapping(s).

Change-Id: I1b0319358778c7aee650bc843e021a6803a1cf3a
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2024-10-14 14:08:43 +02:00
Roman Scherer
886b410e6f
image: Add support for btrfs.
* gnu/build/image.scm (make-btrfs-image): New variable.
* gnu/system/image.scm (system-disk-image): Support btrfs.

Change-Id: I80a5b52ec478ce5927d6208e324cbb70282c647a
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2024-10-14 14:08:43 +02:00
Roman Scherer
727a72c5e2
image: Use file system options in make-vfat-image.
* gnu/build/image.scm (make-vfat-image): Use file system options.

Change-Id: I791aadd2803d1ef96fc79cf8910a74a0083d2b6e
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2024-10-14 14:08:43 +02:00
Herman Rimm
766ad072ad
services: configuration: Document multiple configurations per field.
* gnu/services/configuration.scm (generate-documentation): Filter for all
configurations associated with each field-name.
* doc/guix.texi (Complex Configurations): Describe use case for multiple
field-names.

Change-Id: I6d1e7b8858231aa05fda884b31a9bd0a48f07293
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2024-10-14 14:08:43 +02:00
Dariqq
41b5b723b3
doc: Document home-shepherd-configuration-daemonize?
* gnu/home/services/shepherd.scm: Export home-shepherd-configuration-daemonize?.
* doc/guix.texi (home-shepherd-configuration): Add entry for daemonize? field.

Change-Id: Ifd1518c89fe8d5869d5e6469823dafd8457f24f1
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2024-10-14 14:08:42 +02:00
Dariqq
8221a6a1ac
home: home-shepherd-configuration: Add silent? field.
* gnu/home/services/shepherd.scm (home-shepherd-configuration): Add silent? field.
(launch-shepherd-gexp): Conditionally invoke shepherd with --silent.
* doc/guix.texi (home-shepherd-configuration): Document it.

Change-Id: I1ce7a92c2777ebded39fe293b0bdcbd03562b4fc
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2024-10-14 14:08:42 +02:00
Ludovic Courtès
ff5072d270
doc: Refer to ‘iso-codes’, not ‘iso-codes/pinned’.
This effectively reverts 8e5c8303a4, which
was unnecessary in this case and would break when evaluating
‘doc/build.scm’ against a previous Guix revision where
‘iso-codes/pinned’ is unbound.

* doc/build.scm (localization-helper-module): Use ‘iso-codes’ rather
than ‘iso-codes/pinned’.

Change-Id: I95497fa474fb5ce89c7d2fe9bf0925a0cd438763
2024-10-14 14:08:42 +02:00
Florian Pelz
e473fc7535
doc: Fix typos.
* doc/guix.texi (Sound Services, Web Services, Miscellaneous
Services, Invoking guix system, Sway window manager): Fix typos.

Change-Id: I28c09ecb6034e4aae43ca6006b46fdb186832edd
2024-10-14 09:42:46 +02:00
Ludovic Courtès
9d1b97d7a4
doc: Add “Deprecation Policy” section.
* doc/contributing.texi (Deprecation Policy): New node.
(Commit Access): Link to ‘package-removal-policy’.

Change-Id: I5d095559920a3d9b791b5d919aab4e2f2a0c2dee
2024-10-12 19:49:31 +02:00
Arnaud Daby-Seesaram
b64f7984a5
home: services: Add 'home-sway-service-type'.
* gnu/home/services/sway.scm: New file.
(home-sway-service-type): New variable.
(sway-configuration->file): New procedure.
(sway-configuration): New configuration record.
(sway-bar): New configuration record.
(sway-output): New configuration record.
(sway-input): New configuration record.
(point): New configuration record.
(sway-color): New configuration record.
(sway-border-color): New configuration record.
(sway-mode): New configuration record.
(flatmap): New procedure.
* gnu/local.mk: Add gnu/home/services/sway.scm.
* doc/guix.texi (Sway window manager): New node to document the above
changes.

Signed-off-by: Florian Pelz <pelzflorian@pelzflorian.de>
Change-Id: I880261570c5afdb795f2ce18bac2b9a5c898677f
2024-10-12 14:26:01 +02:00
Maxim Cournoyer
d44beb9b4a
doc: Update documentation for wayland? option of gdm-configuration.
This is a follow-up to commit 06d01c610e ("services: gdm: Enable wayland by
default."), which forgot updating the associated documentation.

Change-Id: I3ea0402680e3e0f588db057988eb00af44ab4ae6
2024-10-08 17:05:14 +09:00
Tomas Volf
db1a1dc0b2
time-machine: Print profile path if no command is given.
Instead of warning, print the profile path of the cached-channel-instance.

* guix/scripts/time-machine.scm (guix-time-machine)[not command-line]: Print
the profile directory.
(show-help): Adjust usage message.
* doc/guix.texi (Invoking guix time-machine): Document it.

Change-Id: Id2c1ded514e6c5af45af9008ad1ef91beb509177
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2024-10-07 12:51:23 +02:00
Maxim Cournoyer
cf3f9230c3
services: Extend udev rules in joycond-service-type.
* gnu/services/games.scm (joycond-service-type): Also extend the udev service
with the configured joycond package.
* doc/guix.texi (Game Services): Update documentation.

Change-Id: I9f7fb0da5cfc1f8a7e8bb5f2ce7161e5e66b2f5e
2024-10-07 01:20:22 +09:00
Maxim Cournoyer
6954cc6c7a
services: networking: Add 'version' field to dhcp-client-configuration.
* gnu/services/networking.scm (<dhcp-client-configuration>)
[version]: New field.
(dhcp-client-shepherd-service): Use 'match-record' instead of various
accessors.  Honor the new 'version field'.  Include the version the PID file
name when a non-default version is used.
* doc/guix.texi (Networking Setup) <dhcp-client-configuration>
[version]: Document it.

Change-Id: I6236ae160967c95fe7a2c1785821cc9b0c183e77
2024-10-07 01:20:21 +09:00
Roman Scherer
8e5c8303a4
gnu: iso-codes: Rename to iso-codes/pinned.
* gnu/packages/iso-codes.scm (iso-codes): Rename to…
(iso-codes/pinned): … this.
* doc/build.scm,
gnu/installer.scm,
gnu/packages/fcitx.scm,
gnu/packages/fcitx5.scm,
gnu/packages/gnome.scm,
gnu/packages/gstreamer.scm,
gnu/packages/gtk.scm,
gnu/packages/ibus.scm,
gnu/packages/kde-frameworks.scm,
gnu/packages/kde-plasma.scm,
gnu/packages/mate.scm,
gnu/packages/photo.scm,
gnu/packages/video.scm: Adjust accordingly.

Change-Id: Ia98fee15a27009583fee822cf411512727b1aa27
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2024-09-28 12:55:54 +02:00
Andreas Enge
1c088531cf
services: guix-build-coordinator-agent: Add extra-options.
* gnu/services/guix.scm (<guix-build-coordinator-agent-configuration>):
Add field extra-options.
(guix-build-coordinator-agent-shepherd-services): Add and use EXTRA-OPTIONS
argument.
* doc/guix.texi (Guix Services): Adapt the documentation.

Change-Id: I9e7e258e03e2b6553aa1570f5fcfaf3b0ada3e15
Reviewed-by: Maxim Cournoyer <maxim.cournoyer@gmail>
2024-09-18 11:21:06 +02:00
Andreas Enge
fb8c4916be
services: guix-build-coordinator-agent: Remove defaults.
* gnu/services/guix.scm (<guix-build-coordinator-agent-configuration>)
[max-parallel-builds, max-parallel-uploads]: Set default to #f.
(guix-build-coordinator-agent-shepherd-services): Check for
max-parallel-builds.
* doc/guix.texi (Guix Services): Adapt the documentation.

If set to #f, the default values are now taken as the defaults of the
guix-build-coordinator-agent command.

Change-Id: Ide6dde0e88aa0dc851b6295095f414ca2ddc72ac
Reviewed-by: Maxim Cournoyer <maxim.cournoyer@gmail>
2024-09-18 11:20:35 +02:00
Richard Sent
85556e1dab
services: admin: Support rebooting after an unattended upgrade
* gnu/services/admin.scm (unattended-upgrade-configuration): Add reboot?
field. When truthy, unattended upgrade will stop the shepherd root service,
triggering a reboot.
* doc/guix.texi (Unattended Upgrades): Document it.

Change-Id: I0af659b3c318421b1a7baa94dde3dadacc1fa10d
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2024-09-16 00:16:21 +02:00
Tobias Geerinckx-Rice
b5fc642ae6
doc: Add more newline.
* doc/guix.texi (partition Reference): Enumerate one list per paragraph.

Change-Id: I939a73fa8a3e5063e2d9441d7a64cc4a41862abd
2024-09-01 02:00:00 +02:00
Tobias Geerinckx-Rice
fd863f0385
doc: Committers are people.
* doc/contributing.texi (Commit Access): Use ‘who’.

Change-Id: I88304640f8f184f7ec0caae5bb862c7f170c0d79
2024-09-01 02:00:00 +02:00
Tobias Geerinckx-Rice
3d6388aebf
doc: Add newlines.
* doc/contributing.texi (Commit Access): Split one trademark Guix
megagraph™ into three of your human paragraphs.  No other change.

Change-Id: Ifd2a9166b1dfe1a22dcd0811044a408325cc22cb
2024-09-01 02:00:00 +02:00
Roman Scherer
6517baf995
doc: cookbook: Fix typo in screen-locker-service-type
The screen locker service type is called screen-locker-service-type, and not
screen-locker-services-type.

* doc/guix-cookbook.texi (Xorg): Fix typo.

Change-Id: I191b0cb971f435f283ff8d0278e581372d16ae95
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2024-09-09 17:17:56 +02:00
Ludovic Courtès
0629af7c2a
guix build: ‘--log-file’ honors the configured substitute URLs.
* guix/scripts/build.scm (guix-build): When defining ‘urls’, add
‘substitute-urls’ call.
* doc/guix.texi (Additional Build Options): Adjust ‘--log-file’
documentation.

Change-Id: I40f0647efe64ba3a63a6379b8da80b0da8910f48
2024-09-06 11:46:23 +02:00
Ludovic Courtès
94656e2eb0
doc: Add index entries for ‘assume-file-name’ & co.
* doc/guix.texi (G-Expressions): Add index entries for
‘assume-file-name’ and ‘assume-source-relative-file-name’.

Change-Id: Iee51fb09f4cbd32dacf90f03cafca973e8c993f8
2024-09-04 19:17:00 +02:00
Richard Sent
f3ea876895
gexp: Add ‘assume-source-relative-file-name’.
* guix/gexp.scm (assume-source-relative-file-name): New macro.
(local-file): Use assume-source-relative-file-name to look up a non-literal
file relative to the current source directory.
* doc/guix.texi (G-expressions): Document it.
* tests/gexp.scm ("local-file, non-literal source relative file name"):
New test.

Signed-off-by: Ludovic Courtès <ludo@gnu.org>
Change-Id: I18573c8c7a6c87e8351b34412f9d26bb23b068b4
2024-09-04 19:17:00 +02:00
Herman Rimm
c4ce313052
scripts: style: Add 'alphabetical-sort' option.
* guix/scripts/style.scm (show-help): Describe option.
(order-packages): Add procedure.
(format-whole-file): Add 'order?' argument.
(%options): Add 'alphabetical-sort' option.
(guix-style): Alphabetically order packages in files.
* tests/guix-style.sh: Test alphabetical ordering.
* doc/guix.texi (Invoking guix style): Document option.

Change-Id: I4aa7c0bd0b6d42529ae7d304587ffb10bf5f4006
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2024-09-03 13:59:33 +02:00
Florian Pelz
0ba20c7634
doc: build: Handle when guile source is packed with zstd.
* doc/build.scm (guile-manual): Also include zstd in PATH.

Change-Id: Iff49825fe84121bff777ed45c03fb14af0a0e719
2024-09-02 00:46:42 +02:00
Rodion Goritskov
61a7930cb0
services: agate: Change variable names and add system test.
* doc/guix.texi (Web Services): Update documentation for agate-service-type.
* gnu/services/web.scm (agate-configuration): Rename certs, addr, lang and
central-conf variables.
* gnu/tests/web.scm (%test-agate): Add system test for agate-service-type.

Change-Id: Ie14814fca1d5158acd67899da0c3fc2c5b586c72
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2024-08-31 19:06:39 +02:00
Romain GARBAGE
f5d75acd0d
doc: Document changes to `copy-recursively'.
* doc/guix.texi: Document new key `select?' in `copy-recursively'.

Change-Id: I4b14ae5a1b40e0939456604f75597b5596b76f83
Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
2024-08-31 10:44:42 +02:00
Bruno Victal
b3d5e2d252
build: copy-build-system: Allow specifying different output labels.
* guix/build/copy-build-system.scm: Introduce '#:output' parameter to specify
which output label to use for a given rule.
* doc/guix.texi (Build Systems): Document it.

Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2024-08-31 10:44:16 +02:00
Bruno Victal
e96fa0b695
search-paths: Add $XML_CATALOG_FILES and $SGML_CATALOG_FILES.
These variables are used by some packages for XML/SGML catalog lookups.

* guix/search-paths ($XML_CATALOG_FILES, $SGML_CATALOG_FILES): New variable,
extracted from …
* gnu/packages/xml.scm (libxml2, opensp)[native-search-paths]: … here. Refer
to the variables from (guix search-paths) respectively.
* gnu/packages/perl.scm
(perl-app-xml-docbook-builder)[native-search-paths]: Use $XML_CATALOG_FILES.
* doc/guix.texi (Search Paths): Update documentation to reflect changes.

Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
2024-08-31 10:42:07 +02:00
Tobias Geerinckx-Rice
6c56608561
doc: Fix typos.
* doc/guix.texi (Desktop Services): Transpose 2 adjacent bytes.
(Complex Configurations): Add a missing one.

Change-Id: Ia03404b500e22ed0f8a414e6b63a8f3cc6270379
2024-08-18 02:00:00 +02:00