"starlib" installation instructions.

INSTALLATION INSTRUCTIONS:

What you need before you begin:

Follow the steps...

  1. Get the starlib.tar.gz file from BMRB.
  2. Unpack the archive file with this command:
    gunzip --stdout starlib.tar.gz | tar xvf -

  3. cd starlib

  4. Edit the "Makefile". Uncomment the appropriate section for your particular OS/compiler. Also change the appropriate defines that set up where the compiler is on your system, if need be.

    I apologise for not using something like GNU autoconf, but we have not had time to convert to it. I am interested in any systems on which this code is known to compile, and the Makefile that was used to do so. If you change the Makefile and it compiles, please let BMRB know so we can make it part of the standard install in a later version. (e-mail address can be found at the bottom of this document).

  5. Issue the command: make

  6. If it works, copy the resulting libstar.a file to a location where you intend to use it, and copy all the header files in this directory (*.h) to a location where a program using this library can find them using the '-I' option to the compiler.

    If you don't mind the clutter, you can just use the directory in which you just built starlib for this purpose.

    If you are like me and prefer to read the header files, to see the exact prototypes in addition to using the documentation, I recommend that you read them in the order shown here for maximum understandability:

  7. Read the next topic, "Using the library" for instructions on how to make use of libstar.a in your own code.

The current maintainer of starlib is:


- previous topic - - next topic -