rice 1.2.0 → 1.3.0

data/Doxyfile

@@ -23,7 +23,7 @@ PROJECT_NAME           = Rice
 # This could be handy for archiving the generated documentation or 
 # if some version control system is used.
 
-PROJECT_NUMBER         = 1.2
+PROJECT_NUMBER         = 1.3.0
 
 # The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) 
 # base path where the generated documentation will be put. 

data/Makefile.in

@@ -1,8 +1,9 @@
-# Makefile.in generated by automake 1.10.2 from Makefile.am.
+# Makefile.in generated by automake 1.11 from Makefile.am.
 # @configure_input@
 
 # Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002,
-# 2003, 2004, 2005, 2006, 2007, 2008  Free Software Foundation, Inc.
+# 2003, 2004, 2005, 2006, 2007, 2008, 2009  Free Software Foundation,
+# Inc.
 # This Makefile.in is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
 # with or without modifications, as long as this notice is preserved.
@@ -45,8 +46,9 @@
 # This is usually added to MOSTLYCLEANFILES.
 VPATH = @srcdir@
 pkgdatadir = $(datadir)/@PACKAGE@
-pkglibdir = $(libdir)/@PACKAGE@
 pkgincludedir = $(includedir)/@PACKAGE@
+pkglibdir = $(libdir)/@PACKAGE@
+pkglibexecdir = $(libexecdir)/@PACKAGE@
 am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
 install_sh_DATA = $(install_sh) -c -m 644
 install_sh_PROGRAM = $(install_sh) -c
@@ -65,7 +67,7 @@ DIST_COMMON = README $(am__configure_deps) $(srcdir)/Makefile.am \
 	$(srcdir)/Makefile.in $(srcdir)/doxygen.am \
 	$(top_srcdir)/configure \
 	$(top_srcdir)/rice/detail/ruby_version_code.hpp.in COPYING \
-	config.guess config.sub depcomp install-sh missing
+	TODO config.guess config.sub depcomp install-sh missing
 subdir = .
 ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
 am__aclocal_m4_deps = $(top_srcdir)/ruby.ac $(top_srcdir)/doxygen.ac \
@@ -77,6 +79,7 @@ am__CONFIG_DISTCLEAN_FILES = config.status config.cache config.log \
 mkinstalldirs = $(install_sh) -d
 CONFIG_HEADER = $(top_builddir)/rice/config.hpp
 CONFIG_CLEAN_FILES = rice/detail/ruby_version_code.hpp
+CONFIG_CLEAN_VPATH_FILES =
 SOURCES =
 DIST_SOURCES =
 RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \
@@ -88,6 +91,9 @@ RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \
 	ps-recursive uninstall-recursive
 RECURSIVE_CLEAN_TARGETS = mostlyclean-recursive clean-recursive	\
   distclean-recursive maintainer-clean-recursive
+AM_RECURSIVE_TARGETS = $(RECURSIVE_TARGETS:-recursive=) \
+	$(RECURSIVE_CLEAN_TARGETS:-recursive=) tags TAGS ctags CTAGS \
+	distdir dist dist-all distcheck
 ETAGS = etags
 CTAGS = ctags
 DIST_SUBDIRS = $(SUBDIRS)
@@ -98,6 +104,31 @@ am__remove_distdir = \
   { test ! -d "$(distdir)" \
     || { find "$(distdir)" -type d ! -perm -200 -exec chmod u+w {} ';' \
          && rm -fr "$(distdir)"; }; }
+am__relativize = \
+  dir0=`pwd`; \
+  sed_first='s,^\([^/]*\)/.*$$,\1,'; \
+  sed_rest='s,^[^/]*/*,,'; \
+  sed_last='s,^.*/\([^/]*\)$$,\1,'; \
+  sed_butlast='s,/*[^/]*$$,,'; \
+  while test -n "$$dir1"; do \
+    first=`echo "$$dir1" | sed -e "$$sed_first"`; \
+    if test "$$first" != "."; then \
+      if test "$$first" = ".."; then \
+        dir2=`echo "$$dir0" | sed -e "$$sed_last"`/"$$dir2"; \
+        dir0=`echo "$$dir0" | sed -e "$$sed_butlast"`; \
+      else \
+        first2=`echo "$$dir2" | sed -e "$$sed_first"`; \
+        if test "$$first2" = "$$first"; then \
+          dir2=`echo "$$dir2" | sed -e "$$sed_rest"`; \
+        else \
+          dir2="../$$dir2"; \
+        fi; \
+        dir0="$$dir0"/"$$first"; \
+      fi; \
+    fi; \
+    dir1=`echo "$$dir1" | sed -e "$$sed_rest"`; \
+  done; \
+  reldir="$$dir2"
 DIST_ARCHIVES = "$(distdir)".tar.gz
 GZIP_ENV = --best
 distuninstallcheck_listfiles = find . -type f -print
@@ -160,6 +191,7 @@ PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@
 PACKAGE_NAME = @PACKAGE_NAME@
 PACKAGE_STRING = @PACKAGE_STRING@
 PACKAGE_TARNAME = @PACKAGE_TARNAME@
+PACKAGE_URL = @PACKAGE_URL@
 PACKAGE_VERSION = @PACKAGE_VERSION@
 PATH_SEPARATOR = @PATH_SEPARATOR@
 RANLIB = @RANLIB@
@@ -280,15 +312,15 @@ $(srcdir)/Makefile.in:  $(srcdir)/Makefile.am $(srcdir)/doxygen.am $(am__configu
 	@for dep in $?; do \
 	  case '$(am__configure_deps)' in \
 	    *$$dep*) \
-	      echo ' cd $(srcdir) && $(AUTOMAKE) --foreign '; \
-	      cd $(srcdir) && $(AUTOMAKE) --foreign  \
+	      echo ' cd $(srcdir) && $(AUTOMAKE) --foreign'; \
+	      $(am__cd) $(srcdir) && $(AUTOMAKE) --foreign \
 		&& exit 0; \
 	      exit 1;; \
 	  esac; \
 	done; \
-	echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign  Makefile'; \
-	cd $(top_srcdir) && \
-	  $(AUTOMAKE) --foreign  Makefile
+	echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign Makefile'; \
+	$(am__cd) $(top_srcdir) && \
+	  $(AUTOMAKE) --foreign Makefile
 .PRECIOUS: Makefile
 Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status
 	@case '$?' in \
@@ -304,9 +336,10 @@ $(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENC
 	$(SHELL) ./config.status --recheck
 
 $(top_srcdir)/configure:  $(am__configure_deps)
-	cd $(srcdir) && $(AUTOCONF)
+	$(am__cd) $(srcdir) && $(AUTOCONF)
 $(ACLOCAL_M4):  $(am__aclocal_m4_deps)
-	cd $(srcdir) && $(ACLOCAL) $(ACLOCAL_AMFLAGS)
+	$(am__cd) $(srcdir) && $(ACLOCAL) $(ACLOCAL_AMFLAGS)
+$(am__aclocal_m4_deps):
 rice/detail/ruby_version_code.hpp: $(top_builddir)/config.status $(top_srcdir)/rice/detail/ruby_version_code.hpp.in
 	cd $(top_builddir) && $(SHELL) ./config.status $@
 
@@ -334,7 +367,7 @@ $(RECURSIVE_TARGETS):
 	  else \
 	    local_target="$$target"; \
 	  fi; \
-	  (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \
+	  ($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \
 	  || eval $$failcom; \
 	done; \
 	if test "$$dot_seen" = "no"; then \
@@ -368,16 +401,16 @@ $(RECURSIVE_CLEAN_TARGETS):
 	  else \
 	    local_target="$$target"; \
 	  fi; \
-	  (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \
+	  ($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \
 	  || eval $$failcom; \
 	done && test -z "$$fail"
 tags-recursive:
 	list='$(SUBDIRS)'; for subdir in $$list; do \
-	  test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) tags); \
+	  test "$$subdir" = . || ($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) tags); \
 	done
 ctags-recursive:
 	list='$(SUBDIRS)'; for subdir in $$list; do \
-	  test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) ctags); \
+	  test "$$subdir" = . || ($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) ctags); \
 	done
 
 ID: $(HEADERS) $(SOURCES) $(LISP) $(TAGS_FILES)
@@ -392,7 +425,7 @@ tags: TAGS
 
 TAGS: tags-recursive $(HEADERS) $(SOURCES)  $(TAGS_DEPENDENCIES) \
 		$(TAGS_FILES) $(LISP)
-	tags=; \
+	set x; \
 	here=`pwd`; \
 	if ($(ETAGS) --etags-include --version) >/dev/null 2>&1; then \
 	  include_option=--etags-include; \
@@ -404,7 +437,7 @@ TAGS: tags-recursive $(HEADERS) $(SOURCES)  $(TAGS_DEPENDENCIES) \
 	list='$(SUBDIRS)'; for subdir in $$list; do \
 	  if test "$$subdir" = .; then :; else \
 	    test ! -f $$subdir/TAGS || \
-	      tags="$$tags $$include_option=$$here/$$subdir/TAGS"; \
+	      set "$$@" "$$include_option=$$here/$$subdir/TAGS"; \
 	  fi; \
 	done; \
 	list='$(SOURCES) $(HEADERS)  $(LISP) $(TAGS_FILES)'; \
@@ -413,29 +446,34 @@ TAGS: tags-recursive $(HEADERS) $(SOURCES)  $(TAGS_DEPENDENCIES) \
 	  done | \
 	  $(AWK) '{ files[$$0] = 1; nonempty = 1; } \
 	      END { if (nonempty) { for (i in files) print i; }; }'`; \
-	if test -z "$(ETAGS_ARGS)$$tags$$unique"; then :; else \
+	shift; \
+	if test -z "$(ETAGS_ARGS)$$*$$unique"; then :; else \
 	  test -n "$$unique" || unique=$$empty_fix; \
-	  $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \
-	    $$tags $$unique; \
+	  if test $$# -gt 0; then \
+	    $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \
+	      "$$@" $$unique; \
+	  else \
+	    $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \
+	      $$unique; \
+	  fi; \
 	fi
 ctags: CTAGS
 CTAGS: ctags-recursive $(HEADERS) $(SOURCES)  $(TAGS_DEPENDENCIES) \
 		$(TAGS_FILES) $(LISP)
-	tags=; \
 	list='$(SOURCES) $(HEADERS)  $(LISP) $(TAGS_FILES)'; \
 	unique=`for i in $$list; do \
 	    if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \
 	  done | \
 	  $(AWK) '{ files[$$0] = 1; nonempty = 1; } \
 	      END { if (nonempty) { for (i in files) print i; }; }'`; \
-	test -z "$(CTAGS_ARGS)$$tags$$unique" \
+	test -z "$(CTAGS_ARGS)$$unique" \
 	  || $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \
-	     $$tags $$unique
+	     $$unique
 
 GTAGS:
 	here=`$(am__cd) $(top_builddir) && pwd` \
-	  && cd $(top_srcdir) \
-	  && gtags -i $(GTAGS_ARGS) $$here
+	  && $(am__cd) $(top_srcdir) \
+	  && gtags -i $(GTAGS_ARGS) "$$here"
 
 distclean-tags:
 	-rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags
@@ -458,34 +496,50 @@ distdir: $(DISTFILES)
 	  if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \
 	  if test -d $$d/$$file; then \
 	    dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \
+	    if test -d "$(distdir)/$$file"; then \
+	      find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
+	    fi; \
 	    if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \
-	      cp -pR $(srcdir)/$$file "$(distdir)"$$dir || exit 1; \
+	      cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \
+	      find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
 	    fi; \
-	    cp -pR $$d/$$file "$(distdir)"$$dir || exit 1; \
+	    cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \
 	  else \
-	    test -f "$(distdir)"/$$file \
-	    || cp -p $$d/$$file "$(distdir)"/$$file \
+	    test -f "$(distdir)/$$file" \
+	    || cp -p $$d/$$file "$(distdir)/$$file" \
 	    || exit 1; \
 	  fi; \
 	done
-	list='$(DIST_SUBDIRS)'; for subdir in $$list; do \
+	@list='$(DIST_SUBDIRS)'; for subdir in $$list; do \
 	  if test "$$subdir" = .; then :; else \
 	    test -d "$(distdir)/$$subdir" \
 	    || $(MKDIR_P) "$(distdir)/$$subdir" \
 	    || exit 1; \
-	    distdir=`$(am__cd) "$(distdir)" && pwd`; \
-	    top_distdir=`$(am__cd) $(top_distdir) && pwd`; \
-	    (cd $$subdir && \
+	  fi; \
+	done
+	@list='$(DIST_SUBDIRS)'; for subdir in $$list; do \
+	  if test "$$subdir" = .; then :; else \
+	    dir1=$$subdir; dir2="$(distdir)/$$subdir"; \
+	    $(am__relativize); \
+	    new_distdir=$$reldir; \
+	    dir1=$$subdir; dir2="$(top_distdir)"; \
+	    $(am__relativize); \
+	    new_top_distdir=$$reldir; \
+	    echo " (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) top_distdir="$$new_top_distdir" distdir="$$new_distdir" \\"; \
+	    echo "     am__remove_distdir=: am__skip_length_check=: am__skip_mode_fix=: distdir)"; \
+	    ($(am__cd) $$subdir && \
 	      $(MAKE) $(AM_MAKEFLAGS) \
-	        top_distdir="$$top_distdir" \
-	        distdir="$$distdir/$$subdir" \
+	        top_distdir="$$new_top_distdir" \
+	        distdir="$$new_distdir" \
 		am__remove_distdir=: \
 		am__skip_length_check=: \
+		am__skip_mode_fix=: \
 	        distdir) \
 	      || exit 1; \
 	  fi; \
 	done
-	-find "$(distdir)" -type d ! -perm -777 -exec chmod a+rwx {} \; -o \
+	-test -n "$(am__skip_mode_fix)" \
+	|| find "$(distdir)" -type d ! -perm -777 -exec chmod a+rwx {} \; -o \
 	  ! -type d ! -perm -444 -links 1 -exec chmod a+r {} \; -o \
 	  ! -type d ! -perm -400 -exec chmod a+r {} \; -o \
 	  ! -type d ! -perm -444 -exec $(install_sh) -c -m a+r {} {} \; \
@@ -502,6 +556,10 @@ dist-lzma: distdir
 	tardir="$(distdir)" && $(am__tar) | lzma -9 -c >"$(distdir)".tar.lzma
 	$(am__remove_distdir)
 
+dist-xz: distdir
+	tardir="$(distdir)" && $(am__tar) | xz -c >"$(distdir)".tar.xz
+	$(am__remove_distdir)
+
 dist-tarZ: distdir
 	tardir="$(distdir)" && $(am__tar) | compress -c >"$(distdir)".tar.Z
 	$(am__remove_distdir)
@@ -530,6 +588,8 @@ distcheck: dist
 	  bunzip2 -c "$(distdir)".tar.bz2 | $(am__untar) ;;\
 	*.tar.lzma*) \
 	  unlzma -c "$(distdir)".tar.lzma | $(am__untar) ;;\
+	*.tar.xz*) \
+	  xz -dc "$(distdir)".tar.xz | $(am__untar) ;;\
 	*.tar.Z*) \
 	  uncompress -c "$(distdir)".tar.Z | $(am__untar) ;;\
 	*.shar.gz*) \
@@ -541,9 +601,11 @@ distcheck: dist
 	mkdir "$(distdir)"/_build
 	mkdir "$(distdir)"/_inst
 	chmod a-w "$(distdir)"
+	test -d "$(distdir)"/_build || exit 0; \
 	dc_install_base=`$(am__cd) "$(distdir)"/_inst && pwd | sed -e 's,^[^:\\/]:[\\/],/,'` \
 	  && dc_destdir="$${TMPDIR-/tmp}/am-dc-$$$$/" \
-	  && cd "$(distdir)"/_build \
+	  && am__cwd=`pwd` \
+	  && $(am__cd) "$(distdir)"/_build \
 	  && ../configure --srcdir=.. --prefix="$$dc_install_base" \
 	    $(DISTCHECK_CONFIGURE_FLAGS) \
 	  && $(MAKE) $(AM_MAKEFLAGS) \
@@ -565,13 +627,15 @@ distcheck: dist
 	  && rm -rf "$$dc_destdir" \
 	  && $(MAKE) $(AM_MAKEFLAGS) dist \
 	  && rm -rf $(DIST_ARCHIVES) \
-	  && $(MAKE) $(AM_MAKEFLAGS) distcleancheck
+	  && $(MAKE) $(AM_MAKEFLAGS) distcleancheck \
+	  && cd "$$am__cwd" \
+	  || exit 1
 	$(am__remove_distdir)
 	@(echo "$(distdir) archives ready for distribution: "; \
 	  list='$(DIST_ARCHIVES)'; for i in $$list; do echo $$i; done) | \
 	  sed -e 1h -e 1s/./=/g -e 1p -e 1x -e '$$p' -e '$$x'
 distuninstallcheck:
-	@cd $(distuninstallcheck_dir) \
+	@$(am__cd) '$(distuninstallcheck_dir)' \
 	&& test `$(distuninstallcheck_listfiles) | wc -l` -le 1 \
 	   || { echo "ERROR: files left after uninstall:" ; \
 	        if test -n "$(DESTDIR)"; then \
@@ -613,6 +677,7 @@ clean-generic:
 
 distclean-generic:
 	-test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES)
+	-test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES)
 
 maintainer-clean-generic:
 	@echo "This command is intended for maintainers to use"
@@ -632,6 +697,8 @@ dvi-am:
 
 html: html-recursive
 
+html-am:
+
 info: info-recursive
 
 info-am:
@@ -640,18 +707,28 @@ install-data-am:
 
 install-dvi: install-dvi-recursive
 
+install-dvi-am:
+
 install-exec-am:
 
 install-html: install-html-recursive
 
+install-html-am:
+
 install-info: install-info-recursive
 
+install-info-am:
+
 install-man:
 
 install-pdf: install-pdf-recursive
 
+install-pdf-am:
+
 install-ps: install-ps-recursive
 
+install-ps-am:
+
 installcheck-am:
 
 maintainer-clean: maintainer-clean-recursive
@@ -674,23 +751,23 @@ ps-am:
 
 uninstall-am:
 
-.MAKE: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) install-am \
-	install-strip
+.MAKE: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) ctags-recursive \
+	install-am install-strip tags-recursive
 
 .PHONY: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) CTAGS GTAGS \
 	all all-am am--refresh check check-am clean clean-generic \
 	ctags ctags-recursive dist dist-all dist-bzip2 dist-gzip \
-	dist-lzma dist-shar dist-tarZ dist-zip distcheck distclean \
-	distclean-generic distclean-tags distcleancheck distdir \
-	distuninstallcheck dvi dvi-am html html-am info info-am \
-	install install-am install-data install-data-am install-dvi \
-	install-dvi-am install-exec install-exec-am install-html \
-	install-html-am install-info install-info-am install-man \
-	install-pdf install-pdf-am install-ps install-ps-am \
-	install-strip installcheck installcheck-am installdirs \
-	installdirs-am maintainer-clean maintainer-clean-generic \
-	mostlyclean mostlyclean-generic pdf pdf-am ps ps-am tags \
-	tags-recursive uninstall uninstall-am
+	dist-lzma dist-shar dist-tarZ dist-xz dist-zip distcheck \
+	distclean distclean-generic distclean-tags distcleancheck \
+	distdir distuninstallcheck dvi dvi-am html html-am info \
+	info-am install install-am install-data install-data-am \
+	install-dvi install-dvi-am install-exec install-exec-am \
+	install-html install-html-am install-info install-info-am \
+	install-man install-pdf install-pdf-am install-ps \
+	install-ps-am install-strip installcheck installcheck-am \
+	installdirs installdirs-am maintainer-clean \
+	maintainer-clean-generic mostlyclean mostlyclean-generic pdf \
+	pdf-am ps ps-am tags tags-recursive uninstall uninstall-am
 
 
 @DX_COND_doc_TRUE@@DX_COND_ps_TRUE@doxygen-ps: @DX_DOCDIR@/@PACKAGE@.ps
@@ -744,6 +821,7 @@ doc: doxygen-doc
 rice/README.doxygen: README
 	@echo Generating documentation
 	@$(RUBY) -e 'File.open("README") { |i| File.open("rice/README.doxygen", "w") { |o| o.puts "/*! #{i.gets}"; i.each_line { |l| o.puts " *  #{l}" if l !~ /^\\comment/ and l !~ /^vim:/ }; o.puts " */" } }'
+
 # Tell versions [3.59,3.63) of GNU make to not export all variables.
 # Otherwise a system limit (for SysV at least) may be exceeded.
 .NOEXPORT:

data/README

@@ -669,7 +669,7 @@ it's necessary to define this in Rice explicitly using Rice::Arg:
 
 The syntax here is simply Arg(nameOfParameter)[ = defaultValue].  The name of the
 parameter is not important (more for readability, and the future for when/if Ruby
-gets named arguments), but the value set via operator= must match the type
+gets named parameters), but the value set via operator= must match the type
 of the given parameter.
 
 These Rice::Arg objects must be in the correct order, and if there are more than
@@ -702,8 +702,8 @@ As polymorphism is the most important tennant of Object Oriented Programming,
 it's important that Rice supports polymorphic calls travelling between C++
 and Ruby seemlessly. Super calls from Ruby subclasses back into C++ already work,
 but enabling the other direction requires some extra work. While this isn't
-something Rice can do on it's own, the Rice::Director class hides most of the
-details.
+something Rice can do on it's own, the Rice::Director class, coupled with 
+Rice::Data_Type::define_director exposes this functionality cleanly.
 
 Like SWIG_Director, Rice::Director is a class that is used to build a proxy class
 to properly send execution up or down the object heiarchy for that class. Take
@@ -721,11 +721,11 @@ the following class:
 Due to the abstract nature of this class, it will not work at all with Rice
 in it's current form. Any attempt to do so will cause a compilation error due to
 this class not being constructable. Even without the pure virtual function, any
-call to VirtualBase::doWork will stop at the C++ level and not pass down into
+call to VirtualBase::doWork will stop at the C++ level and will not pass down into
 any Ruby subclasses.
 
 To properly wrap both of these methods, you'll need to build a proxy class
-that subclasses Rice::Director:
+that subclasses Rice::Director along with a few methods:
 
 \code
   #include "rice/Director.hpp"
@@ -735,30 +735,30 @@ that subclasses Rice::Director:
       VirtualBaseProxy(Object self) : Rice::Director(self) { }
 
       virtual int doWork() {
-        if(callIsFromRuby("do_work")) {
-          return VirtualBase::doWork();
-        } else {
-          return from_ruby<int>( getSelf().call("do_work") );
-        }
+        return from_ruby<int>( getSelf().call("do_work") );
+      }
+
+      int default_doWork() {
+        return VirtualBase::doWork();
       }
 
       virtual int processWorker() {
-        if(callIsFromRuby("process_worker")) {
-          raisePureVirtual();
-        } else {
-          return from_ruby<int>( getSelf().call("process_worker") );
-        }
+        return from_ruby<int>( getSelf().call("process_worker") );
+      }
+
+      int default_processWorker() {
+        raisePureVirtual();
       }
   };
 \endcode
 
-There is a lot going on here, so we'll take go through each part.
+There is a lot going on here, so we'll go through each part.
 
 \code
   class VirtualBaseProxy : public Virtualbase, public Rice::Director {
 \endcode
 
-First, the class needs to subclass both the virtual class and Rice::Director.
+First, the class needs to subclass both the virtual class and Rice::Director class.
 
 \code
     public:
@@ -773,88 +773,54 @@ minimum required for a Rice::Director proxy.
 
 \code
       virtual int doWork() {
-        if(callIsFromRuby("do_work")) {
-          // Call from Ruby via super, head up the stack
-          return VirtualBase::doWork();
-        } else {
-          // Call from C++ heading down the stack, get self
-          // and call the method in Ruby, taking care to
-          // convert types to and from ruby as needed.
-          return from_ruby<int>( getSelf().call("do_work") );
-        }
+        return from_ruby<int>( getSelf().call("do_work") );
+      }
+
+      int default_doWork() {
+        return VirtualBase::doWork();
       }
 \endcode
 
-Every virtual method needs to have a special definition inside of this proxy class.
-Use Rice::Director::callIsFromRuby to check if execution is passing up or down
-the heirarchy. The name passed to this method needs to be the name as exposed to Ruby
-(which will be seen in the wrapper code below).
+The two methods seen here directly correspond to the two code directions this class
+opens up. The virtual method is this class's hook into C++'s polymorphism. Any calls
+that need to be forwarded into Ruby are done as specified here: get the Ruby object
+for the instance of this class, call Rice::Object::call, and if necessary convert
+the return value from Ruby back into C++ types.
 
-A special case as seen in the proxy method for processWorker is the raisePureVirtual
-method. In the case of pure virtual methods, the proxy is the top of the heirarchy.
-This proxy could be written more simply:
+The default_doWork method will be used as Rice's hookup of calling back up the 
+heirarchy (wrapping is below). This method needs to do one of two things: call
+up the class heirarchy, as seen here, or call raisePureVirtual() as seen in the
+processWorker example:
 
 \code
-      virtual int processWorker() {
-        return from_ruby<int>( getSelf().call("process_worker") );
+      int default_processWorker() {
+        raisePureVirtual();
       }
 \endcode
 
-but if the Ruby code accidentally calls #super, the code will get stuck in an infinite loop.
-To prevent this from happening, use Rice::Director::raisePureVirtual to inform users of the 
-extension that they should not be calling up into C++ for that method.
+The method raisePureVirtual() exists to allow wrapping a pure virtual method into Ruby
+but making sure any users of this extension are informed quickly that there's nothing
+in the C++ to call for the given method.
 
 Once the proxy class is built, it's time to wrap it into Ruby:
 
 \code
 extern "C"
 void Init_virtual() {
-  // See Caveat below
-  define_class<VirtualBase>("__VirtualBase__");
-
-  define_class<VirtualBaseProxy, VirtualBase>("VirtualBase")
-    .define_method("do_work", &VirtualBaseProxy::doWork)
-    .define_method("process_worker", &VirtualBaseProxy::processWorker);
+  define_class<VirtualBase>("VirtualBase")
+    .define_director<VirtualBaseProxy>()
+    .define_constructor(Constructor<VirtualBaseProxy, Rice::Object>())
+    .define_method("do_work", &VirtualBaseProxy::default_doWork)
+    .define_method("process_worker", &VirtualBaseProxy::default_processWorker);
 }
 \endcode
 
 The wrapping is the same as is described earlier in this document. Expose the class
-VirtualBaseProxy named as VirtualBase, register it as a subclass of VirtualBase,
-and define methods pointing to the proxy object.
-
-<b>Caveat</b>: Rice figures out inheritance and class heirarchies solely through
-the types given in define_class. Ideally Rice would be able to handle this edge
-case automatically, but for now you'll still need to tell Rice about the base class
-being wrapped into a Rice::Director proxy, or type casting will throw an exception
-during execution. So as a general rule, make sure that any class you use as SuperClass 
-in define_class<Class, SuperClass> is also itself
-exposed.
-
-Following this, if you have subclasses of virtual classes that themselves have virtual
-methods, you need to set the Rice::Director proxy as the superclass of that class,
-something like:
-
-\code
-  // Given a class like this
-  class SubVirtual : public VirtualBase {
-    public:
-      virtual int doMoreWork();
-  }
-
-  // You'd need another Director proxy
-  class SubVirtualDirector : public SubVirtual, public VirtualBase, public Rice::Director {
-    ...
-  }
-
-  // And expose it in Rice as such
-  define_class<SubVirtual, VirtualBaseProxy>("__SubVirtual__");
-  define_class<SubVirtualDirector, SubVirtual>("SubVirtual")
-    ...
-
-\endcode
-
-This situation has not been fully tested
+VirtualBase, and register VirtualBaseProxy as a director proxy of VirtualBase with
+Rice::Data_Type::define_director, then define methods pointing to the proxy object as necessary.
 
+You must use the Rice::Director proxy class in the Constructor line, this allows proper
+object construction / destruction of the types in question.
 
 \section motivation Motivation