ConvertTag
----------

This program is a small supplement to the AmigaETag package designed to
convert tag files from other packages to a format compatible with AmigaETag
and the Spot point package by Nico François.

ConvertTag contains a number of useful features, listed below.

    Compatibility:

        o ConvertTag is fully Commodore Style Guide compliant
        o Designed to work in conjunction with AmigaETag
        o Compatible with all known tag file formats

    Functionality:

        o Command-line specification of tag file name for maximum
          flexibility
        o Optional user-defined break string for easy customization
        o Buffered I/O streams are used for extremely fast and efficient
          tagline conversion

Requirements
------------

    o Any Amiga running AmigaDOS 2.04 (V37) or greater
    o A file containing from 1 to infinite (theoretical) taglines separated
      by a break string (default "\n")

CLI options
-----------

TAGFILE/A      A required argument that defines the name of the tag file to
               be converted.  WARNING: The original tag file will be
               replaced by the converted one, please make a backup of the
               original!
BREAK/K        This keyword argument allows the user to define the break
               string after each tagline that is searched for when
               converting.  Default behavior is to use "\n" as the break
               string.

Known bugs
----------

    None

Disclaimer
----------

The author of this program makes no warranties or representations, either
expressed or implied, with respect to this software product.  The program
accompanying this documentation is being supplied on an "AS IS" basis and is
expressly subject to change without notice.  The entire risk as to the use
of this program is assumed by the user.  IN NO EVENT WILL THE AUTHOR BE
LIABLE FOR DIRECT, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES RESULTING
FROM ANY CLAIM ARISING OUT OF THE USE OF THIS PROGRAM, EVEN IF THE AUTHOR
HAS BEEN ADVISED OF THE POSSIBILITIES OF SUCH DAMAGES.  SOME STATES DO NOT
ALLOW THE LIMITATION OF IMPLIED WARRANTIES OR DAMAGES, SO THE ABOVE
LIMITATIONS MAY NOT APPLY.

Legal
-----

ConvertTag is hereby remitted to the public domain.  All legal rights and
restrictions on this program have therefore been waived.

Program history
---------------

37.4    Public release in E, compiled with Amiga E 2.1b
        Made code public domain and released to Aminet and Fidonet
        Changed code to compile under vanilla Amiga E 2.1b compiler

37.3ß   Internal release in E, compiled with Amiga E 2.1b, EHS 1.00 and
          EPP 1.1
        Improved Spot tag file compatibility
        Created AmigaGuide documentation

37.2    Public release in E, compiled with Amiga E 2.1b
        Minor internal enhancements

37.1    Public release in E, compiled with Amiga E 2.1b
        Fixed bug that caused program to crash without arguments
        Now handles long directory paths correctly
        Removed erroneous debugging code

37.0ß   Internal release in E, compiled with Amiga E 2.1b
        Initial version

Planned enhancements
--------------------

    None

Other programs by the author
----------------------------

    o Convert, a user-configurable multi-platform text conversion tool
      (NOTE: This program is currently being integrated with TabCon into a
       new, easier-to-use combined package and is still under development.)
    o Password, a highly flexible password generation utility (available
      soon at an Aminet site near you)
    o TabCon, a powerful tab insertion/removal utility (also coming soon to
      Aminet)
    o RexxTag and RexxTagII, ARexx programs to automatically generate
      random taglines (originally released to the AMY_POINT echo and now
      unsupported with the release of AmigaETag)
    o KeyUtils, an encapsulated keyfile protection system for use by
      shareware authors who want to combine ease of use and transparency to
      the user with the latest technology in encrypted security

Author information
------------------

I am a 22 year old computer technician living in Kernersville, North
Carolina.  I can be reached at the following addresses:

    FidoNet:

        1:3661/604.2

    Usenet/Internet:

        Rodney.Hester@p2.f604.n3661.z1.fidonet.org

Please feel free to send me electronic mail with bug reports, requests, or
just comments about how you liked the program.  Thanks for testing
ConvertTag!