1 .\"
   2 .\" CDDL HEADER START
   3 .\"
   4 .\" The contents of this file are subject to the terms of the
   5 .\" Common Development and Distribution License (the "License").
   6 .\" You may not use this file except in compliance with the License.
   7 .\"
   8 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   9 .\" or http://www.opensolaris.org/os/licensing.
  10 .\" See the License for the specific language governing permissions
  11 .\" and limitations under the License.
  12 .\"
  13 .\" When distributing Covered Code, include this CDDL HEADER in each
  14 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  15 .\" If applicable, add the following below this CDDL HEADER, with the
  16 .\" fields enclosed by brackets "[]" replaced with your own identifying
  17 .\" information: Portions Copyright [yyyy] [name of copyright owner]
  18 .\"
  19 .\" CDDL HEADER END
  20 .\"
  21 .\" Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
  22 .\" Use is subject to license terms.
  23 .\"
  24 .\" ident       "%Z%%M% %I%     %E% SMI"
  25 .\"
  26 .TH which_scm 1 "11 April 2008"
  27 .SH NAME
  28 which_scm \- Report Source Code Management system
  29 .SH SYNOPSIS
  30 .B which_scm
  31 
  32 .SH DESCRIPTION
  33 .B which_scm
  34 detects the Source Code Management (SCM) system in use, and prints a
  35 single line of text containing a one-word name for the SCM, followed
  36 by a space, and then the top-level directory path for the workspace.
  37 
  38 The typical usage within a ksh script is:
  39 .nf
  40         which_scm | read SCM_TYPE CODEMGR_WS || exit 1
  41 .fi
  42 
  43 If CODEMGR_WS is set in the environment, then \fBwhich_scm\fR
  44 checks only that directory, assuming that it is the top of the tree.
  45 
  46 If CODEMGR_WS is not set, then \fBwhich_scm\fR searches upwards to
  47 find the containing workspace path, and reports that path.
  48 
  49 .B which_scm
  50 can detect the following types of SCM systems (these are the keywords
  51 used in the output format):
  52 .nf
  53         cvs
  54         mercurial
  55         rcs
  56         sccs
  57         subversion
  58         teamware
  59 .fi
  60 
  61 If the type of SCM in use is not known, then the string "unknown" is
  62 printed, and the path returned is $CODEMGR_WS (if set) or the current
  63 working directory.  The command may exit with an error if the SCM
  64 could be detected, but is unusable.
  65 
  66 .SH ENVIRONMENT VARIABLES
  67 The following environment variable is used by \fBwhich_scm\fR:
  68 
  69 .PP
  70 \fBCODEMGR_WS\fR path to current workspace.
  71 
  72 .SH SEE ALSO
  73 .IR cvs(1) ,
  74 .IR hg(1) ,
  75 .IR sccs(1)
  76 .IR svn(1) ,
  77 .IR workspace(1)