1 .\" CDDL HEADER START
   2 .\"
   3 .\" The contents of this file are subject to the terms of the
   4 .\" Common Development and Distribution License (the "License").
   5 .\" You may not use this file except in compliance with the License.
   6 .\"
   7 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   8 .\" or http://www.opensolaris.org/os/licensing.
   9 .\" See the License for the specific language governing permissions
  10 .\" and limitations under the License.
  11 .\"
  12 .\" When distributing Covered Code, include this CDDL HEADER in each
  13 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  14 .\" If applicable, add the following below this CDDL HEADER, with the
  15 .\" fields enclosed by brackets "[]" replaced with your own identifying
  16 .\" information: Portions Copyright [yyyy] [name of copyright owner]
  17 .\"
  18 .\" CDDL HEADER END
  19 .\"
  20 .\" Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
  21 .\" Use is subject to license terms."
  22 .\"
  23 .TH hgsetup 1 "2 October 2008"
  24 .SH NAME
  25 .I hgsetup
  26 \- sets up a user's ~/.hgrc for development of ON with Mercurial
  27 .SH SYNOPSIS
  28 \fBhgsetup [-f] [-c \fIcdm_path\fP] [-m \fImerge_path\fP] [-n \fIname\fP] [-e \fIemail\fP] [-p \fIproxy\fP] [-s \fIstyle_path\fP]
  29 .LP
  30 .SH DESCRIPTION
  31 .IX "OS-Net build tools" "hgsetup" "" "\fBhgsetup\fP"
  32 .LP
  33 The hgsetup script sets up a user's ~/.hgrc (hgrc(5)) file for development
  34 of ON (OS/Net) with Mercurial.  
  35 .LP
  36 It populates the author and email fields with the user's information.
  37 It loads the Cadmium extension.
  38 It aliases canonical repositories for onnv-gate.
  39 It configures Mercurial to use appropriate merge tools.
  40 .SH OPTIONS
  41 .TP 10
  42 .B -f
  43 Force the user's ~/.hgrc to be overwritten if one already exists
  44 .TP 10
  45 .B -c
  46 Override the path to the Cadmium extension for Mercurial to load
  47 .TP 10
  48 .B -m
  49 Override the default merge configuration, such that a single
  50 specified tool is used.
  51 .TP 10
  52 .B -n
  53 Specify the name to use for commits (default is taken from passwd file)
  54 .TP 10
  55 .B -e
  56 Specify the email address to use for commits.
  57 For SWAN users the default is taken from an LDAP query, otherwise -e 
  58 is mandatory.
  59 .TP 10
  60 .B -p
  61 Specify an http_proxy to use for interacting with HTTP repositories
  62 .TP 10
  63 .B -s
  64 Override the path to the Mercurial style file
  65 .LP
  66 .SH OUTPUT
  67 .LP
  68 Generates a .hgrc file in the user's home directory.
  69 .LP
  70 .SH SEE ALSO
  71 .LP
  72 .IR hgrc(5),
  73 .IR hg(1),