summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorFederico Beffa <beffa@fbengineering.ch>2015-04-26 11:22:29 +0200
committerFederico Beffa <beffa@fbengineering.ch>2015-06-09 09:48:38 +0200
commita4154748730b28fd98ff30d968c755c37802a49a (patch)
treea2d2375001ab676cf98172aabb139d05762ba45c /doc
parent0705f79c6f45108961b901e50f828a978fa0e4e8 (diff)
import: hackage: Refactor parsing code and add new options.
* guix/import/cabal.scm: New file. * guix/import/hackage.scm: Update to use the new Cabal parsing module. * tests/hackage.scm: Update tests. * guix/scripts/import/hackage.scm: Add new '--cabal-environment' and '--stdin' options. * doc/guix.texi: ... and document them. * Makefile.am (MODULES): Add 'guix/import/cabal.scm', 'guix/import/hackage.scm' and 'guix/scripts/import/hackage.scm'. (SCM_TESTS): Add 'tests/hackage.scm'.
Diffstat (limited to 'doc')
-rw-r--r--doc/guix.texi22
1 files changed, 17 insertions, 5 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index c62e44e341d..be7a292f084 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -3754,16 +3754,30 @@ dependencies.
3754Specific command-line options are: 3754Specific command-line options are:
3755 3755
3756@table @code 3756@table @code
3757@item --stdin
3758@itemx -s
3759Read a Cabal file from the standard input.
3757@item --no-test-dependencies 3760@item --no-test-dependencies
3758@itemx -t 3761@itemx -t
3759Do not include dependencies only required to run the test suite. 3762Do not include dependencies required by the test suites only.
3763@item --cabal-environment=@var{alist}
3764@itemx -e @var{alist}
3765@var{alist} is a Scheme alist defining the environment in which the
3766Cabal conditionals are evaluated. The accepted keys are: @code{os},
3767@code{arch}, @code{impl} and a string representing the name of a flag.
3768The value associated with a flag has to be either the symbol
3769@code{true} or @code{false}. The value associated with other keys
3770has to conform to the Cabal file format definition. The default value
3771associated with the keys @code{os}, @code{arch} and @code{impl} is
3772@samp{linux}, @samp{x86_64} and @samp{ghc} respectively.
3760@end table 3773@end table
3761 3774
3762The command below imports meta-data for the latest version of the 3775The command below imports meta-data for the latest version of the
3763@code{HTTP} Haskell package without including test dependencies: 3776@code{HTTP} Haskell package without including test dependencies and
3777specifying the value of the flag @samp{network-uri} as @code{false}:
3764 3778
3765@example 3779@example
3766guix import hackage -t HTTP 3780guix import hackage -t -e "'((\"network-uri\" . false))" HTTP
3767@end example 3781@end example
3768 3782
3769A specific package version may optionally be specified by following the 3783A specific package version may optionally be specified by following the
@@ -3772,8 +3786,6 @@ package name by a hyphen and a version number as in the following example:
3772@example 3786@example
3773guix import hackage mtl-2.1.3.1 3787guix import hackage mtl-2.1.3.1
3774@end example 3788@end example
3775
3776Currently only indentation structured Cabal files are supported.
3777@end table 3789@end table
3778 3790
3779The structure of the @command{guix import} code is modular. It would be 3791The structure of the @command{guix import} code is modular. It would be