#193 Standardised file description comment

[Vidar Hasfjord]

I propose updating all of our source code to use a standardised file description comment, using the Doxygen \file tag and description, followed by copyright notices and a reference to our license details.

I made this change in Owlet [r2173] a long time ago. As for the main OWLNext source code, all my files contributed to the project, as well as some of the major refactoring I have done in existing files, use this file description comment as well.

I propose that all new source code files contributed to the project use this standardised file description comment, and that this is prescribed in our Coding Standards.

//
/// \file
/// <description>
//
// Part of OWLNext - the next generation Object Windows Library
// <copyright notices>
//
// For more information, including license details, see
// https://sourceforge.net/projects/owlnext
//

Note: If you take on this ticket and make the effort to update existing files, be careful not to remove copyright notices or any terms included by the copyright holders (unless they have given permission, of course).

[Vidar Hasfjord]

A section with this recommendation has now been added in our documentation guidelines.