[MacRuby-devel] need review for macrubyc man-page

Ernest N. Prabhakar, Ph.D. prabhaka at apple.com
Fri Dec 18 15:40:00 PST 2009


Hi Laurent,

Much nicer.  I'm still a bit confused with what you're doing with the first USAGE paragraph , though:

> USAGE
>     The easiest way to compile an existing project is probably to generate
>     loadable object bundles for every Ruby source file, using the -C option.
>     These bundles have the .rbo file extension and can be installed in the
>     same directory as the original .rb source files. The MacRuby runtime will
>     always pick .rbo files over .rb files upon #require calls. The source
>     files can be removed later.
> 
>           $ find src/lib -name "*.rb" -exec rubyc -C {} \;
> 

My main problem is that I don't understand your implied context. Did you mean something like this?

----
USAGE

When using an existing Ruby library or project with MacRuby, you typically should precompile each  source file using the -C option:

	$ find ./lib -name "*.rb" -exec rubyc -C {} \;

This will create a loadable object bundle for each source file in the same directory, but with the ".rbo" extension. These can be loaded by #require just like Ruby source files, and in fact will always be preferred.  For example:

	require "foo"

will first look for and attempt to load the file foo.rbo. If that fails, only then will it look for foo.rb.
---

Is that what you meant?

-- Ernie P.


More information about the MacRuby-devel mailing list