----------------------------------------------------------------
lines 235-275 of file: include/cppad/example/valvector/class.hpp
----------------------------------------------------------------

   {xrst_begin valvector_resize}
   {xrst_spell
      valvectors
   }

   Resize a valvector
   ##################
   Sets the size of this valvector.

   Prototype
   *********
   {xrst_literal ,
      // BEGIN_RESIZE , // END_RESIZE
   }

   Use
   ***
   This size of a valvector directly after its
   :ref:`constructor<valvector_ctor-name>` is always one.
   This function must be used to create valvectors with other sizes.

   n
   *
   The argument *n* must not be zero and specifies the number of elements
   in the valvector.

   Element Values
   **************
   Directly after this operation,
   none of the element values are specified.

   {xrst_toc_hidden
      example/valvector/resize.cpp
   }
   Example
   =======
   The file :ref:`valvector_resize.cpp-name` is an example and test of
   valvector resize.


   {xrst_end valvector_resize}