uf_urlstr - Expand URL using heuristics

SYNOPSIS

        use URI::Heuristic qw(uf_urlstr);
        $url = uf_urlstr("perl");             # http://www.perl.com
        $url = uf_urlstr("www.sol.no/sol");   # http://www.sol.no/no
        $url = uf_urlstr("aas");              # http://www.aas.no
        $url = uf_urlstr("ftp.funet.fi");     # ftp://ftp.funet.fi
        $url = uf_urlstr("/etc/passwd");      # file:/etc/passwd

DESCRIPTION

       This module provide functions that expand strings into
       real URLs using some (random) heuristics.  Already
       expanded URLs are not modified and are returned unchanged.

       The following functions are provided:

       uf_urlstr($str)
           The uf_urlstr() function will try to make the string
           passed as argument into a proper absolute URL string.
           The "uf_" prefix stands for "User Friendly".

       uf_url($str)
           This functions work the same way as uf_urlstr() but it
           will return a URI::URL object.

ENVIRONMENT

       If the hostname portion of a URL does not contain any
       dots, then centain qualified guesses will be made.  These
       guesses are governed be the following two environment
       variables.

       COUNTRY   This is the two letter country code (ISO 3166)
                 for your location.  If the domain name of your
                 host ends with two letters, then it is taken to
                 be the default country. See also the
                 Locale::Country manpage.

       URL_GUESS_PATTERN
                 Contain a space separated list of URL patterns
                 to try.  The string "ACME" is used as a
                 placeholder for the host name in the URL
                 provided.  Example:

                  URL_GUESS_PATTERN="www.ACME.no www.ACME.se www.ACME.com"
                  export URL_GUESS_PATTERN

                 Specifying URL_GUESS_PATTERN disables any
                 guessing rules based on country.  An empty
                 URL_GUESS_PATTERN disables any guessing that
                 involves host name lookups.

       Copyright 1997, Gisle Aas

       This library is free software; you can redistribute it
       and/or modify it under the same terms as Perl itself.