Show More
@@ -12,7 +12,7 b' SYNOPSIS' | |||||
12 | -------- |
|
12 | -------- | |
13 |
|
13 | |||
14 | The Mercurial system uses a set of configuration files to control |
|
14 | The Mercurial system uses a set of configuration files to control | |
15 |
aspects of its behavio |
|
15 | aspects of its behavior. | |
16 |
|
16 | |||
17 | FILES |
|
17 | FILES | |
18 | ----- |
|
18 | ----- | |
@@ -59,7 +59,7 b' given below, settings from later paths o' | |||||
59 | Per-user configuration file(s), for the user running Mercurial. On |
|
59 | Per-user configuration file(s), for the user running Mercurial. On | |
60 | Windows 9x, `%HOME%` is replaced by `%APPDATA%`. |
|
60 | Windows 9x, `%HOME%` is replaced by `%APPDATA%`. | |
61 | Options in these files apply to all Mercurial commands executed by |
|
61 | Options in these files apply to all Mercurial commands executed by | |
62 | this user in any directory. Options in thes files override |
|
62 | this user in any directory. Options in these files override | |
63 | per-installation and per-system options. |
|
63 | per-installation and per-system options. | |
64 |
|
64 | |||
65 | (Unix, Windows) `<repo>/.hg/hgrc`:: |
|
65 | (Unix, Windows) `<repo>/.hg/hgrc`:: | |
@@ -208,7 +208,7 b' where the standard shell I/O redirection' | |||||
208 | strange effects and may corrupt the contents of your files. |
|
208 | strange effects and may corrupt the contents of your files. | |
209 |
|
209 | |||
210 | The most common usage is for LF <-> CRLF translation on Windows. For |
|
210 | The most common usage is for LF <-> CRLF translation on Windows. For | |
211 |
this, use the "smart" convert |
|
211 | this, use the "smart" converters which check for binary files: | |
212 |
|
212 | |||
213 | [extensions] |
|
213 | [extensions] | |
214 | hgext.win32text = |
|
214 | hgext.win32text = | |
@@ -247,7 +247,7 b' to the aliases of the commands defined.' | |||||
247 |
|
247 | |||
248 | [[diff]] |
|
248 | [[diff]] | |
249 | diff:: |
|
249 | diff:: | |
250 |
Settings used when displaying diffs. They are all |
|
250 | Settings used when displaying diffs. They are all Boolean and | |
251 | defaults to False. |
|
251 | defaults to False. | |
252 | git;; |
|
252 | git;; | |
253 | Use git extended diff format. |
|
253 | Use git extended diff format. | |
@@ -284,15 +284,16 b' email::' | |||||
284 | message on stdin). Normally, setting this to "sendmail" or |
|
284 | message on stdin). Normally, setting this to "sendmail" or | |
285 | "/usr/sbin/sendmail" is enough to use sendmail to send messages. |
|
285 | "/usr/sbin/sendmail" is enough to use sendmail to send messages. | |
286 | charsets;; |
|
286 | charsets;; | |
287 |
Optional. Comma-separated list of charsets considered |
|
287 | Optional. Comma-separated list of character sets considered | |
288 |
for recipients. Addresses, headers, and parts not |
|
288 | convenient for recipients. Addresses, headers, and parts not | |
289 |
patches of outgoing messages will be encoded in the |
|
289 | containing patches of outgoing messages will be encoded in the | |
290 |
to which conversion from local encoding |
|
290 | first character set to which conversion from local encoding | |
291 |
`ui.fallbackencoding`) succeeds. If correct |
|
291 | (`$HGENCODING`, `ui.fallbackencoding`) succeeds. If correct | |
292 |
text in question is sent as is. Defaults to |
|
292 | conversion fails, the text in question is sent as is. Defaults to | |
|
293 | empty (explicit) list. | |||
293 | + |
|
294 | + | |
294 | -- |
|
295 | -- | |
295 | Order of outgoing email charsets: |
|
296 | Order of outgoing email character sets: | |
296 |
|
297 | |||
297 | us-ascii always first, regardless of settings |
|
298 | us-ascii always first, regardless of settings | |
298 | email.charsets in order given by user |
|
299 | email.charsets in order given by user | |
@@ -305,7 +306,7 b' Email example:' | |||||
305 | [email] |
|
306 | [email] | |
306 | from = Joseph User <joe.user@example.com> |
|
307 | from = Joseph User <joe.user@example.com> | |
307 | method = /usr/sbin/sendmail |
|
308 | method = /usr/sbin/sendmail | |
308 |
# charsets for western |
|
309 | # charsets for western Europeans | |
309 | # us-ascii, utf-8 omitted, as they are tried first and last |
|
310 | # us-ascii, utf-8 omitted, as they are tried first and last | |
310 | charsets = iso-8859-1, iso-8859-15, windows-1252 |
|
311 | charsets = iso-8859-1, iso-8859-15, windows-1252 | |
311 | -- |
|
312 | -- | |
@@ -332,7 +333,7 b' supplied.' | |||||
332 | Example for `~/.hgrc`: |
|
333 | Example for `~/.hgrc`: | |
333 |
|
334 | |||
334 | [extensions] |
|
335 | [extensions] | |
335 |
# (the mq extension will get loaded from |
|
336 | # (the mq extension will get loaded from Mercurial's path) | |
336 | hgext.mq = |
|
337 | hgext.mq = | |
337 | # (this extension will get loaded from the file specified) |
|
338 | # (this extension will get loaded from the file specified) | |
338 | myfeature = ~/.hgext/myfeature.py |
|
339 | myfeature = ~/.hgext/myfeature.py | |
@@ -499,17 +500,17 b' precommit;;' | |||||
499 | preoutgoing;; |
|
500 | preoutgoing;; | |
500 | Run before collecting changes to send from the local repository to |
|
501 | Run before collecting changes to send from the local repository to | |
501 | another. Non-zero status will cause failure. This lets you prevent |
|
502 | another. Non-zero status will cause failure. This lets you prevent | |
502 |
pull over |
|
503 | pull over HTTP or SSH. Also prevents against local pull, push | |
503 | (outbound) or bundle commands, but not effective, since you can |
|
504 | (outbound) or bundle commands, but not effective, since you can | |
504 | just copy files instead then. Source of operation is in |
|
505 | just copy files instead then. Source of operation is in | |
505 | `$HG_SOURCE`. If "serve", operation is happening on behalf of remote |
|
506 | `$HG_SOURCE`. If "serve", operation is happening on behalf of remote | |
506 |
|
|
507 | SSH or HTTP repository. If "push", "pull" or "bundle", operation | |
507 | is happening on behalf of repository on same system. |
|
508 | is happening on behalf of repository on same system. | |
508 | pretag;; |
|
509 | pretag;; | |
509 | Run before creating a tag. Exit status 0 allows the tag to be |
|
510 | Run before creating a tag. Exit status 0 allows the tag to be | |
510 | created. Non-zero status will cause the tag to fail. ID of |
|
511 | created. Non-zero status will cause the tag to fail. ID of | |
511 | changeset to tag is in `$HG_NODE`. Name of tag is in `$HG_TAG`. Tag is |
|
512 | changeset to tag is in `$HG_NODE`. Name of tag is in `$HG_TAG`. Tag is | |
512 | local if `$HG_LOCAL=1`, in repo if `$HG_LOCAL=0`. |
|
513 | local if `$HG_LOCAL=1`, in repository if `$HG_LOCAL=0`. | |
513 | pretxnchangegroup;; |
|
514 | pretxnchangegroup;; | |
514 | Run after a changegroup has been added via push, pull or unbundle, |
|
515 | Run after a changegroup has been added via push, pull or unbundle, | |
515 | but before the transaction has been committed. Changegroup is |
|
516 | but before the transaction has been committed. Changegroup is | |
@@ -533,8 +534,8 b' preupdate;;' | |||||
533 | of second new parent is in `$HG_PARENT2`. |
|
534 | of second new parent is in `$HG_PARENT2`. | |
534 | tag;; |
|
535 | tag;; | |
535 | Run after a tag is created. ID of tagged changeset is in `$HG_NODE`. |
|
536 | Run after a tag is created. ID of tagged changeset is in `$HG_NODE`. | |
536 |
Name of tag is in `$HG_TAG`. Tag is local if `$HG_LOCAL=1`, in |
|
537 | Name of tag is in `$HG_TAG`. Tag is local if `$HG_LOCAL=1`, in | |
537 | `$HG_LOCAL=0`. |
|
538 | repository if `$HG_LOCAL=0`. | |
538 | update;; |
|
539 | update;; | |
539 | Run after updating the working directory. Changeset ID of first |
|
540 | Run after updating the working directory. Changeset ID of first | |
540 | new parent is in `$HG_PARENT1`. If merge, ID of second new parent is |
|
541 | new parent is in `$HG_PARENT1`. If merge, ID of second new parent is | |
@@ -646,14 +647,14 b' profiling::' | |||||
646 | server:: |
|
647 | server:: | |
647 | Controls generic server settings. |
|
648 | Controls generic server settings. | |
648 | uncompressed;; |
|
649 | uncompressed;; | |
649 |
Whether to allow clients to clone a repo using the |
|
650 | Whether to allow clients to clone a repository using the | |
650 |
streaming protocol. This transfers about 40% more |
|
651 | uncompressed streaming protocol. This transfers about 40% more | |
651 |
regular clone, but uses less memory and CPU on both |
|
652 | data than a regular clone, but uses less memory and CPU on both | |
652 |
client. Over a LAN (100Mbps or better) or a very fast |
|
653 | server and client. Over a LAN (100 Mbps or better) or a very fast | |
653 |
uncompressed streaming clone is a lot faster (~10x) than a |
|
654 | WAN, an uncompressed streaming clone is a lot faster (~10x) than a | |
654 |
clone. Over most WAN connections (anything slower than |
|
655 | regular clone. Over most WAN connections (anything slower than | |
655 |
6Mbps), uncompressed streaming is slower, because of the |
|
656 | about 6 Mbps), uncompressed streaming is slower, because of the | |
656 | data transfer overhead. Default is False. |
|
657 | extra data transfer overhead. Default is False. | |
657 |
|
658 | |||
658 | [[trusted]] |
|
659 | [[trusted]] | |
659 | trusted:: |
|
660 | trusted:: | |
@@ -772,10 +773,12 b' web::' | |||||
772 | List of archive format (bz2, gz, zip) allowed for downloading. |
|
773 | List of archive format (bz2, gz, zip) allowed for downloading. | |
773 | Default is empty. |
|
774 | Default is empty. | |
774 | allowbz2;; |
|
775 | allowbz2;; | |
775 |
(DEPRECATED) Whether to allow .tar.bz2 downloading of repo |
|
776 | (DEPRECATED) Whether to allow .tar.bz2 downloading of repository | |
|
777 | revisions. | |||
776 | Default is false. |
|
778 | Default is false. | |
777 | allowgz;; |
|
779 | allowgz;; | |
778 |
(DEPRECATED) Whether to allow .tar.gz downloading of repo |
|
780 | (DEPRECATED) Whether to allow .tar.gz downloading of repository | |
|
781 | revisions. | |||
779 | Default is false. |
|
782 | Default is false. | |
780 | allowpull;; |
|
783 | allowpull;; | |
781 | Whether to allow pulling from the repository. Default is true. |
|
784 | Whether to allow pulling from the repository. Default is true. | |
@@ -799,8 +802,8 b' web::' | |||||
799 | contents of the allow_read list are examined after the deny_read |
|
802 | contents of the allow_read list are examined after the deny_read | |
800 | list. |
|
803 | list. | |
801 | allowzip;; |
|
804 | allowzip;; | |
802 |
(DEPRECATED) Whether to allow .zip downloading of repo |
|
805 | (DEPRECATED) Whether to allow .zip downloading of repository | |
803 | Default is false. This feature creates temporary files. |
|
806 | revisions. Default is false. This feature creates temporary files. | |
804 | baseurl;; |
|
807 | baseurl;; | |
805 | Base URL to use when publishing URLs in other locations, so |
|
808 | Base URL to use when publishing URLs in other locations, so | |
806 | third-party tools like email notification hooks can construct |
|
809 | third-party tools like email notification hooks can construct |
General Comments 0
You need to be logged in to leave comments.
Login now