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 
  30 perlgcc - Compile perl modules using gcc.
  31 
  32 =head1 SYNOPSIS
  33 
  34  perlgcc Makefile.PL; make
  35 
  36 =head1 DESCRIPTION
  37 
  38 When perl is built it saves the name of the compiler and any compiler flags
  39 in its configuration files, and then uses these saved settings when any
  40 additional modules are built.  The perl shipped with Solaris is built with the
  41 Forte compilers rather than gcc.
  42 
  43 If add-on modules are built with the Forte compilers, everyting works as
  44 expected.  However, if gcc is used to build add-on modules, the saved
  45 configuration is incorrect as it assumes that the Forte compiler will be
  46 present.
  47 
  48 This command provides a set of perl configuration files that are configured to
  49 use gcc as the compiler rather than the Forte compiler.  The default
  50 configuration files are not modified, instead a replacement set of files are
  51 transparently substituted for the duration of the perlgcc command.
  52 
  53 Instead of invoking C<perl Makefile.PL> to generate the makefile needed
  54 to compile a module, C<perlgcc Makefile.PL> should be used instead.
  55 All command-line arguments to perlgcc are passed unmodified to C<perl>.
  56 
  57 If you use the CPAN.pm module, instead of invoking C<perl -MCPAN -e shell>,
  58 you should use C<perlgcc -MCPAN -e shell> instead, and use as normal.
  59 
  60 =head1 ENVIRONMENT VARIABLES
  61 
  62 PERL5LIB
  63 
  64 This is modified to point to the location of the replacement perl configuration
  65 files.
  66 
  67 =head2 ATTRIBUTES
  68 
  69 See 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 
  81 C<perl(1)>, C<perlrun(1)>, C<perlsolaris(1)>.