Tutorial

A step-by-step introduction to using libcwd. More...

Topics
	Tutorial 1: Hello World
	Print your first line of debug output.
	Tutorial 2: Creating Your Own Debug Channels
	Define project-specific debug channels.
	Tutorial 3: Setting The ostream
	Redirect debug output to any ostream.
	Tutorial 4: Management Of CWDEBUG
	Compile with and without debugging support.
	Tutorial 5: Advanced Examples
	Loop over channels, combine them, and format and interrupt debug output.
	Tutorial 6: Debugging Threaded Applications
	Thread-safety rules and multi-threaded debug output.
	FAQ
	Exhaustive answers to the questions raised by the tutorial.

Detailed Description

Hello, my name is Carlo Wood and I will guide you through a few example programs in order to help familiarize you with libcwd.

Hopefully you have already installed the library and the header files. If not, then do so now - see the INSTALL file that is included in the distribution package for detailed instructions, or the Preparation chapter of the Reference Manual.

This tutorial is mixed with a lot of FAQ-style questions, which are linked to a more detailed explanation in the FAQ. For a correct understanding of the tutorial it is not needed to read these FAQs; they are only provided for your convenience, only read them if you really want to know the answer.

The tutorial is a six-part learning sequence (each part builds on the previous one):

• Tutorial 1: Hello World — print your first line of debug output.
• Tutorial 2: Creating Your Own Debug Channels — create your own debug channels.
• Tutorial 3: Setting The ostream — write debug output to any ostream.
• Tutorial 4: Management Of CWDEBUG — compile with and without debugging support.
• Tutorial 5: Advanced Examples — loop over channels, combine them, and format output.
• Tutorial 6: Debugging Threaded Applications — debug multi-threaded applications.