spotoconf(1) 0.94 spotoconf "Spotoconf"

Name

spotoconf - Configuration and build system

Table Of Contents
Description
SETUP
Files
VARIABLES
TARGETS
GETTING FANCY
Keywords
Category
Copyright

Description

Spot o' Conf is a TEA-inspired configure and build system that caters to Tcl and Jim extensions.

Copy all required files to the source dir of the package and create a spoto.conf file for the package. The spoto.conf file will be executed by configure and should set any variables required by the package.

Building needs at minimum: configure, Makefile.in and a spoto.conf file for the package. Installing needs at minimum: Spotoconf/install-sh, LICENSE, README, README.licenses, README.configure.

Modify as needed; Spotoconf files are not auto-generated.

Files

configure: Spotoconf's configure script.
Makefile.in: Spotoconf's Makefile.in.
tclconfig/install-sh
LICENSE
spoto.conf: Package's spoto.conf
README
Makefile.pkgs.in: Input Makefile for building a package that contains packages.
README.licenses
README.configure
doc
tests/all.tcl: Test runner for use with tcltest.
tests2k/all.tcl: Test runner for use with tcltest2k.

VARIABLES

These are the variables that are substituted into output files.

FOR_WHAT: Tcl or Jim. Default is Tcl.
TITLE: Title of the package. Mixed case acceptable.
NAME: Name of the package. Should be lower case.
VERSION: Version of the package.
NAMESPACE: Namespace the package lives in.
PKG_NAME
DIST_NAME
DESCR: One line description of the package.
CATEGORIES: List of categories of the package.
HOMEPAGE: The home page of the package.
LICENSE: The license of the package.
LOAD_LIB: How to load libraries. Either load or source.
INIT: Name of init function for .so libs.
FOR_WHAT
TITLE
NAME
VERSION
NAMESPACE
PKG_NAME
DIST_NAME
DESCR: One-sentence description.
CATEGORIES: Software categories.
HOMEPAGE: Software homepage.
LICENSE: Name of license
LIB
SHLIB
STLIB
LIBOBJ
LIBSRC
SCLIB
SCLIBSRC
SCLIBSRCDIR
DAT_DIR
DAT_FILES
DAT_SCRIPTS
DOC
DOCSRC
DOCBLD
DOCFMT
EXA_FILES
EXA_SCRIPTS
SCBIN
SCBINSRC
PKGINDEX
CFG_PKGINDEX
LOAD_LIB
INIT
BIN
BINOBJ
BINSRC
BUILD_DIR
INSTALL
INSTALL_LIB
INSTALL_DOC
INSTALL_EXA
INSTALL_DAT
INSTALL_BIN
INSTALL_EXTRA
PKG_INSTALL_DIR
DOC_INSTALL_DIR
DIST_INSTALL_DATA
DIST_INSTALL_SCRIPT
SH
CC
AR
RANLIB
CFLAGS_CC
CFLAGS_WARN
CFLAGS_OPT
CFLAGS_DEBUG
CFLAGS_BUILD
CFLAGS_TH
DEFS_TH
DEFS_OPT
DEFS_SPOT
DEFS_TCL
DEFS_JIM
DEFS_TK
DEFS
LDFLAGS
LDFLAGS_BUILD
LIBS_TH
EXT_CONF_FILES
EXT_MK_FILES
EXT_BUILD
EXT_DEFS
EXT_INC_SPEC
EXT_LIB_SPEC
EXT_DEP_FILES
TCL_INC_SPEC
TCL_LIB_SPEC
TCL_STUB_LIB_SPEC
JIM_INC_SPEC
JIM_LIB_SPEC
CC_INC_SPEC
LD_LIB_SPEC
TK_INC_SPEC
TK_LIB_SPEC
TK_STUB_LIB_SPEC
LD_LIBRARY_PATH_VAR
TCLLIBPATH
TCL_TM_PATH
JIMLIB
TCLSH_PROG
JIMSH_PROG
BJE
SHELL
CLEAN
DISTCLEAN
DIST
TEST
TESTENV
TESTFWK
TESTFLAGS
TESTFILES
VPATH
BUILDTYPE
CROSS_COMPILE
MAKE_SCLIB
MAKE_SCBIN
MAKE_DOC
PKGS: List of subpackages.
PKGS_DIR: Subpackages dir. Default: 'pkgs'.
B
README_SPOTOCONF
cwd: Current working directory as determinded by 'configure'.
srcdir: Source dir path, possibly relative.
asrcdir: Source dir path, absolute.
appdir
prefix
exec_prefix
pkgdir
moddir
mandir
docdir
exadir
datdir
bindir
SPOTO_ARGS: Arguments passed to 'configure'.

TARGETS

GETTING FANCY

Spotoconf can also determine a package's NAME, TITLE, VERSION, and one of LIB, BIN, or DAT from a fancy TITLE, LIB, BIN or DAT. The formula is name-version.extension. Ex. LIB=MyLib-1.2.tm will yield NAME=mylib TITLE=MyLib VERSION=1.2 LIB=mylib-1.2.tm SCLIB=mylib-1.2.tm SCLIBSRC=mylib.tcl

Keywords

build, configure, distribute, install, test