diff options
Diffstat (limited to 'doc/Experimental.dox')
| -rw-r--r-- | doc/Experimental.dox | 13 |
1 files changed, 10 insertions, 3 deletions
diff --git a/doc/Experimental.dox b/doc/Experimental.dox index 2191c2b2c..6d8b90d5a 100644 --- a/doc/Experimental.dox +++ b/doc/Experimental.dox @@ -9,6 +9,12 @@ namespace Eigen { \section summary Summary +With the 2.0 release, Eigen's API is, to a large extent, stable. However, we wish to retain the freedom to make API incompatible changes. To that effect, we call many parts of Eigen "experimental" which means that they are not subject to API stability guarantee. + +Our goal is that for the 2.1 release (expected in July 2009) most of these parts become API-stable too. + +We are aware that API stability is a major concern for our users. That's why it's a priority for us to reach it, but at the same time we're being serious about not calling Eigen API-stable too early. + Experimental features may at any time: \li be removed; \li be subject to an API incompatible change; @@ -16,11 +22,12 @@ Experimental features may at any time: \section modules Experimental modules -The following modules are considered entirely experimental: +The following modules are considered entirely experimental, and we make no firm API stability guarantee about them for the time being: \li SVD \li QR +\li Cholesky \li Sparse -\li Geometry +\li Geometry (this one should be mostly stable, but it's a little too early to make a formal guarantee) \section core Experimental parts of the Core module @@ -37,7 +44,7 @@ The only classes subject to (even partial) API stability guarantee (meaning that All other classes offer no direct API guarantee, e.g. their methods can be changed; however notice that most classes inherit MatrixBase and that this is where most of their API comes from -- so in practice most of the API is stable. -Here are the MatrixBase methods that are considered experimental, hence not part of any API stability guarantee: +A few MatrixBase methods are considered experimental, hence not part of any API stability guarantee: \li all methods documented as internal \li all methods hidden in the Doxygen documentation \li all methods marked as experimental |