diff --git a/src/site/xdoc/userguide/index.xml b/src/site/xdoc/userguide/index.xml
index 1e2c3aa57..605a5a3ab 100644
--- a/src/site/xdoc/userguide/index.xml
+++ b/src/site/xdoc/userguide/index.xml
@@ -58,7 +58,8 @@
                 <ul>
                 <li><a href="linear.html#3.1 Overview">3.1 Overview</a></li>
                 <li><a href="linear.html#3.2 Real matrices">3.2 Real matrices</a></li>
-                <li><a href="linear.html#3.3 Solving linear systems">3.3 Solving linear systems</a></li> 
+                <li><a href="linear.html#3.3 Real vectors">3.3 Real vectors</a></li>
+                <li><a href="linear.html#3.4 Solving linear systems">3.4 Solving linear systems</a></li> 
                 </ul></li>             
             <li><a href="analysis.html">4. Numerical Analysis</a>
                 <ul>
diff --git a/src/site/xdoc/userguide/linear.xml b/src/site/xdoc/userguide/linear.xml
index 11892b51c..c44e1b245 100644
--- a/src/site/xdoc/userguide/linear.xml
+++ b/src/site/xdoc/userguide/linear.xml
@@ -30,7 +30,8 @@
       <subsection name="3.1 Overview" href="overview">
         <p>
            Currently, numerical linear algebra support in commons-math is 
-           limited to basic operations on real matrices and solving linear systems.
+           limited to basic operations on real matrices and vectors and
+           solving linear systems.
         </p>
       </subsection>
       <subsection name="3.2 Real matrices" href="real_matrices">
@@ -69,9 +70,29 @@ System.out.println(p.getRowDimension()); // 2
 // Invert p
 RealMatrix pInverse = p.inverse();
          </source>
-        </p>         
+        </p>
       </subsection>
-      <subsection name="3.3 Solving linear systems" href="solve">
+      <subsection name="3.3 Real vectors" href="real_vectors">
+        <p>
+          The <a href="../apidocs/org/apache/commons/math/linear/RealVector.html">
+          RealVector</a> interface represents a vector with real numbers as 
+          entries.  The following basic matrix operations are supported:
+          <ul>
+          <li>Vector addition, subtraction</li>
+          <li>Element by element multiplication, division</li>
+          <li>Scalar addition, subtraction, multiplication, division and power</li>
+          <li>Mapping of mathematical functions (cos, sin ...)</li>
+          <li>Dot product, outer product</li>
+          <li>Distance and norm according to norms L1, L2 and Linf</li>
+          </ul>
+        </p>
+        <p>
+          The <a href="../apidocs/org/apache/commons/math/linear/RealVectorFormat.html">
+          RealVectorFormat</a> class handles input/output of vectors in a customizable
+          textual format.
+        </p>
+      </subsection>
+      <subsection name="3.4 Solving linear systems" href="solve">
         <p>
           The <code>solve()</code> methods of the <code>RealMatrix</code> interface
           support solving linear systems of equations.  In each case, the