NEWS

   1 Version 0.5.4 of open source Team Foundation for Mono is now available at
   2 http://code.google.com/p/opentf/. The project has been renamed from tf4mono
   3 to OpenTF.
   4
   5 This is a development update with VS2005 project files, a spec file for RPM
   6 packaging, new commands (lock, version, show [ build | cache | ident | stats | tools ]),
   7 numerous API and usability enhancements, and many bugfixes.
   8
   9 A detailed changelog can be found below.
  10
  11 To learn more about many of the unique features found in OpenTF see:
  12   http://code.google.com/p/opentf/wiki/ClientDifferences
  13
  14 Example invocations of the opentf client can be found here:
  15   http://opentf.googlecode.com/svn/trunk/docs/examples/
  16
  17
  18 Enhancements include:
  19 ===================================================================
  20
  21 # add VS2005 project files and solution for building opentf on Windows
  22 # add spec file for building RPMs on OpenSuse
  23 # add "lock" command
  24 # add "show stats" command to show server statistics
  25 # add "show tools" command to show registered tools
  26 # add "show build" command to show build configuration
  27 # add "show ident" command to show server account information
  28 # rename "tf cache" to "tf show cache"
  29 # implement "tf changeset /latest" and test case
  30 # implement "tf history /user:FOO" for filtering history queries by user
  31 # implement "tf history /version:<vspec>" - but not ranges!
  32 # add "tf history /format:byowner" and test case
  33 # add "tf version" command to print program version number
  34 # add "Server.Default" setting
  35 # teach File.Excludes to support directory specifications as well as
  36 file glob patterns
  37 # teach tf shelveset the "name;owner" syntax for specifying a shelveset
  38
  39
  40 API Enhancements
  41 ==================================================================
  42
  43 # The following classes were added (partial implementations)
  44
  45   ICredentialsProvider, ArtifactType, ChangeType, Database,
  46   IGroupSecurityService, IRegistration, Identity, IdentityType,
  47   QueryMembership, OutboundLinkType, RegistrationEntry, SearchFactor
  48   and ServiceInterface classes
  49
  50 # Implement VersionControlServer.GetLatestChangesetId
  51 # Implement TeamFoundationServer.CheckAuthentication
  52 # Started work on Microsoft.TeamFoundation.WorkItemTracking.Client assembly
  53
  54
  55 Bugfixes include:
  56 ===================================================================
  57
  58 # BUGFIX: rework exit codes throughout for more consistency
  59 # BUGFIX: tf shelveset /owner:<owner> should filter results by owner
  60 # BUGFIX: add column headers to history /format:brief output
  61 # BUGFIX: tf get /force shouldn't set preview mode!
  62 # BUGFIX: properly label renames in tf status output
  63 # BUGFIX: make sure all files in a directory are read-write before
  64 attempting to delete a directory containing these files
  65 # BUGFIX: handle QueryHistory requests with maxCount > 256
  66
  67
  68 What is Team Foundation / Team System?
  69 ===================================================================
  70 Team Foundation is a 'collection of collaborative technologies that
  71 support a team effort to deliver a product' from Microsoft that
  72 includes bug tracking, source control, and other capabilities.'
  73
  74 Team Foundation powers Microsoft's CodePlex site and is used in many
  75 corporate environments.
  76
  77 Team Foundation for Mono provides the TF client for accessing
  78 Team Foundation Servers as well as the Microsoft.TeamFoundation.*
  79 assemblies related to Version Control.
  80
  81 An example of accessing CodePlex to pull the latest version of
  82 the "Turtle" project is below.
  83
  84
  85 CodePlex Example Usage
  86 ===================================================================
  87 In the commands below,
  88    UID = your codeplex user name
  89    PWD = your codeplex password
  90    MACHINENAME = your machine name (or any other random name)
  91
  92 First create a workspace:
  93
  94   tf /server:https://tfs01.codeplex.com /login:snd\\UID,PWD
  95   workspace /new "MACHINENAME;UID"
  96
  97 Then map the "Turtle" project to a local folder:
  98
  99   tf /server:https://tfs01.codeplex.com /login:snd\\UID,PWD
 100   workfold "$/Turtle" ~/Source/turtle
 101
 102 Then pull the files:
 103
 104   tf /server:https://tfs01.codeplex.com /login:snd\\UID,PWD get
 105   ~/Source/turtle /recursive
 106
 107 Then you could review the history, review a changeset, then look
 108 at the diff of the changeset. Note: the examples below assume
 109 the tf client "Credentials.Save" option was enabled.
 110
 111   cd ~/Source/turtle
 112   tf history /recursive .
 113   tf changeset 340
 114   tf diff C340
 115
 116 More examples can be found in the docs/examples/ folder.
 117
 118
 119 Source and Packages
 120 ===================================================================
 121 Deb packages, Win32 packages, RPM packages, and source tarball available here:
 122    http://code.google.com/p/opentf/downloads/list
 123
 124 Additionally, a git clone of the source tree can be made with:
 125
 126     git clone git://repo.or.cz/tfs.git
 127
 128 This is where most development happens.
 129
 130 SVN users can check out the semi-regularly updated project source code at:
 131
 132     svn checkout http://opentf.googlecode.com/svn/trunk/ opentf
 133
 134
 135 Project Site
 136 ===================================================================
 137 There is a Google Code Project Site for opentf, the URL is:
 138 http://code.google.com/p/opentf/
 139
 140 There is a Google Discussion Group for opentf as well. The URL is:
 141 http://groups.google.com/group/opentf
 142