README for RTF::Writer Time-stamp: "2001-04-26 17:12:12 MDT" [Excerpted from the POD...] NAME RTF::Writer - for generating documents in Rich Text Format SYNOPSIS use RTF::Writer; my $rtf = RTF::Writer->new_to_file("greetings.rtf"); $rtf->prolog( 'title' => "Greetings, hyoomon" ); $rtf->number_pages; $rtf->paragraph( \'\fs40\b\i', # 20pt, bold, italic "Hi there!" ); $rtf->close; DESCRIPTION This module 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 exports a few useful functions, upon request. The following documentation assumes some familiarity with the RTF Specification. Users not already intimately familiar with RTF should look at RTF::Cookbook. [... RTF::Cookbook is included in this dist ...] COPYRIGHT AND DISCLAIMER Copyright 2001 Sean M. Burke. This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose. The author of this document is not affiliated with the Microsoft corporation. Product and company names mentioned in this document may be the trademarks or service marks of their respective owners. Trademarks and service marks are not identified, although this must not be construed as the author's expression of validity or invalidity of each trademark or service mark. [...end pod excerpt] PREREQUISITES This suite requires perl 5.005 to run. If you really need to run it under perl 5.004, email me and I'll suggest how to get it to work. INSTALLATION You install RTF::Writer et al, as you would install any Perl module library, by running these commands: perl Makefile.PL make make test make install If you want to install a private copy of RTF::Writer in your home directory, then you should try to produce the initial Makefile with something like this command: perl Makefile.PL PREFIX=~/perl See perldoc perlmodinstall for more information and advice. !!!!!!!!!!SPECIAL NOTE!!!!!!!!!! The distribution archive contains two files of some interest, in the examples/ directory. They do not get installed anywhere by the "make install" command, but you should look at them: demo_writer.pl -- sample program using RTF::Writer to generate output. la_dame.rtf -- the "sample complete RTF file" from RTF::Cookbook. DOCUMENTATION POD-format documentation is included in RTF/Writer.pod and RTF/Cookbook.pod. POD is readable with the 'perldoc' utility. See ChangeLog for recent changes. MACPERL INSTALLATION NOTES Don't bother with the makefiles. Just move the lib/RTF directory into your MacPerl site_lib or lib directory. SUPPORT Questions, bug reports, useful code bits, and suggestions for RTF::Writer should just be sent to me at sburke@cpan.org AVAILABILITY The latest version of this suite is available from the Comprehensive Perl Archive Network (CPAN). Visit to find a CPAN site near you.