

  
                             3D Foundation Classes



                                *** UTILS ***



     -------------------
      Table of Contents
     -------------------



           Introduction

           Make Install



     --------------
      Introduction
     --------------

           

            The utilitys available are in directory UTIL.
            
            
            They can be compiled using: "make utils", from 3DFC root
            
            directory. Or each one can be compiled separetely
            
            using: "make util_label", where "util_label" is a name
            
            with sufix "ut", like "utmkins".

            Try "make utmkins", this make the util Make Install.

            All executable files are placed in the UTIL/BIN directory and
            
            have the prefix ".exe".

            
            Some examples can be used as tools, but are not related here.



     --------------
      Make Install
     --------------
            


            This util create a C file, compilable by GCC, that can self extract

            some files, is usefull to make a package installer.


            To use just dispose the files you want to pak in a directory
            
            tree.
            
            Run mkins passing as command line the directory tree and the
            
            pak file.
            
            Automaticaly mkins will create a C file with the contents of
            
            the directory.
            
            After that compile the C file, generating the self extractor
            
            executable.
            
            If you run the compiled file it will create all directory
            
            structure, starting at the directory where it is running.

            
            Problems:


            Because the installation data in inside the self extractor code,
            
            it cann't be too much big (up to 300Kb - more or less). If you
            
            want a biggest pak file is needed set some GCC compiler options
            
            to reserve a biggest heap to the compiled program. I don't know

            what options.

            
            Example:

            
            1) Your directory tree:

                  d:\Proj\Data

               Directory Proj:

                  source.cc
                  makefile

               Directory Data:

                  start.wav
                  photo.pcx

            
            2) Create C file (the pak extractor)

                  mkins install.c d:\proj

            
            3) Compile the C file

                  gcc -o install.exe install.c

            
            4) Test, just run

                  install.exe
