view release on metacpan or  search on metacpan

etc/INSTALL.html  view on Meta::CPAN

<p>If you get syntax errors on '(', try -DCRIPPLED_CC.
<p>Machines with half-implemented dbm routines will need to #undef I_ODBM
<p>SCO prior to 3.2.4 may be missing <EM>dbmclose()</EM>.  An upgrade to 3.2.4
that includes libdbm.nfs (which includes <EM>dbmclose()</EM>) may be available.
<p>If you get duplicates upon linking for malloc et al, say -DHIDEMYMALLOC.
<p>If you get duplicate function definitions (a perl function has the
same name as another function on your system) try -DEMBED.
<p>If you get varags problems with gcc, be sure that gcc is installed
correctly.  When using gcc, you should probably have i_stdarg='define'
and i_varags='undef' in config.sh.  The problem is usually solved
by running fixincludes correctly.
<p>If you wish to use dynamic loading on SunOS or Solaris, and you
have GNU as and GNU ld installed, you may need to add <STRONG>-B/bin/</STRONG> to
your <STRONG>$ccflags</STRONG> and <STRONG>$ldflags</STRONG> so that the system's versions of as
and ld are used.
<p>If you run into dynamic loading problems, check your setting of
the LD_LIBRARY_PATH environment variable.  Perl should build
fine with LD_LIBRARY_PATH unset, though that may depend on details
of your local set-up.
<p>If Configure seems to be having trouble finding library functions,
try not using nm extraction.  You can do this from the command line
with
<p>
<XMP>
        sh Configure -Uusenm

</XMP>
<p></DD>
</DL>
.
<p><p><hr>

<H1> 
<A NAME="INSTALL_make_2">
make test</A>
</H1>

This will run the regression tests on the perl you just made.  If it
doesn't say "All tests successful" then something went wrong.  See the
file <EM>t/README</EM> in the <EM>t</EM> subdirectory.  Note that you can't run it
in background if this disables opening of /dev/tty.  If 
<A HREF="INSTALL.html#INSTALL_make_2">make test</A>

bombs out, just <STRONG>cd</STRONG> to the <EM>t</EM> directory and run <STRONG>TEST</STRONG> by hand
to see if it makes any difference.
If individual tests bomb, you can run them by hand, e.g.,
<p>
<XMP>
        ./perl op/groups.t

</XMP>
<p><STRONG>NOTE</STRONG>: one possible reason for errors is that some external programs
may be broken due to the combination of your environment and the way

<A HREF="INSTALL.html#INSTALL_make_2">make test</A>
 exercises them. This may happen for example if you have
one or more of these environment variables set:
<CODE>LC_ALL LC_CTYPE LANG</CODE>. In certain UNIXes especially the non-English
locales are known to cause programs to exhibit mysterious errors.
If you have any of the above environment variables set, please try
<CODE>setenv LC_ALL C</CODE> or&lt;LC_ALL=C;export LC_ALL&gt;, for <CODE>csh</CODE>-style and
<CODE>Bourne</CODE>-style shells, respectively, from the command line and then
retry 
<A HREF="INSTALL.html#INSTALL_make_2">make test</A>
. If the tests then succeed, you may have a broken
program that is confusing the testing. Please run the troublesome test
by hand as shown above and see whether you can locate the program.
Look for things like:
<CODE>exec, `backquoted command`, system, open("|...")</CODE> or <CODE>open("...|")</CODE>.
All these mean that Perl is trying to run some external program.
<p><p><hr>

<H1> 
<A NAME="INSTALL_installing_0">
INSTALLING PERL5</A>
</H1>
<p><p><hr>

<H1> 
<A NAME="INSTALL_make_3">
make install</A>
</H1>

This will put perl into the public directory you specified to
<STRONG>Configure</STRONG>; by default this is <EM>/usr/local/bin</EM>.  It will also try
to put the man pages in a reasonable place.  It will not nroff the man
page, however.  You may need to be root to run 
<A HREF="INSTALL.html#INSTALL_make_3">make install</A>
.  If you
are not root, you must own the directories in question and you should
ignore any messages about chown not working.
<p>If you want to see exactly what will happen without installing
anything, you can run
<p>
<XMP>
        ./perl installperl -n
        ./perl installman -n

</XMP>
<p>
<A HREF="INSTALL.html#INSTALL_make_3">make install</A>
 will install the following:
<p>
<XMP>
        perl,
            perl5.nnn   where nnn is the current release number.  This
                        will be a link to perl.
        suidperl,
            sperl5.nnn  If you requested setuid emulation.
        a2p             awk-to-perl translator
        cppstdin        This is used by perl -P, if your cc -E can't
                        read from stdin.
        c2ph, pstruct   Scripts for handling C structures in header files.
        s2p             sed-to-perl translator
        find2perl       find-to-perl translator
        h2xs            Converts C .h header files to Perl extensions.
        perlbug         Tool to report bugs in Perl.
        perldoc         Tool to read perl's pod documentation.
        pod2html,       Converters from perl's pod documentation format
        pod2latex, and  to other useful formats.
        pod2man