added comment

Author: brianfelder

cachematrix.R

@@ -1,8 +1,10 @@
-## Put comments here that give an overall description of what your
-## functions do
-
-## Write a short comment describing this function
+## Handles inversion of a matrix, where the matrix inversion must be
+## performed only once, then is cached.
 
+## Make a matrix where the inverse of the matrix is cached
+## Parameters:
+##     x: any matrix. Assuming here that it is invertable.
+## Return: a matrix with methods for caching the inverse of the matrix.
 makeCacheMatrix <- function(x = matrix()) {
   inverse <- NULL
   set <- function(y) {