LUMIERA.clone/doc/devel/rfc/NoBugFlags.txt

66 lines
1.9 KiB
Text

NoBug logging flag hierachy
===========================
[grid="all"]
`------------`-----------------------
*State* _Final_
*Date* _2008-04-05_
*Proposed by* link:ct[]
-------------------------------------
link:NoBug[] logging flag hierachy
----------------------------------
link:NoBug[] allows hierachical organization of logging flags. Propose a
documentation/planning about the setup.
Description
~~~~~~~~~~~
Take a look at my draft at:
link:http://www.lumiera.org/gitweb?p=lumiera/ct;a=blob;f=doc/devel/nobug_flags.t
t;h=74471e255e6ebfedb642e450bdfd3f79e346c600;hb=backend[NoBug_flags]
I've added the things I planning for the backend, others might add their own
plans there too. So far this is an early draft, comments welcome.
NOTE: outdated information. Have a look at `include/logging.h`
Tasks
~~~~~
* Needs a file.c defining the common root see
link:Lumiera/DesignProcess/GlobalInitialization[]
* Everyone needs to setup this hierachy by NOBUG_DEFINE_FLAG_PARENT (flag,
parent_flag);
Pros
~~~~
When done right, logging control is much easier, just 'NOBUG_LOG=lumiera:DEBUG'
would suffice.
Rationale
~~~~~~~~~
We need some easy way to control logging, later on when lumiera runs in beta
tests it must be easy to tell a tester how to create useable debugging logs.
Comments
--------
//comments: append below
cehteh will care for further integration
ct:: '2008-07-26T09:11:29Z'
The basic idea is still valid, but information in this RfC is quite outdated.
Meanwhile, we have a somewhat different and largely extended log hierarchy.
And it turned out, that it isn't practical to scatter the NOBUG_FLAG_PARENT
definitions all over the code base. Rather, we use a single include file
`include/logging.h` to define all flags in a systematic way
Ichthyostega:: 'Di 29 Okt 2013 05:52:34 CET' ~<prg@ichthyostega.de>~
//endof_comments:
Back to link:/documentation/devel/rfc.html[Lumiera Design Process overview]