NEWS

   1 Version 0.6 of open source Team Foundation for Mono is now available at
   2 http://code.google.com/p/opentf/.
   3
   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.
   9
  10 A detailed changelog can be found below.
  11
  12 To learn more about many of the unique features found in OpenTF see:
  13   http://code.google.com/p/opentf/wiki/ClientDifferences
  14
  15 Example invocations of the opentf client can be found here:
  16   http://opentf.googlecode.com/svn/trunk/docs/examples/
  17
  18
  19 Enhancements include:
  20 ===================================================================
  21
  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.
  27
  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.
  35
  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".
  40
  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.
  44
  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.
  48
  49
  50 API Enhancements
  51 ==================================================================
  52
  53 # Microsoft.TeamFoundation.Common: Artifact, ArtifactId, ILinking
  54 LinkFilter, LinkingUtilities, ServiceInterfaces
  55
  56 # Microsoft.TeamFoundation.VersionControl.Client: ShelvingOptions,
  57 ChangesetMerge
  58
  59
  60 Bugfixes include:
  61 ===================================================================
  62
  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
  84
  85
  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.'
  91
  92 Team Foundation powers Microsoft's CodePlex site and is used in many
  93 corporate environments.
  94
  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.
  98
  99 An example of accessing CodePlex to pull the latest version of
 100 the "Turtle" project is below.
 101
 102
 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)
 109
 110 First create a workspace:
 111
 112   tf /server:https://tfs01.codeplex.com /login:snd\\UID,PWD
 113   workspace /new "MACHINENAME;UID"
 114
 115 Then map the "Turtle" project to a local folder:
 116
 117   tf /server:https://tfs01.codeplex.com /login:snd\\UID,PWD
 118   workfold "$/Turtle" ~/Source/turtle
 119
 120 Then pull the files:
 121
 122   tf /server:https://tfs01.codeplex.com /login:snd\\UID,PWD get
 123   ~/Source/turtle /recursive
 124
 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.
 128
 129   cd ~/Source/turtle
 130   tf history /recursive .
 131   tf changeset 340
 132   tf diff C340
 133
 134 More examples can be found in the docs/examples/ folder.
 135
 136
 137 Source and Packages
 138 ===================================================================
 139 Deb packages, Win32 packages, RPM packages, and source tarball available here:
 140    http://code.google.com/p/opentf/downloads/list
 141
 142 Additionally, a git clone of the source tree can be made with:
 143
 144     git clone git://repo.or.cz/tfs.git
 145
 146 This is where most development happens.
 147
 148 SVN users can check out the semi-regularly updated project source code at:
 149
 150     svn checkout http://opentf.googlecode.com/svn/trunk/ opentf
 151
 152
 153 Project Site
 154 ===================================================================
 155 There is a Google Code Project Site for opentf, the URL is:
 156 http://code.google.com/p/opentf/
 157
 158 There is a Google Discussion Group for opentf as well. The URL is:
 159 http://groups.google.com/group/opentf
 160