[perl5.git] / README.micro

microperl is supposed to be a really minimal perl, even more
minimal than miniperl.  No Configure is needed to build microperl,
on the other hand this means that interfaces between Perl and your
operating system are left very -- minimal.

All this is experimental.  If you don't know what to do with microperl
you probably shouldn't.  Do not report bugs in microperl; fix the bugs.

We assume ANSI C89 plus the following:
- <stdlib.h>
- rename()
- opendir(), readdir(), closedir() (via dirent.h)
- memchr (via string.h)
- (a safe) putenv() (via stdlib.h)
- strtoul() (via stdlib.h)
(grep for 'define' in uconfig.sh.)
Also, Perl times() is defined to always return zeroes.

If you are still reading this and you are itching to try out microperl:

	make -f Makefile.micro

If you make changes to uconfig.sh, run

	make -f Makefile.micro regen_uconfig

to regenerate uconfig.h.
Commit	Line	Data
c94ef9bc	1	microperl is supposed to be a really minimal perl, even more
12ae5dfc JH	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
a83b6f46 JH	7	you probably shouldn't. Do not report bugs in microperl; fix the bugs.
a83b6f46 JH	8
7550e1ad	9	We assume ANSI C89 plus the following:
75a5c1c6 JH	10	- <stdlib.h>
	11	- rename()
	12	- opendir(), readdir(), closedir() (via dirent.h)
	13	- memchr (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
a83b6f46 JH	19	If you are still reading this and you are itching to try out microperl:
	20
	21	make -f Makefile.micro
	22
c94ef9bc	23	If you make changes to uconfig.sh, run
a83b6f46	24
c94ef9bc	25	make -f Makefile.micro regen_uconfig
12ae5dfc	26
c94ef9bc	27	to regenerate uconfig.h.