dont connect to server till we need to
[tfs.git] / NEWS
blob76185633d38f4b85fd7d5c554afd6954f62a418c
1 I'd like to announce version 0.4.7 of Team Foundation for Mono, 
2 a maintenance update with a few new TF client commands. If you're 
3 not familiar with Microsoft's Team Foundation / Team System product,
4 checkout the section "What is Team Foundation / Team System?" below.
6 Enhancements include:
7 ===================================================================
9 # Implement label and unlabel commands.
11 # Add "cache" command which shows workspace cache settings.
13 # Add /added, /modified, /deleted flags to Online command to
14         show just additions, just modifications, or just deletions 
15         respectively. These flags may be combined. With no flags, all
16         changes are incorporated.
18 # Add tf diff /modified option to show locally modified files as a
19         unified diff. Can be used to review changes before using the online
20         command.
22 # Add File.Excludes config option. Use in "online" command.
24 # Add Online.Recursive setting. Make default non-recursive to match
25         standard MS client.
27 # Add tf ls-files /writable option (mainly for windows users)
30 Bugfixes include:
31 ===================================================================
33 # BUGFIX: Fixed multiple issues related to running tf4mono on windows.
34         these include deleting read-only files and deleting files still open,
35         which succeed on *nix platforms, but not on windows.
37 # BUGFIX: Online command on windows. Replace server item path separator 
38         with platform path separator.
40 # BUGFIX: Replace windows path separators in diff headers with nix path 
41         separator so /usr/bin/patch is happy
43 # BUGFIX: Show deleted files in tf status as state "Deleted" not "544"
45 # BUGFIX: Compare file hashes when looking for modifications in tf online 
46         command. Previously just looked for files marked writable.
48 Please note that this software is alpha. Use it at your own risk!
51 What is Team Foundation / Team System?
52 ===================================================================
53 Team Foundation is a 'collection of collaborative technologies that
54 support a team effort to deliver a product' from Microsoft that 
55 includes bug tracking, source control, and other capabilities.'
57 Team Foundation powers Microsoft's CodePlex site and is used in many 
58 corporate environments. 
60 Team Foundation for Mono provides the TF client for accessing 
61 Team Foundation Servers as well as the Microsoft.TeamFoundation.* 
62 assemblies related to Version Control. 
64 An example of accessing CodePlex to pull the latest version of 
65 the "Turtle" project is below.
68 CodePlex Example Usage
69 ===================================================================
70 In the commands below,
71    UID = your codeplex user name
72    PWD = your codeplex password
73    MACHINENAME = your machine name (or any other random name)
75 First create a workspace:
77 tf /server:https://tfs01.codeplex.com /login:snd\\UID,PWD 
78 workspace /new "MACHINENAME;UID"
80 Then map "Turtle" project to a local folder:
82 tf /server:https://tfs01.codeplex.com /login:snd\\UID,PWD 
83 workfold "$/Turtle" ~/Source/turtle
85 Then pull the files:
87 tf /server:https://tfs01.codeplex.com /login:snd\\UID,PWD get 
88 ~/Source/turtle /recursive
90 Then you could review the history, review a changeset, then look
91 at the diff of the changeset. Note: the examples below assume
92 Credentials.Save is on.
94 cd ~/Source/turtle
95 tf history /recursive .
96 tf changeset 340
97 tf diff C340
100 Source and Packages
101 ===================================================================
102 Debian packages and source tarball available here:
103    http://code.google.com/p/tf4mono/downloads/list
105 Additionally, a git clone of the source tree can be made with:
107     git clone git://repo.or.cz/tfs.git
109 For SVN users, check out the latest project source code:
111     svn checkout http://tf4mono.googlecode.com/svn/trunk/ tf4mono
114 Project Site
115 ===================================================================
116 There is a Google Code Project Site for tf4mono, the URL is:
117 http://code.google.com/p/tf4mono/
119 There is a Google Discussion Group for tf4mono as well. The URL is:
120 http://groups.google.com/group/tf4mono