Differences

This shows you the differences between two versions of the page.

--- versioncontrol:dollarfreebsd [2006/09/27 13:55] – NikClayton
+++ versioncontrol:dollarfreebsd [2022/10/07 01:39] (current) – Move bakeoff stuff under a single namespace KubilayKocak
@@ Line 13: / Line 13: @@
 ===== SVN Implementation =====
+This is [[http://subversion.tigris.org/issues/show_bug.cgi?id=890|issue#890]] in the Subversion issue tracker.  The bulk of the code to implement this is already in Subversion -- what's missing is a per-repository configuration mechanism that can enable it.  Without it, any client that accessed the repository would need to be patched to support $%%FreeBSD%%$, and any other custom keywords.
 ===== Hg Implementation =====
+Hg by default does no keyword expansion at all.  There are practical reasons not to do this (including the fact that it does complicates the job of the VCS) but it is seen as %%FreeBSD%% developers as a useful feature.  Therefore, someone has written an Hg extension to do expansion of certain keywords.
+This allow for the hash of the changeset that touched a file last to be inserted in the file like $Id$.
+Like git, hg does have some commands to give information about files and revisions: ''%%hg tip%%'' gives you the revision your repository is at, ''%%hg log%%'' gives you the entire history of the repository or files you are looking at.
 ===== Git Implementation =====
@@ Line 20: / Line 27: @@
 For discussing revisions in debugging, ''%%git show%%'' shows what sha1 is at the top of your current branch, ''%%git-rev-list%%'' shows what sha1s are in the history of your branch, and comparing the position a user's latest sha1 with the sha1 of a fix you did in the ''%%git-rev-list%%'' tells you if a user has a given fix in their tree.
+There has been recent work to add checkout hooks to git which would make it easy to have keyword expansion on checkout which could then be compiled into a file and identified with ident(1) or what(1).
+Recent commits to the git repository have added support for receive and checkout filters which have added support for imploding an exploding an $ident$ keyword. So git can now support this.
+===== Monotone Implementation =====
+**Partially Supported**
+(also see [[http://venge.net/monotone/wiki/FeatureEmbeddedIDs|monotone:FeatureEmbeddedIDs]])
+Monotone does not directly support automatic expansion of version strings or other keywords inside file content.  Because the SHA-1 hashes of file content are crucial, and because these kinds of flags have proved difficult and confusing in some other systems, implementation of this feature has been avoided up to now -- mostly for lack of a compelling use case.  It is certainly possible to add.
+Some of the cases where this kind of feature is used in other systems are better addressed by other mechanisms in monotone; the first requirement (see which revision a source file is at) is actually very easy: the file's SHA-1 hash **is** the version itself, so having the id in the file itself is not needed to identify unchanged files.  This would not address the requirement that binary files contain the revision, though.
+It is possible to approximate this feature, if needed, using hooks. A custom attr could be attached to files that need such expansion, and an attr-hook defined in lua to perform the substitution.  Another possibility may be an implementation similar to that used to handle platform-specific newline formats, generalising that to other kinds of filters. In any such implementation, it would be vital to ensure that the content of the file seen for commit has been sanitised to contain only the bare keyword in a 'canonical' form that is stable between revisions.