	"@(#)sde_start	1.10	93/03/11 SMI"

    Tips for getting started in the OS-Net software development environment

Do your builds on SunOS 5.x, using the common build environment (CBE) defined
by the W-team.

Do development using SCCS; do integration using Codemgr.  Get Codemgr from
dunk:/opt/teamware or a local, regularly updated clone of it.  Learn Codemgr
basics from /opt/teamware/doc/overview.ps, which is the first chapter of the
CodeManager User's Guide, part number 801-2169-10.

Run "bringover" to create your source workspace; do this bringover from a
workspace that is recommended by an appropriate "gate keeper," program
manager, manager, or integration engineer.  (See the auto.ws NIS map or
the auto_ws NIS+ table for candidate workspaces.)

Run "bringover" again whenever you want to update your source with changes
available in a recommended workspace.  Always bringover from a parent
workspace that is at an equal or greater release level to your child
workspace.  Do not "reparent" to an older release.

Think SCCS.  Allocate disk space for file histories in each workspace.

Use SCCS, but avoid rmdel, fix, cdc, and comb subcommands.  unedit is okay.

Use the "ws" script, available from OS-Net in /opt/teamware/bin, to simplify
your builds.  See the "ws" man page in /opt/teamware/man.

Use this path setting for doing your builds (e.g., in .login):
path=(/opt/teamware/bin /usr/sbin /opt/SUNWspro/bin /usr/ccs/bin /usr/bin)

Allow "ws" to set shell variables important to the build: SRC, ROOT,
ENVCPPFLAGS*, ENVLDLIBS*, MAKEFLAGS.  Do not set these in your shell's
start-up files.  "ws" prepends to PATH, so if you must modify "path" in
your .cshrc, conditionally protect ws from your modification with:
if ( ! $?ONBLD_DIR ) then   # meaning: if ws has not set the path, then...

If you want to delete a source file and propagate this change to other
workspaces, use "sccsrm", which will rename the file and its corresponding
SCCS s-dot file to "deleted-file names" such as s..del-foo.c and allow
"putback" to propagate this "deletion" as a renamed file.

Be sure there are no unresolved conflicts in your workspace before doing
builds.  Use "resolve -n" to check for conflicts.

Simplify your references to public workspaces by using the auto.ws map
(or the auto_ws table) with your automounter.

See Also:
  "roadmap" in terminator:/usr/integration/doc
  automounted mail-archives in /opt/teamware/doc: avo_updates and osnet-sde
  man pages in /opt/teamware/man
  sccs man pages such as sccs(1), sccs-get(1), and sccsfile(4)
