"Fossies" - the Fresh Open Source Software Archive

Member "SAOImageDS9/tcl8.6/pkgs/README" (13 Nov 2019, 2652 Bytes) of package /linux/misc/ds9.8.1.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 
    2 The 'pkgs' subdirectory of the Tcl source code distribution is meant to be
    3 a place where the source code distribution of Tcl packages may be placed so
    4 that they are built, installed, and tested along with Tcl.  As originally
    5 distributed, Tcl re-distributes a number of packages in this location.  The
    6 build systems for Tcl are written so that additional packages may be added,
    7 or the original packages removed in any number and still have all packages
    8 present get built, installed, and tested along with Tcl.
    9 
   10 In order for a package to work properly under the pkgs subdirectory, it
   11 needs to conform to the following conventions.
   12 
   13   All files of the package need to be contained in (subdirs of ...) a
   14   single subdirectory of the "pkgs" directrory.
   15 
   16   In that subdirectory of "pkgs" there must be an executable file named
   17   "configure".  When the program "configure" is run, it should generate
   18   a file "Makefile" in the current working directory.  The "configure"
   19   program should be able to accept as command line arguments all the
   20   arguments that can be passed to the master unix/configure program.  It
   21   should also accept the --with-tcl= and --with-tclinclude= options in
   22   the conventional way.
   23 
   24   The generated "Makefile" must be one suitable for controlling the operations
   25   of a `make` program.  The following targets must be defined:
   26 
   27     <default>:	Perform a build of the runtime components of the
   28 		package from sources.
   29 
   30     install:	Copy the runtime components of the package into their
   31 		installed location.  Must respect the DESTDIR variable
   32 		for determining the installation location.
   33 
   34     test:	Run the test suite of the package.  Must respect the
   35 		TCLSH_PROG, TESTFLAGS variables.
   36 
   37     clean:	Delete all files generated by the default build target.
   38 
   39     distclean:	Delete all generated files.
   40 
   41     dist:	Produce a copy of the package's source code distribution.
   42 		Must respect the DIST_ROOT variable determining where to
   43 		write the generated directory.
   44 
   45 Packages that are written to make use of the Tcl Extension Architecture (TEA)
   46 and that make use of the tclconfig collection of support files, should
   47 conform to these conventions without further efforts.
   48 
   49 These conventions are subject to revision and refinement over time to
   50 better support the needs of the build system.  Efforts will be made to
   51 keep the TEA support scripts consistent with the demands of this system.
   52 
   53 In addition, it is requested that packages also support building with
   54 Microsoft Visual Studio tools.  This means the file win/makefile.vc
   55 should be included, suitable for use by the nmake program, defining the
   56 targets <default>, install, test, and clean.
   57