/ 
Text-Autoformat-Agenda-0.02
/ Text::Autoformat::Agenda

NAME

Text::Autoformat::Agenda - Automated agenda creation from flat files

SYNOPSIS

### Your boss proclaimeth:

Subject: Status Report Reminder Date: Fri, 2 Mar 2001 15:00:26 -0800 (PST) From: Bigwig <bigwig@bigcompany.com> To: lowly_nobody@bigcompany.com

Please send me status reports by end-of-day Friday and cc the CEO.

Use the following format:

* Accomplishments in the past week

* Plans for the coming week

  Include vacation and classes scheduled and keep them on the report
  until taken.

* Issues/Problems
  Please date these and keep them on the report until closed.


### So then you crank out:
 
 use Text::Autoformat::Agenda; # requires Text::Autoformat
 use Date::Business # not required. just useful for my agendas

 my $d = new Date::Business(FORCE => 'next');

 my ($year,$month,$day) = ($d->image =~ /(.{4})(.{2})(.{2})/);

 my $pretty_date = "$month-$day-$year";

 my $agenda = Text::Autoformat::Agenda->new
   ( Dir   => '/home/tmbranno/status',
     Title => "Status report for the week ending $pretty_date",
     Agenda =>
      [
        "Accomplishments in the past week" => 'accomplishments.txt',
        "Plans for the next week"          =>
            [
              General   => 'plans.txt',
              Vacations => 'vacations.txt',
              Classes   => 'classes.txt'
            ],
        "Outstanding issues"               => 'issues.txt'
      ]
   );

 print $agenda->content;

### Resulting output:

Status report for the week ending 03-02-2001

1. Accomplishments in the past week
   * Checked in bug 1581160. Now, user contact information (ie. phone,
     email) shows up along with the user's responsibilities.
   * Cleaned up and submitted source code for bug # 1479086. Now, users
     can obtain patches via ftp.
   * Contacted R Cissi (68330) to have him reproduce bug #
     1652235. The result of interacting with him forced him to lower
     the priority of bug 1652235 because the complaint levied was
     lacking important related information.
   * Could not reproduce bug number 1618728. Closed.
   * Integreated Clark's criticisms into a re-submission of bug
     1631057, the bug concerning the ability to edit the text of
     obsoleted checkins.

2. Plans for the next week
   3. General
       * Automatic generation of this report is hampered by a bizarre
         recursion bug!
       * Compress the .tar files in my directories automatically
   2. Vacations
       * None
   3. Classes
       * None
3. Outstanding issues
   * Need the key for my left shelf.
   * Bcc'ed mail ends up in my INBOX. Would rather it be automatically
     filed somewhere
   * I would like to auto-file these ARU checkin messages I get.
   * Install xemacs -- problems doing this

DESCRIPTION

Text::Autoformat::Agenda, abbreviated T::A::G, is a module for cranking out Agendas. It takes a directory of status report files and a Perl arrayref indicating how the files are to be composed into an agenda document and creates the agenda.

It runs the text through Text::Autoformat's format for readability.

BUGS

There is a very odd recursion bug in this module. Even when the module's debug output (sent to STDERR) claims that it is generating text which looks a certain way, when you actually look at STDOUT, the output is different.

AUTHOR

T. M. Brannon, tbone@cpan.org

SEE ALSO

perl(1).