|
Size: 6153
Comment: .hgtags now mostly belongs to tags.py
|
Size: 6098
Comment: add section numbers, fix up whitespace (WikiCleanup)
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| #pragma section-numbers 2 | |
| Line 7: | Line 8: |
| == Generated file types == | |
| Line 9: | Line 9: |
| === Bundle files === |
== Bundle files == |
| Line 17: | Line 16: |
| Line 20: | Line 20: |
| Line 26: | Line 25: |
| Line 34: | Line 32: |
| Line 42: | Line 39: |
| This directory in the repository root contains all the revision history and non-versioned configuration data. | |
| Line 43: | Line 41: |
| This directory in the repository root contains all the revision history and non-versioned configuration data. | |
| Line 48: | Line 45: |
| Line 52: | Line 48: |
| Line 56: | Line 51: |
| Line 62: | Line 56: |
| Line 74: | Line 67: |
| Line 86: | Line 78: |
| Line 90: | Line 81: |
| Line 94: | Line 84: |
| Line 98: | Line 87: |
| Line 102: | Line 90: |
| Line 108: | Line 95: |
| Line 115: | Line 101: |
| Line 122: | Line 107: |
| Line 126: | Line 110: |
| Line 132: | Line 115: |
| Line 142: | Line 124: |
| Line 148: | Line 129: |
| Line 154: | Line 134: |
| Line 162: | Line 141: |
For the [[fncacheRepoFormat|fncache]] repository format Mercurial maintains a new file 'fncache' (thus the name of the format) inside '.hg/store'. The fncache file contains the paths of all filelog files in the store as encoded by mercurial.filelog.encodedir. The paths are separated by '\n' (LF). |
For the [[fncacheRepoFormat|fncache]] repository format Mercurial maintains a new file 'fncache' (thus the name of the format) inside '.hg/store'. The fncache file contains the paths of all filelog files in the store as encoded by mercurial.filelog.encodedir. The paths are separated by '\n' (LF). |
| Line 167: | Line 144: |
| Line 171: | Line 147: |
| * directory names ending in .i or .d have .hg appended | * directory names ending in .i or .d have .hg appended |
| Line 173: | Line 149: |
| * uppercase is escaped: 'FOO' -> '_f_o_o' * character codes outside of 32-126 are converted to '~XX' hex format |
* uppercase is escaped: 'FOO' -> '_f_o_o' * character codes outside of 32-126 are converted to '~XX' hex format |
| Line 176: | Line 152: |
| * windows reserved filename prefixes are ~XX-encoded * very long filenames and stored by hash |
* windows reserved filename prefixes are ~XX-encoded * very long filenames and stored by hash |
| Line 180: | Line 156: |
Mercurial File Formats
This page is a starting point for understanding Mercurial file internals. Text files are marked as "local" if they are in the local charset, otherwise "utf-8" or "ascii". Files intended to be user-editable are marked "editable". All files are optional unless otherwise noted.
Contents
1. Bundle files
Bundle files use the WireProtocol format, with a header indicating compression type:
- 'HG10BZ' - bzip2 compressed
- 'HG10GZ' - gzip compressed
- 'HG10UN' - uncompressed
2. Files in the working directory
2.1. .hgignore (local editable)
This lists ignore patterns. May or may not be managed. See hgignore manpage.
Source: mercurial/ignore.py
2.2. .hgtags (utf-8 editable)
This is a managed file containing tags. Effective tags are determined by combining information from this file on all project heads (not from the working directory).
One line per tag in the format '<full hex changeset id> <tag>'.
Source: mercurial/tags.py
2.3. .hgsigs (ascii) [gpg]
This file contains changeset signatures from the gpg extension, one per line. Format:
<full hex changeset id> <signature version> <base64-encoded signature>
Source: hgext/gpg.py
2.4. .hg/
This directory in the repository root contains all the revision history and non-versioned configuration data.
3. Files in the repository directory (.hg)
3.1. 00changelog.i
In repositories with the 'store' requirement, this is a placeholder to warn older Mercurial about version mismatch.
3.2. requires (ascii)
If this file exists, it contains one line per feature that a local Mercurial must support to read the repository. See RequiresFile.
3.3. branch (utf-8)
This file contains a single line with the branch name for the branch in the working directory. If it doesn't exist, the branch is \'\' (aka 'default').
Source: mercurial/dirstate.py:_branch
3.4. branch.cache (utf-8)
First line is:
<full hex id of tip> <revision number of tip>
This line is used to determine if the cache is current.
Remaining lines are:
<full hex id of branch tip> <branch name>
3.5. dirstate
This file contains information on the current state of the working directory in a binary format. It begins with two 20-byte hashes, for first and second parent, followed by an entry for each file. Each file entry is of the following form:
<1-byte state><4-byte mode><4-byte size><4-byte mtime><4-byte name length><n-byte name>
If the name contains a null character, it is split into two strings, with the second being the copy source for move and copy operations.
If the dirstate file is not present, parents are assumed to be (null, null) with no files tracked.
Source: mercurial/parsers.py:parse_dirstate()
3.6. hgrc (local editable)
This is the repository-local configuration file. See .hgrc for more info.
3.7. inotify.sock [inotify]
This is a socket created by the inotify extension to communicate with its daemon.
3.8. localtags (local editable)
File containing local tags. Same format as .hgtags.
3.9. patches/ [mq]
This directory contains mq's patch management data
3.10. wlock
The lock file for the working directory state
Source: mercurial/lock.py, mercurial/localrepo.py:wlock()
3.11. journal.*
These files are backups of files before the beginning of a transaction used to restore earlier state on failure:
- journal.dirstate - copy of dirstate
- journal.branch - copy of branch
3.12. undo.*
Files from last transaction to allow rollback
- undo.dirstate - copy of dirstate
- undo.branch - copy of branch
4. Files in the repository store (.hg or .hg/store)
The following files are stored under .hg/store in repos with the store requirement, otherwise in .hg
4.1. lock
The lock file for the repository store
Source: mercurial/lock.py, mercurial/localrepo.py:lock()
4.2. journal
The journal file is a text file containing one entry per line of the form:
<filename> <pre-modified length>
This file allows mercurial to undo changes to revlogs. If this file exists, a transaction is in progress or has been interrupted.
Source: mercurial/transaction.py
4.3. undo
Renamed journal to allow rollback after transaction is complete.
Source: mercurial/localrepo.py:rollback()
4.4. 00changelog.[id]
The project changelog, stored in Revlog format.
Source: mercurial/changelog.py
4.5. 00manifest.[id]
The project manifest, stored in Revlog format. Each manifest revision contains a list of the file revisions in each changeset, in the form:
<filename>\0<hex file revision id>[<flags>]\n
Source: mercurial/parsers.c:parse_manifest()
4.6. fncache
For the fncache repository format Mercurial maintains a new file 'fncache' (thus the name of the format) inside '.hg/store'. The fncache file contains the paths of all filelog files in the store as encoded by mercurial.filelog.encodedir. The paths are separated by '\n' (LF).
4.7. data/
Revlogs for each file in the project history. Names are escaped in various increasingly-complex ways:
- old (see mercurial/filelog.py:encodedir()):
- directory names ending in .i or .d have .hg appended
- store (see mercurial/store.py:encodedstore):
uppercase is escaped: 'FOO' -> '_f_o_o'
- character codes outside of 32-126 are converted to '~XX' hex format
- fncache (see mercurial/store.py:hybridencode):
- windows reserved filename prefixes are ~XX-encoded
- very long filenames and stored by hash
Metadata may be stored at the start of each revision in a file revlog. If any metadata is there, the file contents will start with '\1\n', after which an arbitrary list of metadata pairs will follow, in '%k: %v\n' format. After that, another '\1\n' sequence follows to denote the start of the content.