# $Id: README,v 1.2 2012/04/02 17:32:19 ksb Exp $

The official pull version for msrc 2008, replacing "rsrc".   The uses an
extra set of 2 macros from "auto.cf" to pull source-code from a site's master
source instance to a client machine where it is built and installed with
mmsrc.

Usage:
	mpull msrc-path [mmsrc-options] [utility]

For example to install local oue tool I would type:
	$ mpull local/bin/oue  make install clean

If you needed to specify configuration other than "auto.cf", just add
options before the utility:
	$ mpull local/bin/oue  -Csite.cf  make install clean

Details:

To make this work "auto.cf" (in /usr/local/lib/hxmd) must be updated to
include (at least the first of) these macros:
	MPULL_FROM=`msrc.example.com/873:module'
	MPULL_SRC=`/usr/src'
Or you can set those as environment variables to avoid the file update.  The
MPULL_FROM is an rsync URI to the remote master source service, the
MPULL_SRC is the path to the local source cache.  I usaully put it in
my home directory on machines where I'm not an admin with:
	$ export MPULL_SRC=$HOME/src

These allow the logic in mpull to poll the correct rsync repository, on the
correct port, under the corret module, and to cache the source in a safe
local cache.  The [/873] is optional, and the default module is "msrc".  so
	MPULL_FROM="msrc"
searches the local DNS search path for the hostname and uses the default port
and module name, since "msrc" is a good CNAME to put in your DNS this make
failover easy.  That's the default too.

--ksb, Apr 2012