# Typical invocation: create a pure Perl module (no C code) called
# 'Amazing::Perl::Extension", omit AutoLoader
cd ~/development
h2xs -XA Amazing::Perl::Extension

#  You can even declare it as backward-compatible - e.g., w/Perl 5.7.1
h2xs -XA -b 5.7.1 Amazing::Perl::Extension

##</code><code>##

lib/Amazing/Perl/Extension.pm   # This is the boilerplate for your module
t/Amazing-Perl-Extension.t      # The Test::More-based test for loading it
Changes                         # History/listing of per-version changes
Makefile.PL                     # ExtUtils::MakeMaker-based makefile maker
MANIFEST                        # Listing of all of the above
README                          # Intro/installation instructions

##</code><code>##

tar cvzf Amazing-Perl-Extension-0.01.tgz Amazing-Perl-Extension

##</code><code>##

# This is in a separate file in t/*.t - e.g., 't/OS_test.t'
use Test::More tests => 1;

ok($^O !~ /^(?:MSWin|VMS|dos|MacOS|os2|epoc|cygwin)/i) or BAIL_OUT("OS unsupported");

##</code><code>##

use Test::More tests => 1;

ok($^O eq 'linux');

##</code><code>##

=head1 ABSTRACT

To generate a menu series that looks like this:

=begin html

<pre>
  .--------------------------------------------.
  | 1) Breakfast | 2) Dinner    | 3) Lunch     |
  '--------------------------------------------'
  Item number (1-3, 0 to restart, 'q' to quit)? 2
</pre>

=end html

=begin text

  .--------------------------------------------.
  | 1) Breakfast | 2) Dinner    | 3) Lunch     |
  '--------------------------------------------'
  Item number (1-3, 0 to restart, 'q' to quit)? 2

  +++++++++++[New page]++++++++++++++++++++++++++++++

=end text