/// a brief description
/** \brief first part of brief desicription * brief description continued * * longer description, details, if you like... * \author your name * \param x description of \a x * \pre a precondition * \post a postcondition * \remarks some remarks, e.g., time complexity O(n^2) * \return a number */