Writing Debug Output

API documentation related to producing debug output. More...

Topics
	Introduction (Debug Output)
	Introduction to libcwd's ostream-based debug output.
	Setting The Output Destination
	Selecting or inspecting the ostream used by a debug object.
	The Output Device (Debug Object)
	Documentation of class libcwd::DebugObject and the default debug object libcwd::libcw_do.
	Controlling The Output Level (Debug Channels)
	Controlling which debug output is emitted by toggling channels on and off.
	Control Flags
	Modifying the behavior of a single debug output statement.
	Format Of The Debug Output
	Customizing the layout of debug output (margins, markers, indentation).
	Fatal Debug Output
	Printing a fatal message and terminating the application.
	Nesting Debug Output
	Keeping debug output readable when it is nested or split over several calls.
	Special Functions And Utilities
	Miscellaneous helper functions and macros for debug output.

Detailed Description

This chapter collects the output destination, debug object, debug channel, control flag, formatting, fatal output, nesting, and helper utility documentation used while writing debug output.