THIS IS A TEST INSTANCE ONLY! REPOSITORIES CAN BE DELETED AT ANY TIME!

You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Max Maischein e6769f93f4 Try to find the appropriate SHAs 2 days ago
.github Try to find the appropriate SHAs 2 hours ago
Cross Bump the perl version in various places for 5.31.7 20 hours ago
NetWare Bump the perl version in various places for 5.31.7 20 hours ago
Porting Bump the perl version in various places for 5.31.7 20 hours ago
amigaos4 make exec keep its argument list more reliably 1 year ago
cpan Update Test-Simple to CPAN version 1.302169 2 days ago
cygwin Change bug URL from http://rt.perl.org to https://rt.perl.org 1 month ago
dist Update Module::CoreList for 5.31.7 20 hours ago
djgpp make exec keep its argument list more reliably 1 year ago
ext fix POSIX.xs under VMS 2 days ago
h2pl Switch most open() calls to three-argument form. 2 years ago
haiku Remove "register" declarations 7 years ago
hints Bump the perl version in various places for 5.31.7 20 hours ago
lib Bump the perl version in various places for 5.31.7 20 hours ago
os2 Use sv_catpvs where appropriate vs sv_catpv 1 year ago
plan9 Bump the perl version in various places for 5.31.7 20 hours ago
pod new perldelta for v5.31.7 20 hours ago
qnx Fix typos (spelling errors) in qnx/*. 9 years ago
regen regcharclass.h: Add some macros 5 days ago
symbian Improve setlocale() detection in Configure-ish files 8 months ago
t Try to find the appropriate SHAs 2 hours ago
utils Update IO-Compress to CPAN version 2.089 2 weeks ago
vms new perldelta for v5.31.7 20 hours ago
vos Build perl using the dynamic linking capabilities of OpenVOS Release 17.1. Remove private copies of some POSIX functions that are now implemented by OpenVOS. 8 years ago
win32 Bump the perl version in various places for 5.31.7 20 hours ago
.dir-locals.el Fix Emacs dir-local variables 4 years ago
.git_patch add git commit info into archive exports to allow building outside git 4 weeks ago
.gitattributes add git commit info into archive exports to allow building outside git 4 weeks ago
.gitignore Remove lib/unicore/Heavy.pl 2 weeks ago
.lgtm.yml lgtm.yml: fix erroneous inclusion 1 year ago
.metaconf-exclusions.txt Rely on C89 "const" 11 months ago
.travis.yml Remove compiler in .travis.yml 2 weeks ago
AUTHORS AUTHORS: Ichinose Shogo was in wrong-way-round 4 weeks ago
Artistic fix typo in Artistic 1 year ago
Changes Update documentation, comments, metadata to reference GitHub as canonical repository (#1186) 1 month ago
Configure Adapt Configure to GCC version 10 1 week ago
Copying Update F<Copying> with the FSF's new address. 8 years ago
EXTERN.h The Windows CE Chainsaw Massacre 5 months ago
INSTALL Bump the perl version in various places for 5.31.7 20 hours ago
INTERN.h remove all exported symbols from GCC win32 miniperl 1 year ago
MANIFEST new perldelta for v5.31.7 20 hours ago
META.json Bump the perl version in various places for 5.31.7 20 hours ago
META.yml Bump the perl version in various places for 5.31.7 20 hours ago
Makefile.SH new perldelta for v5.31.7 20 hours ago
Makefile.micro Don't attempt to define or use STANDARD_C 2 years ago
PACKAGING Time::HiRes disable a flapping test for CI 2 years ago
Policy_sh.SH add shebangs where missing 7 years ago
README Update URLs to be https:// 3 weeks ago
README.aix fix typos 1 year ago
README.amiga amigaos4: better kill() implementation 4 years ago
README.android Mention Termux in README.android 3 weeks ago
README.bs2000 Update p5p list archive links 1 month ago
README.cn README.cn: Fix pod errors 2 months ago
README.cygwin Update the installation URL for Cygwin 1 month ago
README.dos README.$OS URLs 12 years ago
README.freebsd pods: Add L<> for links missing them; a couple nits 2 years ago
README.haiku Bump the perl version in various places for 5.31.7 20 hours ago
README.hpux PA-RISC is obsolted 1 year ago
README.hurd Move more URLs from http:// to https:// 1 month ago
README.irix Fix various pod errors. 3 years ago
README.jp update perljp 4 weeks ago
README.ko Revise URLs in README.ko 2 months ago
README.linux README.foo: Change NAME to perlfoo 8 years ago
README.macos README.foo: Change NAME to perlfoo 8 years ago
README.macosx Bump the perl version in various places for 5.31.7 20 hours ago
README.micro Make the request to fix rather than report bugs in microperl politer. 8 years ago
README.netware Fix various pod errors. 3 years ago
README.openbsd README.foo: Change NAME to perlfoo 8 years ago
README.os2 Bump the perl version in various places for 5.31.7 20 hours ago
README.os390 Bump the perl version in various places for 5.31.7 20 hours ago
README.os400 Add note to EBCDIC README's, asking for input 4 years ago
README.plan9 [PATCH] Doc spellcheck + podcheck 18 years ago
README.qnx README.qnx: Make verbatim line fit in 79 columns 5 years ago
README.riscos README.foo: Change NAME to perlfoo 8 years ago
README.solaris fix typos 1 year ago
README.symbian Actually make I18N::Langinfo avail on all platforms 1 year ago
README.synology More documentation links http -> https 1 month ago
README.tru64 Fix various pod errors. 3 years ago
README.tw Replace a few http urls with https 2 months ago
README.vms Bump the perl version in various places for 5.31.7 20 hours ago
README.vos Update README.vos to reflect recent changes 6 years ago
README.win32 The VC6 Chainsaw Massacre 1 month ago
SECURITY.md Add GitHub security template 1 month ago
TestInit.pm Mailling list archaeology, restoring old content 1 month ago
XSUB.h perlapi: Document XST_mUV 2 months ago
asan_ignore asan_ignore: Explicitly list ignored behavior fcns 6 months ago
autodoc.pl autodoc.pl: Special case macros whose name begins with Perl_ 2 months ago
av.c Add some defensive coding to av_store() 4 months ago
av.h Note that AvFILLp is not for public use 2 months ago
caretx.c RT#133573: $^X fallback when platform-specific technique fails 1 year ago
cflags.SH Adapt Configure to GCC version 10 1 week ago
charclass_invlists.h Remove generation and use of NonFinalFold table 5 days ago
config_h.SH Fix erroneous references to USE_CBACKTRACE 4 months ago
configpm Update documentation, comments, metadata to reference GitHub as canonical repository (#1186) 1 month ago
configure.com Make -Duse64bitint the default on VMS. 5 months ago
configure.gnu Remove "dead" RCS $Id$ tags from files that we own. 9 years ago
cop.h Faster feature checks 3 weeks ago
cv.h Add embed.fnc entries for Cv inline fcns 2 months ago
deb.c Change white space to avoid C++ deprecation warning 3 years ago
doio.c (perl #134221) support append mode for open .. undef 4 months ago
doop.c Clean up -Dy debugging 2 days ago
dosish.h The Windows CE Chainsaw Massacre 5 months ago
dquote.c PATCH: [perl #133937] Assertion failure 8 months ago
dquote_inline.h Use new paradigm for hdr file double inclusion guard 2 years ago
dump.c Reimplement tr/// without swashes 2 weeks ago
ebcdic_tables.h regen/ebcdic.pl: Allow for declaring table size. 1 week ago
embed.fnc regcomp.c: Add invlist_lowest() and use it 21 hours ago
embed.h regcomp.c: Add invlist_lowest() and use it 21 hours ago
embedvar.h add explicit 1-arg and 3-arg sig handler functions 3 days ago
fakesdio.h fakesdio.h: Typo 1 year ago
feature.h remove now unneeded FEATURE_IS_ENABLED() 3 weeks ago
form.h better document format code 8 years ago
generate_uudmap.c generate_uudmap.c: Clarify comment 5 years ago
globals.c regcomp.c: don't include INTERN.h 9 months ago
globvar.sym foo_cloexec() under PERL_GLOBAL_STRUCT_PRIVATE 9 months ago
gv.c gv.c: SVf needs to be surrounded by spaces 2 weeks ago
gv.h reduce cost of SvVALID() 3 years ago
handy.h handy.h: Change references to swashes 2 weeks ago
hv.c Fix: local variable hiding parameter of same name 1 week ago
hv.h Change pod for macros that require "literal strings" 2 months ago
hv_func.h fix the name shown in PERL_HASH_SEED_DEBUG for stadtx 7 months ago
hv_macro.h add defensive parens 2 weeks ago
inline.h The VC6 Chainsaw Massacre 1 month ago
install_lib.pl amigaos4: install scripts 4 years ago
installhtml clean up directories of split pod files 1 year ago
installman fix spelling 2 years ago
installperl (perl #127606) adjust dependency paths on installation on darwin 1 year ago
intrpvar.h add explicit 1-arg and 3-arg sig handler functions 3 days ago
invlist_inline.h Reimplement tr/// without swashes 2 weeks ago
iperlsys.h add explicit 1-arg and 3-arg sig handler functions 3 days ago
keywords.c revert smartmatch to 5.27.6 behaviour 1 year ago
keywords.h revert smartmatch to 5.27.6 behaviour 1 year ago
l1_char_class_tab.h l1_char_class_tab.h: Remove some special EBCDIC cases 1 month ago
locale.c (perl #133981) fix my stupid mistake 2 months ago
make_ext.pl Make sure 'if' compiled before Pod::Simple 5 months ago
make_patchnum.pl add git commit info into archive exports to allow building outside git 4 weeks ago
makedef.pl The VC6 Chainsaw Massacre 1 month ago
makedepend.SH makedepend.SH: omit trailing "." in progress messages 2 years ago
malloc.c malloc.c: Use isDIGIT macro instead of hand-rolling it 1 week ago
malloc_ctl.h Use new paradigm for hdr file double inclusion guard 2 years ago
mathoms.c mathoms.c,utf8.c: Update to use UTF8_CHK_SKIP 2 weeks ago
metaconfig.SH Remove some remnants of x2p, which was removed by commit e5a8a0fbd7 4 years ago
metaconfig.h Improve setlocale() detection in Configure-ish files 8 months ago
mg.c Perl_csighandler(): remove forward declaration 3 days ago
mg.h Replace common Emacs file-local variables with dir-locals 4 years ago
mg_names.inc ‘Nonelems’ for pushing sparse array on the stack 1 year ago
mg_raw.h ‘Nonelems’ for pushing sparse array on the stack 1 year ago
mg_vtable.h ‘Nonelems’ for pushing sparse array on the stack 1 year ago
miniperlmain.c get MakeMaker to play under PERL_GLOBAL_STRUCT 9 months ago
mkppport mv Devel-PPPort from cpan to dist 2 years ago
mkppport.lst remove distros from needing ppport.h in core 1 year ago
mro_core.c Fix: local variable hiding parameter of same name 1 week ago
myconfig.SH Add "default_inc_excludes_dot" to "perl -V" output 2 years ago
mydtrace.h rename and function-ise dtrace macros 3 years ago
nostdio.h Replace common Emacs file-local variables with dir-locals 4 years ago
numeric.c handle s being updated without len being updated 1 week ago
op.c Clean up -Dy debugging 2 days ago
op.h Reimplement tr/// without swashes 2 weeks ago
op_reg_common.h silence some gcc -pendantic warnings 4 years ago
opcode.h Change names of some OPpTRANS flags 2 weeks ago
opnames.h revert smartmatch to 5.27.6 behaviour 1 year ago
overload.h Add overload types for string-specifc bitops 4 years ago
overload.inc overload.c -> overload.inc 4 years ago
packsizetables.inc packsizetables.c -> packsizetables.inc 4 years ago
pad.c Fully spell out "subroutine" and "variable" 1 month ago
pad.h Change pod for macros that require "literal strings" 2 months ago
parser.h Signatures: change param count from IV to UV 1 month ago
patchlevel.h Bump the perl version in various places for 5.31.7 20 hours ago
perl.c add explicit 1-arg and 3-arg sig handler functions 3 days ago
perl.h declare perl core's sig handler as 1-arg 3 days ago
perl_inc_macro.h Fix Windows build failure introduced by 7d00a3405c 2 years ago
perl_langinfo.h perl_langinfo.h: Fix typo in comment 1 year ago
perlapi.c Simplify embedvar.h, removing a level of macro indirection for PL_* variables. 8 years ago
perlapi.h add explicit 1-arg and 3-arg sig handler functions 3 days ago
perldtrace.d Replace common Emacs file-local variables with dir-locals 4 years ago
perlio.c (perl #134221) support O_APPEND for open ..., undef on VMS 4 months ago
perlio.h (perl #134221) support append mode for open .. undef 4 months ago
perlio.sym Purge remaining references to PerlIO_sprintf and PerlIO_vsprintf(). 6 years ago
perliol.h Use new paradigm for hdr file double inclusion guard 2 years ago
perlsdio.h Evict PERLIO_IS_STDIO from top-level core files. 4 years ago
perlvars.h add explicit 1-arg and 3-arg sig handler functions 3 days ago
perly.act put signature ops in their own subtree. 1 month ago
perly.c perly.c: Fix typo in comment 6 months ago
perly.h put signature ops in their own subtree. 1 month ago
perly.tab put signature ops in their own subtree. 1 month ago
perly.y put signature ops in their own subtree. 1 month ago
pp.c remove CONSERVATIVE and LIBERAL 3 weeks ago
pp.h inline.h: Change fcn name prefix from S_ to Perl_ 2 months ago
pp_ctl.c clean up quadmath_format_*() functions 4 days ago
pp_hot.c Create fcn for lossless conversion of NV to IV 6 months ago
pp_pack.c pp_pack.c: Use safe UTF8SKIP 8 months ago
pp_proto.h revert smartmatch to 5.27.6 behaviour 1 year ago
pp_sort.c perlapi: sortsv_flags is an SV function 3 months ago
pp_sys.c (perl #134291) propagate non-PVs in $@ in bare die() 4 months ago
proto.h regcomp.c: Add invlist_lowest() and use it 21 hours ago
reentr.c regen/reentr.pl: simplify cpp conditionals 2 years ago
reentr.h Add PERL_REENTRANT for XS modules 1 year ago
regcharclass.h Remove generation and use of NonFinalFold table 5 days ago
regcomp.c regcomp.c: Add invlist_lowest() and use it 21 hours ago
regcomp.h Add ANYOFHs regnode 22 hours ago
regcomp.sym Add ANYOFHs regnode 22 hours ago
regen.pl Patch unit tests to explicitly insert "." into @INC when needed. 3 years ago
regen_perly.pl Support Bison version 3.1 through 3.4 4 months ago
regexec.c Add ANYOFHs regnode 22 hours ago
regexp.h inline.h: Change fcn name prefix from S_ to Perl_ 2 months ago
regnodes.h Add ANYOFHs regnode 22 hours ago
run.c rename and function-ise dtrace macros 3 years ago
runtests.SH avoid 'jobserver unavailable:' warnings 5 years ago
sbox32_hash.h actually fix "implicit fallthrough" warnings in gcc 7 2 years ago
scope.c Faster feature checks 3 weeks ago
scope.h Change pod for macros that require "literal strings" 2 months ago
stadtx_hash.h Clean up U8TO*_LE macro implementations 1 month ago
sv.c add explicit 1-arg and 3-arg sig handler functions 3 days ago
sv.h Double the number of possible SV types 5 days ago
taint.c Add some comments around tainting 6 months ago
thread.h thread.h: simplify cpp conditionals 2 years ago
time64.c A few small tweaks in time64.c 3 years ago
time64.h Use new paradigm for hdr file double inclusion guard 2 years ago
time64_config.h Use new paradigm for hdr file double inclusion guard 2 years ago
toke.c Fix: local variable hiding parameter of same name 1 week ago
uconfig.h Fix erroneous references to USE_CBACKTRACE 4 months ago
uconfig.sh Bump the perl version in various places for 5.31.0 6 months ago
uconfig64.sh Bump the perl version in various places for 5.31.0 6 months ago
uni_keywords.h Remove generation and use of NonFinalFold table 5 days ago
unicode_constants.h Fix apidoc macro entries 4 months ago
universal.c Factor out common code from sv_derived_from_* subs family 2 weeks ago
unixish.h Add mutex for dealing with qr/\p{user-defined}/ 9 months ago
utf8.c Fix: local variable hiding parameter of same name 1 week ago
utf8.h utf8.h: Use MAX() macro instead of its expansion 6 days ago
utfebcdic.h utfebcdic.h: Add comments 1 week ago
util.c remove some redundant sig handler type casts 3 days ago
util.h The VC6 Chainsaw Massacre 1 month ago
utils.lst Update IO-Compress to CPAN version 2.089 2 weeks ago
vutil.c ensure locale_name_on_entry isn't clobbered 4 weeks ago
vutil.h Synch cpan/version/* and other files with CPAN version 0.9921. 1 year ago
vxs.inc Synch cpan/version/* and other files with CPAN version 0.9921. 1 year ago
warnings.h Note that the warnings categories are documented 2 months ago
write_buildcustomize.pl Fix builds after EUMM update 5 months ago
zaphod32_hash.h Clean up U8TO*_LE macro implementations 1 month ago

README

Perl is Copyright (C) 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012,
2013, 2014, 2015, 2016, 2017, 2018, 2019 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/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 https://www.cpan.org/src/

If you want to submit a simple patch to the perl source, see the "SUPER
QUICK PATCH GUIDE" in pod/perlhack.pod.

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
https://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.