//
//-----------------------------------------------------------------------------
// function : block_indirect_sort
-/// @brief parallel sample sort algorithm (stable sort)
+/// @brief invocation of block_indirtect_sort with 2 parameters
///
/// @param first : iterator to the first element of the range to sort
/// @param last : iterator after the last element to the range to sort
//
//-----------------------------------------------------------------------------
// function : block_indirect_sort
-/// @brief parallel sample sort algorithm (stable sort)
+/// @brief invocation of block_indirtect_sort with 3 parameters. The third is
+/// the number of threads
///
/// @param first : iterator to the first element of the range to sort
/// @param last : iterator after the last element to the range to sort
//
//-----------------------------------------------------------------------------
// function : block_indirect_sort
-/// @brief parallel sample sort algorithm (stable sort)
+/// @brief invocation of block_indirtect_sort with 3 parameters. The third is
+/// the comparison object
///
/// @param first : iterator to the first element of the range to sort
/// @param last : iterator after the last element to the range to sort
//
//-----------------------------------------------------------------------------
// function : block_indirect_sort
-/// @brief parallel sample sort algorithm (stable sort)
+/// @brief invocation of block_indirtect_sort with 4 parameters.
///
/// @param first : iterator to the first element of the range to sort
/// @param last : iterator after the last element to the range to sort