Java Number Base Converter Files

====================================================================
README.txt
====================================================================
Java Base Converter (baseconv)
Version 1.1
August 2, 2004

====================================================================
INTRODUCTION 
====================================================================
This program aims at delivering a useful base conversion utility to 
programmers, engineers, and mathematicians who work with numbers of 
different bases. The supported bases are Decimal, Binary, 
Hexadecimal, Octal, and a user-specified base up to base 36. This
means that you can convert from numbers of ANY base to numbers of 
ANY base for arbitray-precision numbers. You may have seen other 
base converters on the Internet, but none are as intuitive, easy to 
use, and accurate as this one.

This program is intended for developers, engineers who work in 
numbers of different bases and any other person interested in 
base conversion.
====================================================================
NEW FEATURES AND FUNCTIONS IN THIS RELEASE 
====================================================================
This is first publicly released version.

Features:
- Conversion from numbers of any base to numbers of any base
- Intuitive design which allows a user to see the most commonly used
  bases.
====================================================================
BUG FIXES 
====================================================================
baseconv Bug #
Problem Description

====================================================================
KNOWN LIMITATIONS
====================================================================
These limitations are known to exists in this release of the software:

There is no support for numbers that include a decimal point, and this
has been entered into the bug tracker as bug #1001811.  This will be
fixed by the next release

====================================================================
GETTING STARTED
====================================================================

SOFTWARE DEPENDENCIES
--------------------------------------------------------------------
This software has been compiled with the Java SDK v1.4.2 and works
on that platform.  Older versions of the SDK may compile it, but 
don't hold your breath.

PLATFORM SUPPORTED
--------------------------------------------------------------------
Windows, Linux, MacOS, Any platform supporting Java 1.4.2

INSTALLATION INSTRUCTIONS
--------------------------------------------------------------------
Download the jar file, and if you want to be able to run it by typing
"baseconv" at the command prompt, simply become root, and then create
a shell script like:

     ******************************
     * #/bin/bash                 *
     *                            *                                                                                                               
     * cd /PATH/TO/baseconv       *
     * java -jar baseconv-1.1.jar *
     ******************************

This is assuming that baseconv.jar is in the location
/PATH/TO/baseconv/baseconv-1.1.jar.

Or in Windows, just create a batch script with the bottom two lines.

COMPILE INSTRUCTIONS
--------------------------------------------------------------------
The product is precompiled, so no compilation is necessary.


USING THE SOFTWARE
--------------------------------------------------------------------
Simply type baseconv if you installed it like mentioned above, or 
change directories into the directory the jar file is stored in and
type "java -jar baseconv-1.1.jar" at the command line.

====================================================================
SOURCE CODE INFORMATION
====================================================================
Please see the documentation online at http://baseconv.sourceforge.net/ .

====================================================================
PACKAGE STRUCTURE 
====================================================================
This PACKAGE contains the following subdirectories or files:
- package name: baseconv-1.1.jar
    - BaseConverter.class - The main class.
    - BaseConverter$1.class
    - BaseConverter$2.class
    - BaseConverter$3.class
    - BaseConverter$4.class
    - BaseConverter$5.class
    - BaseConverter$6.class
    - LICENSE.txt - A copy of the GPL
    - images
        - icon.png - the baseconv icon
        - Convert.gif - convert icon (thanks to iconfactory.com)
        - Clear.gif - clear icon (thanks to iconfactory.com)

====================================================================
CONTRIBUTORS 
====================================================================  
This software consists of software programmed by Damian Carrillo,
base of Java 1.4.2 from Sun Microsystems, and icons from
iconfactory.com.

====================================================================
CONTACT INFORMATION AND WEBSITE
====================================================================
We welcome your feedback, suggestions and contributions. Contact us
via email if you have questions, feedback, code submissions, 
and bug reports.

For general inquiries - damian@cs.utexas.edu

You can subscribe to the mailing lists on 
http://sourceforge.net/mail/?group_id=115114

You can submit bug, patches, software contributions, and feature 
requests using SourceForge.  Access this at
http://sourceforge.net/tracker/?group_id=115114&atid=670547

====================================================================
LICENSE AND COPYRIGHT (see LICENSE.txt for license)
====================================================================
Damian Carrillo 
Base Conversion Utility
Copyright (C) 2004

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, write to the Free Software Foundation, Inc., 59 Temple 
Place, Suite 330, Boston, MA 02111-1307 USA