Skip to content

Commit b036cdb

Browse files
committed
Additional changes for TFVC.
1 parent 91c4e42 commit b036cdb

File tree

1 file changed

+10
-8
lines changed

1 file changed

+10
-8
lines changed

mac/tf-version-control.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -33,20 +33,22 @@ The rest of this article walks you through the options listed above.
3333

3434
## Use Visual Studio Code and the Azure Repos extension
3535

36-
If you like to work with a graphical interface for managing you local version control, then the Azure Repos extension for Visual Studio Code provides a supported solution from Microsoft. To get started, download [Visual Studio Code](https://code.visualstudio.com) and then learn how to [configure the Azure Repos extension](https://marketplace.visualstudio.com/items?itemName=ms-vsts.team).
36+
If you like to work with a graphical interface to manage you files in version control, then the Azure Repos extension for Visual Studio Code provides a supported solution from Microsoft. To get started, download [Visual Studio Code](https://code.visualstudio.com) and then learn how to [configure the Azure Repos extension](https://marketplace.visualstudio.com/items?itemName=ms-vsts.team).
3737

3838
## Connecting using the Team Explorer Everywhere Command Line Client
3939

4040
If you're comfortable using the macOS Terminal, then the Team Explorer Everywhere Command Line Client (TEE-CLC) provides a supported way to connect to your source in TFVC.
4141

42+
You can follow the steps below to set up your connection to TFVC and commit changes.
43+
4244
Special thanks to Chris Pilcher, a developer in our community, who's [original instructions for the TEE-CLC](https://gist.github.com/chris-pilcher/a3f14eb081d7ab983e5c) formed the basis of this section.
4345

4446
### Setting up the TEE-CLC
4547

4648
There are two ways to get setup with the TEE-CLC.
4749

48-
1. Use Homebrew to install the client.
49-
1. Download and manually install the client.
50+
* Use Homebrew to install the client, or
51+
* Download and manually install the client
5052

5153
The easiest solution is **using HomeBrew**, which is a package manager for macOS. To install using this method:
5254

@@ -63,13 +65,13 @@ To **setup the TEE-CLC manually**:
6365

6466
Once the TEE-CLC is installed, you can run the command `tf eula` to view and accept the license agreement for the client.
6567

66-
Finally, to authenticate with your TFS/Azure DevOps environment, you'll need to create a personal access token on the server. Learn more about [authenticating with personal access tokens](https://docs.microsoft.com/en-us/azure/devops/integrate/get-started/authentication/pats?view=azure-devops).
68+
Finally, to authenticate with your TFS/Azure DevOps environment, you'll need to create a personal access token on the server. Learn more about [authenticating with personal access tokens](https://docs.microsoft.com/en-us/azure/devops/integrate/get-started/authentication/pats?view=azure-devops). When creating a personal access token to use with TFVC, be sure to provide Full Access when configuring the token.
6769

6870
### Using the TEE-CLC to connect to your repo
6971

7072
To connect to your source code, you first need to create a workspace using the `tf workspace` command. For example, the following commands connect to an Organization in Azure DevOps Services called "MyOrganization":
7173

72-
```
74+
```bash
7375
export TF_AUTO_SAVE_CREDENTIALS=1
7476
tf workspace -new MyWorkspace -collection:https://dev.azure.com/MyOrganization
7577
```
@@ -78,21 +80,21 @@ The `TF_AUTO_SAVE_CREDENTIALS` environment setting is used to save your credenti
7880

7981
Now, to create a mapping of your source files to a local folder, you'll use the `tf workfold` command. The following example will map a folder named "WebApp.Services" from the "MyRepository" TFVC project and set it up to be copied into the local ~/Projects/ folder (i.e. a "Projects" folder in the current users's home folder).
8082

81-
```
83+
```bash
8284
tf workfold -map $/MyRepository/WebApp.Services -workspace:MyWorkspace ~/Projects/
8385
```
8486

8587
Finally, you use the following command to get the source files from the server and copy them locally:
8688

87-
```
89+
```bash
8890
tf get
8991
```
9092

9193
### Committing changes using the TEE-CLC
9294

9395
After you've made changes to your files in Visual Studio for Mac, you can switch back to the Terminal to check in your edits. The `tf add` command is used to add files to the list of pending changes to be checked-in and the `tf checkin` command performs the actual check-in to the server. The `checkin` command includes parameters to add a comment or associate a related work item. In the following code snippet, all files in a `WebApp.Services` folder are added, recursively, to the checkin. Then, the code is checked in with a comment and associated with a work item with the ID "42".
9496

95-
```
97+
```bash
9698
cd WebApp.Services
9799
tf add * /recursive
98100
tf checkin -comment:"Replaced 'Northwand' typos with the correct word Northwind" -associate:42

0 commit comments

Comments
 (0)