diff options
| author | Federico Beffa <beffa@fbengineering.ch> | 2015-04-26 11:22:29 +0200 |
|---|---|---|
| committer | Federico Beffa <beffa@fbengineering.ch> | 2015-06-09 09:48:38 +0200 |
| commit | a4154748730b28fd98ff30d968c755c37802a49a (patch) | |
| tree | a2d2375001ab676cf98172aabb139d05762ba45c /doc | |
| parent | 0705f79c6f45108961b901e50f828a978fa0e4e8 (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.texi | 22 |
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. | |||
| 3754 | Specific command-line options are: | 3754 | Specific command-line options are: |
| 3755 | 3755 | ||
| 3756 | @table @code | 3756 | @table @code |
| 3757 | @item --stdin | ||
| 3758 | @itemx -s | ||
| 3759 | Read a Cabal file from the standard input. | ||
| 3757 | @item --no-test-dependencies | 3760 | @item --no-test-dependencies |
| 3758 | @itemx -t | 3761 | @itemx -t |
| 3759 | Do not include dependencies only required to run the test suite. | 3762 | Do 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 | ||
| 3766 | Cabal conditionals are evaluated. The accepted keys are: @code{os}, | ||
| 3767 | @code{arch}, @code{impl} and a string representing the name of a flag. | ||
| 3768 | The value associated with a flag has to be either the symbol | ||
| 3769 | @code{true} or @code{false}. The value associated with other keys | ||
| 3770 | has to conform to the Cabal file format definition. The default value | ||
| 3771 | associated 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 | ||
| 3762 | The command below imports meta-data for the latest version of the | 3775 | The 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 |
| 3777 | specifying the value of the flag @samp{network-uri} as @code{false}: | ||
| 3764 | 3778 | ||
| 3765 | @example | 3779 | @example |
| 3766 | guix import hackage -t HTTP | 3780 | guix import hackage -t -e "'((\"network-uri\" . false))" HTTP |
| 3767 | @end example | 3781 | @end example |
| 3768 | 3782 | ||
| 3769 | A specific package version may optionally be specified by following the | 3783 | A 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 |
| 3773 | guix import hackage mtl-2.1.3.1 | 3787 | guix import hackage mtl-2.1.3.1 |
| 3774 | @end example | 3788 | @end example |
| 3775 | |||
| 3776 | Currently only indentation structured Cabal files are supported. | ||
| 3777 | @end table | 3789 | @end table |
| 3778 | 3790 | ||
| 3779 | The structure of the @command{guix import} code is modular. It would be | 3791 | The structure of the @command{guix import} code is modular. It would be |
