   Doxygen, C++ and namespaces
  When documenting (C++) code using Doxygen what and where would be a/the common/correct way to go about documenting a namespace? They're particularly problematic because they're split across multiple files. I can't seem to find a satisfactory answer on Google which usually suggests that I'm either using the wrong search terms or I'm missing something blindingly obvious [rolleyes].   