=head1 NAME

Handouts - create handouts with simple keywords.

=head1 SYNOPSIS

 topic 

 info 
 [ ... ]

 table [ rows | columns ] 
 
  ...

=head1 EXAMPLES

NOTE:  Each of these lines would start on the first column
of a file to be a valid example.

 topic Weak / Damp Spleen

 info Avoid concentrated sweets
 honey, sugar, molasses, maple syrup

 table rows Avoid energetically cold foods
 greens, grains
 celery, lettuce, cucumbers, spinach
 wheat, buckwheat, millet

 info Energetically cold foods are worse cold or raw
 info Overconsumption chills middle burner and spleen yang

 table columns Avoid energetically congesting foods
 dairy, cold, other
 milk, cheese
 ice cream, frozen yogurn, frozen treats
 pizza, greasy foods, spicy foods

=head1 DESCRIPTION

Create a text file as shown in the synopsis.  Use the following
keywords:

  o topic - description or name of topic for handout
  o info - information within topic
  o table rows - table information within topic; show by rows
  o table columns - table information within topic; show by columns

=head1 RULES

Blank lines are ignored.

Any line beginning with a space is ignored.

Keywords must be in the first column of the file.

Any new keyword stops the processing of the previous keyword.

Any line ending in a new line is taken as a line.

Tables are organized as three parts:

  o description: follows "table [rows|columns]" keywords
  o title labels: comma separated list
  o data list for row or column: comma separated list

Tables must have at least two columns or rows.  Every table
should have a matching set of lists for the title labels.

All lists are comma separated lists.

=head1 AUTHOR

David Scott ([email protected])

=cut