@database   HSMathLibs_eng.guide
@author     "Matthias Henze / Kai Fleischer"
@$VER:      HSMathLibs_eng.guide 1.3r (15.04.00)

@SMARTWRAP
@index guideIndex

/// Contents
@node Main Contents
@{jcenter}

@{b}@{fg shine}HighSpeed MathLibs Version 44.41 ( 15.04.2000 ) for MC68040@{par}

Copyright İ 1998/2000 by CyberdyneSystems@{par}

written by Matthias Henze@{fg text}@{ub}@{par}

@{b}@{FG fill}S H A R E W A R E@{FG text}@{ub}

@{code}@{jleft}
  @{" Introduction     " link Introduction}    General Information about HSMathLibs.

  @{" Special Features " link "Special Features"}    Why should I use HSMathLibs?

  @{" Requirements     " link Requirements}    What do I need to use HSMathLibs?

  @{" Installation     " link Installation}    How to install HSMathLibs?

  @{" Known Bugs       " link "Known Bugs"}    Known bugs and misbehaviours.

  @{" Updates          " link Updates}    How to update.

  @{" Copyright        " link Copyright}    Copyright notice.

  @{" History          " link History}    Brief history.

  @{" Future           " link Future}    Future developments.

  @{" Thanks           " link Thanks}    Thanks to ... .

  @{" Author           " link Author}    How to contact the author.

  @{" Index            " link guideIndex}    Index of this documentation.
@endnode
///
/// Introduction
@node Introduction
@{b}@{fg shine}Introduction:@{par}
~~~~~~~~~~~~~@{fg text}@{ub}@{par}

The "HSMathLibs" replace the libraries "mathffp.library", "mathieeedoubbas.library",
"mathieeedoubtrans.library", "mathieeesingtrans.libray" and "mathtrans.library"
with highly optimized versions for MC68040. They patch the "mathieeesingbas.libray"
for MC68040. The precision is as high (some functions are even more precise) as of
the original libraries shipped with AmigaOS 3.x.@{par}
The "HSMathLibs" are completely written in assembler to achieve the maximum
acceleration.@{par}

@{b}Background:@{ub}@{par}
The libraries of AmigaOS 3.x and FMath406 (Fast Math Libraries v40.6 by
Martin Berndt) are quite slow (they use instructions the MC68040 has to emulate).
The MC68060 isn't even supported. So I decided to develop "HSMathLibs".@{par}
@endnode
///
/// Special Features
@node "Special Features"
@{b}@{fg shine}Special features of "HSMathLibs":@{par}
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~@{fg text}@{ub}@{par}

@{b}1.)@{ub}@{par}
because it is completely written in assembler, all functions
are very fast@{par}

@{b}2.)@{ub}@{par}
special versions of "HSMathLibs" for MC68881/82, MC68040 and MC68060@{par}

@{b}3.)@{ub}@{par}
much faster than the libraries of AmigaOS 3.x and FMath406
(Fast Math Libraries v40.6 by Martin Berndt); a MC68040 is up to 21 times as
fast as with AmigaOS 3.x and up to 10 times as fast as with FMath406@{par}

@{b}4.)@{ub}@{par}
the "HSMathLibs" work on the DraCo@{par}

@{b}5.)@{ub}@{par}
"HSMathLibs" is inexpensive @{par}
@endnode
///
/// Requirements
@node Requirements
@{code}@{b}@{fg shine}Requirements:
~~~~~~~~~~~~~@{fg text}@{ub}

- An Amiga or DraCo
- AmigaOS 2.0 (V37) or higher
- MC68040
@endnode
///
/// Installation
@node Installation
@{b}@{fg shine}Installation:@{par}
~~~~~~~~~~~~~@{fg text}@{ub}@{par}

The "HSMathLibs" are installed by the Installer.@{par}
Run "HD-Install_xxx" (xxx is your prefered language) from Workbench
and follow the instructions.@{par}

@{b}@{FG fill}Important@{FG text}@{ub}@{par}

You must remove all other patches (e.g. ffppatch, msbpatch, math-patch from MCP)
of mathlibraries.@{par}

The patches from SetPatch, DraCoSetPatch and OxyronPatcher are OK.@{par}
@endnode
///
/// Known bugs
@node "Known bugs"
@{b}@{fg shine}Known bugs:@{par}
~~~~~~~~~~~@{fg text}@{ub}@{par}

- the registered version of UltraConv V3.x will not work with HSMathLibs. UltraConv
V4.x works fine with HSMathLibs.@{par}
@endnode
///
/// Updates
@node Updates
@{b}@{fg shine}Updates:@{par}
~~~~~~~~@{fg text}@{ub}@{par}

The newest version can be found on the homepage "http://WWW.CyberdyneSystems.de/".@{par}

Updates can be obtained directly from the @{" author " link author}.
If you would like to get the newest version via snail mail just send me
a disk (HD or DD) and an addressed envelope including postage or 5,- DM
(German Marks) or 3,- $ (US Dollar) or 2,- £ (UK Pound).@{par}
@endnode
///
/// Copyright
@node Copyright
@{b}@{fg shine}Copyright:@{par}
~~~~~~~~~~@{fg text}@{ub}@{par}

The demo-version of "HSMathLibs" is freely distributable as long as
it is NOT CHANGED and ALL files are included UNCHANGED.@{par}
@{b}The registered version of "HSMathLibs" is ONLY for registered users.
The "HSMathLibs" and the registrationnumber MUST NOT be published or copied@{ub}.@{par}

Re- or disassembling of "HSMathLibs" is NOT allowed.@{par}


@{b}@{i}@{u}MOST IMPORTANT:@{ub}@{ui}@{uu}@{par}

"HSMathLibs" is PROVIDED AS IS. Use it at your OWN RISK.@{par}

The author is NOT RESPONSIBLE for any data loss or damage caused directly or
indirectly by the use of "HSMathLibs".@{par}

All rights reserved. Please send bugreports and suggestions.@{par}
@endnode
///
/// History
@node History
@{b}@{fg shine}History:@{par}
~~~~~~~~@{fg text}@{ub}@{par}

@{b}HSMathLibs V.44.41 (01.02.1999 - 15.04.2000):@{par}
ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ@{ub}@{par}


@{b}HSMathLibs V.44.40 (06.09.1998 - 30.01.1999):@{par}
ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ@{ub}@{par}
- the functions "IEEEDPCos", "IEEEDPSin", "IEEEDPSincos", "IEEEDPTan", "IEEEDPExp",
"IEEEDPAtan", "IEEEDPAcos", "IEEEDPAsin", "IEEEDPLog", "IEEEDPLog10", "IEEEDPPow",
"IEEEDPCosh", "IEEEDPSinh", "IEEEDPTanh" (mathieeedoubtrans.library), "IEEEDPCmp", "IEEEDPTst",
"IEEEDPFloor", "IEEEDPCeil" (mathieeedoubbas.library), "SPAdd", "SPSub", "SPMul", "SPDiv",
"SPFlt", "SPFloor", "SPCeil" (mathffp.library), "IEEESPCos", "IEEESPSin", "IEEESPSincos",
"IEEESPTan", "IEEESPExp", "IEEESPAtan", "IEEESPAcos", "IEEESPAsin", "IEEESPLog", "IEEESPLog10",
"IEEESPPow", "IEEESPCosh", "IEEESPSinh", "IEEESPTanh" (mathieeesingtrans.library), "SPCos",
"SPSin", "SPSincos", "SPTan", "SPExp", "SPAtan", "SPAcos", "SPAsin", "SPLog", "SPLog10", "SPPow",
"SPCosh", "SPSinh", "SPTanh", "SPFieee", "SPSqrt" (mathtrans.library), "IEEESPCmp", "IEEESPTst",
"IEEESPFloor" and "IEEESPCeil" (mathieeesingbas-Patch) optimized@{par}

- Bugfixing of the functions "IEEEDPCos", "IEEEDPSin", "IEEEDPSincos", "IEEEDPTan",
"IEEEDPExp", "IEEEDPPow", "IEEEDPCosh", "IEEEDPSinh", "IEEEDPTanh", "IEEEDPAsin", "IEEEDPAtan",
"IEEEDPAcos" (mathieeedoubtrans.library), "IEEESPCos", "IEEESPSin", "IEEESPSincos", "IEEESPTan",
"IEEESPExp", "IEEESPAtan", "IEEESPAsin", "IEEESPAcos", "IEEESPTanh", "IEEESPPow"
(mathieeesingtrans.library), "SPCos", "SPSin", "SPSincos", "SPTan", "SPExp", "SPAtan", "SPAsin",
"SPAcos", "SPTanh", "SPPow" (mathtrans.library), "SPAdd", "SPSub", "SPMul", "SPDiv" and "SPCeil"
(mathffp.library)@{par}

- the manual overwork and extend@{par}

- installerscript overwork and extend@{par}


@{b}HSMathLibs V.44.33 (11.11.1998 - 15.11.1998):@{par}
ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ@{ub}@{par}
- Bugfixing of the functions "IEEESPSin" (mathieeesingtrans.library) and
"IEEEDPSin" (mathieeedoubtrans.library)@{par}


@{b}HSMathLibs V.44.32 (17.09.1998 - 10.11.1998):@{par}
ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ@{ub}@{par}
- Bugfixing of the functions "SPCos", "SPSin", "SPExp" (mathtrans.library),
"IEEESPCos", "IEEESPSin", "IEEESPExp" (mathieeesingtrans.library), "IEEEDPCos",
"IEEEDPSin", "IEEEDPExp" (mathieeedoubtrans.library) and many other functions@{par}

- the manual overwork and extend@{par}


@{b}HSMathLibs V.44.31 (06.09.1998 - 16.09.1998):@{par}
ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ@{ub}@{par}
- Bugfixing of the function "IEEEDPPow" (mathieeedoubtrans.library)@{par}


@{b}HSMathLibs V.44.30 (26.07.1998 - 05.09.1998):@{par}
ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ@{ub}@{par}
- the mathffp.library and a patch to load this lib written@{par}

- the functions "SPExp", "SPLog", "SPLog10", "SPPow", "SPAcos", "SPCosh",
"SPSinh", "SPTanh" (mathtrans.library), "IEEESPExp", "IEEESPLog", "IEEESPLog10",
"IEEESPPow", "IEEESPAcos", "IEEESPCosh", "IEEESPSinh", "IEEESPTanh"
(mathieeesingtrans.library), "IEEEDPLog", "IEEEDPLog10", "IEEEDPPow",
"IEEEDPAcos", "IEEEDPCosh", "IEEEDPSinh", "IEEEDPTanh"
(mathieeedoubtrans.library) and many other functions optimized@{par}

- Bugfixing of the function "InitLib" by all libraries@{par}

- Bugfixing of the functions "SPPow", "SPCos", "SPSin", "SPTan"
(mathtrans.library), "IEEESPPow", "IEEESPCos", "IEEESPSin", "IEEESPTan"
(mathieeesingtrans.library), "IEEEDPPow", "IEEEDPCos", "IEEEDPSin",
"IEEEDPTan" (mathieeedoubtrans.library), "IEEEDPFloor", "IEEEDPCeil"
(mathieeedoubbas.library) and many other functions@{par}

- the manual overwork and extend@{par}

- installerscript overwork and extend@{par}
@endnode
///
/// Future
@node Future
@{b}@{fg shine}The future:@{par}
~~~~~~~~~~~@{fg text}@{ub}@{par}

The following topics are on my wishlist for the next versions of
"HSMathLibs".@{par}

- more speed ???@{par}

- Your suggestions@{par}
@endnode
///
/// Thanks
@node Thanks
@{b}@{fg shine}Thanks:@{par}
~~~~~~~@{fg text}@{ub}@{par}

I want to thank the following persons and companies:@{par}
ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ@{par}

- by all registered user@{par}

- @{b}Uwe Schienbein@{ub}; for betatesting@{par}

- @{b}ALeX Kazik@{ub}; for betatesting and bugreports@{par}

- @{b}Jens Schildknecht@{ub}; for betatesting and bugreports@{par}

- @{b}Kai Fleischer@{ub}; for the translation (english) of this guide@{par}

- @{b}Massimo Gais@{ub}; for the translation (italiano) of this guide@{par}

- @{b}Llorenç Grau@{ub}; for the translation (catalan) of this guide@{par}

- @{b}Juergen Urbanek@{ub}; for betatesting and bugreports@{par}

- @{b}Jens Troeger@{ub}; for the indication to the installerscript@{par}

- @{b}Dietmar Heidrich@{ub}; for "OMA"@{par}

- @{b}Frank Wille@{ub}; for "PhxAss"@{par}

- by all user which I have forget, sorry@{par}
@endnode
///
/// Author
@node Author
@{b}@{fg shine}Author:@{par}
~~~~~~~@{fg text}@{ub}@{par}
@{jcenter}
Matthias Henze@{par}
Gorkistrasse 127@{par}
04347 Leipzig@{par}
Germany@{par}

fon: +49 (0) 341/2326414@{par}

email: Matthias_Henze@CyberdyneSystems.de@{par}

URL: http://WWW.CyberdyneSystems.de/@{par}

@{b}@{fg shine}English guide:@{par}
~~~~~~~~~~~~~~@{fg text}@{ub}@{par}
For bugreports or suggestions concerning the english guide please email:@{par}

    kai.fleischer@cww.de@{par}
@{par}

@{jleft}
I am always looking for bugreports und suggestions.@{par}
Please tell me your opinion about "HSMathLibs".@{par}
@endnode
///
/// Index
@node guideIndex Index
@{code}@{b}@{fg shine}Index:
~~~~~~@{fg text}@{ub}

@{b} A@{ub}

 @{" Author           " link author}

@{b} C@{ub}

 @{" Copyright        " link Copyright}

@{b} H@{ub}

 @{" History          " link History}

@{b} I@{ub}

 @{" Installation     " link Installation}
 @{" Introduction     " link Introduction}

@{b} K@{ub}

 @{" Known bugs       " link "Known Bugs"}

@{b} R@{ub}

 @{" Requirements     " link Requirements}

@{b} S@{ub}

 @{" Special features " link "Special features"}

@{b} T@{ub}

 @{" Thanks           " link Thanks}
 @{" The future       " link future}

@{b} U@{ub}

 @{" Updates          " link Updates}

@endnode
///