#   Copyright
#
#	Copyright (C) 2009-2010 Jari Aalto
#
#   License
#
#       This program is free software; you can redistribute it and/or modify
#       it under the terms of the GNU General Public License as published by
#       the Free Software Foundation; either version 2 of the License, or
#       (at your option) any later version.
#
#       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. See the
#       GNU General Public License for more details.
#
#       You should have received a copy of the GNU General Public License
#       along with this program. If not, see <http://www.gnu.org/licenses/>.
#
#   Description
#
#	To learn what TOP LEVEL sections to use in manual pages,
#	see POSIX/Susv standard and "Utility Description Defaults" at
#	http://www.opengroup.org/onlinepubs/009695399/utilities/xcu_chap01.html#tag_01_11
#
#	This is manual page in Perl POD format. Read more at
#	http://perldoc.perl.org/perlpod.html or run command:
#
#	    perldoc perlpod | less
#
#	To check the syntax:
#
#	    podchecker *.pod
#
#	Create manual page with command:
#
#	    pod2man PAGE.N.pod > PAGE.N

=pod

=head1 NAME

morsegen - convert file to ASCII morse code

=head1 SYNOPSIS

  morsegen <file>

=head1 DESCRIPTION

This program implements the International Morse Code Standard by
converting ASCII text file into morse code ASCII notation.

Morse code was created for the telegraph in the early 1840s. Morse
code uses a standardized sequence of short and long elements to
represent the letters, numerals, punctuation and special characters
of a given message.

The morse code standard does not define all characters in ASCII table
therefore translation of file into morse notation is only an
approximation. The following special translation have been used:

    ASCII	    Morse prosign
    ------------    ------------------
    ' '	(space)	    Invitation to transmit
    \t		    Starting signal
    \r		    Wait
    \n		    End of work

=head1 OPTIONS

None.

=head1 ENVIRONMENT

None.

=head1 FILES

None.

=head1 SEE ALSO

cw(1)
cwgen(1)
qrq(1)

=head1 STANDARDS

http://en.wikipedia.org/wiki/Morse_code

=head1 AUTHORS

Program was written by Luigiru Auriemma <aluigi@autistici.org>.

This manual page was written by Jari Aalto <jari.aalto@cante.net> for
the Debian GNU system (but may be used by others). Released under
license GNU GPL version 2 or (at your option) any later version. For
more information about license, visit
<http://www.gnu.org/copyleft/gpl.html>.

=cut
