Doxygen: we missed the plain C code

src/backend/backend.c

@@ -21,6 +21,11 @@
 * *****************************************************/
 
 
+/** @file backend.c
+ ** TODO backend.c
+ */
+
+
 #include "include/logging.h"
 #include "lib/safeclib.h"
 #include "lib/tmpbuf.h"

src/backend/backend.h

@@ -21,6 +21,11 @@
 */
 
 
+/** @file backend.h
+ ** TODO backend.h
+ */
+
+
 #ifndef BACKEND_BACKEND_H
 #define BACKEND_BACKEND_H
 

src/backend/engine/engine-config.h

@@ -21,6 +21,11 @@
 */
 
 
+/** @file engine-config.h
+ ** TODO engine-config.h
+ */
+
+
 #ifndef BACKEND_ENGINE_ENGINE_CONFIG_H
 #define BACKEND_ENGINE_ENGINE_CONFIG_H
 

src/backend/file-handling.c

@@ -21,6 +21,11 @@
 * *****************************************************/
 
 
+/** @file file-handling.c
+ ** TODO file-handling.c
+ */
+
+
 #include "include/logging.h"
 #include "lib/mutex.h"
 #include "lib/safeclib.h"

src/backend/filedescriptor.c

@@ -21,6 +21,11 @@
 * *****************************************************/
 
 
+/** @file filedescriptor.c
+ ** TODO filedescriptor.c
+ */
+
+
 #include "include/logging.h"
 #include "lib/mutex.h"
 #include "lib/safeclib.h"

src/backend/filedescriptorregistry.c

@@ -21,6 +21,11 @@
 * *****************************************************/
 
 
+/** @file filedescriptorregistry.c
+ ** TODO filedescriptorregistry.c
+ */
+
+
 #include "include/logging.h"
 #include "lib/safeclib.h"
 #include "lib/mutex.h"

src/backend/filehandle.c

@@ -21,6 +21,11 @@
 * *****************************************************/
 
 
+/** @file filehandle.c
+ ** TODO filehandle.c
+ */
+
+
 #include "include/logging.h"
 #include "lib/llist.h"
 #include "lib/safeclib.h"

src/backend/filehandlecache.c

@@ -21,6 +21,11 @@
 * *****************************************************/
 
 
+/** @file filehandlecache.c
+ ** TODO filehandlecache.c
+ */
+
+
 #include "include/logging.h"
 #include "lib/safeclib.h"
 

src/backend/fileheader.c

@@ -21,6 +21,11 @@
 * *****************************************************/
 
 
+/** @file fileheader.c
+ ** TODO fileheader.c
+ */
+
+
 #include "lib/tmpbuf.h"
 
 #include "backend/fileheader.h"

src/backend/mmap.c

@@ -21,6 +21,11 @@
 * *****************************************************/
 
 
+/** @file mmap.c
+ ** TODO mmap.c
+ */
+
+
 #include "include/logging.h"
 #include "lib/safeclib.h"
 

src/backend/mmapcache.c

@@ -21,6 +21,11 @@
 * *****************************************************/
 
 
+/** @file mmapcache.c
+ ** TODO mmapcache.c
+ */
+
+
 #include "include/logging.h"
 #include "lib/safeclib.h"
 

src/backend/mmapings.c

@@ -21,6 +21,11 @@
 * *****************************************************/
 
 
+/** @file mmapings.c
+ ** TODO mmapings.c
+ */
+
+
 #include "include/logging.h"
 #include "lib/mutex.h"
 #include "lib/safeclib.h"

src/backend/resourcecollector.c

@@ -21,6 +21,11 @@
 * *****************************************************/
 
 
+/** @file resourcecollector.c
+ ** TODO resourcecollector.c
+ */
+
+
 #include "include/logging.h"
 #include "lib/llist.h"
 #include "lib/mutex.h"

src/backend/resourcecollector.h

@@ -21,6 +21,11 @@
 */
 
 
+/** @file resourcecollector.h
+ ** TODO resourcecollector.h
+ */
+
+
 #ifndef BACKEND_RESOURCECOLLECTOR_H
 #define BACKEND_RESOURCECOLLECTOR_H
 

src/backend/threadpool.c

@@ -21,6 +21,11 @@
 * *****************************************************/
 
 
+/** @file threadpool.c
+ ** TODO threadpool.c
+ */
+
+
 #include "include/logging.h"
 #include "lib/safeclib.h"
 #include "backend/threadpool.h"

src/backend/threadpool.h

@@ -21,6 +21,11 @@
 */
 
 
+/** @file threadpool.h
+ ** TODO threadpool.h
+ */
+
+
 #ifndef BACKEND_THREADPOOL_H
 #define BACKEND_THREADPOOL_H
 

src/backend/threads.c

@@ -21,6 +21,11 @@
 * *****************************************************/
 
 
+/** @file threads.c
+ ** TODO threads.c
+ */
+
+
 #include "include/logging.h"
 #include "lib/safeclib.h"
 #include "backend/threads.h"

src/backend/threads.h

@@ -21,6 +21,11 @@
 */
 
 
+/** @file threads.h
+ ** TODO threads.h
+ */
+
+
 #ifndef BACKEND_THREADS_H
 #define BACKEND_THREADS_H
 

src/common/config-interface.c

@@ -21,6 +21,11 @@
 * *****************************************************/
 
 
+/** @file config-interface.c
+ ** TODO config-interface.c
+ */
+
+
 #include "common/config-interface.h"
 #include "common/config.h"
 

src/common/config-wordlist.c

@@ -21,6 +21,11 @@
 * *****************************************************/
 
 
+/** @file config-wordlist.c
+ ** TODO config-wordlist.c
+ */
+
+
 #include "include/logging.h"
 #include "lib/error.h"
 #include "lib/tmpbuf.h"

src/common/config.c

@@ -21,6 +21,11 @@
 * *****************************************************/
 
 
+/** @file config.c
+ ** TODO config.c
+ */
+
+
 #include "include/logging.h"
 #include "lib/safeclib.h"
 #include "lib/tmpbuf.h"

src/common/configentry.c

@@ -21,6 +21,11 @@
 * *****************************************************/
 
 
+/** @file configentry.c
+ ** TODO configentry.c
+ */
+
+
 #include "lib/safeclib.h"
 #include "common/configentry.h"
 

src/common/configentry.h

@@ -21,6 +21,11 @@
 */
 
 
+/** @file configentry.h
+ ** TODO configentry.h
+ */
+
+
 #ifndef COMMON_CONFIGENTRY_H
 #define COMMON_CONFIGENTRY_H
 

src/common/interface-descriptor.h

@@ -21,6 +21,11 @@
 */
 
 
+/** @file interface-descriptor.h
+ ** TODO interface-descriptor.h
+ */
+
+
 #ifndef COMMON_INTERFACEDESCRIPTOR_H
 #define COMMON_INTERFACEDESCRIPTOR_H
 

src/include/dummy-player-facade.h

@@ -21,6 +21,11 @@
 */
 
 
+/** @file dummy-player-facade.h
+ ** TODO dummy-player-facade.h
+ */
+
+
 #ifndef PROC_INTERFACE_DUMMYPLAYER_H
 #define PROC_INTERFACE_DUMMYPLAYER_H
 

src/include/play-facade.h

@@ -21,6 +21,11 @@
 */
 
 
+/** @file play-facade.h
+ ** TODO play-facade.h
+ */
+
+
 #ifndef PROC_INTERFACE_PLAY_H
 #define PROC_INTERFACE_PLAY_H
 

src/lib/hash-fnv.c

@@ -22,6 +22,11 @@
 * *****************************************************/
 
 
+/** @file hash-fnv.c
+ ** TODO hash-fnv.c
+ */
+
+
 #include "lib/hash-fnv.h"
 
 #include <nobug.h>

src/lib/lockerror.c

@@ -21,6 +21,11 @@
 * *****************************************************/
 
 
+/** @file lockerror.c
+ ** TODO lockerror.c
+ */
+
+
 #include "lib/lockerror.h"
 
 #include <errno.h>

src/lib/lockerror.h

@@ -19,6 +19,11 @@
   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */
 
+
+/** @file lockerror.h
+ ** TODO lockerror.h
+ */
+
 #ifndef LUMIERA_LOCKERRORS_H
 #define LUMIERA_LOCKERRORS_H
 

src/lib/luid.c

@@ -21,6 +21,11 @@
 * *****************************************************/
 
 
+/** @file luid.c
+ ** TODO luid.c
+ */
+
+
 #include "lib/luid.h"
 
 #include <sys/stat.h>

src/lib/mpool.c

@@ -19,6 +19,11 @@
   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */
 
+
+/** @file mpool.c
+ ** TODO mpool.c
+ */
+
 #include <stdlib.h>
 #include <stdio.h>
 #include <stdbool.h>

src/lib/mpool.h

@@ -19,6 +19,11 @@
   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */
 
+
+/** @file mpool.h
+ ** TODO mpool.h
+ */
+
 #include <stdint.h>
 #include <nobug.h>
 #include "lib/llist.h"

src/lib/mrucache.c

@@ -19,6 +19,11 @@
   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */
 
+
+/** @file mrucache.c
+ ** TODO mrucache.c
+ */
+
 #include "lib/safeclib.h"
 #include "lib/mrucache.h"
 

src/lib/priqueue.c

@@ -21,6 +21,11 @@
 * *****************************************************/
 
 
+/** @file priqueue.c
+ ** TODO priqueue.c
+ */
+
+
 #include "lib/priqueue.h"
 #include "include/logging.h"
 

src/lib/psplay.c

@@ -21,6 +21,11 @@
   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */
 
+
+/** @file psplay.c
+ ** TODO psplay.c
+ */
+
 #include "include/logging.h"
 #include "lib/psplay.h"
 

src/lib/safeclib.c

@@ -18,6 +18,11 @@
   along with this program; if not, write to the Free Software
   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */
+
+
+/** @file safeclib.c
+ ** TODO safeclib.c
+ */
 #include "lib/error.h"
 #include "lib/safeclib.h"
 

src/lib/sectionlock.h

@@ -19,6 +19,11 @@
   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */
 
+
+/** @file sectionlock.h
+ ** TODO sectionlock.h
+ */
+
 #ifndef LUMIERA_SECTIONLOCK_H
 #define LUMIERA_SECTIONLOCK_H
 

src/lib/tmpbuf.c

@@ -18,6 +18,11 @@
   along with this program; if not, write to the Free Software
   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */
+
+
+/** @file tmpbuf.c
+ ** TODO tmpbuf.c
+ */
 #include "lib/safeclib.h"
 #include "lib/tmpbuf.h"
 

src/tool/alsa.c

@@ -21,6 +21,11 @@
 * *****************************************************/
 
 
+/** @file alsa.c
+ ** TODO alsa.c
+ */
+
+
 #include "alsa.h"
 
 #include <alsa/asoundlib.h>

src/tool/hello.c

@@ -3,6 +3,11 @@
  *           integrated into the SCons based build system of Lumiera
  */
 
+
+/** @file hello.c
+ ** TODO hello.c
+ */
+
 #include <stdio.h>
 
 int

src/tool/main.c

@@ -21,6 +21,11 @@
 * *****************************************************/
 
 
+/** @file main.c
+ ** TODO main.c
+ */
+
+
 #include "alsa.h"
 
 #include <unistd.h>

src/tool/rsvg-convert.c

@@ -24,6 +24,11 @@
 * *****************************************************/
 
 
+/** @file rsvg-convert.c
+ ** TODO rsvg-convert.c
+ */
+
+
 #ifndef N_
 #define N_(X) X
 #endif

tests/backend/test-filedescriptors.c

@@ -20,6 +20,10 @@
 
 * *****************************************************/
 
+/** @file §§§
+ ** unit test TODO §§§
+ */
+
 
 #include "lib/safeclib.h"
 

tests/backend/test-filehandles.c

@@ -20,6 +20,10 @@
 
 * *****************************************************/
 
+/** @file §§§
+ ** unit test TODO §§§
+ */
+
 
 #include "lib/llist.h"
 #include "lib/tmpbuf.h"

tests/backend/test-fileheader.c

@@ -20,6 +20,10 @@
 
 * *****************************************************/
 
+/** @file §§§
+ ** unit test TODO §§§
+ */
+
 
 #include "backend/backend.h"
 #include "backend/fileheader.h"

tests/backend/test-filemmap.c

@@ -20,6 +20,10 @@
 
 * *****************************************************/
 
+/** @file §§§
+ ** unit test TODO §§§
+ */
+
 
 //#include <stdio.h>
 //#include <string.h>

tests/backend/test-resourcecollector.c

@@ -20,6 +20,10 @@
 
 * *****************************************************/
 
+/** @file §§§
+ ** unit test TODO §§§
+ */
+
 
 #include "backend/resourcecollector.h"
 

tests/backend/test-threadpool.c

@@ -20,6 +20,10 @@
 
 * *****************************************************/
 
+/** @file §§§
+ ** unit test TODO §§§
+ */
+
 
 #include "lib/test/test.h"
 

tests/backend/test-threads.c

@@ -20,6 +20,10 @@
 
 * *****************************************************/
 
+/** @file §§§
+ ** unit test TODO §§§
+ */
+
 
 //#include <stdio.h>
 //#include <string.h>

tests/core/application/test-configloader.c

@@ -21,6 +21,10 @@
 
 * *****************************************************/
 
+/** @file §§§
+ ** unit test TODO §§§
+ */
+
 
 #include "lib/tmpbuf.h"
 

tests/core/application/test-interfaces.c

@@ -20,6 +20,10 @@
 
 * *****************************************************/
 
+/** @file §§§
+ ** unit test TODO §§§
+ */
+
 
 #include "common/interface.h"
 #include "common/interfaceregistry.h"

tests/include/interface/say_hello.h

@@ -3,6 +3,10 @@
 /*
   one interface which can greet in different languages
 */
+
+/** @file §§§
+ ** unit test TODO §§§
+ */
 LUMIERA_INTERFACE_DECLARE (lumieraorg_testhello, 0,
                            LUMIERA_INTERFACE_SLOT (void, hello, (void)),
                            LUMIERA_INTERFACE_SLOT (void, goodbye, (const char*)),

tests/library/c-lib/test-errorstate.c

@@ -20,6 +20,10 @@
 
 * *****************************************************/
 
+/** @file §§§
+ ** unit test TODO §§§
+ */
+
 
 #include <stdio.h>
 #include <string.h>

tests/library/c-lib/test-llist.c

@@ -20,6 +20,10 @@
 
 * *****************************************************/
 
+/** @file §§§
+ ** unit test TODO §§§
+ */
+
 
 #include <nobug.h>
 

tests/library/c-lib/test-locking.c

@@ -20,6 +20,10 @@
 
 * *****************************************************/
 
+/** @file §§§
+ ** unit test TODO §§§
+ */
+
 
 #include "lib/test/test.h"
 #include "lib/mutex.h"

tests/library/c-lib/test-luid.c

@@ -20,6 +20,10 @@
 
 * *****************************************************/
 
+/** @file §§§
+ ** unit test TODO §§§
+ */
+
 
 #include "lib/luid.h"
 

tests/library/c-lib/test-mpool.c

@@ -20,6 +20,10 @@
 
 * *****************************************************/
 
+/** @file §§§
+ ** unit test TODO §§§
+ */
+
 
 #include "lib/test/test.h"
 #include "lib/mpool.h"

tests/library/c-lib/test-priqueue.c

@@ -20,6 +20,10 @@
 
 * *****************************************************/
 
+/** @file §§§
+ ** unit test TODO §§§
+ */
+
 
 #include "lib/test/test.h"
 #include "lib/priqueue.h"

tests/library/c-lib/test-psplay.c

@@ -20,6 +20,10 @@
 
 * *****************************************************/
 
+/** @file §§§
+ ** unit test TODO §§§
+ */
+
 
 #include <time.h>
 #include <stdlib.h>

tests/library/c-lib/test-safeclib.c

@@ -20,6 +20,10 @@
 
 * *****************************************************/
 
+/** @file §§§
+ ** unit test TODO §§§
+ */
+
 
 #include "lib/safeclib.h"
 #include "lib/tmpbuf.h" /* not factored out yet */

tests/library/c-lib/test-slist.c

@@ -20,6 +20,10 @@
 
 * *****************************************************/
 
+/** @file §§§
+ ** unit test TODO §§§
+ */
+
 
 #include "lib/slist.h"
 #include "lib/test/test.h"

tests/library/c-lib/test-time.c

@@ -20,6 +20,10 @@
 
 * *****************************************************/
 
+/** @file §§§
+ ** unit test TODO §§§
+ */
+
 
 #include "lib/test/test.h"
 #include "lib/time.h"

tests/plugin/test-c-plugin/example_plugin.c

@@ -20,6 +20,10 @@
 
 * *****************************************************/
 
+/** @file §§§
+ ** unit test TODO §§§
+ */
+
 
 #include <stdio.h>
 

tests/tool/vgsuppression.c

@@ -19,6 +19,10 @@
   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */
 
+/** @file §§§
+ ** unit test TODO §§§
+ */
+
 /*
   just place any problematic calls where valgrind whines about in main (with comments please)
 */