Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

perl mirror

branch: blead
Cross Configure detection of __attribute__((deprecated))
NetWare Configure detection of __attribute__((deprecated))
Porting Add a new Porting/podtidy to reformat pod using Pod::Tidy
apollo integrate changes#3116,3119 from maint-5.005
beos Re: [perl #32717] BeOS specific Updates
cygwin Cygwin build harmonization, remove cygwin/Makefile.SHs
djgpp Nullch and others were still alive and well in some of the operating
emacs Upgrade to cperl-mode 5.23
epoc Configure detection of __attribute__((deprecated))
ext There shouldn't be a ByteLoader directory in ext, even if all it has …
h2pl perl 4.0 patch 7: patch #4, continued
haiku Haiku Port
hints Subject: Patch for hints/netbsd.sh
lib POD nits from Frank Wiegand <frank.wiegand@gmail.com>
mad MAD dump xml escape regex
mint Atari MiNT port by Guido Flohr <gufl0000@stud.uni-sb.de>
mpeix make PERL_SYS_INIT/INIT3/TERM into functions
os2 PATCH: Large omnibus patch to clean up the JRRT quotes
plan9 Configure detection of __attribute__((deprecated))
pod Remove inconsistent formatting in pod/perlrepository.pod with Porting…
qnx Time::Piece & matherr on qnx4
symbian Configure detection of __attribute__((deprecated))
t f6a8029 needs to be reflected in our switch
utils Subject: [perl #61418] perlthanks isn't documented in perlthanks
uts UTS tweaks for Hal Morris.
vmesa Nullch and others were still alive and well in some of the operating
vms Add the perlperf manpage, by Richard Foley
vos RE: Perl @ 33218 (Stratus VOS patches)
win32 Add the perlperf manpage, by Richard Foley
x2p [admin] set up .gitignore files
.gitignore add some stuff to .gitignore
AUTHORS Add Rainer Tammer and Torsten Schönfeld to AUTHORS.
Artistic [inseparable changes from patch from perl5.003_11 to perl5.003_12]
Changes Update Changes with the last 432 Perforce applied changes, finishing …
Changes5.000 Run unexpand -a on all the Changes files, which were a jumbled mix of
Changes5.001 Run unexpand -a on all the Changes files, which were a jumbled mix of
Changes5.002 Run unexpand -a on all the Changes files, which were a jumbled mix of
Changes5.003 Run unexpand -a on all the Changes files, which were a jumbled mix of
Changes5.004 Run unexpand -a on all the Changes files, which were a jumbled mix of
Changes5.005 Run unexpand -a on all the Changes files, which were a jumbled mix of
Changes5.10 De-encode missed RFC 2047 encoded headers.
Changes5.6 Run unexpand -a on all the Changes files, which were a jumbled mix of
Changes5.8 De-encode missed RFC 2047 encoded headers.
Configure Configure detection of __attribute__((deprecated))
Copying correct FSF address in various places
EXTERN.h Revert bogus change 28763.
INSTALL Note perl5-security-report@perl.org in INSTALL. Must remember to
INTERN.h Revert bogus change 28763.
MANIFEST Add a new Porting/podtidy to reformat pod using Pod::Tidy
META.yml Update Porting/makemeta to generate a META.yml compliant with the 1.4
Makefile.SH AIX patches for Perl 5.8.9 RC2 and gcc on AIX + suidperl on AIX READM…
Makefile.micro Re: [PATCH] various RC1 nits
Policy_sh.SH Regen Configure to use the *html*dir files.
README Update copyright year to 2008.
README.aix Re: 5.8.9 RC2 (was Re: 5.8.9 RC1)
README.amiga README.$OS URLs
README.apollo Podify the remaining README.platform files;
README.beos Re: [perl #32717] BeOS specific Updates
README.bs2000 PerlIO on EBCDIC on BS2000 advice from Thomas Dorner.
README.ce cross-compilation for linux
README.cn Correct Audrey's name in traditional and simplified Chinese (with a lot
README.cygwin /cygdrive is configurable
README.dgux Subject: [perl #16971] [PATCH] Fix a couple of URLs that changed rec…
README.dos README.$OS URLs
README.epoc Spelling correction spotted by Greg McCarroll
README.freebsd Re: FreeBSD 4.6 imminent
README.haiku Haiku Port
README.hpux URL for End-Of-Life and OS/Arch documentation
README.hurd Quotes in pod/*.pod
README.irix IRIX 5.3 is 99.90% okay.
README.jp README.$OS URLs
README.ko PATCH: Add =encoding directive to non-latin READMEs
README.linux Initial, albeit hackish, support for the alpha version of Sun Studio
README.machten Re: [PATCH] Re: Proposal to remove support for MachTen
README.macos pod cleanups.
README.macosx Suppress System V IPC for 64-bit Darwin builds
README.micro microperl plus missing config vars
README.mint Quotes in pod/*.pod
README.mpeix Fix Pod errors.
README.netware README.$OS URLs
README.openbsd Re: [PATCH] reentr.h changes so threaded Perl's compile on OpenBSD 3.7
README.os2 Fixes to Pod errors found by podchecker.
README.os390 Remove the -P switch
README.os400 Integrate change #18391 from maint-5.8:
README.plan9 [PATCH] Doc spellcheck + podcheck
README.qnx for QNX 6.2
README.riscos Addition to README.riscos suggested by Nicholas
README.solaris More readable MEM_WRAP_CHECK_1() macro.
README.symbian Symbian sync
README.tru64 More INSTALL nits. Move Tru64 specific info in the related
README.tw Correct Audrey's name in traditional and simplified Chinese (with a lot
README.uts Add README.uts from Hal Morris.
README.vmesa Quotes in pod/*.pod
README.vms Updates to VMS-specific pod.
README.vos RE: Perl @ 33218 (Stratus VOS patches)
README.win32 Visual C++ 2008 Express Edition is now out: update README.win32
Todo.micro YA resync with mainstem, including VMS patches from others
XSUB.h Assigning to DEFSV leaks if PL_defgv's gp_sv isn't set.
autodoc.pl Subject: PATCH 5.10 documentation
av.c PATCH: Large omnibus patch to clean up the JRRT quotes
av.h Add MUTABLE_AV(), and remove (AV *) casts from headers.
cc_runtime.h Update copyright years.
cflags.SH /bin/sh isn't /usr/bin/perl :-)
config_h.SH Configure detection of __attribute__((deprecated))
configpm Add a few =cuts (so configpm is displayed mostly correctly
configure.com Configure detection of __attribute__((deprecated))
configure.gnu I think once is enough.
cop.h rxres_free() and rxres_restore() are only used in pp_ctl.c, so can be
cv.h Convert all (CV *) casts to (const CV *). Convert (XPVCV*) casts to add
deb.c PATCH: Large omnibus patch to clean up the JRRT quotes
doio.c Fix change 35082 by manually expanding do_open() to Perl_do_openn().
doop.c PATCH: Large omnibus patch to clean up the JRRT quotes
dosish.h Add editor blocks to some header files.
dump.c Add a dump to help tracing taint bugs, by Chip Salzenberg
embed.fnc It looks like the previous patch is working fine on UNIXish boxes,
embed.h Convention seems to be that static definitions are also made visible by
embed.pl PATCH: Large omnibus patch to clean up the JRRT quotes
embedvar.h Rename PL_breakable_sub_generation to PL_breakable_sub_gen, to please
fakesdio.h Add editor blocks to some header files.
fakethr.h Add editor blocks to some header files.
form.h Update copyright notices
generate_uudmap.c Silence Borland compiler warnings (except for warnings from zlib) here:
genpacksizetables.pl Missing static declarations
global.sym It looks like the previous patch is working fine on UNIXish boxes,
globals.c PATCH: Large omnibus patch to clean up the JRRT quotes
globvar.sym PL_bincompat_opt should be exported on AIX and Windows
gv.c Merge S_is_gv_magical() into Perl_is_gv_magical_sv().
gv.h Add a macro MUTABLE_PTR(p), which on (non-pedantic) gcc will not cast
handy.h Subject: PATCH 5.10 documentation
hv.c PATCH: Large omnibus patch to clean up the JRRT quotes
hv.h Add MUTABLE_HV(), and remove (HV *) casts from headers.
install_lib.pl Merge common code from installperl and installman into install_lib.pl
installhtml There's no point in empty TODO sections
installman A couple more installman tidy ups.
installperl installperl patchlet
intrpvar.h The vestigial PL_pad_reset_pending can actually be bool, rather than
iperlsys.h Silence Borland compiler warnings (except for warnings from zlib) here:
keywords.h Remove the 'err' keyword
keywords.pl Drag autodoc.pl and overload.pl into the age of safer_open().
locale.c PATCH: Large omnibus patch to clean up the JRRT quotes
madly.c merge perly.y and madlu.y
makeaperl.SH The problem described in 20010514.031 still wasn't
makedef.pl Re: 5.8.9 RC1 report
makedepend.SH RE: Perl @ 33218 (Stratus VOS patches)
makedir.SH The problem described in 20010514.031 still wasn't
malloc.c PATCH: Large omnibus patch to clean up the JRRT quotes
malloc_ctl.h malloc cleanup
mathoms.c Avoid warnings from exacting C compilers when -DNO_MATHOMS is in force.
mg.c standardize save/restore of errno & vaxc$errno
mg.h Add a macro MUTABLE_PTR(p), which on (non-pedantic) gcc will not cast
minimod.pl ./miniperl minimod.pl ... Can't locate strict.pm
miniperlmain.c PATCH: Large omnibus patch to clean up the JRRT quotes
mkppport Only copy ppport.h to destination if it is different.
mkppport.lst Upgrade to IPC::SysV 1.99_07
mro.c S_mro_get_linear_isa_*() should have an *un*signed level.
myconfig.SH Don't mention redundant usethreads in -V output
mydtrace.h Add dtrace support
nostdio.h Add editor blocks to some header files.
numeric.c PATCH: Large omnibus patch to clean up the JRRT quotes
op.c Note where (nearly) all the other private non-static functions are used.
op.h Replace Perl_my() with a small shell script. er. macro.
opcode.h Ensure that constant folding runs with IN_PERL_RUNTIME true, by copying
opcode.pl Update copyright year in opcode.pl to reflect change 33364.
opnames.h Update copyright year in opcode.pl to reflect change 33364.
overload.c Make PL_AMG_names and PL_AMG_namelens static
overload.h PL_AMG_names is only used by gv.c (as far as Google code search can
overload.pl Make PL_AMG_names and PL_AMG_namelens static
pad.c Just s/Perl_/S_/ isn't good enough - you also need to add the C<static>
pad.h Add MUTABLE_AV(), and remove (AV *) casts from headers.
parser.h Add editor blocks to some header files.
patchlevel.h Bump the version number to 5.11.0
perl.c make perl use git-describe for PATCHNUM
perl.h WCOREDUMP is in <sys/wait.h>
perl_keyword.pl err should be removed from perl_keyword.pl, too
perlapi.c Regenerate API docs
perlapi.h Rename PL_breakable_sub_generation to PL_breakable_sub_gen, to please
perldtrace.d Add dtrace support
perlio.c Silence compiler warning in perlio.c
perlio.h Add editor blocks to some header files.
perlio.sym Adjustment to symbol lists after latest changes (by Jarkko)
perliol.h Silence Borland compiler warnings (except for warnings from zlib) here:
perlsdio.h Update copyright years.
perlsfio.h Add editor blocks to some header files.
perlsh [inseperable changes from patch from perl-5.003_95 to perl-5.003_86]
perlvars.h Following 32238, change "interpreter_size" to "interp_size" in the new
perly.act Add ..., !!!, and ??? operators
perly.c Update copyright years.
perly.h Add ..., !!!, and ??? operators
perly.tab Add ..., !!!, and ??? operators
perly.y PATCH: Large omnibus patch to clean up the JRRT quotes
pod.lst Add the perlperf manpage, by Richard Foley
pp.c Re: [perl #59280] perlbug AutoReply: PUSH on tied array gives incorre…
pp.h Update copyright years.
pp.sym Re: [PATCH] Splitting OP_CONST (Was: pp_const, not, that, hot?)
pp_ctl.c Change PL_debug behaviour so that string eval lines are saved whenever
pp_hot.c [perl #38809] return do { } : take 3 (or 4...)
pp_pack.c PATCH: Large omnibus patch to clean up the JRRT quotes
pp_proto.h Re: [PATCH] Splitting OP_CONST (Was: pp_const, not, that, hot?)
pp_sort.c PATCH: Large omnibus patch to clean up the JRRT quotes
pp_sys.c [perl #60978] [PATCH] Tied filehandles can't distinguish eof forms
proto.h It looks like the previous patch is working fine on UNIXish boxes,
reentr.c assert() that every NN argument is not NULL. Otherwise we have the
reentr.h Integrate:
reentr.pl Drag autodoc.pl and overload.pl into the age of safer_open().
regcharclass.h Change Porting/regcharclass.pl so it doesn't depend on unpack 'U0C*'
regcomp.c create new unicode props as defined in POSIX spec (optionally use the…
regcomp.h create new unicode props as defined in POSIX spec (optionally use the…
regcomp.pl Drag autodoc.pl and overload.pl into the age of safer_open().
regcomp.sym Re: Analysis of problems with mixed encoding case insensitive matches…
regen.pl Move all the logic to print the "Changed" message into regen_lib.pl,
regen_lib.pl Move all the logic to print the "Changed" message into regen_lib.pl,
regen_perly.pl merge the four parser stacks into one
regexec.c Assigning to DEFSV leaks if PL_defgv's gp_sv isn't set.
regexp.h Revert SvPVX() to allow lvalue usage, but also add a
regnodes.h Abolish RXf_UTF8. Store the UTF-8-ness of the pattern with SvUTF8().
run.c PATCH: Large omnibus patch to clean up the JRRT quotes
scope.c Fix for tainting regression in a test of Text::Template spotted by
scope.h Move the implmentation of SAVEHINTS() into a new Perl_save_hints() in
sv.c It looks like the previous patch is working fine on UNIXish boxes,
sv.h It looks like the previous patch is working fine on UNIXish boxes,
taint.c PATCH: Large omnibus patch to clean up the JRRT quotes
thread.h Add MUTABLE_AV(), and remove (AV *) casts from headers.
toke.c ywarn() is actually only used inside toke.c, so it can be static.
uconfig.h Update uconfig.h to add USE_DTRACE back in.
uconfig.sh Configure detection of __attribute__((deprecated))
universal.c PATCH: Large omnibus patch to clean up the JRRT quotes
unixish.h Add editor blocks to some header files.
utf8.c Subject: PATCH 5.10 documentation
utf8.h Add editor blocks to some header files.
utfebcdic.h Add editor blocks to some header files.
util.c Re: [PATCH] standardize save/restore of errno & vaxc$errno
util.h Add editor blocks to some header files.
utils.lst Also install perlbug as perlthanks, to make it easy for people to send
uupacktool.pl Erroneous binmode() call in uupacktool.pl
warnings.h warn if ++ or -- are unable to change the value because it's beyond
warnings.pl Drag autodoc.pl and overload.pl into the age of safer_open().
writemain.SH *static* pointers to newXSUB(), dammit!
xsutils.c PATCH: Large omnibus patch to clean up the JRRT quotes
README
Perl is Copyright (C) 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001,
2002, 2003, 2004, 2005, 2006, 2007, 2008 by Larry Wall and others.
All rights reserved.



ABOUT PERL
==========

Perl is a general-purpose programming language originally developed for
text manipulation and now used for a wide range of tasks including
system administration, web development, network programming, GUI
development, and more.

The language is intended to be practical (easy to use, efficient,
complete) rather than beautiful (tiny, elegant, minimal).  Its major
features are that it's easy to use, supports both procedural and
object-oriented (OO) programming, has powerful built-in support for text
processing, and has one of the world's most impressive collections of
third-party modules.

For an introduction to the language's features, see pod/perlintro.pod.

For a discussion of the important changes in this release, see
pod/perl5100delta.pod.  (This will also be installed as perldelta.pod).

There are also many Perl books available, covering a wide variety of topics,
from various publishers.  See pod/perlbook.pod for more information.


INSTALLATION
============

If you're using a relatively modern operating system and want to
install this version of Perl locally, run the following commands:

  ./Configure -des -Dprefix=$HOME/localperl
  make test
  make install

This will configure and compile perl for your platform, run the regression
tests, and install perl in a subdirectory "localperl" of your home directory.

If you run into any trouble whatsoever or you need to install a customized
version of Perl, you should read the detailed instructions in the "INSTALL"
file that came with this distribution.  Additionally, there are a number of
"README" files with hints and tips about building and using Perl on a wide
variety of platforms, some more common than others.

Once you have Perl installed, a wealth of documentation is available to you
through the 'perldoc' tool.  To get started, run this command:

  perldoc perl


IF YOU RUN INTO TROUBLE
=======================

Perl is a large and complex system that's used for everything from
knitting to rocket science.  If you run into trouble, it's quite
likely that someone else has already solved the problem you're
facing. Once you've exhausted the documentation, please report bugs to us
using the 'perlbug' tool. For more information about perlbug, either type
'perldoc perlbug' or just 'perlbug' on a line by itself.

While it was current when we made it available, Perl is constantly evolving
and there may be a more recent version that fixes bugs you've run into or
adds new features that you might find useful.

You can always find the latest version of perl on a CPAN (Comprehensive Perl
Archive Network) site near you at http://www.cpan.org/src/


Just a personal note:  I want you to know that I create nice things like this
because it pleases the Author of my story.  If this bothers you, then your
notion of Authorship needs some revision.  But you can use perl anyway. :-)

							The author.


LICENSING
=========

This program is free software; you can redistribute it and/or modify
it under the terms of either:

	a) the GNU General Public License as published by the Free
	Software Foundation; either version 1, or (at your option) any
	later version, or

	b) the "Artistic License" which comes with this Kit.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See either
the GNU General Public License or the Artistic License for more details.

You should have received a copy of the Artistic License with this
Kit, in the file named "Artistic".  If not, I'll be glad to provide one.

You should also have received a copy of the GNU General Public License
along with this program in the file named "Copying". If not, write to the
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, 
Boston, MA 02110-1301, USA or visit their web page on the internet at
http://www.gnu.org/copyleft/gpl.html.

For those of you that choose to use the GNU General Public License,
my interpretation of the GNU General Public License is that no Perl
script falls under the terms of the GPL unless you explicitly put
said script under the terms of the GPL yourself.  Furthermore, any
object code linked with perl does not automatically fall under the
terms of the GPL, provided such object code only adds definitions
of subroutines and variables, and does not otherwise impair the
resulting interpreter from executing any standard Perl script.  I
consider linking in C subroutines in this manner to be the moral
equivalent of defining subroutines in the Perl language itself.  You
may sell such an object file as proprietary provided that you provide
or offer to provide the Perl source, as specified by the GNU General
Public License.  (This is merely an alternate way of specifying input
to the program.)  You may also sell a binary produced by the dumping of
a running Perl script that belongs to you, provided that you provide or
offer to provide the Perl source as specified by the GPL.  (The
fact that a Perl interpreter and your code are in the same binary file
is, in this case, a form of mere aggregation.)  This is my interpretation
of the GPL.  If you still have concerns or difficulties understanding
my intent, feel free to contact me.  Of course, the Artistic License
spells all this out for your protection, so you may prefer to use that.


Something went wrong with that request. Please try again.