'Helpful installation message for display to package users'

def installation_report(self, req, dist, what='Installed'):

    msg = '\n%(what)s    %(eggloc)s%(extras)s'
    if (self.multi_version and (not self.no_report)):
        msg += '\n\nBecause    this    distribution    was    installed    --multi-version,    before    you    can\nimport    modules    from    this    package    in    an    application,    you    will    need    to\n\'import    pkg_resources\'    and    then    use    a    \'require()\'    call    similar    to    one    of\nthese    examples,    in    order    to    select    the    desired    version:\n\n                pkg_resources.require("%(name)s")        #    latest    installed    version\n                pkg_resources.require("%(name)s==%(version)s")        #    this    exact    version\n                pkg_resources.require("%(name)s>=%(version)s")        #    this    version    or    higher\n'
        if (self.install_dir not in map(normalize_path, sys.path)):
            msg += "\n\nNote    also    that    the    installation    directory    must    be    on    sys.path    at    runtime    for\nthis    to    work.        (e.g.    by    being    the    application's    script    directory,    by    being    on\nPYTHONPATH,    or    by    being    added    to    sys.path    by    your    code.)\n"
    eggloc = dist.location
    name = dist.project_name
    version = dist.version
    extras = ''
    return (msg % locals())
