Синтаксис командной строки (Team Explorer Everywhere)
Вы установили Межплатформенный клиент командной строки для Team Foundation Server.Но до того, как ввести любую команду, необходимо понимать общие сведения о синтаксисе и использовании.
Содержание раздела
Установка параметров
На компьютерах UNIX абсолютные пути начинаются с косой черты (/), поэтому для запуска параметров используется дефис (-).В противном случае Межплатформенный клиент командной строки для Team Foundation Server не сможет отличить путь от параметра.
Кавычки и escape-символы
Оболочки Unix поддерживают много специальных знаков для подстановочных знаков, регулярных выражений и т. д.Если эти аргументы содержат символы, которые оболочка считает специальными, необходимо применить escape-последовательность или заключить в кавычки аргументы команд.Можно пометить литералы в оболочках Unix, как показано ниже:
Чтобы сохранить буквальное значение символа, укажите перед ним обратную косую чертой (\).Например:
tf checkout -recursive $/Inventory/Client\ Suite/Чтобы сохранить буквальные значения заключенных символов, необходимо заключить текст в одинарных кавычках (‘’).Переменные оболочек, ссылка на которые делается со знаком доллара ($), не вычисляются, если заключить их в одиночные кавычки.Например:
tf checkout -recursive ‘$/Inventory/Client Suite/’Чтобы сохранить буквальное значение заключенных символов (за исключением $, `, \ и !), необходимо заключить текст в двойных кавычках (“”).
Из-за этих исключений переменные развернуты, подоболочки по-прежнему вычисляются, обратную косую черту можно по-прежнему использовать в escape-символах, а события журнала по-прежнему развернуты.В следующем примере показано, что обратная черта все равно необходима, чтобы это предотвратить.от разворачивания в событие журнала.
tf checkin -comment:”Fixed the bug\!” file.java
Серверные пути для Visual Studio Team Foundation Server начинаются со знака доллара, однако в оболочках Unix знак доллара используется для запуска вычисления переменной.Такие оболочки, как sh, ksh, bash и zsh распознает, что символ в серверном пути, который стоит после знака доллара, не является допустимым именем переменной.Поэтому эти оболочки передают знак доллара на Межплатформенный клиент командной строки для Team Foundation Server без изменений.
Однако оболочки, производные от csh (включая tcsh), не анализируют командную строку подобным образом.Эти оболочки считывают знак доллара и делают попытка заменить переменную, которая соответствует тексту, который передается.Поскольку следующий текст представляет собой косую черту (/), и эти оболочки требуют имен переменных начинающихся с буквы, возникает ошибка.При использовании оболочек csh или tcsh необходимо создавать escape-символы для знаков доллара в путях к серверу. Для этого можно использовать обратную косую черту или одиночные кавычки.Двойные кавычки служат причиной попытки развернуть переменную, предпринимаемой оболочкой.Ниже приведено несколько примеров escape-преобразования и заключения в кавычки для оболочек csh:
tf checkout -recursive \$/Inventory/Client\ Suite/
tf checkout -recursive ‘$/Inventory/Client Suite/’
tf checkout -recursive \$”/Inventory/Client Suite/”
Спецификации элемента
Спецификация элемента это локальный путь или путь сервера, описывающий файл или папку, представляющие собой входной параметр для опции или команды для Межплатформенный клиент командной строки для Team Foundation Server.Спецификация элемента может содержать суффикс спецификации версии, разделенных точкой с запятой.Этот суффикс является необязательным.Указывайте суффикс, только если нужно сослаться на историческую версию элемента.
Примеры спецификаций элементов:
Спецификация элемента |
Описание |
|---|---|
$/Inventory/src |
Серверный путь к папке |
$/Inventory/src/Class.java |
Серверный путь к файлу |
/tmp/Inventory |
Локальный путь к Рабочая папка (Unix) |
/tmp/Inventory/src/Class.java |
Локальный путь к файлу (Unix) |
C:\Inventory\src |
Локальный путь к Рабочая папка (Windows) |
C:\Inventory\src\Class.java |
Локальный путь к файлу (Windows) |
$/Inventory/src;C4095 |
Серверный путь к папке на наборе изменений 4095 |
.\Class.java;C129 |
Относительный путь к локальному (Windows) файлу на наборе изменений 129 |
./Class.java;Lrelease-1.0 |
Относительный путь к локальному (Unix) файлу на метке release-1.0 |
$/Inventory/src/file.txt;Wdev;john |
Серверный путь в версии в рабочей области dev, принадлежащей Джону. |
file.txt;D01/01/2007 |
Локальный путь для 1 января 2007 г. .gif "Примечание") Примечание
Поддерживаются даты ISO 8601.Анализ дат выполняется согласно языковому стандарту пользователя.
|
file.txt;X1067 |
Ранее удаленный файл с deletionID 1067 |
Спецификации версии
Спецификация версии это специально отформатированная строка, которая указывает на конкретную единую версию или диапазон версий элемента в системе управления версиями.Спецификации версий используются в 2 случаях: как суффиксы к спецификациям элементов (см. раздел Item Specifications ранее в этом разделе) и как изолированные значения параметра -version для некоторых команд.
Примеры спецификаций версий:
Формат спецификации версии |
Описание |
|---|---|
T |
Последняя версия. |
Cn |
Версия в наборе изменений n. |
LlabelID |
Версия на метке labelID. |
Wимя; владелец |
Версия в данный момент в рабочей области имя, принадлежащей владелец. |
Ddatestring |
Версия по дате и времени, указанным в datestring |
XdeletionID |
Версия, которая была удалена и получила deletionID от сервера. |