From 003caf1d7fdf6467b0bc41ffefeca0dc8ec0ffb8 Mon Sep 17 00:00:00 2001 From: Tavian Barnes Date: Tue, 30 Nov 2010 01:38:53 -0500 Subject: Add docs to platform.h. --- libdimension/platform.h | 21 +++++++++++++++++---- 1 file changed, 17 insertions(+), 4 deletions(-) (limited to 'libdimension/platform.h') diff --git a/libdimension/platform.h b/libdimension/platform.h index a339ced..fbf467b 100644 --- a/libdimension/platform.h +++ b/libdimension/platform.h @@ -30,16 +30,29 @@ #include #include -/* Provide a stack trace if possible */ +/** + * Print a stack trace, if implemented for the current platform. + * @param[in,out] file The file to which to write the stack trace. + */ void dmnsn_backtrace(FILE *file); -/* Return whether this is the main execution thread, if we can tell */ +/** + * Is the calling thread the main thread? + * @return Whether this is the main execution thread, or \c true if we can't + * tell. + */ bool dmnsn_is_main_thread(void); -/* Return true if we are little-endian */ +/** + * Are we running on a little-endian computer? + * @return Whether the current architecture is little-endian. + */ bool dmnsn_is_little_endian(void); -/* Return the number of CPUs available to dimension */ +/** + * How many CPUs are available? + * @return The number of CPUs available to dimension. + */ size_t dmnsn_ncpus(void); #endif /* DIMENSION_IMPL_PLATFORM_H */ -- cgit v1.2.3