home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume14 / ephem-4.21 / part02 / Readme < prev    next >
Encoding:
Text File  |  1990-08-30  |  6.4 KB  |  160 lines
  1. General Notes for version 4.20, August 17, 1990:
  2.  
  3. 1) Start by reading the generic-printer-ready manual in Man.txt. If you have
  4.    source, read on in this file for building hints.
  5.  
  6. 2) Beware that ephem does not gracefully handle the fact that there is no year
  7.    0 in the Christian calendar. It is best to avoid entering a year of 0 for
  8.    now.
  9.  
  10. Recent Change History:
  11.  
  12. Changes from 4.19 to 4.20:
  13.     add g/k and H/G magnitude model options for elliptical objects.
  14.     put moon's geocentric long/lat under Hlong/Hlat columns.
  15.     allow entering negative decimal years.
  16.     init all static mjd storage to unlike times.
  17.     add USE_TERMIO option to io.c.
  18.  
  19. Changes from 4.18 to 4.19:
  20.     add listing feature, with 'L' hot-key.
  21.     add title for plot file (as well as listing file).
  22.     add some (void) casts for lint sake.
  23.  
  24. Changes from 4.17 to 4.18:
  25.     fix parabolic comet bug in objx.c (bad lam computation).
  26.  
  27. Changes from 4.16 to 4.17:
  28.     add 'c' short cut to Menu field.
  29.     display full Dec precision for fixed objx setup.
  30.     increase pluto auscale in watch.c, and guard screen boundries.
  31.     add Pause field.
  32.     fruther improve rise/set and dawn/dusk times.
  33.     add MENU={DATA,RISET,SEP} config/arg option.
  34.  
  35. Changes from 4.15 to 4.16:
  36.     watch popup now allows changing formats without returning.
  37.     add 'w' short cut to watch field.
  38.     improve labeling a bit in Dome display.
  39.  
  40. Changes from 4.14 to 4.15:
  41.     move setjmp() in main so it catches error in config file too.
  42.     maintain name of objx/y and generally clean up objx.c.
  43.     fix bug in circum.c related to phase of fixed objects.
  44.     add "Sky dome" watch format and improve labels.
  45.     remember last watch, plot and search popup selections.
  46.  
  47. Changes from 4.13 to 4.14:
  48.     fix bug watching object y by adding y to body_tags[] in watch.c.
  49.     add ! support (#ifdef BANG in sel_fld()).
  50.     add support for VMS via #ifdef VMS.
  51.     switch to EPHEMCFG environ variable (HOME no longer used).
  52.     fix phase so it works for objects out of the ecliptic.
  53.  
  54. If you have source, here is how you build ephem:
  55.  
  56. 1) io.c:
  57.    define UNIX, VMS or TURBO_C in io.c depending on your system. Note that
  58.    TURBO_C also seems to work ok with Microsoft and Lattice C too but these
  59.    have not been tested recently. Note also that the VMS C compiler defines VMS
  60.    automatically so you don't really have to #define it.
  61.  
  62.    Also in io.c and if you use UNIX, you have two choices of methods for doing
  63.    non-blocking reads depending on whether you define USE_NDELAY; use whichever
  64.    works for you. You can also choose between sgtty.h and termio.h; again,
  65.    use whichever works on your system; for the latter, define USE_TERMIO.
  66.  
  67.    MSDOS users can do cursor control with direct BIOS calls (the default),
  68.    or with ANSI.SYS by defining USE_ANSISYS in io.c.
  69.  
  70. 2) time.c:
  71.    Select from two methods of dealing with time from the operating system
  72.    with the TZA/TZB defines in time.c. If you get link undefines related to
  73.    time functions try changing to the other form.
  74.  
  75.    On Sun systems running OS 4.0.3 (or BSD 4.3) or Apollo SR 10.1 use TZB and
  76.    change <time.h> to <sys/time.h>.
  77.  
  78.    For VMS, since it does not support time zone info, do NOT #define EITHER
  79.    of TZA or TZB. This will have the effect of leaving the time zone unchanged
  80.    whenever you set the time via the "Now" option. (This is taken care of
  81.    automatically in time.c by #undef'ining TZA and TZB if VMS is defined.)
  82.  
  83. 3) mainmenu.c:
  84.    if you are compiling for an IBM-PC then try #define PC_GRAPHICS for a
  85.    nicer looking way to draw the screen boundry lines.
  86.  
  87. 4) sel_fld.c:
  88.    if your runtime library supports the system() function (to run a shell
  89.    command) then #define BANG in sel_fld.c, else leave it undefine. When
  90.    defined, this will allow you to jump out of ephem and run any command,
  91.    then resume where you left off.
  92.  
  93. 5) beware that I have not used string.h or strings.h. if your library's
  94.    strlen() and str.*cmp() functions don't return int (such as long), then you
  95.    will have to hand add string.h or your own extern declarations. I have
  96.    included all the necessary declarations for the functions that return
  97.    (char *) such as strcpy(), etc, though.
  98.  
  99. 6) main.c calls sleep() which is not in some IBM-PC runtime C libraries. You
  100.    might kludge up your own call that does a cpu countdown loop. The accuracy
  101.    will only effect the Pause feature, not ephem's actual time mechanisms.
  102.  
  103. 7) Ephem can now be built by simply compiling all the .c files and linking them
  104.    all together. On Unix systems, you must also link with the termcap library
  105.    (-ltermcap) and possibly the auxiliary math library (-lm) if your default C
  106.    library does not include all the required transcendental functions. At the
  107.    end of this file I have included a VMS build script for those building
  108.    ephem on a that system.
  109.  
  110. The following files are pretty much just pure transliterations from BASIC
  111. into C from machine-readable copies of the programs in Duffett-Smith's book.
  112. They have nothing to do with the rest of ephem so they may be used for
  113. completely different applications if so desired.
  114.  
  115.    aa_hadec.c anomaly.c astro.h cal_mjd.c comet.c eq_ecl.c moon.c moonnf.c
  116.    nutation.c obliq.c parallax.c pelement.c plans.c precess.c reduce.c
  117.    refract.c sex_dec.c sun.c utc_gst.c
  118.  
  119. $!========================================================================
  120. $!
  121. $! Name      : BUILD.COM
  122. $!
  123. $! Purpose   : compile and link ephem under VMS
  124. $!
  125. $! Arguments : P1/P2 = DEBUG: compile with DEBUG info
  126. $!             P1/P2 = LINK : link only
  127. $!
  128. $! Created  23-MAR-1990   Karsten Spang
  129. $!
  130. $!========================================================================
  131. $   ON ERROR     THEN $ GOTO EXIT
  132. $   ON CONTROL_Y THEN $ GOTO EXIT
  133. $   IF P1.EQS."DEBUG" .OR. P2.EQS."DEBUG"
  134. $   THEN
  135. $       CC:=CC/DEBUG/NOOPTIMIZE/NOLIST
  136. $       LINK:=LINK/DEBUG/NOMAP
  137. $   ELSE
  138. $       CC:=CC/NOLIST
  139. $       LINK:=LINK/NOMAP
  140. $   ENDIF
  141. $   FILES="MAIN,AA_HADEC,ALTMENUS,ANOMALY,CAL_MJD,CIRCUM,COMET,COMPILER,"+ -
  142.         "EQ_ECL,FLOG,FORMATS,IO,MAINMENU,MOON,MOONNF,NUTATION,"+ -
  143.         "OBJX,OBLIQ,PARALLAX,PELEMENT,PLANS,PLOT,POPUP,PRECESS,REDUCE,"+ -
  144.         "REFRACT,RISET,RISET_C,SEL_FLD,SEX_DEC,SRCH,SUN,TIME,UTC_GST,"+ -
  145.         "VERSION,WATCH"
  146. $   IF P1.EQS."LINK" .OR. P2.EQS."LINK" THEN GOTO LINK
  147. $   FILE_NUM=0;
  148. $COMPILE_LOOP:
  149. $       FILE=F$ELEMENT(FILE_NUM,",",FILES)
  150. $       IF FILE.EQS."," THEN GOTO COMPILE_END
  151. $       CC 'FILE'
  152. $       FILE_NUM=FILE_NUM+1
  153. $       GOTO COMPILE_LOOP
  154. $COMPILE_END:
  155. $LINK:
  156. $   LINK/EXE=EPHEM 'FILES',SYS$INPUT/OPT
  157. SYS$LIBRARY:VAXCRTL/SHARE
  158. $EXIT:
  159. $   EXIT
  160.