From d73750d4032cc6768f10f2778846d367f3360196 Mon Sep 17 00:00:00 2001
From: mquinson <mquinson@48e7efb5-ca39-0410-a469-dd3cf9ba447f>
Date: Mon, 7 Feb 2005 17:04:49 +0000
Subject: [PATCH] Do not document the crude internals of logs with the user
 interface

git-svn-id: svn+ssh://scm.gforge.inria.fr/svn/simgrid/simgrid/trunk@892 48e7efb5-ca39-0410-a469-dd3cf9ba447f
---
 include/xbt/log.h | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/include/xbt/log.h b/include/xbt/log.h
index 1bd156f4b6..0de57388f1 100644
--- a/include/xbt/log.h
+++ b/include/xbt/log.h
@@ -40,17 +40,17 @@ typedef enum {
 } e_xbt_log_priority_t;
 	      
 
-/**
- * \define NLOG
- *
- * \note All logging facilities are disabled at compilation time
+/*
+ * define NLOG to disable at compilation time any logging request
+ * define NDEBUG to disable at compilation time any logging request of priority below INFO
  */
 
 
 /**
- * XBT_LOG_STATIC_THRESHOLD:
+ * \def XBT_LOG_STATIC_THRESHOLD:
+ * \ingroup XBT_log
  *
- * All logging with priority < XBT_LOG_STATIC_THRESHOLD is disabled at
+ * All logging requests with priority < XBT_LOG_STATIC_THRESHOLD are disabled at
  * compile time, i.e., compiled out.
  */
 #ifdef NLOG
@@ -158,7 +158,7 @@ typedef struct xbt_log_appender_s s_xbt_log_appender_t,*xbt_log_appender_t;
 typedef struct xbt_log_event_s    s_xbt_log_event_t,   *xbt_log_event_t;
 typedef struct xbt_log_category_s s_xbt_log_category_t,*xbt_log_category_t;
 
-/**
+/*
  * Do NOT access any members of this structure directly. FIXME: move to private?
  */
 struct xbt_log_category_s {
@@ -189,7 +189,7 @@ struct xbt_log_event_s {
 };
 
 /**
- * \ingroup XBT_log  
+ * \ingroup XBT_log_implem
  * \param cat the category (not only its name, but the variable)
  * \param thresholdPriority the priority
  *
@@ -199,7 +199,7 @@ extern void xbt_log_threshold_set(xbt_log_category_t cat,
 				   e_xbt_log_priority_t thresholdPriority);
 
 /**
- * \ingroup XBT_log  
+ * \ingroup XBT_log_implem  
  * \param cat the category (not only its name, but the variable)
  * \param parent the parent cat
  *
@@ -209,7 +209,7 @@ extern void xbt_log_parent_set(xbt_log_category_t cat,
 				xbt_log_category_t parent);
 
 /**
- * \ingroup XBT_log  
+ * \ingroup XBT_log_implem  
  * \param cat the category (not only its name, but the variable)
  * \param app the appender
  *
-- 
2.20.1