(svn r12971) -Documentation: add @file in files that missed them and add something more than whitespace as description of files that don't have a description.

src/misc/array.hpp

@@ -1,6 +1,6 @@
 /* $Id$ */
 
-/** @file array.hpp */
+/** @file array.hpp Array without an explicit maximum size. */
 
 #ifndef  ARRAY_HPP
 #define  ARRAY_HPP

src/misc/binaryheap.hpp

@@ -1,6 +1,6 @@
 /* $Id$ */
 
-/** @file binaryheap.hpp */
+/** @file binaryheap.hpp Binary heap implementation. */
 
 #ifndef  BINARYHEAP_HPP
 #define  BINARYHEAP_HPP

src/misc/blob.hpp

@@ -1,6 +1,6 @@
 /* $Id$ */
 
-/** @file blob.hpp */
+/** @file blob.hpp Support for storing random binary data. */
 
 #ifndef BLOB_HPP
 #define BLOB_HPP

src/misc/countedobj.cpp

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file countedobj.cpp Support for reference counted objects. */
+
 #include "../stdafx.h"
 
 #include "countedptr.hpp"

src/misc/crc32.hpp

@@ -1,6 +1,6 @@
 /* $Id$ */
 
-/** @file crc32.hpp */
+/** @file crc32.hpp Cyclic reduncancy check support. */
 
 #ifndef  CRC32_HPP
 #define  CRC32_HPP

src/misc/dbg_helpers.cpp

@@ -1,6 +1,7 @@
 /* $Id$ */
 
-/** @file dbg_helpers.cpp */
+/** @file dbg_helpers.cpp Helpers for outputting debug information. */
+
 #include "../stdafx.h"
 #include "../openttd.h"
 #include "../direction_type.h"

src/misc/dbg_helpers.h

@@ -1,6 +1,6 @@
 /* $Id$ */
 
-/** @file dbg_helpers.h */
+/** @file dbg_helpers.h Functions to be used for debug printings. */
 
 #ifndef DBG_HELPERS
 #define DBG_HELPERS

src/misc/fixedsizearray.hpp

@@ -1,6 +1,6 @@
 /* $Id$ */
 
-/** @file fixedsizearray.hpp */
+/** @file fixedsizearray.hpp A fixed size array that doesn't create items until needed. */
 
 #ifndef  FIXEDSIZEARRAY_HPP
 #define  FIXEDSIZEARRAY_HPP

src/misc/hashtable.hpp

@@ -1,6 +1,6 @@
 /* $Id$ */
 
-/** @file hashtable.hpp */
+/** @file hashtable.hpp Hash table support. */
 
 #ifndef  HASHTABLE_HPP
 #define  HASHTABLE_HPP

src/misc/smallvec.h

@@ -1,6 +1,6 @@
 /* $Id$ */
 
-/* @file smallvec.h */
+/** @file smallvec.h Simple vector class that allows allocating an item without the need to copy data needlessly. */
 
 #ifndef SMALLVEC_H
 #define SMALLVEC_H

src/misc/str.hpp

@@ -1,6 +1,6 @@
 /* $Id$ */
 
-/** @file str.hpp */
+/** @file str.hpp String formating? */
 
 #ifndef  STR_HPP
 #define  STR_HPP

src/misc/strapi.hpp

@@ -1,6 +1,6 @@
 /* $Id$ */
 
-/** @file strapi.hpp */
+/** @file strapi.hpp More string formatting? */
 
 #ifndef  STRAPI_HPP
 #define  STRAPI_HPP