hgfs(4) incomplete manpage

1 files changed, 82 insertions, 0 deletions

diff --git a/sys/man/4/hgfs b/sys/man/4/hgfs
new file mode 100644
index 000000000..9fafd2aa6
--- /dev/null
+++ b/sys/man/4/hgfs
@@ -0,0 +1,82 @@
+.TH HGFS 4
+.SH NAME
+hgfs \- mercurial file system
+.SH SYNOPSIS
+.B hgfs
+[
+.B -D
+]
+[
+.B -m
+.I mtpt
+]
+[
+.B -s
+.I service
+]
+[
+.I dir
+]
+.SH DESCRIPTION
+Mercurial is a distributed version control system. It tracks
+and organizes files and keeps a change history of them. The
+file revisions are stored as packed deltas in a repository
+and can be checked out with the
+.IR hg (1)
+program.
+
+Hgfs allows read only access to all stored file revisions
+in a repository as simple files.
+
+Starting hgfs without any options finds the repository of
+the current working directory and mounts itself to
+.B /n/hg.
+
+The served directory contains a list of subdirectories
+each corresponding to a specific changeset revision.
+
+The special
+name
+.B tip
+corresponds to the latest changeset but is not listed.
+
+In each revision directory the following files can be found:
+.TP
+.B rev1,rev2
+These files contain the two parent revision ids as text.
+.TP
+.B log
+The
+.B log
+file contains a list of file names, separated by newline, that where
+touched in this changeset. Files that are listed in the log
+but are not visible in
+.B files or
+.B changes
+where deleted in this changeset.
+.TP
+.B who,why
+These files contains the commiter and the commit message of
+the changeset.
+.TP
+.B files,changes
+These directories contain a snapshot of the filetree when this
+change was made. The 
+.B changes
+directory contains only the changed
+files.
+
+On files in the
+.B files
+and
+.B changes
+directories, one can append
+.I .n
+(or
+.I .revn
+to get the revision id)
+to the filename where
+.I n
+is the nth past version of the file.
+.SH SEE ALSO
+.IR hg (1)