Rtf::writer is for generating documents in rich text format.

this module is a class; an object belonging to this class acts like an output filehandle, and calling methods on it causes rtf text to be written.

incidentally, this module also optionally exports a few functions, particularly related to length.

the following documentation assumes some familiarity with the rtf specification. users not already intimately familiar with rtf should look at rtf::cookbook and/or the book "rtf pocket guide" from o'reilly.