bk receive(7.3ce)           BitKeeper User's Manual          bk receive(7.3ce)

NAME
       bk receive - receive a BitKeeper patch

SYNOPSIS
       bk receive [<takepatch_options>] [<repository>]

DESCRIPTION
       Use  when  applying  a BitKeeper patch you received via email.  You can
       take a BitKeeper patch and pipe the  whole  email  message  through  bk
       receive.  Headers and footers are stripped automatically.

       When someone sends you a patch with the following command:

           $ bk send -rbeta.. you@your.host.com

       You  will  receive  an email message which needs to be saved so you can
       feed it to the bk receive command:

           $ bk receive ~/mypackage < patch

       Many Unix email programs (pine, elm, etc) will allow you to pipe a mes-
       sage directly to a program. For example, when you are reading a message
       in pine, you can hit the '|' key, and you will be prompted with a  mes-
       sage asking you for a program name where the message should be piped.

       Remember that if you are getting the very first patch, you need to cre-
       ate a new repository by adding the -i option.  BitKeeper does not  cre-
       ate repositories by default.

       Specifying the repository is optional; if it is unspecified, bk receive
       tries to use the current working directory.

       Patches may be wrapped. If they are you will see something like

           ## Wrapped with uu ##

       near the top of the patch.  BitKeeper knows how to unwrap patches which
       it  wrapped.   We  currently support only uuencoded wrappers, but it is
       trivial to create different ones, see bk wrap for more information.

       Once a patch is run through bk receive, run bk  resolve  to  apply  the
       changes.

OPTIONS
       All  options  are  passed through to bk takepatch.  With no options, bk
       takepatch is completely silent.   If  you  want  to  see  the  progress
       reports you see with bk pull, add -vv to the options.

       -a  Apply the changes (call bk resolve.)
       -c  Do not accept conflicts with this patch.
       -i  Initial patch, create a new repository.
       -v  Verbose level, more is more verbose, -vv is suggested.

SEE ALSO
       bk range
       bk send
       bk takepatch
       bk wrap

CATEGORY
       File

BitKeeper Inc                         1E1                    bk receive(7.3ce)