]> git.lizzy.rs Git - plan9front.git/blob - sys/man/4/hgfs
hgfs(4): cleanup. still needs EXAMPLES.
[plan9front.git] / sys / man / 4 / hgfs
1 .TH HGFS 4
2 .SH NAME
3 hgfs \- mercurial file system
4 .SH SYNOPSIS
5 .B hgfs
6 [
7 .B -D
8 ]
9 [
10 .B -m
11 .I mtpt
12 ]
13 [
14 .B -s
15 .I service
16 ]
17 [
18 .I dir
19 ]
20 .SH DESCRIPTION
21 Mercurial is a distributed version control system. It tracks
22 and organizes files and keeps a change history of them. The
23 file revisions are stored as packed deltas in a repository
24 that can be checked out with the
25 .IR hg (1)
26 program.
27
28 .I Hgfs
29 allows read-only access to all stored file revisions
30 in a repository as simple files.
31
32 Starting
33 .I hgfs
34 without any options locates the repository of
35 the current working directory and mounts itself on
36 .B /n/hg.
37
38 The resulting served directory contains a list of subdirectories,
39 each corresponding to a specific changeset revision.
40
41 The special
42 name
43 .B tip
44 corresponds to the latest changeset but is not listed.
45
46 In each revision directory the following files can be found:
47 .TP
48 .B rev1
49 contains the parent revision id as text.
50 .TP
51 .B rev2
52 If the changeset was a merge, contains the other parent revision id. Otherwise, a zero size file.
53 .TP
54 .B log
55 The
56 .B log
57 file contains a list of file names, separated by a newline, that where
58 touched in this changeset. Files that are listed in the log
59 but are not visible in
60 .B files
61 or
62 .B changes
63 where deleted in this changeset.
64 .TP
65 .B who
66 committer of the changeset.
67 .TP
68 .B why
69 commit message of the changeset.
70 .TP
71 .B files
72 A directory that contains a snapshot of the filetree when this change was made.
73 To retrieve the \fIn\fRth
74 past version of a file, append
75 .I .n
76 to the filename. For revision id
77 .I revn,
78 append
79 .I .revn.
80 .TP
81 .B changes
82 Same as
83 .B files,
84 but contains only the changed files.
85 .SH SEE ALSO
86 .IR hg (1)