From 775bb045201ec9a24842d2883cd6373f27ea5369 Mon Sep 17 00:00:00 2001 From: Joel Reed Date: Sat, 30 Jun 2007 09:30:18 -0400 Subject: [PATCH] sync --- NEWS | 77 +++++++++++++++++++++++++++++++++++++++++++------------------ docs/tf.txt | 53 +++++++++++++++--------------------------- 2 files changed, 73 insertions(+), 57 deletions(-) diff --git a/NEWS b/NEWS index 5ad6b52..7618563 100644 --- a/NEWS +++ b/NEWS @@ -1,29 +1,70 @@ I'd like to announce version 0.4.7 of Team Foundation for Mono, -a maintenance update... +a maintenance update with a few new TF client commands. If you're +not familiar with Microsoft's Team Foundation / Team System product, +checkout the section "What is Team Foundation / Team System?" below. -Team Foundation powers Microsoft's CodePlex site and is used in many -corporate environments. +Enhancements include: +=================================================================== -Team Foundation for Mono provides the TF client for accessing -Team Foundation Servers as well as the Microsoft.TeamFoundation.* -assemblies related to Version Control. +# Implement label and unlabel commands. -An example of accessing CodePlex to pull the latest version of -the "Turtle" project is below. +# Add "cache" command which shows workspace cache settings. +# Add /added, /modified, /deleted flags to Online command to + show just additions, just modifications, or just deletions + respectively. These flags may be combined. With no flags, all + changes are incorporated. -Enhancements include: -=================================================================== +# Add tf diff /modified option to show locally modified files as a + unified diff. Can be used to review changes before using the online + command. + +# Add File.Excludes config option. Use in "online" command. -# Add XXX option to +# Add Online.Recursive setting. Make default non-recursive to match + standard MS client. + +# Add tf ls-files /writable option (mainly for windows users) Bugfixes include: =================================================================== +# BUGFIX: Fixed multiple issues related to running tf4mono on windows. + these include deleting read-only files and deleting files still open, + which succeed on *nix platforms, but not on windows. + +# BUGFIX: Online command on windows. Replace server item path separator + with platform path separator. + +# BUGFIX: Replace windows path separators in diff headers with nix path + separator so /usr/bin/patch is happy + +# BUGFIX: Show deleted files in tf status as state "Deleted" not "544" + +# BUGFIX: Compare file hashes when looking for modifications in tf online + command. Previously just looked for files marked writable. + Please note that this software is alpha. Use it at your own risk! +What is Team Foundation / Team System? +=================================================================== +Team Foundation is a 'collection of collaborative technologies that +support a team effort to deliver a product' from Microsoft that +includes bug tracking, source control, and other capabilities.' + +Team Foundation powers Microsoft's CodePlex site and is used in many +corporate environments. + +Team Foundation for Mono provides the TF client for accessing +Team Foundation Servers as well as the Microsoft.TeamFoundation.* +assemblies related to Version Control. + +An example of accessing CodePlex to pull the latest version of +the "Turtle" project is below. + + CodePlex Example Usage =================================================================== In the commands below, @@ -65,19 +106,9 @@ Additionally, a git clone of the source tree can be made with: git clone git://repo.or.cz/tfs.git -will include a signed v0.4.7 tag which points to a commit named: - - - -which can be verified with: - - gpg --keyserver hkp://keyserver.veridis.com --recv-keys 0xB1850655 - - git verify-tag v0.4.7 - -and can be checked out with a command such as: +For SVN users, check out the latest project source code: - git checkout -b build v0.4.7 + svn checkout http://tf4mono.googlecode.com/svn/trunk/ tf4mono Project Site diff --git a/docs/tf.txt b/docs/tf.txt index b5ec60c..a8f5a9a 100644 --- a/docs/tf.txt +++ b/docs/tf.txt @@ -18,14 +18,14 @@ DESCRIPTION OPTIONS ------- -*/login*:username[,password]:: +*/login:username [,password]*:: Provide authentication credentials. If you don't specify a password you will be prompted for one. If you have gnome-keyring support enabled, TF will store the login credentials on your default keyring if configured to do so (see "Credentials.Save" configuration option below). -*/server*::: +*/server:*:: Specify the Team Foundation Server. If you are within a mapped working folder, you don't need to specify the /server option, as this information is stored in the VersionControl.config @@ -42,10 +42,11 @@ COMMANDS The changeset id is just an integer - no "C" prefix is required as in the diff command below. -*checkin [ /recursive ]*:: +*checkin [ /recursive /comment: ]*:: Checkin pending changes in workspace. With no arguments, this command will checkin all files in your workspace, not just all files underneath - your current working directory. + your current working directory. Due to a limitation in Mono.GetOptions, + the /comment parameter cannot include spaces. This will be fixed soon! *checkout *:: Checkout a file for editing. Command alias: edit. @@ -56,8 +57,8 @@ COMMANDS sets the value of to . See Configuration section below for more details on valid settings. -*delete [ /recursive ]*:: - Pend a delete against a file or files from the repository. To commit, you +*delete [ /recursive ]*:: + Pend a delete against a file or files from the repository. To commit, you must issue a checkin command. *diff [ /old | /modified ]*:: @@ -81,7 +82,7 @@ COMMANDS Display changelog history for specified file. If you are looking for a git-log/svn log type function use this and add /recursive. -*label* [ /recursive ]*:: +*label [ /recursive ]*:: Add a label or tag to an item. *labels [ /owner: /format:detailed ]*:: @@ -146,37 +147,20 @@ COMMANDS EXAMPLES -------- -* List all workspaces on the server 10.2.10.2, using a username of - "domain\\username" and a password of "password". +*List all workspaces on the server 10.2.10.2, using a username of "domain\\username" and a password of "password".*:: + tf workspaces /server:10.2.10.2 /login:domain\\username,password /owner:"+++*+++" /computer:"+++*+++" ------------- -$ tf workspaces /server:10.2.10.2 /login:domain\\username,password \ - /owner:"*" /computer:"*" ------------- - -* Create a workspace with the name "workspaceName" with an owner name of ownerName - ------------- -$ tf workspace /new "workspaceName;ownerName" ------------- - -* Setup a working folder for the project "ProjectName" in directory ~/src/project - ------------- -$ tf workfold "$/ProjectName" /home/username/src/project ------------- +*Create a workspace with the name "workspaceName" with an owner name of ownerName.*:: + tf workspace /new "workspaceName;ownerName" -* Fetch/Get all files in folder in project "ProjectName" to local machine. - ------------- -$ tf get /recursive /home/username/src/project ------------- +*Setup a working folder for the project "ProjectName" in directory ~/src/project.*:: + tf workfold "$/ProjectName" /home/username/src/project -* Delete the workspace "workspaceName" created above. +*Fetch/Get all files in folder in project "ProjectName" to local machine.*:: + tf get /recursive /home/username/src/project ------------- -$ tf workspace /delete workspaceName ------------- +*Delete the workspace "workspaceName" created above.*:: + tf workspace /delete workspaceName MULTIPLE COMMANDS @@ -185,6 +169,7 @@ You can execute multiple commands in sequence in a single run of TF, by separating the commands with '%'. Here's how you might checkin a patch with a single run of TF: + ------------ $ patch -p1 < ~/new-feature.diff $ tf online % checkin -- 2.11.4.GIT