[MPlayer-G2-dev] CVS: g2/DOCS cfg.txt,1.2,1.3
Diego Biurrun CVS
syncmail at mplayerhq.hu
Tue Feb 3 00:36:23 CET 2004
CVS change done by Diego Biurrun CVS
Update of /cvsroot/mplayer/g2/DOCS
In directory mail:/var2/tmp/cvs-serv15966
Modified Files:
cfg.txt
Log Message:
spelling cosmetics
Index: cfg.txt
===================================================================
RCS file: /cvsroot/mplayer/g2/DOCS/cfg.txt,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- cfg.txt 1 Feb 2004 00:04:50 -0000 1.2
+++ cfg.txt 2 Feb 2004 23:36:21 -0000 1.3
@@ -12,7 +12,7 @@
unsigned short type, version; // for loadable plugins
void *entry; // pointer to module entry point (xxx_open() or xxx_functions_t*)
char *name;
- char *desc; // short description for commandline help and gui
+ char *desc; // short description for command line help and GUI
char *maintainer;
char *author;
char *comment;
@@ -24,7 +24,7 @@
Yes, it looks like the *_info_t of g1's plugins. No wonder, it is that.
The difference is that in g2 not only actual plugins have such description,
-but core layers (like libdemux etc) and even the main application too.
+but core layers (like libdemux etc) and even the main application, too.
Config handler and parser functions receive info in this module_info_t struct.
So, look at this struct a bit closer:
@@ -33,13 +33,13 @@
int config_size;
In g2, modules may have their own dynamically allocated config data structure.
-It means: no more globals! yeah. Of course globals can be used, too.
+It means: no more globals! Yeah. Of course globals can be used, too.
The implementation of per-module dynamic config is the following:
A module (be it core layer or a plugin) will define its own config_data_t
-structure, containing its configuration variables. It can (optinally)
+structure, containing its configuration variables. It can (optionally)
define a set of default values, in the layout of config_data_t.
Then it will define a config_t array, describing each option, with pointers
-into the config_data_t struct. It's a bit tricky: if you have config_defaults,
+into the config_data_t struct. It's a bit tricky: If you have config_defaults,
your pointers should point into that. If you don't have defaults, your pointers
will be struct offsets (NULL-based pointers).
@@ -73,24 +73,24 @@
};
What if I leave/ignore some of these fields?
-- if config_size>0 then config_data will be dynamically allocated,
+- If config_size>0 then config_data will be dynamically allocated,
otherwise all options (in config_t array) are handled as globals,
with absolute pointers.
-- if config_defaults!=NULL, then config_data will be cloned from it,
+- If config_defaults!=NULL, then config_data will be cloned from it,
instead of allocating zero-filled memory.
- option pointers targetting inside the config_defaults struct will be
+ Option pointers targetting inside the config_defaults struct will be
handled as dynamic variables (relocated to cloned config_data), others
will be handled as globals.
-- if config_defaults==NULL and config_size>0, then pointers will be handled
+- If config_defaults==NULL and config_size>0, then pointers will be handled
as struct offsets relative to the start of config_data_s structure.
- In this case you should use macros like ST_OFF() (from mplayer g1) or
+ In this case you should use macros like ST_OFF() (from MPlayer g1) or
do it by hand: &( ((struct config_data_s*)NULL)->field )
Config layers:
~~~~~~~~~~~~~~
-The new config code is layered by functionality and dependancy:
+The new config code is layered by functionality and dependency:
-layer #0 is actually cfg.h and a small cfg-l0.c containing helper functions
+Layer #0 is actually cfg.h and a small cfg-l0.c containing helper functions
to work with the cfg.h structs.
It includes 2 functions:
@@ -103,17 +103,12 @@
the module's defaults) or the user-supplied base (config_data_t* def).
The later can be used for configtree/playtree implementation, when a given
module inherits non-default config from a previous layer. 'def' may be NULL!
-Normally this function should be called only once (per url/file) by the app
+Normally this function should be called only once (per URL/file) by the app
for only the top level module, assuming it has references (CONF_TYPE_MODULE
or _MODLIST) to all other modules.
-layer #1 is the place for the string<->conf_type parsers/converters.
+Layer #1 is the place for the string<->conf_type parsers/converters.
Currently it includes functions for string->conf_type conversion (parsing),
-an complete option parsing handler (including option serach and
+a complete option parsing handler (including option search and
CONF_TYPE_MODULE recursion), and a subconfig-compatible syntax parser
(already used for CONF_TYPE_MODLIST).
-
-
-
-
-
More information about the MPlayer-G2-dev
mailing list