diff options
| author | Andy Patterson <ajpatter@uwaterloo.ca> | 2017-04-08 23:43:33 -0400 |
|---|---|---|
| committer | Ricardo Wurmus <rekado@elephly.net> | 2017-05-16 15:18:16 +0200 |
| commit | 8a3814cdc5be79f4308ce20d8351d5bcc9536ee2 (patch) | |
| tree | 4f7260915f4434c0ce5a6ebab9c2b98c0ff6fbb7 | |
| parent | 0383afa02ae3777a0adb5304cb6918a2a5f5f250 (diff) | |
| download | guix-8a3814cdc5be79f4308ce20d8351d5bcc9536ee2.tar guix-8a3814cdc5be79f4308ce20d8351d5bcc9536ee2.tar.gz | |
doc: Update the documentation for the asdf build systems.
* doc/guix.texi (Build Systems): Remove the no-longer relevant parts about
naming inputs. Add documentation for the new parameters #:asd-system-name and
#:test-asd-file.
| -rw-r--r-- | doc/guix.texi | 30 |
1 files changed, 12 insertions, 18 deletions
diff --git a/doc/guix.texi b/doc/guix.texi index 7baf6ee38a..b272fcec83 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -3358,23 +3358,8 @@ These build systems can also be used to produce executable programs, or lisp images which contain a set of packages pre-loaded. The build system uses naming conventions. For binary packages, the -package itself as well as its run-time dependencies should begin their -name with the lisp implementation, such as @code{sbcl-} for -@code{asdf-build-system/sbcl}. Beginning the input name with this -prefix will allow the build system to encode its location into the -resulting library, so that the input can be found at run-time. - -If dependencies are used only for tests, it is convenient to use a -different prefix in order to avoid having a run-time dependency on such -systems. For example, - -@example -(define-public sbcl-bordeaux-threads - (package - ... - (native-inputs `(("tests:cl-fiveam" ,sbcl-fiveam))) - ...)) -@end example +package name should be prefixed with the lisp implementation, such as +@code{sbcl-} for @code{asdf-build-system/sbcl}. Additionally, the corresponding source package should be labeled using the same convention as python packages (see @ref{Python Modules}), using @@ -3394,7 +3379,16 @@ expressions to be passed as the @code{#:entry-program} argument. If the system is not defined within its own @code{.asd} file of the same name, then the @code{#:asd-file} parameter should be used to specify -which file the system is defined in. +which file the system is defined in. Furthermore, if the package +defines a system for its tests in a separate file, it will be loaded +before the tests are run if it is specified by the +@code{#:test-asd-file} parameter. If it is not set, the files +@code{<system>-tests.asd}, @code{<system>-test.asd}, @code{tests.asd}, +and @code{test.asd} will be tried if they exist. + +If for some reason the package must be named in a different way than the +naming conventions suggest, the @code{#:asd-system-name} parameter can +be used to specify the name of the system. @end defvr |