Revert "Minor language improvements."
authorChristian Thaeter <ct@pipapo.org>
Mon, 9 Aug 2010 20:45:32 +0000 (22:45 +0200)
committerChristian Thaeter <ct@pipapo.org>
Mon, 9 Aug 2010 20:45:32 +0000 (22:45 +0200)
Only revert the documentation about NOBUG_INIT(), currently the
INIT_FLAG*() will call NOBUG_INIT(), but this is mainly meant as
undocumented compatibility feature. calling NOBUG_INIT() should be
mandatory for the time being.

This reverts commit a3f52ec12331395f39da9bc6f1ca9ce0fcae49b2.

doc/initialization.txt

index 0c17e96..586183e 100644 (file)
@@ -2,20 +2,16 @@ HEAD- Initialization;;
 
 HEAD++ Global Initialization;;
 
-Before anything from NoBug can be used, NoBug must be initialised.  This is
-performed by calling one of the `NOBUG_INIT_` macros.
-
-The simpliest such macro among the initialising set is the following:
-
-  NOBUG_INIT()
+Before anything from NoBug can be used, NoBug must be initialised. This
+is archived by calling the `NOBUG_INIT()` macro before using any other of the
+NoBug facilities.
 
 `NOBUG_INIT` can be called more than once, subsequent calls will be a no-op,
 thus initialising in main and in libraries won't interfere with one another.
 
-In other words, `NOBUG_INIT` is usually the first call to NoBug.
-Care must be taken when one is already using NoBug features from dynamic
-initialized properties in C++, one has to ensure that NoBug is first initialized
-possibly by pulling up a singleton as the very first thing.
+Care must be taken when one already using NoBug features from dynamic
+initialized things in C++, one has to ensure that NoBug gets initialized first
+possibly by pulling up a singleton at very first.
 
 
 HEAD== Destroying NoBug;;