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)