[Write complete documentation for a generic sort routine that sorts Vectors.]

1. the method signature (name, parameters, return type);

public vector genericVectorSort(vector vec, String typeofsort)
{
}//genericVectorSort

2.  a one- or two-sentence summary of the purpose;

genericVectorSort will take in a vector and the type of sort a person would like to have genericVectorSort apply to that vector and then sort it accordingly.  (were this ACTUALLY being programmed I would assume this as the system with cases, one case for each kind of sort).  

3.   any preconditions, stated as formally as you can;
Preconditions:
genericVectorSort is a non-null non-empty vector containing elements that are all of the same type. (comparing 1 with say a, doesn't work as well for sorting).
[perhaps only in the version that I have created:] typeofsort must be a sort method that has already been defined in the program.

4.  any postconditions, stated as formally as you can;
Postconditions:
a new vector is created and returned with all the elements of the old vector sorted in the appropriate order.  

5.  an indication of exceptions that you throw.
EmptyVector (exception)
InvalidTypes (exception)
[InvalidTypes would stop the program from running if there was no way to compare the objects inside of the vector with eachother]