doxygen fix

[edwardhartnett]

Part of #15

Convert one function to explore use of brief tag. It's needed at the file level, but not at the subroutine level.

[edwardhartnett]

With this, I see the description in the file list:

[edwardhartnett]

One problem (?) is that a separate brief tag is needed for file and subprogram. Normally this makes sense because one file holds multiple subprograms. So the file level one summarizes what's in the file, and each subprogram summarizes what's in the subprogram.

But in this case there is one subprogram per file...

[jbathegit]

Yeah, I thought about that too, but what I'm going to do for this is to have a slightly more general description at the file level vs. at the subprogram level, the idea being that when everything's displayed in "Files" we want the user to be able to quickly determine where they need to drill down to find what they're looking for. Hopefully you'll see what I mean when I submit my next PR ;-)

[jbathegit]

Thanks for playing around with this to help figure this out!

[edwardhartnett]

I do agree that the list of files looks much nicer and more useful when each file has a brief description next to it.