Permalink
Browse files

Add an example of platform ID

Add an example of make clean
"make r3" can be used
Rename REBOL to Rebol
  • Loading branch information...
1 parent fc51038 commit 692eba311237099e9dee9f9f6f03cb453777672d @ladislav ladislav committed Aug 12, 2013
Showing with 16 additions and 12 deletions.
  1. +16 −12 README
View
@@ -1,4 +1,4 @@
-REBOL [R3] Source Code Distribution
+Rebol [R3] Source Code Distribution
Date: 12-Dec-2012
Version: 2.101.0
From: Carl Sassenrath
@@ -16,36 +16,40 @@ tough to create one yourself. You will need to set struct align to 4 bytes.
About the Makefile:
You might notice that the makefile is a bit old-fashioned. That's because I
-still support REBOL on some very old systems that don't offer newer makefile
+still support Rebol on some very old systems that don't offer newer makefile
features. So, please keep that in mind and stick with this simple format.
-Also, the makefile is built by REBOL. Typing "make make" will rebuild it,
-and you can also select a different platform target the same way by providing
-the REBOL platform identifiers (the last two parts of the version string).
+Also, the makefile is built by Rebol. Typing "make make" will rebuild it,
+and you can also select a different platform target by providing
+the Rebol platform identifier typing e.g. "make make OS_ID=0.4.4" (Linux
+Libc6 2.11 platform version).
Build Instructions:
-Parts of REBOL are built by REBOL. So, to build it, you'll need to download a
+Parts of Rebol are built by Rebol. So, to build it, you'll need to download a
running binary into the local make directory. Call it r3-make.
The build happens in the make directory. It will create an obj sub-dir for
storing the object files. I prefer this over mixing the source and object
files into the same directory.
-The biggest step is to do the "make prep" which will use REBOL to configure
+You may need to do "make clean" for clean make session.
+
+The biggest step is to do the "make prep" which will use Rebol to configure
and build a number of important C header files.
-If you are building for a new platform that has no existing REBOL, you can use
+If you are building for a new platform that has no existing Rebol, you can use
"make prep" to build all the files you need on an existing platform and copy
them to the new platform.
-After the prep, just run "make" and the rest of the system will build.
+After the prep, just run "make" or "make r3" and the rest of the system will
+build.
Toolchain Note:
-REBOL builds on many different compilers over a range of systems. Although
+Rebol builds on many different compilers over a range of systems. Although
the C source doesn't strictly follow any one standard, it's quite portable
and I've yet to find a toolchain that won't build it. You can even cross
compile it for embedded systems quite easily. If you run into a problem,
@@ -54,7 +58,7 @@ it's probably something fairly simple. Don't over complicate it.
Note to Contributors:
-I welcome your help with porting REBOL to many more devices and making various
+I welcome your help with porting Rebol to many more devices and making various
improvements. I just ask that you:
1. Keep code clear and simple.
@@ -63,7 +67,7 @@ improvements. I just ask that you:
4. Keep in mind Linux, OS X, BSD, big/little endian CPUs.
5. Test everything, then test it again.
-Enjoy your new REBOL freedom,
+Enjoy your new Rebol freedom,
-Carl

0 comments on commit 692eba3

Please sign in to comment.