summaryrefslogtreecommitdiff
path: root/doc/guix.texi
diff options
context:
space:
mode:
Diffstat (limited to 'doc/guix.texi')
-rw-r--r--doc/guix.texi39
1 files changed, 19 insertions, 20 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 58a4aa65ac..10d735431b 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -6168,23 +6168,22 @@ all the boilerplate code often needed for the
To further simplify the file installation process, an
@code{#:install-plan} argument is exposed to let the packager specify
-which files go where.
-The install plan is a list of @code{(SOURCE TARGET [FILTERS])}.
-@code{FILTERS} are optional.
+which files go where. The install plan is a list of @code{(@var{source}
+@var{target} [@var{filters}])}. @var{filters} are optional.
@itemize
-@item When @code{SOURCE} matches a file or directory without trailing slash, install it to @code{TARGET}.
+@item When @var{source} matches a file or directory without trailing slash, install it to @var{target}.
@itemize
- @item If @code{TARGET} has a trailing slash, install @code{SOURCE} basename beneath @code{TARGET}.
- @item Otherwise install @code{SOURCE} as @code{TARGET}.
+ @item If @var{target} has a trailing slash, install @var{source} basename beneath @var{target}.
+ @item Otherwise install @var{source} as @var{target}.
@end itemize
-@item When @code{SOURCE} is a directory with a trailing slash, or when @code{FILTERS} are used,
- the trailing slash of @code{TARGET} is implied with the same meaning
+@item When @var{source} is a directory with a trailing slash, or when @var{filters} are used,
+ the trailing slash of @var{target} is implied with the same meaning
as above.
@itemize
- @item Without @code{FILTERS}, install the full @code{SOURCE} @emph{content} to @code{TARGET}.
- @item With @code{FILTERS} among @code{#:include}, @code{#:include-regexp}, @code{exclude},
+ @item Without @var{filters}, install the full @var{source} @emph{content} to @var{target}.
+ @item With @var{filters} among @code{#:include}, @code{#:include-regexp}, @code{#:exclude},
@code{#:exclude-regexp}, only select files are installed depending on
the filters. Each filters is specified by a list of strings.
@itemize
@@ -6199,21 +6198,21 @@ The install plan is a list of @code{(SOURCE TARGET [FILTERS])}.
on top of the inclusions.
@end itemize
@end itemize
- In all cases, the paths relative to @code{SOURCE} are preserved within
- @code{TARGET}.
+ In all cases, the paths relative to @var{source} are preserved within
+ @var{target}.
@end itemize
Examples:
@itemize
-@item @code{("foo/bar" "share/my-app/")}: Install @code{bar} to @code{share/my-app/bar}.
-@item @code{("foo/bar" "share/my-app/baz")}: Install @code{bar} to @code{share/my-app/baz}.
-@item @code{("foo/" "share/my-app")}: Install the content of @code{foo} inside @code{share/my-app},
- e.g. install @code{foo/sub/file} to @code{share/my-app/sub/file}.
-@item @code{("foo/" "share/my-app" #:include ("sub/file"))}: Install only @code{foo/sub/file} to
-@code{share/my-app/sub/file}.
-@item @code{("foo/sub" "share/my-app" #:include ("file"))}: Install @code{foo/sub/file} to
-@code{share/my-app/file}.
+@item @code{("foo/bar" "share/my-app/")}: Install @file{bar} to @file{share/my-app/bar}.
+@item @code{("foo/bar" "share/my-app/baz")}: Install @file{bar} to @file{share/my-app/baz}.
+@item @code{("foo/" "share/my-app")}: Install the content of @file{foo} inside @file{share/my-app},
+ e.g., install @file{foo/sub/file} to @file{share/my-app/sub/file}.
+@item @code{("foo/" "share/my-app" #:include ("sub/file"))}: Install only @file{foo/sub/file} to
+@file{share/my-app/sub/file}.
+@item @code{("foo/sub" "share/my-app" #:include ("file"))}: Install @file{foo/sub/file} to
+@file{share/my-app/file}.
@end itemize
@end defvr