exit.codes.and.excluding.directories
[tfs.git] / NEWS
blob3f3c03cd45785e0c8eb5b81211aa78040b8d363d
1 Version 0.5.1 of open source Team Foundation for Mono is now available at
2 http://code.google.com/p/opentf/
4 This is a development update with win32 installation packages, a GTK-based gui mode 
5 for exploring TFS repositories, command enhancements, improved builtin help with
6 usage guidelines, and many bugfixes.
8 If you're not familiar with Microsoft's Team Foundation / Team System product,
9 checkout the section "What is Team Foundation / Team System?" below.
11 Example invocations of the opentf client can be found here:
12   http://opentf.googlecode.com/svn/trunk/docs/examples/
15 Enhancements include:
16 ===================================================================
17 # Add "explore" command for visually browsing a repository. Features include
18 syntax highlighting, sortable columns, multiple views, and copy-and-paste for code review
19 feedback. This is a work in progress!
21 # Win32 packages of opentf, built with NSIS. A base version without GTK dependencies 
22 and no explore command and a full version WITH GTK dependencies and the "explore" command
23 are available.
25 # Add gtk login dialog for missing auth credentials
27 # Undo with no args will undo all local changes, previously the command
28 required at least one filename or path
30 # All commands now support reading arguments from stdin
32 # Command chaining now supports output piping using %%. Implemented for ls-files 
33 and diff /q commands only! For example, you can say "tf ls-files /others %% add"
34 to add all unknown files to the repository. 
36 # Support wildcards in checkout paths
38 # Teach tf workspaces command to filter by workspace name if requested
40 # Add syntax guidance to tf help <cmd> invocations
42 # 8 more test cases for tf client program covering add, renaming, 
43 and deleting of directories, and renaming files
45 # Report on UndonePendingChange events (which can happen if file upload
46         fails on checkin for example)
49 Bugfixes include:
50 ===================================================================
51 # BUGFIX: tf rename <olddir> <newdir> should work now
52 # BUGFIX: teach diff /modified to check file hashes before reporting a modified file
53 # BUGFIX: when told to delete a directory, delete files within them too
54 # BUGFIX: implement CheckAuthentication call - this makes adding large numbers
55         of files more reliable as it prevents NTML authentication timeout related failures
56 # BUGFIX: on windows, must do case insensitive path comparisons 
57         when looking for cached workspace info
58 # BUGFIX: tf online <list-of-files> didn't pickup deletes to pend
59 # BUGFIX: GetLocalWorkspaceInfo(string path) should trim workspaceinfo directory
60         separators before looking for a match
61 # BUGFIX: TryGetServerItemForLocalItem and TryGetLocalItemForServerItem
62         should find longest match
63 # BUGFIX: teach tf workfold /unmap to accept relative paths
64 # BUGFIX: always sort items in an ItemSet (sorts tf dir output for example)
67 What is Team Foundation / Team System?
68 ===================================================================
69 Team Foundation is a 'collection of collaborative technologies that
70 support a team effort to deliver a product' from Microsoft that 
71 includes bug tracking, source control, and other capabilities.'
73 Team Foundation powers Microsoft's CodePlex site and is used in many 
74 corporate environments. 
76 Team Foundation for Mono provides the TF client for accessing 
77 Team Foundation Servers as well as the Microsoft.TeamFoundation.* 
78 assemblies related to Version Control. 
80 An example of accessing CodePlex to pull the latest version of 
81 the "Turtle" project is below.
84 CodePlex Example Usage
85 ===================================================================
86 In the commands below,
87    UID = your codeplex user name
88    PWD = your codeplex password
89    MACHINENAME = your machine name (or any other random name)
91 First create a workspace:
93 tf /server:https://tfs01.codeplex.com /login:snd\\UID,PWD 
94 workspace /new "MACHINENAME;UID"
96 Then map "Turtle" project to a local folder:
98 tf /server:https://tfs01.codeplex.com /login:snd\\UID,PWD 
99 workfold "$/Turtle" ~/Source/turtle
101 Then pull the files:
103 tf /server:https://tfs01.codeplex.com /login:snd\\UID,PWD get 
104 ~/Source/turtle /recursive
106 Then you could review the history, review a changeset, then look
107 at the diff of the changeset. Note: the examples below assume
108 the tf client "Credentials.Save" option was enabled.
110 cd ~/Source/turtle
111 tf history /recursive .
112 tf changeset 340
113 tf diff C340
116 Source and Packages
117 ===================================================================
118 Debian packages, Win32 packages, and source tarball available here:
119    http://code.google.com/p/opentf/downloads/list
121 Additionally, a git clone of the source tree can be made with:
123     git clone git://repo.or.cz/tfs.git
125 This is where most development happens.
127 SVN users can check out the semi-regularly updated project source code at:
129     svn checkout http://opentf.googlecode.com/svn/trunk/ opentf
132 Project Site
133 ===================================================================
134 There is a Google Code Project Site for opentf, the URL is:
135 http://code.google.com/p/opentf/
137 There is a Google Discussion Group for opentf as well. The URL is:
138 http://groups.google.com/group/opentf