Entities that are members of classes are only documented if their class is documented. Entities declared at namespace scope are only documented if their namespace is documented. Entities declared at file scope are only documented if their file is documented.
So to document a free function in the global namespace you also need a line like this somewhere in the header file in which it is declared:
/** @file */
Or like this:
/*! \file */