summaryrefslogtreecommitdiff
path: root/README.micro
diff options
context:
space:
mode:
authorNicholas Clark <nick@ccl4.org>2011-03-26 21:22:55 +0000
committerNicholas Clark <nick@ccl4.org>2011-03-28 10:21:48 +0100
commitc13bf28c5e59a95be2cd4bec3c8e48c16f0199f7 (patch)
tree60240bb2b4cae628adf147975afd3b07b270d3b8 /README.micro
parentab3ee5ad1f0702fbf85684d763bfd4b074269ec6 (diff)
downloadperl-c13bf28c5e59a95be2cd4bec3c8e48c16f0199f7.tar.gz
For microperl, add uconfig64.sh, with values suitable for an LP64 platform.
Add instructions on how to use it to README.micro. There's rather too much size-specific in perl's configuration to make it viable to have a single uconfig.sh that will work "properly" on both LP32 and LP64 platforms. It seems best to ship the default as LP32 (which is correct for Win32 (although I don't know if microperl yet builds on Win32)), and provide just a config.sh file for LP64, as most (all?) 64 bit *nix platforms are LP64, and can run the shell commands to generate a uconfig.h from it. (Win64 is LLP64, so uconfig64.sh isn't going to be right for it, so the inability of Win64 to generate uconfig.h from uconfig64.sh isn't a problem)
Diffstat (limited to 'README.micro')
-rw-r--r--README.micro17
1 files changed, 14 insertions, 3 deletions
diff --git a/README.micro b/README.micro
index 412b95287b..c6597323c1 100644
--- a/README.micro
+++ b/README.micro
@@ -20,16 +20,27 @@ If you are still reading this and you are itching to try out microperl:
make -f Makefile.micro
+The defaults assume a little endian LP32 platform - ie long and pointers are
+32 bits, so sizeof(long) and sizeof(void *) are 4
+If your platform is little endian LP64 - ie long and pointers are 64 bits,
+sizeof(long) and sizeof(void *) are 8, then you first need to run
+
+ make -f Makefile.micro regen_uconfig64
+
+to generate a suitable uconfig.h
+
If you make changes to uconfig.sh, run
make -f Makefile.micro regen_uconfig
-to regenerate uconfig.h. If your compilation platform is not 32-bit
-little-endian (like x86), you might want to try
+to regenerate uconfig.h. (or regen_uconfig64 if you're editing uconfig64.sh)
+
+
+If neither of the above default configs work on your platform, you might want
+to try
make -f Makefile.micro patch_uconfig
*before* the "make -f Makefile.micro". This tries to minimally patch
the uconfig.sh using your *current* Perl so that your microperl has
the correct basic types and sizes and byteorder.
-