From b8638f03471a0c45f441caef1acf2dad7c457661 Mon Sep 17 00:00:00 2001 From: Ludovic Courtès Date: Sun, 31 Jan 2016 21:33:08 +0100 Subject: guix package: Support package transformation options. * guix/scripts/package.scm (show-help): Call 'show-transformation-options-help'. (%options): Append %TRANSFORMATION-OPTIONS. (process-actions)[transform, transform-entry]: New procedures. * doc/guix.texi (Invoking guix package): Mention package transformations. (Package Transformation Options): Mention 'guix package'. --- doc/guix.texi | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) (limited to 'doc') diff --git a/doc/guix.texi b/doc/guix.texi index 10ca9b76ad..dcced797f7 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -1643,7 +1643,13 @@ Consequently, this command must be used with care. Finally, since @command{guix package} may actually start build processes, it supports all the common build options (@pxref{Common Build -Options}). +Options}). It also support package transformation options, such as +@option{--with-source} (@pxref{Package Transformation Options}). +However, note that package transformations are lost when upgrading; to +preserve transformation across upgrades, you should define your own +package variant in a Guile module and add it to @code{GUIX_PACKAGE_PATH} +(@pxref{Defining Packages}). + @node Substitutes @section Substitutes @@ -3946,11 +3952,12 @@ the parsed command-line options. @cindex package variants Another set of command-line options supported by @command{guix build} -are @dfn{package transformation options}. These are options that allow, -from the command-line, to define @dfn{package variants}---for instance, -packages built from different source code. This is a convenient way to -create customized packages on the fly without having to type in the -definitions of package variants (@pxref{Defining Packages}). +and also @command{guix package} are @dfn{package transformation +options}. These are options that allow you to define @dfn{package +variants}---for instance, packages built from different source code. +This is a convenient way to create customized packages on the fly +without having to type in the definitions of package variants +(@pxref{Defining Packages}). @table @code -- cgit v1.2.3