show the difference between two versions for a specified path
[tfs.git] / NEWS
1 Version 0.6 of open source Team Foundation for Mono is now available at
4 This is a development update with a new IRC changeset notification bot,
5 support for CruiseControl (an open source continuous build framework),
6 a monodevelop plugin for browsing TFS servers, several new commands 
7 ("shelve", "rollback", and "merges"), numerous API and usability enhancements, 
8 and many bugfixes.
10 A detailed changelog can be found below.
12 To learn more about many of the unique features found in OpenTF see: 
15 Example invocations of the opentf client can be found here:
19 Enhancements include:
20 ===================================================================
22 # CRUISECONTROL: add support for date range queries to the history
23         command, e.g. -version:"D2006-10-01T01:01:01Z~D2006-12-13T20:00:00Z"
24 # CRUISECONTROL: add -noprompt option
25 # CRUISECONTROL: add support for username@domain -login syntax
26 # TFSBOT: add new IRC commit notification daemon. 
28 # add alpha-quality MonoDevelop addin, with debian package
29 # implement "tf shelve <name> <path>" to create new shelvesets
30 # implement "tf shelve /delete <name>" for deleting shelvesets
31 # implement "tf merges <src> <dest>" for listing merge points
32 # implement "tf diff /ignorespace" option
33 # implement "tf rollback <changeset>" for undoing a changeset.
34         NOTE: only useful if no one else has changed the file since then.
36 # add Get.ChangesetMtimes setting: By enabling this option, 
37         the TF will set the modification time of any file subsequently fetched
38         to the date of the last changeset in which the file was modified. 
39         Warning: this mode of operation can significantly slow down "tf get".
41 # add Get.DefaultToCwd setting: By enabling this option, the TF 
42         client will look for updates starting with the current working folder 
43         instead of pulling updates from all registered working folders.
45 # add Workspace.Default setting: If the TF client cannot determine the 
46         active workspace, first from the "/workspace:" option, and second the 
47         workspace cache, then it will use the Workspace.Default setting if non-null.
50 API Enhancements
51 ==================================================================
53 # Microsoft.TeamFoundation.Common: Artifact, ArtifactId, ILinking
54 LinkFilter, LinkingUtilities, ServiceInterfaces
56 # Microsoft.TeamFoundation.VersionControl.Client: ShelvingOptions,
57 ChangesetMerge
60 Bugfixes include:
61 ===================================================================
63 # BUGFIX: tf history with stopAfter > 256 shouldn't emit
64         duplicate entries (thanks to dion.olsthoorn for the report & fix)
65 # BUGFIX: tf online <path> shouldn't croak if <path> is an add awaiting 
66         its first checkin
67 # BUGFIX: tf undo <paths> shouldn't undo all local changes
68 # BUGFIX: when parsing changeset and shelveset datetimes don't 
69         drop the time portion
70 # BUGFIX: insert trailing tabs after filenames (a/b) in diffs to
71         help diffutils grok filenames with spaces
72 # BUGFIX: make sure tf ls-files <paths> is not passed a filename
73 # BUGFIX: set proper checkin time (by passing 0, not DateTime.Now - doh!)
74 # BUGFIX: fix tf ls-files /others breakage on windows for subdirectories
75 # BUGFIX: update local workspace cache when "tf workspaces" command called.
76 # BUGFIX: fix issue #8 "tf config expects ~/.tf/ to already exist"
77 # BUGFIX: teach tf that diffing binary files should print short 
78         "Binary files $1 and $2 differ" message
79 # BUGFIX: teach status command how to deal with locked files
80 # BUGFIX: teach tf branches command about server paths
81 # BUGFIX: don't clobber workspace info cache when there
82         are >1 TFS server
83 # BUGFIX: update build for monodevelop 0.18.1 changes
86 What is Team Foundation / Team System?
87 ===================================================================
88 Team Foundation is a 'collection of collaborative technologies that
89 support a team effort to deliver a product' from Microsoft that 
90 includes bug tracking, source control, and other capabilities.'
92 Team Foundation powers Microsoft's CodePlex site and is used in many 
93 corporate environments. 
95 Team Foundation for Mono provides the TF client for accessing 
96 Team Foundation Servers as well as the Microsoft.TeamFoundation.* 
97 assemblies related to Version Control. 
99 An example of accessing CodePlex to pull the latest version of 
100 the "Turtle" project is below.
103 CodePlex Example Usage
104 ===================================================================
105 In the commands below,
106    UID = your codeplex user name
107    PWD = your codeplex password
108    MACHINENAME = your machine name (or any other random name)
110 First create a workspace:
112   tf /server: /login:snd\\UID,PWD 
113   workspace /new "MACHINENAME;UID"
115 Then map the "Turtle" project to a local folder:
117   tf /server: /login:snd\\UID,PWD 
118   workfold "$/Turtle" ~/Source/turtle
120 Then pull the files:
122   tf /server: /login:snd\\UID,PWD get 
123   ~/Source/turtle /recursive
125 Then you could review the history, review a changeset, then look
126 at the diff of the changeset. Note: the examples below assume
127 the tf client "Credentials.Save" option was enabled.
129   cd ~/Source/turtle
130   tf history /recursive .
131   tf changeset 340
132   tf diff C340
134 More examples can be found in the docs/examples/ folder.
137 Source and Packages
138 ===================================================================
139 Deb packages, Win32 packages, RPM packages, and source tarball available here:
142 Additionally, a git clone of the source tree can be made with:
144     git clone git://
146 This is where most development happens.
148 SVN users can check out the semi-regularly updated project source code at:
150     svn checkout opentf
153 Project Site
154 ===================================================================
155 There is a Google Code Project Site for opentf, the URL is:
158 There is a Google Discussion Group for opentf as well. The URL is: