work on NEWS file
[tfs.git] / NEWS
blobdfaf44e7ada3a048bb2d8d8f908c5b0b5e8c176f
1 I'd like to announce version 0.5.0 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 ===================================================================
8 # NEW: add "tf help /list" helper for shell completion
9 # NEW: add History.StopAfter setting option
10 # NEW: implement tf help <cmd> with display of valid options for 
11         each command.
12 # NEW: support for tf add /recursive <path>
13 # NEW: --disable-magic option for windows/cygwin users
15 Bugfixes include:
16 ===================================================================
17 # BUGFIX: don't try to upload new directories on checkin, only files
18 # BUGFIX: Command.VerifiedFullPaths should accept directories too
19 # BUGFIX: shell wrapper tf should quote $@ so /C:"This is my comment" 
20         will work
21 # BUGFIX: uninstall man page and pkg-config file too
22 # BUGFIX: fix /format:detailed output for added files in history cmd
23 # BUGFIX: tf delete <folder> should actually delete the folder
25 Please note that this software is alpha. Use it at your own risk!
28 What is Team Foundation / Team System?
29 ===================================================================
30 Team Foundation is a 'collection of collaborative technologies that
31 support a team effort to deliver a product' from Microsoft that 
32 includes bug tracking, source control, and other capabilities.'
34 Team Foundation powers Microsoft's CodePlex site and is used in many 
35 corporate environments. 
37 Team Foundation for Mono provides the TF client for accessing 
38 Team Foundation Servers as well as the Microsoft.TeamFoundation.* 
39 assemblies related to Version Control. 
41 An example of accessing CodePlex to pull the latest version of 
42 the "Turtle" project is below.
45 CodePlex Example Usage
46 ===================================================================
47 In the commands below,
48    UID = your codeplex user name
49    PWD = your codeplex password
50    MACHINENAME = your machine name (or any other random name)
52 First create a workspace:
54 tf /server:https://tfs01.codeplex.com /login:snd\\UID,PWD 
55 workspace /new "MACHINENAME;UID"
57 Then map "Turtle" project to a local folder:
59 tf /server:https://tfs01.codeplex.com /login:snd\\UID,PWD 
60 workfold "$/Turtle" ~/Source/turtle
62 Then pull the files:
64 tf /server:https://tfs01.codeplex.com /login:snd\\UID,PWD get 
65 ~/Source/turtle /recursive
67 Then you could review the history, review a changeset, then look
68 at the diff of the changeset. Note: the examples below assume
69 Credentials.Save is on.
71 cd ~/Source/turtle
72 tf history /recursive .
73 tf changeset 340
74 tf diff C340
77 Source and Packages
78 ===================================================================
79 Debian packages and source tarball available here:
80    http://code.google.com/p/tf4mono/downloads/list
82 Additionally, a git clone of the source tree can be made with:
84     git clone git://repo.or.cz/tfs.git
86 For SVN users, check out the latest project source code:
88     svn checkout http://tf4mono.googlecode.com/svn/trunk/ tf4mono
91 Project Site
92 ===================================================================
93 There is a Google Code Project Site for tf4mono, the URL is:
94 http://code.google.com/p/tf4mono/
96 There is a Google Discussion Group for tf4mono as well. The URL is:
97 http://groups.google.com/group/tf4mono