f912d5c740
doc: Substitute @deffn usage with @defvar for Scheme variables.
...
* doc/guix.texi (Base Services) (Networking Setup)
(Networking Services) (Printing Services) (Desktop Services)
(Sound Services) (Database Services) (Mail Services) (Messaging Services)
(File-Sharing Services) (Web Services) (DNS Services)
(Power Management Services) (Virtualization Services) (Linux Services)
(Miscellaneous Services): Substitute @deffn usage with @defvar for Scheme variables.
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2023-01-23 23:51:33 +01:00
f88e855f9f
doc: Use @defvar instead of @defvr for Scheme variables.
...
* doc/guix.texi (Build Systems) (Search Paths) (The Store)
(The Store Monad) (File Systems) (Mapped Devices) (User Accounts)
(Locales) (Base Services) (Scheduled Job Execution) (Log Rotation)
(Networking Setup) (Networking Services) (Unattended Upgrades)
(X Window) (Desktop Services) (Database Services) (Messaging Services)
(Kerberos Services) (Web Services) (Certificate Services) (VPN Services)
(Network File System) (Samba Services) (Power Management Services)
(Audio Services) (Virtualization Services) (Linux Services) (Hurd Services)
(Miscellaneous Services) (Setuid Programs) (Name Service Switch)
(Initial RAM Disk) (Service Reference) (Shepherd Services)
(Essential Home Services) (Mcron Home Service)
(Power Management Home Services) (Shepherd Home Service) (Secure Shell)
(Desktop Home Services) (Guix Home Services) (Supported Platforms)
(Instantiate an Image) (image-type Reference): Use @defvar instead of @defvr for Scheme variables.
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2023-01-23 23:51:02 +01:00
d2454e91b3
doc: Fix incorrect use of @defvar.
...
* doc/guix.texi (Monitoring Services) (VNC Services)
(Samba Services) (Game Services) (PAM Mount Service)
(Guix Services): Fix incorrect use of @defvar.
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2023-01-23 23:49:45 +01:00
5aef6a55a2
doc: Document the 'release-monitoring-url' package property.
...
* doc/guix.texi (Invoking guix refresh): Mention the
'release-monitoring-url' property.
2023-01-23 23:23:08 +01:00
6ffeef92e6
services: hpcguix-web: Provide default values.
...
* gnu/services/web.scm (<hpcguix-web-configuration>)[specs]: Default to #f.
(hpcguix-web-shepherd-service): Do not pass '--config' when SPECS is #f.
(hpcguix-web-service-type)[default-value]: New field.
* doc/guix.texi (Web Services): Adjust accordingly.
2023-01-22 18:12:09 +01:00
e1dbac04c3
gnu: hpcguix-web: Update to 0.3.0.
...
* gnu/packages/web.scm (hpcguix-web): Update to 0.3.0.
[inputs]: Add GUILE-SYNTAX-HIGHLIGHT.
[arguments]: In 'wrap-program' phase, take guile-syntax-highlight into
account.
* gnu/tests/web.scm (%hpcguix-web-specs): Remove 'define'.
* doc/guix.texi (Web Services): Adjust accordingly.
2023-01-22 18:12:09 +01:00
2491a60404
doc: Fix Xvnc service example.
...
Reported by bost on #guix (thank you!)
* doc/guix.texi (VNC Services): Add the missing host argument in the SSH
command example.
2023-01-20 12:32:34 -05:00
8221cb6d2a
doc: Fix typo.
...
* doc/guix.texi (Cross-Compilation): Replace "penaly" with "penalty".
Replace "few users" with "fewer users".
2023-01-18 21:40:07 -05:00
79b11cafcf
doc: Use the right cross-reference command.
...
* doc/guix.texi (Package Transformation Options): Use @pxref, not @ref.
2023-01-17 16:05:20 +01:00
0f20fc4dd9
services: connman: Add iwd backend support.
...
* gnu/services/networking.scm (connman-configuration)[iwd?]: New field.
(connman-shepherd-service): Add iwd? logic, remove wpa-supplicant requirement.
* doc/guix.texi: Add information about connman-configuration iwd? option.
Co-authored-by: Andrew Tropin <andrew@trop.in>
Signed-off-by: Andrew Tropin <andrew@trop.in>
2023-01-16 20:59:30 +04:00
a472aa1bb0
doc: Fix erroneous copyright line.
...
* doc/guix.texi: Fix copyright line for Antero Mejr.
2023-01-16 09:02:40 -05:00
93e683a952
scripts: repl: Add -i, --interactive flag.
...
* guix/scripts/repl.scm (%options): Add -i, --interactive flag.
(guix-repl): Honor -i, --interactive flag.
* doc/guix.texi (Invoking guix repl): Add documentation for -i, --interactive.
Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
2023-01-16 09:00:03 -05:00
abd9569571
scripts: repl: Add --list-types flag.
...
* guix/scripts/repl.scm (%options): Add --list-types.
* doc/guix.texi (Invoking guix repl): Add documentation for --list-types.
Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
2023-01-16 08:50:05 -05:00
137b91f03b
transformations: Add '--with-version'.
...
This is a followup to 8aeccc6240
2023-01-16 13:41:27 +01:00
a5b914156e
services: greetd: Add 'source-profile?' configuration field.
...
* gnu/services/base.scm (<greetd-terminal-configuration>)[source-profile?]:
New field.
(make-greetd-terminal-configuration-file): Serialize new field to
configuration file.
* doc/guix.texi (Base Services): Document it.
2023-01-15 20:30:12 +01:00
202ac747e6
gnu: services: Add joycond-service.
...
* gnu/services/games.scm (joycond-configuration): New configuration type.
(joycond-shepherd-service): New procedure.
(joycond-service-type): New variable.
* doc/guix.texi (Game Services): Document it.
2023-01-14 07:53:21 -05:00
9aa3b6eb6d
doc: Clarify how to use the #:go key of go-build-system.
...
This is a followup to commit 9ec62d1b9c
2023-01-11 20:20:05 -05:00
9ec62d1b9c
doc: Document the #:go key of the Go build system.
...
* doc/guix.texi (Build Systems): Document '#:go'.
2023-01-11 20:17:37 -05:00
09cd488c97
doc: contributing: Note '-v REVISION' bug in 'git send-email'.
...
* doc/contributing.texi ("Submitting Patches")["Sending a Patch Series"]:
Note that a bug in 'git send-email' means '-v REVISION' (with a
space) will not work.
Signed-off-by: Christopher Baines <mail@cbaines.net>
2023-01-11 10:31:58 +00:00
9aa2b74198
doc: contributing: Tweak the Commit Policy.
...
Add more examples of when it can be appropriate to push changes without
review, as I think this can be appropriate in the case of trivial changes (as
mentioned before), but also non-trivial fixes.
No longer suggest pushing simple new packages or package upgrades (that don't
cause lots of rebuilds) without sending to guix-patches. Now there's some
automation for testing changes sent to guix-patches, sending changes there
before pushing can mean that more rigorous testing takes place and help speed
up substitutes becoming available. This is true, even if no human review takes
place.
Only suggest waiting one week for review for simpler changes, wait two weeks
for more significant changes.
Also, reorder some of the information in this section so it's grouped together
better.
* doc/contributing.texi (Commit Policy): Tweak.
Signed-off-by: Christopher Baines <mail@cbaines.net>
2023-01-11 10:31:55 +00:00
65d24b9a24
doc: Fix documentation typo.
...
* doc/guix.texi (VNC Services): Fix typo.
Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
2023-01-10 11:12:11 -05:00
5f63811032
services: unattended-upgrade: Add 'operating-system-expression' field.
...
* gnu/services/admin.scm (<unattended-upgrade-configuration>)
[operating-system-expression]: New field.
(unattended-upgrade-mcron-jobs): Honor it.
* doc/guix.texi (Unattended Upgrades): Document it.
Co-authored-by: Ludovic Courtès <ludo@gnu.org>
2023-01-10 11:49:14 +01:00
22e9b01bda
services: git-daemon: Deprecate 'git-daemon-service' procedure.
...
* gnu/services/version-control.scm
(git-daemon-service): Define with 'define-deprecated'
* doc/guix.texi (Version Control Services): Replace with
'git-daemon-service-type'
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2023-01-10 11:49:13 +01:00
e4673b45d3
doc: Fix <openntpd-configuration> openntpd default.
...
* doc/guix.texi (Networking Services): <openntpd-configuration>'s
openntpd field takes a package: it does not default to a FILE-APPEND
call.
2023-01-08 01:00:01 +01: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
8b314efd50
services: base: Add environment support to guix-configuration.
...
* gnu/services/base.scm (<guix-configuration>)[extra-env]: New field.
(guix-shepherd-service): Honor it.
* doc/guix.texi (Base Services): Document it.
2023-01-09 17:15:28 +01:00
699d104146
Revert "services: base: Add extra-env support to guix-configuration."
...
This reverts commit 78a9b4f996
2023-01-07 20:14:24 +01:00
78a9b4f996
services: base: Add extra-env support to guix-configuration.
...
* gnu/services/base.scm (<guix-configuration>)[extra-env]: New field.
(guix-shepherd-service): Honor it.
* doc/guix.texi (Base Services): Document it.
2023-01-07 19:41:51 +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
c9b383fb38
doc: Introduce using swap space for hibernation, with examples.
...
* doc/guix.texi (Swap Space): Add a concise introduction to hibernation and
specifying a swap space to the kernel to make resume work. Mention space
requirements and the need of an offset for swap files. Include a trivial
example on how to set up a mapped swap volume for hibernation and another one
for a swap file, including how to compute the file offset.
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2023-01-05 23:02:45 +01:00
73684dc90e
home: services: environment-variables: Add support for literal strings.
...
* gnu/home/services.scm (<literal-string>): New record type.
(environment-variable-shell-definitions): Split 'shell-quote' into
'quote-string' and 'shell-double-quote'. Add 'shell-single-quote'.
Add clause for 'literal-string' records.
* tests/guix-home.sh: Test it.
* doc/guix.texi (Essential Home Services): Document it.
2023-01-05 14:20:23 +01:00
ec365d1959
doc: Fix broken link for go-build-system.
...
* doc/guix.texi (Build Systems): Fix broken link for go-build-system.
Signed-off-by: Maxim Cournoyer <maxim.cournoyer@gmail.com>
2023-01-03 16:25:38 -05:00
d57dd25d38
import/cran: Allow custom license prefix.
...
* guix/import/cran.scm (string-licenses): Add license-prefix argument.
(string->license): Ditto.
(description->package): Ditto.
(cran->guix-package): Ditto.
(cran-recursive-import): Ditto.
* guix/scripts/import/cran.scm (%options): Add new option -p/--license-prefix.
(show-help): Document it.
(parse-options): Pass it to importer.
* doc/guix.texi (Invoking guix import): Document it.
2022-12-31 14:48:46 +01:00
de781de2e9
doc: Give example of when to use describe in .guix-channel file.
...
* doc/guix.texi (Package Modules in a Sub-directory): Mention "guix deploy"
files as an example.
Signed-off-by: Ricardo Wurmus <rekado@elephly.net>
2022-12-29 20:01:59 +01:00
d0d700526c
doc: Describe format of channel that uses directory field.
...
* doc/guix.texi (Package Modules in a Sub-directory): Explain that directory
must be the module root.
2022-12-29 20:01:59 +01:00
fe14f88d56
doc: Update expired URL.
...
* doc/guix.texi (DNS Services): Update knot-resolver documentation link.
2022-12-28 00:38:40 +01:00
7c476873e0
doc: Describe how to update to a specific version.
...
* doc/guix.texi (Invoking guix refresh): Describe how to update to a specific
version.
2022-12-26 17:38:07 +01:00
9369c1ccf4
gnu: services: Fix bluetooth-service docstring.
...
* gnu/services/desktop.scm (bluetooth-service): Sync docstring with info,
remove mention to group not really needed to access D-Bus service.
* doc/guix.texi (Desktop Services): Also remove mention to group here.
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2022-12-26 00:48:05 +01:00
2967abf1a2
services: wireguard: Allow specifying pre-shared keys.
...
* gnu/services/vpn.scm (<wireguard-peer>)[preshared-key]: New field.
* doc/guix.texi (VPN Services): Document it.
Signed-off-by: Mathieu Othacehe <othacehe@gnu.org>
2022-12-25 16:56:48 +01:00
9cadac9787
doc: Fix typo.
...
* doc/contributing.texi (Sending a Patch Series): Fix e-mail address of
<guix-patches@gnu.org>.
Reported by Denis 'GNUtoo' Carikli <GNUtoo@cyberdimension.org>.
2022-12-18 01:00:10 +01:00
0a45d4bad4
doc: Wrap $localstatedir in Texinfo syntax.
...
* doc/guix.texi (Limitations): Use @file syntax.
2022-12-23 20:20:06 +01:00
672c48f15d
doc: Suggest remounting store before relabeling the file system.
...
* doc/guix.texi (Installing the SELinux policy): Mention that the store may
need to be remounted before writing to it.
2022-12-23 20:20:06 +01:00
00f48860e9
services: opensmtpd: Add 'shepherd-requirement' field.
...
* gnu/services/mail.scm (<opensmtpd-configuration>)[shepherd-requirement]:
New field.
(opensmtpd-shepherd-service): Honor it.
* doc/guix.texi (Mail Services): Document it.
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2022-12-20 16:56:04 +01:00
3f6c5c6f78
doc: Avoid 'match' on the <udev-configuration> record.
...
Fixes <https://issues.guix.gnu.org/59907 >.
Reported by MANCINI Raffael <Raffael.MANCINI@mnhn.lu>.
* doc/guix.texi (Service Types and Services): Change
'udev-configuration' example to avoid 'match'.
2022-12-20 16:56:03 +01:00
12ca767702
Merge branch 'version-1.4.0'
2022-12-19 00:40:33 +01:00
553f46a094
doc: Tweak cross-ref Texinfo command.
...
* doc/guix.texi (Swap Space): Use @pxref instead of @xref at the end of
a sentence.
2022-12-18 23:02:59 +01:00
8e2f32cee9
doc: Update URLs for the manual and cookbook translations.
...
* doc/htmlxref.cnf: Update URLs for "guix" and "guix-cookbook".
2022-12-18 16:01:32 +01:00
b77b4c7c3a
doc: Add guile-netlink to 'htmlxref.cnf'.
...
* doc/htmlxref.cnf: Add guile-netlink.
2022-12-18 15:53:43 +01:00
047ae5c345
doc: Use VM image file name consistently.
...
Previously, what "/tmp/qemu-image" refers to could be unclear at first.
* doc/guix.texi (Running Guix in a VM): Use the original image file
name instead of /tmp/qemu-image.
* po/doc/guix-manual.de.po, po/doc/guix-manual.es.po,
po/doc/guix-manual.fr.po, po/doc/guix-manual.pt_BR.po,
po/doc/guix-manual.ru.po, po/doc/guix-manual.zh_CN.po: Adjust
accordingly.
2022-12-15 00:15:36 +01:00
2cf16f2c31
doc: Fix formatting for 'computed-file'.
...
* doc/guix.texi (G-Expressions): Fix formatting for 'computed-file'.
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2022-12-14 15:09:49 +01:00
Bruno Victal
Ludovic Courtès
Maxim Cournoyer
Declan Tsien
Antero Mejr
Jelle Licht
David Thompson
Leo Famulari
(
Christopher Baines
jgart
Giacomo Leidi
Tobias Geerinckx-Rice
Ludovic Courtès
Mathieu Othacehe
Ivan Vilata-i-Balaguer
Lars-Dominik Braun
Karl Hallsby
Marius Bakke
Hartmut Goebel
Timo Wilken
Ricardo Wurmus