summaryrefslogtreecommitdiff
path: root/doc/README.logging
diff options
context:
space:
mode:
authorMichael Roitzsch <mroi@users.sourceforge.net>2003-10-12 19:07:40 +0000
committerMichael Roitzsch <mroi@users.sourceforge.net>2003-10-12 19:07:40 +0000
commit1419e22bf73986d239e5b0ad2f06c32886bdd5c9 (patch)
tree76c8cdce777b20a8b1f7c25799070ed3ef59eab5 /doc/README.logging
parent60239a297dd0e7a6454dbd15de9d0186dea93c14 (diff)
downloadxine-lib-1419e22bf73986d239e5b0ad2f06c32886bdd5c9.tar.gz
xine-lib-1419e22bf73986d239e5b0ad2f06c32886bdd5c9.tar.bz2
* removed READMEs which are now part of the hackersguide
* some small updates CVS patchset: 5495 CVS date: 2003/10/12 19:07:40
Diffstat (limited to 'doc/README.logging')
-rw-r--r--doc/README.logging76
1 files changed, 0 insertions, 76 deletions
diff --git a/doc/README.logging b/doc/README.logging
deleted file mode 100644
index 145207252..000000000
--- a/doc/README.logging
+++ /dev/null
@@ -1,76 +0,0 @@
-The xine logging system
-=======================
-
-xine offers a wide range of possibilities to display
-strings. This document should describe when to use
-which way and how to do it right.
-
-
-xine_log
---------
-Output which is done thru this function will be
-displayed by the frontend. It can not be disabled.
-If xine->verbosity is not 0 the messages will also
-be displayed on the console. Often these strings
-are translated.
-This function is for information which the user should
-read always.
-
-usage: xine_log(xine_t *xine, int buf, const char *format, ...);
- -buf is either XINE_LOG_MSG for general messages or
- XINE_LOG_PLUGIN for messages about plugins.
-
-
-xprintf
--------
-This macro uses the xine->verbosity value to decide
-if the string should be printed to the console. Possible
-values are XINE_VERBOSITY_NONE, XINE_VERBOSITY_LOG or
-XINE_VERBOSITY_DEBUG. By default nothing is printed.
-When you use xine-ui you can enable this output with
-the --verbose=[1,2] options.
-This function should be used for information which the
-user should only read up on request.
-
-usage: xprintf(xine_t *xine, int verbosity, const char *format, ...);
-
-
-lprintf/llprintf
-----------------
-These macros are for debugging purpose only. Under normal
-circumstances it is disabled. And can only be enabled by changing
-a define statement and a recompilation. It has to be enabled for these
-files that are of interest.
-It should only be use for information which is intended for developers.
-
-usage: lprintf(const char *format, ...);
- llprintf(cat , const char *format, ...);
- where cat is a flag which enables or disables this logging.
-
-
--lprintf can be enabled by defining LOG at the top of the source file:
-#define LOG
-
--llprintf can used for more than one categorie per file by using diffent lables:
-#define LOG_LOAD 1
-#define LOG_SAVE 0
-
-llprintf(LOG_LOAD, "loading was successful\n");
-llprintf(LOG_SAVE, "could not save to file %s\n", filename);
-
-in this case only hte first messages is printed. To enable/disable change the
-defines.
-
--LOG_MODULE should be used to set the modulename for xprintf/lprintf/llprintf.
-Each output line starts with "modulename: ":
-#define LOG_MODULE "modulename"
-
--LOG_VERBOSE should be set to enable the logging of functionname and linenumbers:
-#define LOG_VERBOSE
-
-then the output will be:
-modulename: (function_name:42) message
-
-
-
-