Commits

Anonymous committed 9de77f1

Doc updates

Comments (0)

Files changed (10)

-Kongsberg SIM, http://www.sim.no/
+Kongsberg SIM, http://www.km.kongsberg.com/sim
 
 Most Active Developers:
 =======================
 Thomas Hammer <thammer@sim.no>
 Řystein Handegard <handegar@sim.no>
 Karin Kosina <kyrah@sim.no>
+Tom Fredrik Klaussen <bfg@sim.no>
+Tamer Fahmy <tamer@sim.no>
 Kristian Eide
 
     cd ..
     rm -rf coin-build Coin-3.0.0
 
+Running "make install" directly instead of "make" first and then
+"make install" is not recomended, since this will lead to partial
+installations in the case where the build breaks for some reason.  Also, if
+you want to launch all the build-commands on one command-line, don't separate
+commands with ; but separate them with && so the failure of one will stop the
+full chain of commands.  Like this:
+
+  .../Coin-3.0.0/configure && make && make install
+
+and not like this
+
+  .../Coin-3.0.0/configure; make; make install
+
 
 The Build Environment
 =====================
 	docs/ChangeLog.2005 \
 	docs/ChangeLog.2006 \
 	docs/ChangeLog.2007 \
+	docs/ChangeLog.v3.0.0 \
 	docs/HACKING \
 	docs/announcement-2_0_0.txt \
 	docs/announcement-2_0_1.txt \
 	docs/ChangeLog.2005 \
 	docs/ChangeLog.2006 \
 	docs/ChangeLog.2007 \
+	docs/ChangeLog.v3.0.0 \
 	docs/HACKING \
 	docs/announcement-2_0_0.txt \
 	docs/announcement-2_0_1.txt \
-New in Coin v3.0.0-RC1 (2008-08-18):
+New in Coin v3.0.0 (2008-09-11):
 * new:
   - Scene graph performance profiling subsystem
   - SoDepthBuffer node for constrolling Z-buffer settings
   - Shaders: SoVertexAttribute and SoVertexAttributeBinding nodes
   - Shadows: SoShadowSpotLight node
-  - SoHeightMapToNormalMap engine
+  - SoHeightMapToNormalMap texture conversion engine
   - SoPickStyle: new styles SHAPE_ON_TOP, BOUNDING_BOX_ON_TOP, SHAPE_FRONTFACES
   - New XML-based GL driver feature database for tagging buggy/slow features
     in specific drivers
   - Statechart XML engine (2007-draft based), used to implement examiner viewer
     mode at the Coin level
   - Foreign file format support through SoForeignFileKit w. example SoSTLFileKit
-  - Boost.Test-based testsuite
   - Draggers: minTranslation/maxTranslation fields in SoTranslate1Dragger and
     SoTranslate2Dragger
   - OS X: Coin has become more bundle-aware and will loads external libs bundled
     with Inventor.framework or the application bundle (better encapsulation)
   - SoLineHighlightRenderAction and SoBoxHighlightRenderAction now only
-    supports one SoSelection node
+    supports one SoSelection node (performance and OIV-compatibility)
   - SoBumpMap will now detect height maps stored as rgb(a)
   - SoRayPickAction picking precision improvements
-  - Support SoFieldContainer userdata when doing a deep node copy
+  - Include SoFieldContainer userdata when doing a deep node copy
   - Anti-aliasing is now done around the center of each pixel
+  - Boost.Test-based testsuite
 * bugfixes:
   - ATi driver workarounds (VBO rendering related)
   - Fixed SoToVRML2Action Transform handling bug
   - SoVRMLAppearance now checks material on the state
   - SoComposeRotation. Default axis is now (0,0,1)
   - Various SoShadowGroup fixes
-  - 3ds loader will not normalize the model anymore
+  - 3ds loader will no longer normalize the model (still not enabled by default)
   - Workaround for nVidia line pattern bug
   - Fixes for SoVRMLBillboard
+  - SoFile-SoSearchAction bugfix
   - Correctly load bold/italic version of fonts with a single ttf file
   - Bugfix for anti aliasing with numpasses > 16
+  - New Visual Studio 9 build files and other VS-related fixes
     ... and more
 
 New in Coin v2.5.0 (2007-10-01):
 Building Coin
 =============
 
-Building Coin should be straightforward: ./configure && make && sudo
-make install. See the file INSTALL for details. If any of these stages
-fails, it's a bug in Coin. Please let us know about this, and we will
-be glad to fix it.
+Building Coin should be straightforward:
+
+  ./configure && make && sudo make install
+
+See the file INSTALL for details. If any of these stages fails, it's a bug
+in Coin. Please let us know about this, and we will be glad to fix it.
 
 Please make sure that you have the latest version of Apple's developer
 tools installed before building Coin.
 Binary SDKs
 ===========
 
-Precompiled binaries of the Coin framework can be found on our ftp server[0].
+Precompiled binaries of the Coin framework can be found on our ftp server[0]
+or through the www.coin3d.org webserver.
 
 
 Using Coin
 related to Mac OS X versions, ABI compatibility, etc.
 
 
+Mac OS 10.4 ("Tiger") and 10.5 ("Leopard")
+------------------------------------------
+
+No particuar notes for these at this time.
+
+
 The Inventor framework
 ======================
 
 
 The source code archive for Coin comes with Microsoft Visual Studio files
 for building and installing the Coin library.  Visual Studio 6,
-Visual Studio 7/7.1, and Visual Studio 8 are supported.
+Visual Studio 7/7.1, Visual Studio 8, and Visual Studio 9 are supported.
+For later versions in the future, you can probably just "upgrade" one of
+these to get a working set for that version as well.  Visual Studio 6 will
+not be supported (at the C++ language level) for very much longer.
 
-At the last stage of the build, the Coin development kit is automatically
-installed into the directory the COINDIR environment variable points to.
-Set it to "C:\Coin3D" or wherever you want the Coin SDK to reside by using
+A separate target "coin3_install" is provided for copying the built Coin
+library into the directory provided in the COINDIR environment variable.
+Set it to e.g. "C:\Coin3D" or wherever you want the Coin SDK to reside by
+using
 
   Control Panel => System => Advanced => Environment Variables
 
-and make sure you create that directory before starting the build - if the
-variable isn't set or the directory doesn't exist, the installation will
-break and you won't get a functional SDK.  Using the source hierarchy as
-the SDK is not recommended - let Coin be installed, and use COINDIR from
-your other projects that use Coin.
+and make sure you create that directory before starting the build of that
+target - if the variable isn't set or the directory doesn't exist, the
+installation will break and you won't get a functional SDK.  Using the
+source hierarchy as the SDK is not recommended - let Coin be installed, and
+use COINDIR from your other projects that use Coin.
 
 For Microsoft Visual Studio 6, you will find the complete build file setup
 in the directory "build/msvc6/".  Select the dsw file.
 
-For Microsoft Visual Studio 7, you will find the complete build file setup
+For Microsoft Visual Studio 7/7.1, you will find the complete build file setup
 in the directory build/msvc7/.  Select the sln file.
 
 For Microsoft Visual Studio 8, you will find the complete build file setup
 in the directory build/msvc8/.  Select the sln file.
 
+For Microsoft Visual Studio 9, you will find the complete build file setup
+in the directory build/msvc9/.  Select the sln file.
+
 
 Other IDEs
 ==========
 
 
 ============================================================================
-==                    OLD OBSOLETED INFORMATION BELOW                     ==
+==              OLD INFORMATION ON CYGWIN-BASED BUILDS BELOW              ==
 ============================================================================
 
 This below text is information about building Coin on MS Windows platforms
         
     depends <app.exe>
   
-  MSVC 7:
+  MSVC 7 and later:
 
     dumpbin /dependents <app.exe>
 
 
 New scene graph traversal profiling subsystem.
 
-New node SoVertexAttribute whih provides vertex attribute support for
+New node SoVertexAttribute which provides vertex attribute support for
 shaders.
 
 New SoDepthBuffer node to control depth buffer settings.
 component normal maps.
 
 SoPickStyle has three new style settings, SHAPE_ON_TOP,
-BOUNDING_BOX_ON_TOP, and SHAPE_FRONTFACES.  They are documented in the
-SoPickStyle node documentation.
+BOUNDING_BOX_ON_TOP, and SHAPE_FRONTFACES.
 
-Integrated XML parser.
+Integrated XML parser used for various purposes.
 
 GL feature control through a new GLDriverDatabase subsystem which is
 configurable through XML files.

docs/ChangeLog.v3.0.0

+Stub

docs/announcement-3_0_0.txt

 From: "Lars J. Aas" <larsa@sim.no>
-Subject: Coin 3.0.0 "Buffalo" RC1 Now Available
+Subject: Coin 3.0.0 "Buffalo" Released
  
-Coin 3.0.0 "Buffalo" RC1
-========================
+Coin 3.0.0 "Buffalo"
+====================
 
-Kongsberg SIM is proud to make Release Candidate 1 (RC1) of version 3.0.0 of
-the Coin 3D graphics library available.  Coin 3.0.0 RC1 will be identical to
-the Coin 3.0.0 "Buffalo" proper release, released shortly, given that no
-showstopper bugs are found in the release candidate.
+Kongsberg SIM is proud to release version 3.0.0 of the Coin 3D graphics
+library.  Coin 3.0.0 is a major release.  It breaks binary compatibility
+with previous versions of Coin, but is for the most part upward source
+code compatible with Coin 2.*.  A new major release means it was time for
+doing cleanup-duties.  Some dead-end developments were removed, certain
+ABI-preservation-related hacks were discarded and rewritten properly.
+Certain bad design choices were improved upon.
 
-Coin 3.0.0 is a major release.  It breaks binary compatibility with previous
-versions of Coin, but is for the most part upward source code compatible
-with Coin 2.*.  A new major release means it was time for doing
-cleanup-duties.  Some dead-end developments were removed, certain
-ABI-preservation-related hacks were rewritten properly.  Certain poor design
-choices were improved upon.
-
-Coin 3.0.0 is not a release which is a massive roll-out of new features.
+Coin 3.0.0 is not a release with a massive roll-out of new features.
 Resources have at times been stretched, but we have managed to accumulate a
 decent set of features for a release anyway, and internal to Coin we have
 many new subsystems to build future features on.
 
-While we have your attention, it should also be mentioned that the Coin 3.0
-series will be the last set of releases of Coin to support the archaic
-Microsoft Visual C++ 6.0 compiler, which has become a really a big pain to
-keep supporting at this point, C++-language-wise.  Just a word of warning to
-VC++6.0 users out there.  This is the beginning of the end of the line.
+It should also be mentioned that the Coin 3.0 series will be the last set
+of releases of Coin to support the archaic Microsoft Visual C++ 6.0 compiler,
+which has become a big pain to keep supporting at this point, C++
+languagewise.  Just a word of warning to VC++6.0 users out there.  This is
+the beginning of the end of the line.
 
 
 NEWS File Excerpt:
   - SoDepthBuffer node for constrolling Z-buffer settings
   - Shaders: SoVertexAttribute and SoVertexAttributeBinding nodes
   - Shadows: SoShadowSpotLight node
-  - SoHeightMapToNormalMap engine
-  - SoPickStyle: styles SHAPE_ON_TOP, BOUNDING_BOX_ON_TOP, SHAPE_FRONTFACES
+  - SoHeightMapToNormalMap texture conversion engine
+  - SoPickStyle: new styles SHAPE_ON_TOP, BOUNDING_BOX_ON_TOP, SHAPE_FRONTFACES
   - New XML-based GL driver feature database for tagging buggy/slow features
     in specific drivers
-  - Statechart XML engine (2007-draft based), used to implement examiner
-    viewer mode at the Coin level
-  - Foreign file format support through SoForeignFileKit w. ex. SoSTLFileKit
-  - Boost.Test-based testsuite
-  - Draggers: minTranslation/maxTranslation fields in SoTranslate1Dragger
-    and SoTranslate2Dragger
-  - OS X: Coin has become more bundle-aware and will loads external libs
-    bundled with Inventor.framework or the application bundle
+  - Statechart XML engine (2007-draft based), used to implement examiner viewer
+    mode at the Coin level
+  - Foreign file format support through SoForeignFileKit w. example SoSTLFileKit
+  - Draggers: minTranslation/maxTranslation fields in SoTranslate1Dragger and
+    SoTranslate2Dragger
+  - OS X: Coin has become more bundle-aware and will loads external libs bundled
+    with Inventor.framework or the application bundle (better encapsulation)
   - SoLineHighlightRenderAction and SoBoxHighlightRenderAction now only
-    supports one SoSelection node
+    supports one SoSelection node (performance and OIV-compatibility)
   - SoBumpMap will now detect height maps stored as rgb(a)
   - SoRayPickAction picking precision improvements
-  - Support SoFieldContainer userdata when doing a deep node copy
+  - Include SoFieldContainer userdata when doing a deep node copy
   - Anti-aliasing is now done around the center of each pixel
+  - Boost.Test-based testsuite
 * bugfixes:
   - ATi driver workarounds (VBO rendering related)
   - Fixed SoToVRML2Action Transform handling bug
   - SoVRMLAppearance now checks material on the state
   - SoComposeRotation. Default axis is now (0,0,1)
   - Various SoShadowGroup fixes
-  - 3ds loader will not normalize the model anymore
+  - 3ds loader will no longer normalize the model (still not enabled by default)
   - Workaround for nVidia line pattern bug
   - Fixes for SoVRMLBillboard
+  - SoFile-SoSearchAction bugfix
   - Correctly load bold/italic version of fonts with a single ttf file
   - Bugfix for anti aliasing with numpasses > 16
+  - New Visual Studio 9 build files and other VS-related fixes
     ... and more
 
 See the ChangeLog file if you want the really gory details.  See
 
 
 ChangeLog:
-  http://svn.coin3d.org/repos/Coin/trunk/ChangeLog
+  http://svn.coin3d.org/repos/Coin/trunk/docs/ChangeLog.v3.0.0
 
-Source Code by FTP: 
-  http://ftp.coin3d.org/coin/src/all/Coin-3.0.0-RC1.tar.gz 
-  http://ftp.coin3d.org/coin/src/all/Coin-3.0.0-RC1.zip
+Source Code: 
+  http://ftp.coin3d.org/coin/src/all/Coin-3.0.0.tar.gz 
+  http://ftp.coin3d.org/coin/src/all/Coin-3.0.0.zip
 
 Precompiled for MS Windows:
-  http://ftp.coin3d.org/coin/bin/win32/Coin-3.0.0-RC1-bin-msvc6.zip
-  http://ftp.coin3d.org/coin/bin/win32/Coin-3.0.0-RC1-bin-msvc7.zip
-  http://ftp.coin3d.org/coin/bin/win32/Coin-3.0.0-RC1-bin-msvc8.zip
-  http://ftp.coin3d.org/coin/bin/win32/Coin-3.0.0-RC1-bin-msvc9.zip
+  http://ftp.coin3d.org/coin/bin/win32/Coin-3.0.0-bin-msvc6.zip
+  http://ftp.coin3d.org/coin/bin/win32/Coin-3.0.0-bin-msvc7.zip
+  http://ftp.coin3d.org/coin/bin/win32/Coin-3.0.0-bin-msvc8.zip
+  http://ftp.coin3d.org/coin/bin/win32/Coin-3.0.0-bin-msvc9.zip
     or look in
   http://ftp.coin3d.org/coin/bin/win32/ ...