Skip to content

Commit

Permalink
Add an example of platform ID
Browse files Browse the repository at this point in the history
Add an example of make clean
"make r3" can be used
Rename REBOL to Rebol
  • Loading branch information
ladislav committed Aug 12, 2013
1 parent fc51038 commit 692eba3
Showing 1 changed file with 16 additions and 12 deletions.
28 changes: 16 additions & 12 deletions README
@@ -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
Expand All @@ -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,
Expand All @@ -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.
Expand All @@ -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

Expand Down

0 comments on commit 692eba3

Please sign in to comment.