[LV-tools-commit] toolchain/scripts README,NONE,1.1 vax_toolchain_config,NONE,1.1

[Jan-Benedict G. <jb...@us...>]

Update of /cvsroot/linux-vax/toolchain/scripts
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv1125

Added Files:
	README vax_toolchain_config 
Log Message:
- First start with new toolchain scripts, containing build scripts as
  well as helper scripts for toolchain development.  Maybe this process
  will once be guided by some advanced, distributed source code management
  tool...


--- NEW FILE: README ---
Hi!

This is a set of scripts to aid in toolchain hacking and building.
Unfortunately, the VAX toolchain isn't yet complete, but we're
working on it. Here's a description of the scripts:

vax_toolchain_config
~~~~~~~~~~~~~~~~~~~~
This script is ment to be sourced by you into your shell. It'll set some
environment variables (where to find patches, CVS sandboxes, build space, ...)
Please feel free to add your pathes and check it in. This script will
always look a bit messy, so don't care about it... Also, the very first
thing you'd do it to actually source it, because all other scripts depend on
the variables being set here. To source this file, use this:

$ . /path/to/vax_toolchain_config

Notice the dot at the beginning of the command line. Alternatively, you can
use the "source" buildin:

$ source /path/to/vax_toolchain_config


--- NEW FILE: vax_toolchain_config ---
#
# This file contains variable setting that are needed for all the scripts
# to aid you in toolchain hacking.
#

#
# These variables need to be set:
#
# UPSTREAM_SANDBOXES_PATH
# ~~~~~~~~~~~~~~~~~~~~~~~
#	Below this directory are checked-out sandboxes of the four important
#	upstream CVS sandboxes (binutils, gcc, glibc and ports). Below
#	${UPSTREAM_SANDBOXES_PATH}, this directory layout is expected:
#
#	${UPSTREAM_SANDBOXES_PATH}/binutils/
#	${UPSTREAM_SANDBOXES_PATH}/binutils/binutils-upstream-HEAD/
#	${UPSTREAM_SANDBOXES_PATH}/binutils/binutils-upstream-HEAD-last/
#	${UPSTREAM_SANDBOXES_PATH}/gcc/gcc-upstream-HEAD/
#	${UPSTREAM_SANDBOXES_PATH}/gcc/gcc-upstream-HEAD-last/
#	${UPSTREAM_SANDBOXES_PATH}/glibc/libc-upstream-HEAD/
#	${UPSTREAM_SANDBOXES_PATH}/glibc/libc-upstream-HEAD-last/
#	${UPSTREAM_SANDBOXES_PATH}/glibc/ports-upstream-HEAD/
#	${UPSTREAM_SANDBOXES_PATH}/glibc/ports-upstream-HEAD-last/
#
#	Initially, the *-HEAD/ and *-HEAD-last/ should contain identical
#	content. (So please checkout *-HEAD/ and then copy over the content
#	to the other directory. Do _not_ do a fresh checkout into the
#	*-HEAD-last/ directory since somebody might check in changes in
#	between.
#
#	There's a reason for having two copies of the sandboxes. The pure
#	*-HEAD/ version is used as the "current" state. If sources are about
#	to be copied into a temporary directory (for building a toolchain),
#	while the *-HEAD-last/ variant is used to break out upstream patches.
#	I use this to fill a (private) CVS server with these patches to
#	"track" upstream sources. You may or may not use the *-HEAD-last/
#	variant, though.  After patches are diffed out for this purpose,
#	they're also applied to *-HEAD-last/ .
#
# UPSTREAM_PATCHES_PATH
# ~~~~~~~~~~~~~~~~~~~~~
#	As noted in the UPSTREAM_SANDBOXES_PATH section, I try to spit out
#	patches for tracking upstream sources. All diffed out patches will
#	go into this directory. If you don't need these patches, maybe setting
#	this variable to /tmp/ .
#
# VAX_PATCHES_PATH
# ~~~~~~~~~~~~~~~~
#	This directory contains out VAX-specific patches. They will be
#	applied automatically whenever you (try to) build a toolchain.
#	All patches _must_ match this specific filename convention to be
#	recognized:
#
#	${VAX_PATCHES_PATH}/COMPONENT-nnn-some_description.patch
#
#	COMPONENT is one of binutils, gcc, glibc, ports. nnn is a decimal
#	number (three digits with leading zero). Patches are applied in order
#	of the given number.
#
# BUILD_BASE_DIR
# ~~~~~~~~~~~~~~
#	When you run a build, a directory below ${BUILD_BASE_DIR} will be
#	created to contain:
#
#	${BUILD_BASE_DIR}/build-20050414-181818-vax-linux/src/{binutils,gcc,glibc}/
#	${BUILD_BASE_DIR}/build-20050414-181818-vax-linux/build/{binutils,gcc1,gcc2glibc}/
#	${BUILD_BASE_DIR}/build-20050414-181818-vax-linux/install/usr/bin/...
#
#	The src/ directories will contain patched sources, containing all
#	patches from ${VAX_PATCHES_PATH}/ .
#


#
# Settings for:
#
#	Jan-Benedict Glaw <jb...@lu...>
#
if [ `whoami` = jbglaw -a `hostname` = d2 ]; then
	echo "Setting variables to match jbglaw@d2"
	export UPSTREAM_SANDBOXES_PATH=""
	export UPSTREAM_PATCHES_PATH=""
	export VAX_PATCHES_PATH=""
	export BUILD_BASE_DIR=""
fi