bcreate(1)          UNIX Programmer's Manual           bcreate(1)



NAME
     bcreate - create a new source file

SYNOPSIS
     bcreate [bcs_options]  file(s)

     bcs_options:
                 [ -auto -fast -debug -quiet -rc -sb -set -newset
                 -newconfig -path -newpath ]

FLAGS
 bcs_options - Defaults may be modified and/or overridden with
the following switches.

     -auto
          Automatically choose the default answer to any question
          asked by a command.  If the default answer requires
          manual intervention of some sort (e.g. to edit a file),
          then revert to interactive mode for the duration of the
          remaining operations for the current file and only
          return to automatic mode after proceeding to the next
          file in the list.

     -fast
          Always choose the default answer to any question asked
          by a command.  If the default answer requires manual
          intervention of some sort (e.g. to edit a file), then
          abort the operation on the current file instead and
          proceed to the next file in the list.

     -debug
          Enable debugging code.

     -quiet, -q
          Be less verbose about actions taken.

     -rc sandbox_rc_file
          Specifies an alternate sandbox rc file.  The defaults
          is $HOME/.sandboxrc.

     -sb sandbox_name
          Name of the sandbox to use.  If this option is not
          used, the sandbox will be determined by the environment
          variable SANDBOX or, if that is not set,  by the user's
          default sandbox as specified in the sandbox rc file.

     -sb_rc sandbox-rcfile
          Provides the path and name of the sandbox's rc file to
          use instaed of the default file sandbox/rc_files/local.
          If this option is not used, the default sandbox rc file
          will be used.




Printed 1/23/91              4/25/90                            1

bcreate(1)          UNIX Programmer's Manual           bcreate(1)



     -set set_name
          Performs operation on set_name instead of the  current
          default set.

     -path path
          Use path as the current directory within the shadow
          source area.  Used in conjunction with the -newpath
          option.

     -newpath
          Create and/or update the ./.BCSpath-<user_set_name> to
          contain the current relative path within the shadow
          source area.  This file is used by workon to chdir
          within to the same subdirectory when working on a set
          over an extended period of time.


DESCRIPTION
     The bcreate command creates an empty working file in the
     users sandbox, and creates the revision history file in the
     RCS tree.  The argument can be the name of the file or the
     path to and name of the file.  If the path does not exist,
     either in the user's sandbox or in rcs tree, it will be
     created.

     bcreate does not have the ability to create an empty direc-
     tory.


EXAMPLES
     bcreate /usr/bin/wakeup.c
          Creates the file wakeup.c,v in the rcs tree under the
          directory /usr/bin. If the directory does not exist, it
          creates it.  Also does a check-out, locked of the file
          into the user's current sandbox.  The file will be
          empty.  If the directory /sandbox/src/usr/bin does not
          exist, it will be created.


FILES
     ${HOME}/.sandboxrc
          rc file that specifies user's sandbox's and base direc-
          tories and the default sandbox

     /sandbox/rcfiles/sets
          list of valid sets in the sandbox

     /sandbox/set/.BCSconfig
          file containing revision for each file checked out

     /sandbox/set/.BCSset-<user_set_name>
          list of files in set



Printed 1/23/91              4/25/90                            2

bcreate(1)          UNIX Programmer's Manual           bcreate(1)



     /sandbox/set/.BCSlog-<user_set_name>
          record of log messages for set

     /tmp/b-$USER/*
          temporary files for bcs commands


SEE ALSO
     bcs(1), bco(1), bci(1), bmerge(1), rcsci(1), rcs(1), rcsin-
     tro(1),
     the RCS Cookbook.


PLANNED ENHANCEMENTS
     A "-undo" option will be added to bcreate to facilitate
     removing a file which was created incorrectly.







































Printed 1/23/91              4/25/90                            3