home *** CD-ROM | disk | FTP | other *** search
/ Amiga Games 1996 January / amigagames-cdrom-1996-01.iso / archive / userbox / publicdomain / astrolog.lha / Astrolog / Readme.amiga < prev    next >
Text File  |  1995-08-11  |  11KB  |  269 lines
  1. Short: Amiga port of Astrolog (Version 4.40)
  2. Type: misc/sci
  3. Uploader: tf@antares.ping.de (Tobias Ferber)
  4. Author: astara@u.washington.edu (Walter D. "Cruiser1" Pullen)
  5. Replaces: misc/misc/ast44pl4.lha
  6.  
  7. Note: The patchlevel (pl) is valid for Amiga versions of Astrolog only!
  8.  
  9. ******************************************************************************
  10. * ABSTRACT
  11. ******************************************************************************
  12.  
  13. Astrolog version 4.40 is a powerful, customizable, and platform independent
  14. astrology chart calculation program, used in 20+ countries on six continents.
  15. It is 100% freeware and requires no registration fee.  :) The complete source
  16. code is available.  Astrolog features:  wheels, aspects, midpoints,
  17. relationship charts, transits, progressions, some interpretations,
  18. astro-graphy, local horizon, constellations, planet orbits, dispositors,
  19. various influence charts, biorhythms, different zodiacs, central planets, 13
  20. house systems, 8400 year ephemeris, asteroids, Uranians, fixed stars, Arabic
  21. parts, script files and macros, PC screen graphics, X11 Windows graphics,
  22. smooth animation of charts, graphic files in PostScript, Windows metafile, and
  23. bitmap formats, and more!
  24.  
  25. ******************************************************************************
  26. * INSTALLATION
  27. ******************************************************************************
  28.  
  29. Read the "Distfile" and "readme.440" for details about the files in this
  30. archive.  Copy the executable (astrolog.000 or astrolog.030 respectively)
  31. somewhere into your path and rename it to "astrolog".  Copy the config file 
  32. "astrolog.dat" into the same directory as where you put the executable.
  33. Make sure that your stack size is set to at least 10240 bytes:
  34.  
  35.   stack 10240
  36.  
  37. Now try out:
  38.  
  39.   astrolog -n -X
  40.  
  41. (... and press `q' to quit)
  42.  
  43. You might also want to play around with the default graphics resolution in
  44. the file "astrolog.dat" (line 146).  I use
  45.  
  46. :Xw 554 554
  47.  
  48. -->  Please have a look at the file "HELPFILE.440" !   A Texinfo version of
  49.      this file can be found -- together with various other formats like
  50.      AmigaGuide®, PostScript, DVI, etc. in the ast44pl5-doc.lha archive!
  51.  
  52. ******************************************************************************
  53. * FREQUENYLY ASKED QUESTIONS (FAQ)
  54. ******************************************************************************
  55.  
  56. Q: I changed astrolog.dat and configured my default longitude and latitude
  57.    via `-zl', set the default time zone via `-z' and the DST via `-z0' but
  58.    Astrolog still keeps using the wrong time when calling it via `-n' or
  59.    `-i now'.  Why?
  60.  
  61. A: Astrolog expects your system clock to be set to GMT (which is correct for
  62.    unix systems and thus a feature, not a bug :-).  However on PC and Amiga
  63.    systems the internal clock is set to LMT and so Astrolog gets the "wrong"
  64.    time.
  65.  
  66.    A localized Amiga Workbench allows setting the time zone via the Locale
  67.    prefs.  However, locale.library does not support DST yet (version 40.4).
  68.    Since the Amiga port of Astrolog knows about locale.library it will try
  69.    to get the time zone from your Locale prefs but for said reason this will
  70.    be false if DST is in effect (or if you don't have a localized WB).
  71.  
  72.    This is why Astrolog preferably uses ENV:GMTOFF to convert your system
  73.    time to GMT.  The environment variable GMTOFF holds the number of seconds
  74.    which your system time differs from GMT.
  75.  
  76.    Example:
  77.  
  78.    (!)  I live in Germany and we have CET, which is +1h from GMT.  Currently
  79.         DST is in effect, so we are actually +2h from GMT.  Solution:
  80.  
  81.           SetEnv GMTOFF `eval (1+1)*60*60`
  82.           Copy ENV:GMTOFF ENVARC:
  83.  
  84.         In astrolog.dat we need "-z -1", which sais that we have CET and
  85.         "-z0 1", which sais that DST is in effect.
  86.  
  87.  
  88. Q: ... Oh! what a superb GUI ...
  89.  
  90. A: Yes, a MUI GUI (c: is under development.
  91.  
  92.  
  93. Q: Is there any documentation besides "Helpfile.440" ?
  94.  
  95. A: I made a Texinfo version "astrolog.texi" of Helpfile.440.  Texinfo can be
  96.    converted into many other hypertext formats such as Info, AmigaGuide® or 
  97.    HTML, but also to DVI or PostScript.  However, Amiga specific modifications
  98.    are not yet mentioned in this file.
  99.  
  100. ******************************************************************************
  101. * CHANGES SINCE AST44PL4.LHA
  102. ******************************************************************************
  103.  
  104. o  Problems with the 68000 version are solved.
  105.  
  106. o  The Amiga version of astrolog is now distributed in 4 archives:
  107.  
  108.      ast44pl5-000.lha - Basic files and executable for all Amigas
  109.      ast44pl5-030.lha - Basic files and executable for 68030/68882 Amigas
  110.      ast44pl5-doc.lha - Documentation in Texinfo, AmigaGuide, DVI, PostScript
  111.      ast44pl5.src.lha - The source code of the Amiga version
  112.  
  113.    Additional information about these archives and their contents can be  
  114.    found in the supplied "Distfile".
  115.  
  116. ******************************************************************************
  117. * CHANGES SINCE AST44PL3.LHA
  118. ******************************************************************************
  119.  
  120. o  Several minor modifications have been made to the source code.
  121.  
  122. o  The source code and further documentation (!) are now distributed together
  123.    with the executable.  I'm sorry for increasing your downloading costs with 
  124.    the size of the archive, but there had been *very* many requests for an 
  125.    amiga-compilant version of the source code!
  126.  
  127. ******************************************************************************
  128. * CHANGES SINCE AST44PL2.LHA
  129. ******************************************************************************
  130.  
  131. o  Double buffered animations are now implemented!
  132.  
  133. o  When pressing 'H', '?' or 'v' in graphics mode then the help page and/or
  134.    the chart listing is printed onto the graphics screen now instead of the
  135.    console window.
  136.  
  137. o  The `-k' extends the charset which lead to problems with Astrolog's
  138.    internal vector font.  We now ignore the `-k' switch in graphics mode.
  139.    (I actually abused the `-k' switch in graphics mode to offer an alternate 
  140.    EGA palette which is slightly brighter than the default palette.)
  141.  
  142. o  An experimental interaction page has been provided in graphic mode.
  143.    It can be reached via TAB if animation mode is off.
  144.  
  145. o  Large parts of Astrolog have been revised and some new generic functions
  146.    have been provided which lead to faster and better readable code... (-:
  147.  
  148. ******************************************************************************
  149. * CHANGES SINCE AST44PL1.LHA
  150. ******************************************************************************
  151.  
  152. o  Astrolog now processes mouse events and allows keyboard input from the
  153.    chart window now instead of from the console window.  (xscreen.c)
  154.    This also means that the ^C signal is checked and can be used to quit
  155.    Astrolog.
  156.  
  157. o  Fixed a bug in the bitmap saving routine which made it impossible to save
  158.    the Astrolog output to a file.
  159.  
  160. o  In contrast to other systems, the Amiga system clock knows local mean time
  161.    (LMT) only.  This lead to problems with the `-n' or `-i now' option.
  162.  
  163.    Astrolog now tries to obtain the local offset from Greenwich Mean Time via
  164.    the locale.library (V38+).  If for any reason you want to overwrite the
  165.    offset obtained from there or if you don't have V38 or better then you can
  166.    set the environment variable `GMTOFF' to the offset from GMT in seconds.
  167.    (Positive values indicating East of Greenwich.)
  168.  
  169.    Note:  The locale library actually (V40.4) does *not* support Daylight
  170.           Savings Time.  You might therefore need GMTOFF even if you have
  171.           locale when DST is in effect (-z0 1).
  172.  
  173.    (Problem reported by John Blyth,john.blyth@edserv.monash.edu.au)
  174.  
  175. o  Astrolog.000 contained MC86020 or '030 code.  It crashed on MC68000 Amigas.
  176.    This is actually a problem of gcc-2.6.3.  However, I finally managed to
  177.    compile astrolog via DCC 2.07.56R (11.6.93).
  178.  
  179.    (Reported by Ian Forster,ifor@fastnet.co.uk)
  180.  
  181. o  Astrolog used to "forget" the former X/Y resolution when switching to
  182.    certain chart types, like the world map and aspect grids which must
  183.    always be at a certain size.  This is however a non-amiga-specific
  184.    astrolog problem which has been fixed using a quick hack.
  185.  
  186.    (Bug reported by Robin Reynolds,astarte@solar.sky.net)
  187.  
  188. ******************************************************************************
  189. * CHANGES SINCE ASTROLOG-4.40.LHA
  190. ******************************************************************************
  191.  
  192. o  Fixed the wrong graphics.library LVO of DrawEllipse()
  193.    (Bug reported by Michal Kara,lemming@k332.feld.cvut.cz)
  194.  
  195.    Hmmm... I really don't know why it worked on my machine?!  8-/
  196.  
  197. ******************************************************************************
  198. * CHANGES IN THE SOURCE CODE OF AST44SRC.ZIP
  199. ******************************************************************************
  200.  
  201. astrolog.h line 1167 & extern.h line 127:
  202.  
  203. #ifdef PI
  204. #undef PI
  205. #endif /*PI*/
  206.  
  207. astrolog.c: return type of main() changed from `void' to `int'
  208.  
  209. data.c:115: initializer element is not constant
  210.  
  211.     FILE *S = stdout;  /* initialization moved to main() */
  212.  
  213.  
  214. general.c:652:  sign = (int)floor(deg / 30.0);
  215.                             ^^^^^
  216.     otherwise the degree value 'd' might become negative
  217.  
  218.  
  219. general.c:663:  d = (int)floor(deg / 15.0);
  220.                          ^^^^^
  221.     otherwise the minutes value 'm' might become negative
  222.  
  223. ----
  224.  
  225. astrolog.h
  226.     Added some fields to struct gi and some #includes and prototypes
  227.         for the AMIGA.   Changed the default input search path to "PROGDIR:"
  228.  
  229. xgeneral.c
  230. xscreen.c
  231.     Implementation of Amiga graphic support.  See #ifdef AMIGA for
  232.     the relevant parts.  Some changes had to be made because of the
  233.     #else clauses which expected everything which was not X11 to be
  234.     PCG.
  235.  
  236. ellipse.s
  237.     Here we call LVO_DrawEllipse() via GfxBase.  We need this because
  238.     Astrolog's ellipse routine is called DrawEllipse() as well.
  239.         This file is needed on Amiga *only*.
  240.  
  241. io.c
  242.     ':' has been introduced as a legal path seperator like '/'.
  243.     Astrolog first attempts to read `astrolog.dat' from the current
  244.     directory (as usual) but then (if that fails) it looks in it's
  245.     own directory `PROGDIR:astrolog.dat'.
  246.  
  247. amiga.c
  248.     Routines to initialize and close Amiga graphics.
  249.  
  250. ----
  251.  
  252. Several other modifications have been made.  Search for #ifdef AMIGA in the
  253. source code for further details.
  254.  
  255. See also: my posting <5onwk3YjTyB@antares.ping.de> in alt.astrology.
  256.  
  257. #+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#
  258.  
  259. Astrolog 4.40's DOS, Mac, and Unix versions (along with an old OS/2
  260. port) may be downloaded using anonymous ftp at ftp.magitech.com in
  261. /pub/astrology/astrolog. The DOS version is also at oak.oakland.edu in
  262. /SimTel/msdos/entertn/ast44*.zip. There are some other programs at the
  263. former site in /pub/astrology/software and at the latter site in the
  264. same directory and in the corresponding directory for Windows programs.
  265.  
  266. #+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#
  267. +       Walter D. "Cruiser1" Pullen      !      astara@u.washington.edu       +
  268. #+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#+#
  269.