 
Basics, Building SPICE Applications (FORTRAN)
===========================================================================
 
   May 21, 2018
 
 
Note About HTML Links
--------------------------------------------------------
 
   The HTML version of this lesson contains links pointing to various HTML
   documents provided with the Toolkit. All of these links are relative
   and, in order to function, require this document to be in a certain
   location in the Toolkit HTML documentation directory tree.
 
   In order for the links to be resolved, if not done already by installing
   the lessons package under the Toolkit's ``doc/html'' directory, create a
   subdirectory called ``lessons'' under the ``doc/html'' directory of the
   ``toolkit/'' tree and copy this document to that subdirectory before
   loading it into a Web browser.
 
 
Environment Set-up
--------------------------------------------------------
 
 
Unix/Linux
 
   Assume SPICELIB is installed at /naif/toolkit/. The corresponding path
   for the SPICELIB library being /naif/toolkit/lib/spicelib.a.
 
 
Windows
 
   Assume SPICELIB is installed at C:\naif\toolkit\. The corresponding path
   for the SPICELIB library being C:\naif\toolkit\lib\SPICELIB.LIB.
 
 
A simple example program
--------------------------------------------------------
 
   This program calls the SPICELIB subroutine 'TKVRSN' then outputs the
   VERSN return argument.
 
   File tk_ver.f:
 
            PROGRAM TK_VER
 
            CHARACTER*(20) VERSN
 
            CALL TKVRSN ( 'TOOLKIT', VERSN )
 
            WRITE(*,*) 'Toolkit version: ', VERSN
 
            END
 
 
Unix/Linux
 
   This example uses the GNU FORTRAN 9X compiler (gfortran):
 
      skynet 35: gfortran tk_ver.f -o tk_ver /naif/toolkit/lib/spicelib.a
 
      skynet 36: ./tk_ver
       Toolkit version: N0061
 
   SPICE library naming does not conform to the UNIX convention of
   libname.a for use with the -L/path_to_libs/ -lname_of_lib compile
   option.
 
   A FORTRAN compiler may require an additional flag "-lU77" when linking
   against SPICELIB. A link failure due to an unresolved symbol "_exit"
   occurs when a link requires -lU77.
 
 
Windows
 
   This example uses the Digital FORTRAN compiler (df):
 
      > df tk_ver.f C:\naif\toolkit\lib\SPICELIB.LIB
 
      > tk_ver
       Toolkit version: N0061
 
