[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
02/12: doc: Expound description of the <package> 'arguments' field.
From: |
guix-commits |
Subject: |
02/12: doc: Expound description of the <package> 'arguments' field. |
Date: |
Thu, 23 Jun 2022 17:22:35 -0400 (EDT) |
civodul pushed a commit to branch master
in repository guix.
commit 2327bf41d97fa92c078d0eeeec4f2729ade33105
Author: Ludovic Courtès <ludovic.courtes@inria.fr>
AuthorDate: Thu Jun 23 18:02:11 2022 +0200
doc: Expound description of the <package> 'arguments' field.
* doc/guix.texi (package Reference): Augment description of the
'arguments' field.
---
doc/guix.texi | 21 +++++++++++++++++++--
1 file changed, 19 insertions(+), 2 deletions(-)
diff --git a/doc/guix.texi b/doc/guix.texi
index 9f3f1e39a4..874dab1597 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -7379,8 +7379,25 @@ The build system that should be used to build the
package (@pxref{Build
Systems}).
@item @code{arguments} (default: @code{'()})
-The arguments that should be passed to the build system. This is a
-list, typically containing sequential keyword-value pairs.
+The arguments that should be passed to the build system (@pxref{Build
+Systems}). This is a list, typically containing sequential
+keyword-value pairs, as in this example:
+
+@lisp
+(package
+ (name "example")
+ ;; several fields omitted
+ (arguments
+ (list #:tests? #f ;skip tests
+ #:make-flags #~'("VERBOSE=1") ;pass flags to 'make'
+ #:configure-flags #~'("--enable-frobbing"))))
+@end lisp
+
+The exact set of supported keywords depends on the build system
+(@pxref{Build Systems}), but you will find that almost all of them honor
+@code{#:configure-flags}, @code{#:make-flags}, @code{#:tests?}, and
+@code{#:phases}. The @code{#:phases} keyword in particular lets you
+modify the set of build phases for your package (@pxref{Build Phases}).
@item @code{inputs} (default: @code{'()})
@itemx @code{native-inputs} (default: @code{'()})
- branch master updated (c98f412de6 -> 000b710cee), guix-commits, 2022/06/23
- 01/12: doc: Remove trailing #t in example., guix-commits, 2022/06/23
- 03/12: gnu: wlroots: Replace input libinput by libinput-minimal., guix-commits, 2022/06/23
- 06/12: gnu: hikari: Replace input libinput by libinput-minimal., guix-commits, 2022/06/23
- 08/12: gnu: polybar: Update to 3.6.3., guix-commits, 2022/06/23
- 09/12: gnu: polybar: Simply inputs., guix-commits, 2022/06/23
- 04/12: gnu: sway: Replace input libinput by libinput-minimal., guix-commits, 2022/06/23
- 02/12: doc: Expound description of the <package> 'arguments' field.,
guix-commits <=
- 05/12: gnu: waybar: Replace input libinput by libinput-minimal., guix-commits, 2022/06/23
- 07/12: gnu: direnv: Update to 2.32.1., guix-commits, 2022/06/23
- 12/12: gnu: Add casacore., guix-commits, 2022/06/23
- 10/12: gnu: litecli: Update to 1.9.0., guix-commits, 2022/06/23
- 11/12: gnu: hypre: Add missing dependencies on latex fonts., guix-commits, 2022/06/23