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