Welcome to the OpenSolaris Desktop Common Build Environment [CBE]

   Version @CBE_VERSION@ (@DATE@, @ARCH@ architecture)


What is the Desktop CBE?

   The Desktop CBE is a collection of tools needed for building GNOME,
   KDE or SFE packages.

   Supported operating systems:

   - Solaris 10
   - Solaris Nevada (a.k.a. Solaris Express Community Edition or
     Solaris Express Developer Edition)
   - OpenSolaris

   Most of the tools in the Desktop CBE are included in Solaris Nevada
   and OpenSolaris, but sometimes using different names (e.g. ginstall
   instead of install, gmake instead of make).  The Desktop CBE
   will not install duplicate packages, instead it will create
   symbolic links to the tools shipped with the OS.

   The following tools are included:

   For KDE: ant, GNU m4, autoconf, automake, libtool, bison, GNU coreutils,
            GNU diff, flex, GNU gettext, subversion, GNU awk, GNU sed,
            cmake, GNU make, yasm
   For GNOME/SFE: ant, GNU m4, autoconf, automake, libtool, bison,
            GNU coreutils, GNU diff, flex, GNU gettext, GNU make,
            subversion
   Optional tools: rsync cvs

   Tool Versions:

   - ant: 1.7.1
   - autoconf: 2.61
   - automake: 1.10.1
   - bison: 2.3
   - cmake: 2.4.8
   - coreutils: 6.10
   - cvs: 1.12.13
   - diff: 2.8.1
   - flex: 2.5.33
   - gettext: 0.16.1
   - gawk: 3.1.6
   - sed: 4.1.5
   - libtool: 1.5.26
   - libtool: 2.2.4
   - m4: 1.4.9
   - make: 3.81
   - rsync: 3.0.4
   - svn: 1.4.6
   - yasm: 0.7.1


What's new in this release (@CBE_VERSION@)?

   This release combines the JDS CBE (GNOME, SFE build env) and the
   KBE (KDE build env).  Those who used the JDS CBE before will
   find the following improvements:

   - newer tools
   - only the missing tools (i.e. those not shipped in the OS) are
     installed
   - supports multiple compilers (see Using the Desktop CBE below)


Installing the Desktop CBE

   After unpacking the CBE tarball (which you have already done if
   you're reading this document ;) run the cbe-install script.
   (If you have a previous JDS CBE installed, you can use the
   cbe-remove script to uninstall it.)

   The cbe-install script is interactive and will guide you
   through the installation process.

   Use the -n option for non-interactive installation.  In this case
   the default answers will be assumed for all questions:

   $ ./cbe-install -n --gnome --compiler /opt/SUNWspro/bin/cc

   Run ./cbe-install --help for more information about command line
   options.

   The binary packages included in the Desktop CBE tarball are
   compiled for installation in /opt/dtbld.  If you wish to
   install the Desktop CBE in a different prefix, use the
   source tarball.

Using the Desktop CBE

   The cbe-install script will locate the C compilers on your
   system and set up "environment config files" in
   /opt/dtcbe/lib/cbe-env.  One of these config files will be
   selected as the default.  Depending on your shell, you
   can use the env.sh or env.csh scripts to set up your
   build environment for one of the compilers:

   bash$ . /opt/dtcbe/bin/env.sh gcc3
   Desktop CBE version 1.7.0 built on 2008-06-16 by laca@tecra
   Using CC=/usr/bin/gcc
   Using CXX=/usr/bin/g++
   Setting PATH=/opt/dtbld/bin:/usr/ccs/bin:/usr/gnu/bin:/usr/bin:/usr/sbin:/bin:/usr/sfw/bin

   tcsh% source /opt/dtbld/bin/env.csh ss12
   Desktop CBE version 1.7.0 built on 2008-06-16 by laca@tecra
   Using CC=/opt/SUNWspro/bin/cc
   Using CXX=/opt/SUNWspro/bin/CC
   Setting PATH=/opt/dtbld/bin:/opt/SUNWspro/bin:/usr/ccs/bin:/usr/gnu/bin:/usr/bin:/usr/sbin:/bin:/usr/sfw/bin

   zsh% source /opt/dtbld/bin/env.sh foo
   Desktop CBE version 1.7.0 built on 2008-06-18 by laca@tecra
   ERROR: Unknown CBE environment: foo

   Valid choices are: 

	default -> ss12
	gcc3
	gcc4
	sexp
	ss12

   Note: you cannot pass arguments after source <file> when using the csh
   shell.  You can start a subshell, though:

   If you run the env scripts instead of "sourcing" them, they will
   start a subshell.  The shell started will be $SHELL:

   bash$ /opt/dtbld/bin/env.sh ss12
   Desktop CBE version 1.7.0 built on 2008-06-18 by laca@tecra
   Using CC=/opt/SUNWspro/bin/cc
   Using CXX=/opt/SUNWspro/bin/CC
   Setting PATH=/opt/dtbld/bin:/opt/SUNWspro/bin:/usr/ccs/bin:/usr/gnu/bin:/usr/bin:/usr/sbin:/bin:/usr/sfw/bin
   Starting subshell /bin/bash --norc --noprofile
   bash$

   bash$ SHELL=/bin/csh /opt/dtbld/bin/env.sh sexp
   Desktop CBE version 1.7.0 built on 2008-06-18 by laca@tecra
   Using CC=/opt/SunStudioExpress/bin/cc
   Using CXX=/opt/SunStudioExpress/bin/CC
   Setting PATH=/opt/dtbld/bin:/opt/SunStudioExpress/bin:/usr/ccs/bin:/usr/gnu/bin:/usr/bin:/usr/sbin:/bin:/usr/sfw/bin
   Starting subshell /bin/csh -f
   csh%     

   Use the env_include.sh script for setting up the Desktop build
   environment in scripts (sh, bash, ksh, zsh should work).  This script
   provides the init_dt_cbe function.  It takes one [optional] argument:
   the name of a CBE environment (found in /opt/dtbld/lib/cbe-env).
   You can set the JDS_CBE_ENV_QUIET variable to 1 to make the env script
   silent.  This is useful when calling it from your .profile or .bashrc,
   for example:

   bash$ cat ~/.bashrc
   PS1='\u@\h:\w> '
   JDS_CBE_ENV_QUIET=1
   . /opt/dtbld/bin/env_include.sh
   init_dt_cbe ss12
   export EDITOR=vi
   export PAGER=less
   export PATH=$HOME/bin:$PATH