Below is the list of changes that have just been committed into a local
5.1 repository of kostja. When kostja does a push these changes will
be propagated to the main repository and, within 24 hours after the
push, to the public repository.
For information on how to access the public repository
see http://dev.mysql.com/doc/mysql/en/installing-source-tree.html
ChangeSet@stripped, 2007-08-15 19:08:44+04:00, kostja@bodhi.(none) +17 -0
Provide initial module structure to Doxygen.
sql/event_data_objects.cc@stripped, 2007-08-15 19:08:40+04:00, kostja@bodhi.(none) +8 -0
Add module comments.
sql/event_data_objects.h@stripped, 2007-08-15 19:08:40+04:00, kostja@bodhi.(none) +9 -0
Add module comments.
sql/event_db_repository.cc@stripped, 2007-08-15 19:08:40+04:00, kostja@bodhi.(none) +9 -0
Add module comments.
sql/event_db_repository.h@stripped, 2007-08-15 19:08:40+04:00, kostja@bodhi.(none) +11 -2
Add module comments.
sql/event_queue.cc@stripped, 2007-08-15 19:08:40+04:00, kostja@bodhi.(none) +8 -0
Add module comments.
sql/event_queue.h@stripped, 2007-08-15 19:08:40+04:00, kostja@bodhi.(none) +17 -0
Add module comments.
sql/event_scheduler.cc@stripped, 2007-08-15 19:08:40+04:00, kostja@bodhi.(none) +9 -0
Add module comments.
sql/event_scheduler.h@stripped, 2007-08-15 19:08:40+04:00, kostja@bodhi.(none) +15 -3
Add module comments.
sql/events.cc@stripped, 2007-08-15 19:08:40+04:00, kostja@bodhi.(none) +9 -0
Add module comments.
sql/events.h@stripped, 2007-08-15 19:08:40+04:00, kostja@bodhi.(none) +6 -3
Add module comments.
sql/lock.cc@stripped, 2007-08-15 19:08:40+04:00, kostja@bodhi.(none) +8 -1
Add module comments.
sql/sp_head.h@stripped, 2007-08-15 19:08:40+04:00, kostja@bodhi.(none) +9 -0
Add module comments.
sql/sql_base.cc@stripped, 2007-08-15 19:08:40+04:00, kostja@bodhi.(none) +7 -0
Add module comments.
sql/sql_lex.h@stripped, 2007-08-15 19:08:41+04:00, kostja@bodhi.(none) +7 -0
Add module comments.
sql/sql_parse.cc@stripped, 2007-08-15 19:08:41+04:00, kostja@bodhi.(none) +9 -0
Add module comments.
sql/sql_select.cc@stripped, 2007-08-15 19:08:41+04:00, kostja@bodhi.(none) +8 -0
Add module comments.
sql/sql_yacc.yy@stripped, 2007-08-15 19:08:41+04:00, kostja@bodhi.(none) +8 -0
Add module comments.
diff -Nrup a/sql/event_data_objects.cc b/sql/event_data_objects.cc
--- a/sql/event_data_objects.cc 2007-08-02 08:50:52 +04:00
+++ b/sql/event_data_objects.cc 2007-08-15 19:08:40 +04:00
@@ -20,6 +20,10 @@
#include "event_db_repository.h"
#include "sp_head.h"
+/**
+ @addtogroup Event_Scheduler
+ @{
+*/
#define EVEX_MAX_INTERVAL_VALUE 1000000000L
@@ -2082,3 +2086,7 @@ event_basic_identifier_equal(LEX_STRING
return !sortcmp_lex_string(name, b->name, system_charset_info) &&
!sortcmp_lex_string(db, b->dbname, system_charset_info);
}
+
+/**
+ @} (End of group Event_Scheduler)
+*/
diff -Nrup a/sql/event_data_objects.h b/sql/event_data_objects.h
--- a/sql/event_data_objects.h 2007-06-28 21:34:48 +04:00
+++ b/sql/event_data_objects.h 2007-08-15 19:08:40 +04:00
@@ -15,6 +15,12 @@
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */
+/**
+ @addtogroup Event_Scheduler
+ @{
+
+ @file event_data_objects.h
+*/
#define EVEX_GET_FIELD_FAILED -2
#define EVEX_BAD_PARAMS -5
@@ -280,5 +286,8 @@ event_basic_db_equal(LEX_STRING db, Even
bool
event_basic_identifier_equal(LEX_STRING db, LEX_STRING name, Event_basic *b);
+/**
+ @} (End of group Event_Scheduler)
+*/
#endif /* _EVENT_DATA_OBJECTS_H_ */
diff -Nrup a/sql/event_db_repository.cc b/sql/event_db_repository.cc
--- a/sql/event_db_repository.cc 2007-08-15 17:42:54 +04:00
+++ b/sql/event_db_repository.cc 2007-08-15 19:08:40 +04:00
@@ -20,6 +20,11 @@
#include "events.h"
#include "sql_show.h"
+/**
+ @addtogroup Event_Scheduler
+ @{
+*/
+
static
const TABLE_FIELD_W_TYPE event_table_fields[ET_FIELD_COUNT] =
{
@@ -1112,3 +1117,7 @@ Event_db_repository::check_system_tables
DBUG_RETURN(test(ret));
}
+
+/**
+ @} (End of group Event_Scheduler)
+*/
diff -Nrup a/sql/event_db_repository.h b/sql/event_db_repository.h
--- a/sql/event_db_repository.h 2007-06-28 21:34:48 +04:00
+++ b/sql/event_db_repository.h 2007-08-15 19:08:40 +04:00
@@ -15,8 +15,14 @@
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */
-/*
- @file
+/**
+ @addtogroup Event_Scheduler
+ @{
+
+ @file event_db_repository.h
+
+ Data Dictionary related operations of Event Scheduler.
+
This is a private header file of Events module. Please do not include it
directly. All public declarations of Events module should be stored in
events.h and event_data_objects.h.
@@ -119,4 +125,7 @@ private:
void operator=(Event_db_repository &);
};
+/**
+ @} (End of group Event_Scheduler)
+*/
#endif /* _EVENT_DB_REPOSITORY_H_ */
diff -Nrup a/sql/event_queue.cc b/sql/event_queue.cc
--- a/sql/event_queue.cc 2007-08-02 08:50:52 +04:00
+++ b/sql/event_queue.cc 2007-08-15 19:08:40 +04:00
@@ -17,6 +17,10 @@
#include "event_queue.h"
#include "event_data_objects.h"
+/**
+ @addtogroup Event_Scheduler
+ @{
+*/
#define EVENT_QUEUE_INITIAL_SIZE 30
#define EVENT_QUEUE_EXTENT 30
@@ -749,3 +753,7 @@ Event_queue::dump_internal_status()
DBUG_VOID_RETURN;
}
+
+/**
+ @} (End of group Event_Scheduler)
+*/
diff -Nrup a/sql/event_queue.h b/sql/event_queue.h
--- a/sql/event_queue.h 2007-05-21 12:49:51 +04:00
+++ b/sql/event_queue.h 2007-08-15 19:08:40 +04:00
@@ -15,12 +15,26 @@
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */
+/**
+
+ @addtogroup Event_Scheduler
+ @{
+
+ @file event_queue.h
+
+ Queue of events awaiting execution.
+*/
+
class Event_basic;
class Event_queue_element;
class Event_queue_element_for_exec;
class THD;
+/**
+ Queue of active events awaiting execution.
+*/
+
class Event_queue
{
public:
@@ -105,5 +119,8 @@ private:
bool mutex_queue_data_attempting_lock;
bool waiting_on_cond;
};
+/**
+ @} (End of group Event_Scheduler)
+*/
#endif /* _EVENT_QUEUE_H_ */
diff -Nrup a/sql/event_scheduler.cc b/sql/event_scheduler.cc
--- a/sql/event_scheduler.cc 2007-07-30 12:33:43 +04:00
+++ b/sql/event_scheduler.cc 2007-08-15 19:08:40 +04:00
@@ -20,6 +20,11 @@
#include "event_queue.h"
#include "event_db_repository.h"
+/**
+ @addtogroup Event_Scheduler
+ @{
+*/
+
#ifdef __GNUC__
#if __GNUC__ >= 2
#define SCHED_FUNC __FUNCTION__
@@ -790,3 +795,7 @@ Event_scheduler::dump_internal_status()
DBUG_VOID_RETURN;
}
+
+/**
+ @} (End of group Event_Scheduler)
+*/
diff -Nrup a/sql/event_scheduler.h b/sql/event_scheduler.h
--- a/sql/event_scheduler.h 2007-05-21 12:49:51 +04:00
+++ b/sql/event_scheduler.h 2007-08-15 19:08:40 +04:00
@@ -16,10 +16,18 @@
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */
/**
+ @addtogroup Event_Scheduler
+ @{
+*/
+/**
@file
- This file is internal to Events module. Please do not include it directly.
- All public declarations of Events module are in events.h and
- event_data_objects.h.
+
+ Declarations of the scheduler thread class
+ and related functionality.
+
+ This file is internal to Event_Scheduler module. Please do not
+ include it directly. All public declarations of Event_Scheduler
+ module are in events.h and event_data_objects.h.
*/
@@ -139,5 +147,9 @@ private:
Event_scheduler(const Event_scheduler &);
void operator=(Event_scheduler &);
};
+
+/**
+ @} (End of group Event_Scheduler)
+*/
#endif /* _EVENT_SCHEDULER_H_ */
diff -Nrup a/sql/events.cc b/sql/events.cc
--- a/sql/events.cc 2007-08-15 17:42:54 +04:00
+++ b/sql/events.cc 2007-08-15 19:08:40 +04:00
@@ -21,6 +21,11 @@
#include "event_scheduler.h"
#include "sp_head.h" // for Stored_program_creation_ctx
+/**
+ @addtogroup Event_Scheduler
+ @{
+*/
+
/*
TODO list :
- CREATE EVENT should not go into binary log! Does it now? The SQL statements
@@ -1186,3 +1191,7 @@ end:
DBUG_RETURN(ret);
}
+
+/**
+ @} (End of group Event_Scheduler)
+*/
diff -Nrup a/sql/events.h b/sql/events.h
--- a/sql/events.h 2007-08-15 17:42:54 +04:00
+++ b/sql/events.h 2007-08-15 19:08:40 +04:00
@@ -16,10 +16,13 @@
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */
/**
- @file
- A public interface of Events Scheduler module.
- @defgroup Event Scheduler
+ @defgroup Event_Scheduler Event Scheduler
+ @ingroup Runtime_Environment
@{
+
+ @file events.h
+
+ A public interface of Events_Scheduler module.
*/
class Event_parse_data;
diff -Nrup a/sql/lock.cc b/sql/lock.cc
--- a/sql/lock.cc 2007-08-15 17:42:56 +04:00
+++ b/sql/lock.cc 2007-08-15 19:08:40 +04:00
@@ -74,6 +74,11 @@ TODO:
#include <hash.h>
#include <assert.h>
+/**
+ @defgroup Locking Locking
+ @{
+*/
+
extern HASH open_cache;
/* flags for get_lock_data */
@@ -1590,4 +1595,6 @@ void broadcast_refresh(void)
VOID(pthread_cond_broadcast(&COND_global_read_lock));
}
-
+/**
+ @} (end of group Locking)
+*/
diff -Nrup a/sql/sp_head.h b/sql/sp_head.h
--- a/sql/sp_head.h 2007-08-15 17:42:56 +04:00
+++ b/sql/sp_head.h 2007-08-15 19:08:40 +04:00
@@ -23,6 +23,11 @@
#include <stddef.h>
+/**
+ @defgroup Stored_Routines Stored Routines
+ @ingroup Runtime_Environment
+ @{
+*/
// Values for the type enum. This reflects the order of the enum declaration
// in the CREATE TABLE command.
#define TYPE_ENUM_FUNCTION 1
@@ -1321,5 +1326,9 @@ sp_prepare_func_item(THD* thd, Item **it
bool
sp_eval_expr(THD *thd, Field *result_field, Item **expr_item_ptr);
+
+/**
+ @} (end of group Stored_Routines)
+*/
#endif /* _SP_HEAD_H_ */
diff -Nrup a/sql/sql_base.cc b/sql/sql_base.cc
--- a/sql/sql_base.cc 2007-08-15 17:42:58 +04:00
+++ b/sql/sql_base.cc 2007-08-15 19:08:40 +04:00
@@ -82,6 +82,10 @@ bool Prelock_error_handler::safely_trapp
return ((m_handled_errors > 0) && (m_unhandled_errors == 0));
}
+/**
+ @defgroup Data_Dictionary Data Dictionary
+ @{
+*/
TABLE *unused_tables; /* Used by mysql_test */
HASH open_cache; /* Used by mysql_test */
@@ -7802,3 +7806,6 @@ void close_performance_schema_table(THD
thd->restore_backup_open_tables_state(backup);
}
+/**
+ @} (end of group Data_Dictionary)
+*/
diff -Nrup a/sql/sql_lex.h b/sql/sql_lex.h
--- a/sql/sql_lex.h 2007-08-15 17:42:58 +04:00
+++ b/sql/sql_lex.h 2007-08-15 19:08:41 +04:00
@@ -13,6 +13,9 @@
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */
+/**
+ @defgroup Semantic_Analysis Semantic Analysis
+*/
/* YACC and LEX Definitions */
@@ -1822,5 +1825,9 @@ extern int MYSQLlex(void *arg, void *yyt
extern void trim_whitespace(CHARSET_INFO *cs, LEX_STRING *str);
extern bool is_lex_native_function(const LEX_STRING *name);
+
+/**
+ @} (End of group Semantic_Analysis)
+*/
#endif /* MYSQL_SERVER */
diff -Nrup a/sql/sql_parse.cc b/sql/sql_parse.cc
--- a/sql/sql_parse.cc 2007-08-15 17:42:59 +04:00
+++ b/sql/sql_parse.cc 2007-08-15 19:08:41 +04:00
@@ -28,6 +28,11 @@
#include "events.h"
#include "sql_trigger.h"
+/**
+ @defgroup Runtime_Environment Runtime Environment
+ @{
+*/
+
/* Used in error handling only */
#define SP_TYPE_STRING(LP) \
((LP)->sphead->m_type == TYPE_ENUM_FUNCTION ? "FUNCTION" : "PROCEDURE")
@@ -7242,3 +7247,7 @@ bool parse_sql(THD *thd,
return err_status;
}
+
+/**
+ @} (end of group Runtime_Environment)
+*/
diff -Nrup a/sql/sql_select.cc b/sql/sql_select.cc
--- a/sql/sql_select.cc 2007-08-03 19:15:20 +04:00
+++ b/sql/sql_select.cc 2007-08-15 19:08:41 +04:00
@@ -13,6 +13,10 @@
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */
+/**
+ @defgroup Query_Optimizer Query Optimizer
+ @{
+*/
/* mysql_select and join optimization */
@@ -16037,3 +16041,7 @@ bool JOIN::change_result(select_result *
}
DBUG_RETURN(FALSE);
}
+
+/**
+ @} (end of group Query_Optimizer)
+*/
diff -Nrup a/sql/sql_yacc.yy b/sql/sql_yacc.yy
--- a/sql/sql_yacc.yy 2007-08-15 06:31:01 +04:00
+++ b/sql/sql_yacc.yy 2007-08-15 19:08:41 +04:00
@@ -15,6 +15,11 @@
/* sql_yacc.yy */
+/**
+ @defgroup Parser Parser
+ @{
+*/
+
%{
/* thd is passed as an argument to yyparse(), and subsequently to yylex().
** The type will be void*, so it must be cast to (THD*) when used.
@@ -12255,3 +12260,6 @@ uninstall:
}
;
+/**
+ @} (end of group Parser)
+*/
| Thread |
|---|
| • bk commit into 5.1 tree (kostja:1.2568) | konstantin | 15 Aug |