1#
2# Copyright 2005 Sun Microsystems, Inc.  All rights reserved.
3# Use is subject to license terms.
4#
5# CDDL HEADER START
6#
7# The contents of this file are subject to the terms of the
8# Common Development and Distribution License, Version 1.0 only
9# (the "License").  You may not use this file except in compliance
10# with the License.
11#
12# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
13# or http://www.opensolaris.org/os/licensing.
14# See the License for the specific language governing permissions
15# and limitations under the License.
16#
17# When distributing Covered Code, include this CDDL HEADER in each
18# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
19# If applicable, add the following below this CDDL HEADER, with the
20# fields enclosed by brackets "[]" replaced with your own identifying
21# information: Portions Copyright [yyyy] [name of copyright owner]
22#
23# CDDL HEADER END
24#
25#ident	"%Z%%M%	%I%	%E% SMI"
26#
27
28=head1 NAME
29
30perlgcc - Compile perl modules using gcc.
31
32=head1 SYNOPSIS
33
34 perlgcc Makefile.PL; make
35
36=head1 DESCRIPTION
37
38When perl is built it saves the name of the compiler and any compiler flags
39in its configuration files, and then uses these saved settings when any
40additional modules are built.  The perl shipped with Solaris is built with the
41Forte compilers rather than gcc.
42
43If add-on modules are built with the Forte compilers, everyting works as
44expected.  However, if gcc is used to build add-on modules, the saved
45configuration is incorrect as it assumes that the Forte compiler will be
46present.
47
48This command provides a set of perl configuration files that are configured to
49use gcc as the compiler rather than the Forte compiler.  The default
50configuration files are not modified, instead a replacement set of files are
51transparently substituted for the duration of the perlgcc command.
52
53Instead of invoking C<perl Makefile.PL> to generate the makefile needed
54to compile a module, C<perlgcc Makefile.PL> should be used instead.
55All command-line arguments to perlgcc are passed unmodified to C<perl>.
56
57If you use the CPAN.pm module, instead of invoking C<perl -MCPAN -e shell>,
58you should use C<perlgcc -MCPAN -e shell> instead, and use as normal.
59
60=head1 ENVIRONMENT VARIABLES
61
62PERL5LIB
63
64This is modified to point to the location of the replacement perl configuration
65files.
66
67=head2 ATTRIBUTES
68
69See C<attributes(5)> for descriptions of the following attributes:
70
71  ___________________________________________________________
72 |       ATTRIBUTE TYPE        |      ATTRIBUTE VALUE        |
73 |_____________________________|_____________________________|
74 | Availability                | CPAN (http://www.cpan.org)  |
75 |_____________________________|_____________________________|
76 | Interface Stability         | Evolving                    |
77 |_____________________________|_____________________________|
78
79=head1 SEE ALSO
80
81C<perl(1)>, C<perlrun(1)>, C<perlsolaris(1)>.
82