X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=CONTRIBUTING.adoc;h=bc6ff471ec403e22e6f2e1698ed35211eedee2f2;hb=0675eb8c07c440a4d3811ddc95001cc129a9dc17;hp=265d088e92d130bf884c202fe1099fca235e64e5;hpb=b81626f99715af53bcd982638c74a6281f883289;p=babeltrace.git diff --git a/CONTRIBUTING.adoc b/CONTRIBUTING.adoc index 265d088e..bc6ff471 100644 --- a/CONTRIBUTING.adoc +++ b/CONTRIBUTING.adoc @@ -69,9 +69,9 @@ node of the graph keeps all other reachable nodes alive. The scheme employed in Babeltrace to break this cycle consists in the "children" holding *reverse component references* to their parents. That -is, in the context of CTF IR, that event classes hold a reference to -their parent stream class and stream classes hold a reference to their -parent trace. +is, in the context of the trace IR, that event classes hold a reference +to their parent stream class and stream classes hold a reference to +their parent trace. On the other hand, parents hold *claiming aggregation references* to their children. A claiming aggregation reference means that the object @@ -613,8 +613,8 @@ the environment variable and sets the log level symbol accordingly. -- [source,c] ---- -#ifndef MY_MODULE_LOGGING_H -#define MY_MODULE_LOGGING_H +#ifndef BABELTRACE_MY_MODULE_LOGGING_H +#define BABELTRACE_MY_MODULE_LOGGING_H /* * Copyright (c) 2017 EfficiOS Inc. @@ -643,7 +643,7 @@ the environment variable and sets the log level symbol accordingly. BT_LOG_LEVEL_EXTERN_SYMBOL(my_module_log_level); -#endif /* MY_MODULE_LOGGING_H */ +#endif /* BABELTRACE_MY_MODULE_LOGGING_H */ ---- -- + @@ -653,6 +653,9 @@ log level symbol. . Include the `logging.c` and `logging.h` in the `_SOURCES` variable of your module's object in your module's root `Makefile.am`. +. Add the log level initializing environment variable name to the + `log_level_env_var_names` array in `cli/babeltrace.c`. + [[logging-instrument-source]] ==== Instrument a C source file