summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorEdward Z. Yang <ezyang@cs.stanford.edu>2014-08-11 18:40:13 +0100
committerEdward Z. Yang <ezyang@cs.stanford.edu>2014-11-18 17:41:08 -0800
commit7c748d9fcf12bd16e0de56187fa6fcf3d6dbf39a (patch)
tree88339e0a7bed26792a66a8903216f75525d5788e /docs
parent1019e3c6f90e32785c6a75726282b7362e921047 (diff)
downloadhaskell-7c748d9fcf12bd16e0de56187fa6fcf3d6dbf39a.tar.gz
Support for "with" renaming syntax, and output a feature flag.
Summary: - Feature flag indicates to Cabal that we support thinning and renaming as it needs. - Support -package "base with (Foo as Bar)" which brings the ordinary modules into scope, as well as adding the renamings to scope. Signed-off-by: Edward Z. Yang <ezyang@cs.stanford.edu> Test Plan: validate Reviewers: simonpj, austin Subscribers: thomie, carter Differential Revision: https://phabricator.haskell.org/D485
Diffstat (limited to 'docs')
-rw-r--r--docs/users_guide/packages.xml15
1 files changed, 8 insertions, 7 deletions
diff --git a/docs/users_guide/packages.xml b/docs/users_guide/packages.xml
index 7a4734d224..15ce719939 100644
--- a/docs/users_guide/packages.xml
+++ b/docs/users_guide/packages.xml
@@ -390,13 +390,14 @@ _ZCMain_main_closure
parenthesized, comma-separated list of module names to import. For example,
<literal>-package "base (Data.List, Data.Bool)"</literal> makes only
<literal>Data.List</literal> and <literal>Data.Bool</literal> visible from
- package <literal>base</literal>.
- We also support renaming of modules, in case you need to refer to both modules
- simultaneously; this is supporting by writing <literal>OldModName as
- NewModName</literal>, e.g. <literal>-package "base (Data.Bool as
- Bool)</literal>. It's important to specify quotes
- so that your shell passes the package name and thinning/renaming list as a
- single argument to GHC.</para>
+ package <literal>base</literal>. We also support renaming of modules, in case
+ you need to refer to both modules simultaneously; this is supporting by
+ writing <literal>OldModName as NewModName</literal>, e.g. <literal>-package
+ "base (Data.Bool as Bool)</literal>. You can also write <literal>-package
+ "base with (Data.Bool as Bool)</literal> to include all of the original
+ bindings (e.g. the renaming is strictly additive). It's important to specify
+ quotes so that your shell passes the package name and thinning/renaming list
+ as a single argument to GHC.</para>
<para>Package imports with thinning/renaming do not hide other versions of the
package: e.g. if containers-0.9 is already exposed, <literal>-package