Software Development in Practice

General

Contents

  1. Releasing software in petsoftware directory
    Gives instructions for updating the petsoftware directory.
  2. Using make-utility in TPC software development
    Gives instructions for using special Makefile targets defined for TPC software.
  3. Updating TPC C-library
    Gives instructions for updating TPC C-libraries.

Releasing software in petsoftware directory

When you have updated sources in petsoftware/source folder, follow these instructions to update petsoftware with make targets.
Click here to view the standard Makefile.

Programs

UNIX


Go to the folder where the updated source is
Type
"make -e" to compile
"make -e install" to install the executables in directory petsoftware/bin/unix
"make -e www" to update petsoftware/www
"make -e archive" to update directory petsoftware/archive, don't archive the sources if you have already archive on Windows.


Windows


Go to the folder where the updated source is
Type
"make -e" to compile
"make -e install" to install the executables in directory petsoftware/bin/windows
"make -e www" to update petsoftware/www
or "make -e exearchive" if you have used target www already in UNIX.
in MSYS terminal "make -e archive" to update directory petsoftware/archive in Windows, don't do this if you have already archived on UNIX


After this remember to update files modelling.html and imaging.html!


When you have finished you should have:

  • all the sources packed (example_0_0_1_20050520.zip) in folder archive/programs
  • UNIX executable (example_0_0_1) in folder bin/unix
  • windows executable (example_0_0_1.exe) in folder bin/windows
  • both executables packed (names example_sol.zip and example_dos.zip)
    and all source files packed (name example_src.zip) in www/programs
  • new program help file (example.html) in www/programs/doc
  • updated modeling.html and imaging.html files in www/programs
    (at the moment updating has to be done by hand)

Using make-utility in TPC software development

General

After the required environment variables has been set, as instructed in Software development in TUCH network, user can apply the special make targets for TPC software. Naming of the make targets loosely follow the GNU naming policy for make targets.

Library Makefile

Main targets in a TPC library Makefile:
  • compile: compile the library and the test program
  • install: install the library and the test program
  • www: create the html documentation with doxygen and distribute the sources
  • archive: archive the source code
  • test: run tests on library
  • clean & clobber: clean the directory
  • upgrade: clean compile test install html archive

    • Program Makefile

    Main targets in a TPC program Makefile:
  • compile: compile the program
  • install: install the program
  • www: create the html documentation and distribute the sources and executables
  • archive: archive the source code
  • clean & clobber: clean the directory

    • Usage

    To overwrite possible INCLUDE and LDFLAGS settings in the Makefile use option -e for compiling, e.g.
    make -e or make -e compile to compile,
    make -e install to install, make -e archive to archive etc.

    Updating TPC C-libraries

    Responsibilities

    Library guardians

    Kaisa Liukko: libtpccurveio, libtpcmodel, libtpcroi
    Jarkko Johansson: libtpcimgio, libtpcimgp, libtpcmisc
    The guardians will keep track on who are working with their libraries, check and accept modifications/new functions and install new versions. To get modification/new functions accepted, proper testfunctions and comments inside the code are required.

  • Always when you start to work with already existing library functions, ask a permission from the guardian concerned!!
  • After you have finished your work send it to the guardian for acceptance. After accepting modifications the guardian will install updated library version.



    • Last modified: Fri Dec 02 14:46:07 Normaaliaika 2005