[commit: ghc] master: Update documentation to follow 2dc3b476aff28 (48abb88)

[git at git.haskell.org]

Repository : ssh://git@git.haskell.org/ghc

On branch  : master
Link       : http://ghc.haskell.org/trac/ghc/changeset/48abb88b20d1204dfaaf613194ab110fe43f0491/ghc

>---------------------------------------------------------------

commit 48abb88b20d1204dfaaf613194ab110fe43f0491
Author: Edward Z. Yang <ezyang at cs.stanford.edu>
Date:   Thu Jun 19 09:25:59 2014 -0700

    Update documentation to follow 2dc3b476aff28
    
    Signed-off-by: Edward Z. Yang <ezyang at cs.stanford.edu>


>---------------------------------------------------------------

48abb88b20d1204dfaaf613194ab110fe43f0491
 compiler/main/PackageConfig.hs | 15 +++++----------
 1 file changed, 5 insertions(+), 10 deletions(-)

diff --git a/compiler/main/PackageConfig.hs b/compiler/main/PackageConfig.hs
index acedd7e..514a2e0 100644
--- a/compiler/main/PackageConfig.hs
+++ b/compiler/main/PackageConfig.hs
@@ -47,16 +47,11 @@ defaultPackageConfig = emptyInstalledPackageInfo
 
 -- $package_naming
 -- #package_naming#
--- Mostly the compiler deals in terms of 'PackageName's, which don't
--- have the version suffix. This is so that we don't need to know the
--- version for the @-package-name@ flag, or know the versions of
--- wired-in packages like @base@ & @rts at . Versions are confined to the
--- package sub-system.
---
--- This means that in theory you could have multiple base packages installed
--- (for example), and switch between them using @-package@\/@-hide-package at .
---
--- A 'PackageId' is a string of the form @<pkg>-<version>@.
+-- Mostly the compiler deals in terms of 'PackageId's, which have the
+-- form @<pkg>-<version>@. You're expected to pass in the version for
+-- the @-package-name@ flag. However, for wired-in packages like @base@
+-- & @rts@, we don't necessarily know what the version is, so these are
+-- handled specially; see #wired_in_packages#.
 
 -- | Turn a Cabal 'PackageIdentifier' into a GHC 'PackageId'
 mkPackageId :: PackageIdentifier -> PackageId