@database Calculator Documentation
@author "Donald W Millican"
@(C) "1999 DWM Productions"
@ $ver: Calculator Documentation V2.2
@toc Main

@node Main "Contents"

                            @{b}Calculator@{ub}

                Calculator and this AmigaGuide is created
         by Donald W Millican and (C) Copyright 1999 DWM Productions.

                        1 @{"What is it?" link part1}
                        2 @{"System Requirements" link part2}
                        3 @{"Legal" link part3}
                        4 @{"Usage" link part4}
                        5 @{"Why did I create it?" link part5}
                        6 @{"Author" link part6}
                        7 @{"History" link part7}
                        8 @{"DWM Productions Releases" link part8}
@endnode

@node part1 "What is it?"



            Calculator is unsurprisingly - a calculator. It performs all
            of the functions of an ordinary calculator but is restricted
            to two decimal places in entries and answers for now - an
            attempt to make coding easier and will be fixed in the future.

            To discover why I created Calculator click @{"here" link part5}.

            If you want to run it you'll want to know the @{"system requirements" link part2}.

            Or jump straight to @{"usage" link part4} for instructions on
            how to access the program.


                        @{"Return to contents" link main}
@endnode

@node part2 "System Requirements"

            @{b}@{u}Minimum system required (this is untested):@{uu}@{ub}

            An Amiga, 60Kb RAM, Workbench 2.05+

            @{b}@{u}Recommended system:@{uu}@{ub}

            Amiga1200, 100Kb RAM free, Workbench 3.0


            @{b}@{u}Development system:@{uu}@{ub}

            @{b}Hardware@{ub}
            Amiga1260T in Power Tower, Blizzard 1260 with 16Mb RAM,
            6.4Gb hard disk, Microvitec Multiscan monitor,
            2Gb JAZ2 drive.

            @{b}Software@{ub}
            Workbench 3.0, StormC3.0, Enforcer

                        @{"Return to contents" link main}
@endnode

@node part3 "Legal"

    This program is Emailware.
    In the event that you find this program useful, send me an email.

    It is freely distributable and no profit should be made from it.

    EasyConvert is provided 'as is' and the author cannot be held responsible
    for any damage occurred as a result of running this program.
    (I would hope that none of my programs cause any damage).

    The latest version of this legal section supersedes any previous versions.

    EasyConvert is (C) Copyright DWM Productions ie. Donald W Millican
    The EasyConvert code is copyright and its code and/or design cannot be
    altered or used in full or in part.
    The whole program cannot be changed and redistributed without my consent.
    This document may be updated for any re-release but the legal section must
    remain unchanged. The program can be spread anywhere but I request that all
    the files be kept together including all of this document.

                        @{"Return to contents" link main}
@endnode

@node part4 "How to use the program"



            Numbers can be entered by typing them on the keyboard or clicking
            their buttons on the screen - the same goes for the add, multiply,
            etc., buttons.

            NOTE: For reasons which I do not fully understand, you cannot use
            the RETURN or ENTER keys to end a calculation - you must use the
            equals button at all times.
            If a mistake in entry is made, use the button marked '<-'. This is
            the takeback button and will delete your previous entries in the
            display. It currently cannot delete beyond a decimal point - this
            will be fixed soon. You cannot use the 'backspace' or
            'del' keys for this as I cannot yet read them.

            The C button will clear the current calculation.

            Other than this the calculator works 100% like the real thing.

            If you can live with these restrictions and the fact that there
            is a lot more to be implemented yet, then have fun.

                        @{"Return to contents" link main}
@endnode

@node part5 "Why did I create it?"

    I know that many other programs similar to mine already exist.
    I decided that I wanted a challenging project to work on so I decided
    to create a calculator. It was an awful lot harder than I thought -
    looking at the program @{"history" link part7} will tell you that.

    The reason that my previous version 1.0 release of the calculator
    largely didn't work and because of this was released as source code,
    was that I simply hadn't realised how complex the workings of a
    calculator really are. I am still learning.

    I have hoped from the beginning that one day I could add scientific
    functions to the calculator, e.g. sine, cosine, tangent, etc. This
    may be possible if I can get all of the basic functions to work bug free.


                        @{"Return to contents" link main}
@endnode

@node part6 "Author"

            Donald W Millican
            83 Stonelaw Drive,
            Rutherglen,
            Glasgow,
            G73 3PA.
            Scotland.

            E-Mail: DonaldWM@stonelawdrive.freeserve.co.uk

            Websites(All created by me!):

            Millican home pages: http://millican.cjb.net
            DWM Productions: http://millican.cjb.net/dwm/indexdwm.html
            The Amiga Computer: http://amigacomputer.cjb.net


                        @{"Return to contents" link main}
@endnode

@node part7 "History"

*** Pre-Program History ***
06/02/99 : Version 0.1 : Main Window created and basic GUI structures ready
14/02/99 : Version 0.2 : All number buttons work and are displayed
14/02/99 : Version 0.4 : Add, subtract and equals buttons work
20/02/99 : Version 0.5 : Keyboard shortcuts work
21/02/99 : Version 0.6 : Multiply and divide buttons work
21/02/99 : Version 0.8 : Switching sign button works
21/02/99 : Version 0.9 : Code to be cleaned up but integer calculator works

*** Program History ***
21/02/99 : Version 1.0 : Initial Release
16/06/99 : Version 1.1 : Source is split into several files for easier editing
16/06/99 : Version 1.2 : Major bug fixes - code still full of unsolvable bugs
*** Calculator reprogrammed ***
28/11/99 : Version 1.3 : GUI redesigned
29/11/99 : Version 1.4 : Floating point is possible
03/12/99 : Version 1.5 : Basic calculation routines rewritten
05/12/99 : Version 1.55 : Bugfixes in calculation routines
06/12/99 : Version 1.6 : Repeat previous calculation by re-pressing EQUALS
06/12/99 : Version 1.65 : Deal with post-EQUALS calculations
06/12/99 : Version 1.7 : Display running total
10/12/99 : Version 1.75 : Take Back button implemented
--/--/-- : Version 1.8 : Attempt to read RETURN, ENTER, BACKSPACE & DEL keys
--/--/-- : Version 1.9 : Do something about two decimal places restriction
--/--/-- : Version 2.0 : Start adding scientific functions (Sine, Cosine, etc.)

                        @{"Return to contents" link main}
@endnode

@node part8 "Releases under the DWM Productions label"

        I have released several programs.
        They are as follows:

        CycleDBase:
        Database primarily for my benefit for recording cycle trips.
        Offers loading, saving and extensive search facilities.
        On Aminet as util/misc/CycleDBase.lha
        Also on website: http://amigacomputer.cjb.net/programs/cycledbase.html

        Easy Convert:
        Converts to and from a number of measurements. Several satisfied users.
        Deliberately simplistic interface.
        On Aminet as util/conv/EasyConvert.lha
        Also on website: http://amigacomputer.cjb.net/programs/easyconvert.html

        Calculator:
        A fully functional calculator with a temporary restriction
        on the number of decimal places it handles.
        On Aminet as util/misc/Calculator.lha
        Also on website: http://amigacomputer.cjb.net/programs/calculator.html

        Quotes:
        A 'cookie' like program which loads in sayings from a file
        and randomly puts them together to make weird messages. Has been known
        to cause system crashes - USE AT YOUR OWN RISK.
        On Aminet as util/wb/Quotes.lha
        Also on website: http://amigacomputer.cjb.net/programs/quotes.html

        Vowel Count:
        A silly program which counts the number of vowels
        in an entered string and then displays statistics
        of its findings and the string (minus vowels).
        On Aminet as util/misc/Vowel.lha

                        @{"Return to contents" link main}
@endnode


