This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Bump version of threads.pm
[perl5.git] / README.micro
1 microperl is supposed to be a really minimal perl, even more
2 minimal than miniperl.  No Configure is needed to build microperl,
3 on the other hand this means that interfaces between Perl and your
4 operating system are left very -- minimal.
5
6 All this is experimental.  If you don't know what to do with microperl
7 you probably shouldn't.  Do not report bugs in microperl; fix the bugs.
8
9 We assume ANSI C89 plus the following:
10 - <stdlib.h>
11 - rename()
12 - opendir(), readdir(), closedir() (via dirent.h)
13 - memchr(), memcmp(), memcpy() (via string.h)
14 - (a safe) putenv() (via stdlib.h)
15 - strtoul() (via stdlib.h)
16 (grep for 'define' in uconfig.sh.)
17 Also, Perl times() is defined to always return zeroes.
18
19 If you are still reading this and you are itching to try out microperl:
20
21         make -f Makefile.micro
22
23 If you make changes to uconfig.sh, run
24
25         make -f Makefile.micro regen_uconfig
26
27 to regenerate uconfig.h.  If your compilation platform is not 32-bit
28 little-endian (like x86), you might want to try
29
30         make -f Makefile.micro patch_uconfig
31
32 *before* the "make -f Makefile.micro".  This tries to minimally patch
33 the uconfig.sh using your *current* Perl so that your microperl has
34 the correct basic types and sizes and byteorder.
35