11

I'd like to keep two ~/.hgrc files: ~/.hgrc and ~/.hgrc.local – one with "standard" settings (eg, username), the other with machine-specific settings (eg, setting a graphical merge tool).

How can I do this with hg?

For example, this is how I do it with Vim:

# ~/.vimrc
syntax enable
source ~/.vimrc.local

Then:

# ~/.vimrc.local
let work_code = 'code/work/.*'
if expand('%:p:h') =~ work_code ... fi
David Wolever
  • 148,955
  • 89
  • 346
  • 502

4 Answers4

20

There's a not-often used %include directive in mercurial 1.3 and later:

From man hgrc:

   A  line  of  the  form %include file will include file into the current
   configuration file.  The  inclusion  is  recursive,  which  means  that
   included  files  can include other files. Filenames are relative to the
   configuration file in which the %include directive is found.

so go with:

   %include ~/.hgrc.local

and you should be good to go.

Ry4an Brase
  • 78,112
  • 7
  • 148
  • 169
  • Wow, I had no idea that existed. Nice. – Steve Losh Dec 08 '09 at 21:19
  • Hrm, so that would be really cool… But it doesn't work with hg 1.3.1 or 1.4.1… And grepping the hg source tree (1.4.1+7-4ddfad7ebd98) for '%import' doesn't turn anything up. So… Where'd you find that? – David Wolever Dec 09 '09 at 01:00
  • In case you haven't already caught it, the command is '%include', not '%import'. It's first referenced in mercurial.config.py, class config.parse(), about line 79 and implemented at about line 102. This is in mercurial 1.3.1. – Peter Rowell Dec 09 '09 at 02:50
  • Ehm... I'm afraid substitution of environment variables only work some times :-( That is, it works in the `[extensions]` section and it works for the `ui.ignore` setting. But we're not yet expanding variables in `%include` paths and it's also slightly broken in the `[paths]` section (it only works with a relative path). I'll look into it! – Martin Geisler Dec 12 '09 at 13:54
  • ... well, to say I feel like an idiot would be an understatement. Thanks for being gentle in pointing out my ignorance (I hadn't noticed that it's `%include` not `%import`) – David Wolever Dec 13 '09 at 22:35
5

I solve this problem for all my "dot files" in a similar way. On login my shell checks a list of files (hgrc, vimrc, ....) and checks if any of them is older than ${that_name}.global or ${that_name}.local. If it is - cat ${that_name}.{global,local} > ${that_name}. Simple and works great so far. While there's a "better" way (using %include) sometimes processing the config files manually has advantages - for example it will work with mercurial pre-1.3.

viraptor
  • 33,322
  • 10
  • 107
  • 191
4

Mercurial checks for a number of configuration files with a specific priority. This way you can have global, user-specific and repository-specific settings. Mercurial version >= 1.4 has a hg help config command which describes this in a nice overview:

$ hg help config
Configuration Files

    Mercurial reads configuration data from several files, if they exist. Below we list the most specific file first.

    On Windows, these configuration files are read:

    - "<repo>\.hg\hgrc"
    - "%USERPROFILE%\.hgrc"
    - "%USERPROFILE%\Mercurial.ini"
    - "%HOME%\.hgrc"
    - "%HOME%\Mercurial.ini"
    - "C:\Mercurial\Mercurial.ini"
    - "HKEY_LOCAL_MACHINE\SOFTWARE\Mercurial"
    - "<install-dir>\Mercurial.ini"

    On Unix, these files are read:

    - "<repo>/.hg/hgrc"
    - "$HOME/.hgrc"
    - "/etc/mercurial/hgrc"
    - "/etc/mercurial/hgrc.d/*.rc"
    - "<install-root>/etc/mercurial/hgrc"
    - "<install-root>/etc/mercurial/hgrc.d/*.rc"

    The configuration files for Mercurial use a simple ini-file format. A configuration file consists of sections, led by a "[section]" header and followed by
    "name = value" entries:

      [ui]
      username = Firstname Lastname <firstname.lastname@example.net>
      verbose = True

    This above entries will be referred to as "ui.username" and "ui.verbose", respectively. Please see the hgrc man page for a full description of the possible
    configuration values:

    - on Unix-like systems: "man hgrc"
    - online: http://www.selenic.com/mercurial/hgrc.5.html

You can list your current settings with hg showconfig.

Paidhi
  • 745
  • 2
  • 8
  • 21
0

Mercurial will look in several different locations for hgrc files and will load them if present. For system-wide configuration the standard (on UNIX) would be to use /etc/mercurial/hgrc.

See the files section of the hgrc man page for more information.

Steve Losh
  • 19,642
  • 2
  • 51
  • 44