X3D libraries
The libraries to work with X3D dataset


  libx3d documentation -- Notes on how the directories, files, etc.

  File: dev/NOTES.txt
  License: none
  libx3d project version 0.1
  http://libx3d.sourceforge.net

Author: Alexis Wilke
email: alexis@m2osw.com
email: alexis_wilke@users.sourceforge.net

IMPORTANT NOTE: if you are reading the dev package, then many files
		will be found under dev/* instead; also, the dev
		package includes all the files that you need to
		create the entire world!

This package includes:

  base/*		the X3D dataset library (nodes) (include, src)

  BUILD/*		suggested sub-directory to compile the code:

				mkdir BUILD
				cd BUILD
				../configure [-opts]
				make
				make install

  doc/CHANGES.txt	the changes in the different releases

  configure		the configure script; run it to generate the
			Makefile's; to get the different options type:

				./configure --help

  dev/*			only in the dev package; includes all the
			basic development scripts, the original files
			of the documentation, etc.

  doc/*			all the documentation, including our special
			version of the X3D specification used to generate
			the X3D dataset defined in the base/* directory;
			this is NOT included in the dev package since it
			is generated from its content (see dev/create_docs)

  io/*			the X3D reading/writing: XML, VRML, etc.
  			(include, src)

  LICENSE		there are several licenses; the libraries
			are licensed under the LGPL; the tools under
			the GPL; most scripts and utilities are under
			the MIT license (very similar to the BSD).
			check the LICENSE in a specific directory to
			know how most of the files in that directory
			are covered; edit files to see the license at
			the top of the file

  Makefile.am		the original auto-make makefiles

  render/*		the X3D rendering engine (OpenGL) (include, src)

  tmp/*			automatically created by different scripts when
			you create the whole world.

  tools/*		X3D tools; mainly to test the library, but some
			of these can actually be useful

  utilities/*		files used to generate the libraries; for instance
			there is html-to-header.c++ which parses the HTML
			and DTD files for nodes and generate the
			corresponding C++ code; there is also a smart pointer
			implementation so we don't have to manage the reference
			count ourselves

		

$Id: NOTES.txt,v 1.4 2005/11/29 08:49:59 alexis Exp $