From 8fe33a340b8979a73fa84f201c15519a9b5d0266 Mon Sep 17 00:00:00 2001 From: Tavian Barnes Date: Sun, 14 Nov 2010 21:20:43 -0500 Subject: Document libdimension with Doxygen. --- libdimension/dimension.h | 23 +++++++++++++++++++++-- 1 file changed, 21 insertions(+), 2 deletions(-) (limited to 'libdimension/dimension.h') diff --git a/libdimension/dimension.h b/libdimension/dimension.h index 5f84054..55b3b87 100644 --- a/libdimension/dimension.h +++ b/libdimension/dimension.h @@ -18,8 +18,22 @@ * . * *************************************************************************/ -/* - * libdimension - a library for photo-realistic 3-D rendering +/** + * @file + * The main #include file for libdimension. This file declares all public + * functions and types used by the Dimension library. You should never attempt + * to include any of the component headers in the dimension/ subdirectory + * directly; only this file. + */ + +/** + * @mainpage libdimension - A library for photo-realistic 3-D rendering + * + * The Dimension library (libdimension) is the ray-tracing library that handles + * all rendering-related tasks for Dimension. It is written in C and designed + * with performance and concurrency in mind. It is also generic enough to be + * used for applications other than Dimension, though that is its primary + * purpose. */ #ifndef DIMENSION_H @@ -31,6 +45,11 @@ extern "C" { #endif /* Common types */ + +/** + * Destructor callback type. + * @param[in,out] ptr The pointer to free. + */ typedef void dmnsn_free_fn(void *ptr); /* Include all the libdimension headers */ -- cgit v1.2.3