Команда "history"
Обновлен: Ноябрь 2007
Отображает журнал изменений для одного или нескольких файлов и папок.
Требуемые разрешения
Для использования команды history необходимо иметь разрешение Чтение со значением Разрешить для всех файлов или папок, журнал которых требуется отобразить. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
tf history [/server:servername] itemspec [/version:versionspec]
[/stopafter:number] [/recursive] [/user:username]
[/format:(brief|detailed)] [/slotmode] [/noprompt]
Параметры
Аргумент |
Описание |
|---|---|
servername |
Предоставляемое пользователем значение параметра /server. Пример: "teamfoundation2". |
itemspec |
Указывает файл или папку, для которой нужно отобразить журнал. Дополнительные сведения о том, как Team Foundation выполняет анализ спецификаций элементов, чтобы определить, какие из них находятся в области его действия, см. в разделе Параметры командной строки. |
versionspec |
Предоставляет значение, например C58, для параметра /version. Дополнительные сведения о том, как Team Foundation выполняет анализ спецификаций версий для определения элементов, находящихся в области его действия, см. в разделе Синтаксис командной строки (Team System). |
number |
Определяет количество наборов изменений, включаемых в запрос журнала. |
username |
Предоставляет значение для параметра /user. В зависимости от параметров сети, можно задать либо ДОМЕН\имя пользователя, либо имя пользователя. |
Параметр |
Описание |
|---|---|
/server |
Определяет Team Foundation Server. Этот параметр является обязательным, если вызов команды осуществляется из каталога, который не сопоставлен рабочей области. |
/version |
Указывает версию элементов, для которых нужно отобразить журнал изменений. По умолчанию Team Foundation использует версию рабочей области. Этот параметр не может использоваться вместе с параметром /slotmode. |
/stopafter |
Отображает журнал дляnumber указанных наборов изменений. Например, /stopafter:10 выводит последние десять изменений указанного элемента. |
/recursive |
Извлекает исторические данные об элементах, расположенных по указанному пути. |
/user |
Фильтрует список изменений по имени пользователя. Для выбора всех пользователей можно использовать знак "звездочка" (*). Если параметр не указывается, будут выбраны все пользователи. |
/format |
Задает описания, отображаемые для исторических данных. Brief отображает одну строку о каждом наборе изменений. Detailed выводит полное описание набора изменений. Если параметр не указывается, отображаются краткие описания. |
/slotmode |
Отображает журнал изменений для всех элементов, когда-либо находившихся в указанном расположении пространства имен. |
/noprompt |
Отключает отображение запросов на ввод данных пользователем. |
Заметки
Команда "history" открывает окно Журнал, в котором находятся кнопки Подробнее, Просмотреть и Сравнить. Кнопка Подробнее предназначена для отображения сведений о наборе изменений. Кнопка Просмотреть предназначена для отображения версий файлов. Кнопка Сравнить предназначена для сравнения версий файлов с текущей версией рабочей области, если выбрана только одна строка, или с двумя версиями, если выбраны две строки. Для копирования текстовых данных из выделенных строк в буфер обмена, воспользуйтесь параметром copy, доступном в контекстном меню окна "Журнал". Дополнительные сведения см. в разделе Основные сведения об окне журнала.
Для просмотра журнала для одного или нескольких файлов или папок служит команда history. Для каждого набора изменений, содержащего запрошенные элементы, Team Foundation в выходных данных отображает запись изменения. Сведения о наборе изменений включают информацию о пользователе, выполнившем изменение на сервере Team Foundation (подсистема контроля версий), о файлах и папках, для которых были сделаны ожидающие изменения, тип ожидающего изменения, номер набора изменений, дата и время создания набора изменений.
Если версия не указана, Team Foundation отображает весь журнал файла или папки. Если указывается спецификация одной версии, Team Foundation отображает сведения об элементе из этой версии обратно в версию 1. Если указывается диапазон версий (с использованием синтаксиса ~), выводится журнал для этих версий и всех версий, входящих в диапазон. Диапазон можно указать по возрастанию или по убыванию.
При использовании параметра /slotmodeTeam Foundation отображает журнал изменений для указанного элемента. Например, если файл был переименован, данный параметр выведет старое и новое имя. . Поскольку параметр /slotmode задает диапазон различных элементов и версий, комбинировать параметры /slotmode и /version нельзя.
Для определения номера набора изменений, в котором был зафиксирован набор файлов, используйте команду history, после этого воспользуйтесь командой "changeset" для отображения дополнительных сведений о сущности набора изменений и операции возврата, в результате которой он был создан. Или в окне "Журнал" выберите строку и нажмите кнопку Подробнее.
Ссылки на другие команды Team Foundation, предоставляющие дополнительные сведения об элементах на сервере Team Foundation (подсистема контроля версий) и сопоставленной рабочей области, см. в разделе Информационные команды.
Дополнительные сведения о поиске программы командной строки tf см. в разделе Команды служебной программы командной строки "tf".
Примеры
В следующем примере отображаются изменения, произошедшие между набором изменений версии 5 и версии 8 для файла 1256.c.
c:\projects> tf history /version:C5~C8 1256.c
В следующем примере отображаются последние десять изменений для файла 314.cs.
c:\projects> tf history /stopafter:10 314.cs
В следующем примере отображаются подробные результаты отформатированного журнала раздела пространства имен файла 1256.c.
c:\projects> tf history /format:detailed/slotmode 1256.c
См. также
Основные понятия
Работа с наборами изменений системы управления версиями
Ссылки
Синтаксис командной строки (Team System)