Llewellyn/conky
1
0
Fork 0
mirror of https://github.com/Llewellynvdm/conky.git synced 2025-01-02 22:40:14 +00:00
Code Issues Releases Activity

Add some comments to explain how things work

Browse Source
This commit is contained in:
Pavel Labath 2010-02-16 12:32:53 +01:00
parent ad6707fac9
commit 5b743293da
2 changed files with 16 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
src/data-source.cc
View File

@ -38,6 +38,8 @@ namespace conky {
*/ */
float NaN = std::numeric_limits<float>::quiet_NaN(); float NaN = std::numeric_limits<float>::quiet_NaN();
typedef std::unordered_map<std::string, lua::cpp_function> data_sources_t;
/* /*
* We cannot construct this object statically, because order of object construction in * We cannot construct this object statically, because order of object construction in
* different modules is not defined, so register_source could be called before this * different modules is not defined, so register_source could be called before this

21
src/data-source.hh
View File

@ -58,9 +58,10 @@ namespace conky {
}; };
/* /*
* A simple data source that returns the value of some variable. * A simple data source that returns the value of some variable. It ignores the lua table.
* It ignores the lua table, but one can create a wrapper for the factory function that uses * The source variable can be specified as a fixed parameter to the register_data_source
* data in the table to decide which variable to return. * constructor, or one can create a subclass and then set the source from the subclass
* constructor.
*/ */
template<typename T> template<typename T>
class simple_numeric_source: public data_source_base { class simple_numeric_source: public data_source_base {
@ -76,6 +77,10 @@ namespace conky {
{ return *source; } { return *source; }
}; };
/*
* This is a part of the implementation, but it cannot be in .cc file because the template
* functions below call it
*/
namespace priv { namespace priv {
const char data_source_metatable[] = "conky::data_source_metatable"; const char data_source_metatable[] = "conky::data_source_metatable";
@ -90,8 +95,8 @@ namespace conky {
} }
/* /*
* Declaring an object of this type at global scope will register a data source with the give * Declaring an object of this type at global scope will register a data source with the
* name and factory function. * given name. Any additional parameters are passed on to the data source constructor.
*/ */
template<typename T> template<typename T>
class register_data_source { class register_data_source {
@ -128,8 +133,10 @@ namespace conky {
register_disabled_data_source(const std::string &name, const std::string &setting); register_disabled_data_source(const std::string &name, const std::string &setting);
}; };
typedef std::unordered_map<std::string, lua::cpp_function> data_sources_t; /*
* It expects to have a table at the top of lua stack. It then exports all the data sources
* into that table (actually, into a "variables" subtable).
*/
void export_data_sources(lua::state &l); void export_data_sources(lua::state &l);
} }