Библиотека программиста

Все, что необходимо начинающему и опытному программисту

Ключевые слова $Author$
Имя пользователя, добавившего новую версию. $Date$
Дата и время обновления.
$Header$
Название, включающее полный путь файла RCS, версию обновления, дату, имя автора, состояние и (при блокировке) имя пользователя, блокировавшего файл.
$И$
Идентично $Header$, но исключая полный путь файла RCS. $Locker$
Имя пользователя, который заблокировал версию. Если файл не блокирован, ключевое слово имеет пустое значение.
$Log$
Текст, который был создан при добавлении файла для описания его изменений. Текст предваряется именем файла RCS, номером версии, именем автора и датой. Описания изменений накапливаются, а не перезаписываются.
$RCSfile$
Имя файла RCS (без пути к нему). $Revision$
Присвоенный номер версии. $Source$
Имя файла RCS, включая путь. $State$
Состояние, установленное параметром —s команды ci или res. Примеры значений
Допустим, файл /projects/'new/chapter&uji добавлен и извлечен пользователем с именем daniel. Вот каким будет результат подстановки ключевых слов во второй по счету версии файла:
$Author: daniel $

$Date: 2000702/25 18:21:10 $
SHeader: /projects/new/chapter3,v 1.2 2000/02/25 18:21:10 daniel \ Exp Locker: daniel $
$Id: chapter3,v 1.2 2000/02/25 18:21:10 daniel Exp Locker: daniel $
daniel $
$Log: chapter3,v $
SRevision 1.2 2000/02/25 18:21:10 daniel
ft Added section on error-handling
ft
ftRevision 1.1 2000/02/25 16:49:59 daniel
ft Initial revision
#
$RCSfile: chapter3,v $ $Revision: 1.2 $
$Source: /project/new/chapter3,v $
$State: Exp $
Нумерация версий
Команды RCS работают с последней версией файла, если нет явных указаний на иное. У некоторых из команд существует параметр —г, который используется для задания номера версии. Кроме того, со многими параметрами номер версии может указываться в качестве дополнительного аргумента. (В описаниях команд этот аргумент отображен как [Л]). Номера версий могут состоять из четырех полей: издание (release), уровень, ветвь и порядковый номер, но обычно состоят только из двух - издания и уровня.
Например, извлечь версию 1.4 можно следующим образом: со -1-Г1.4 ch01
Когда эта версия снова будет добавлена в проект, она получит номер версии 1.5. Но можно сделать измененный файл следующим изданием. Например:
ci -г2 ch01
Будет создана версия 2.1 файла. Вы также можете создать ответвление предыдущей версии. Следующая команда создает версию 1.4.1.1:
ci -П.4.1 сп01
Нумерация, впрочем, не является единственным способом обозначения версий. Возможно задание имен версий в виде текстовой метки посредством использования параметра —п команд ci или res. Также возможно задание этого имени в качестве аргумента любого параметра, принимающего номер версии. Например, вы можете добавлять свои программы на языке С, используя одну и ту же метку независимо от номера текущей версии:
ci -u -nPrototype ..с
Кроме того, начиная с версии RCS 5.6, существует возможность задания аргумента $, который предписывает создавать номер версии на основе значений ключевых слов рабочего файла. Например:
rcsdiff -r$ ch01
сравнивает файл chOl с поступившим обновлением. Также можно использовать имена вместе со специальными символами. Команда
rcs -nDraft:$ ch*
присваивает имя номерам версий, связанным с файлами нескольких глав.

Задание даты
Отметка времени для добавляемых версий производится на основе текущей даты и времени. Строки значений некоторых ключевых слов содержат дату. Даты могут передаваться в параметрах командам ci, со и rlog. По умолчанию в RCS используется следующий формат задания даты:
1999/10/16 02:00:00 (год/месяц/деньвремя)
Часовой пояс по умолчанию - GMT (Greenwich Mean Time), время которого известно также как UTC (Coordinated Universal Time). Даты можно задавать в произвольном формате. Это позволяет использовать различные стили. Вот некоторые из самых распространенных вариантов, в которых отображено то же время, что и в вышеприведенном примере:
6:00 pm it (предполагается, что текущая дата - октябрь, 16,1999)
2:00 AM, Oct. 16, 1999
Sat Oct 16 18:00:00 1999 LT Sat Oct 16 18:00:00 PST 1999
Сочетание букв ft (в любом регистре) является указанием на местное время (в данном случае Pacific Standard Time). В третьей строке представлен формат ctime (плюс LT); четвертая строка соответствует формату команды date.

Задание состояний
В некоторых ситуациях, в особенности, если речь идет о проекте разработки программного обеспечения, существует необходимость получить сведения о текущем состоянии набора версий. Файлы RCS связываются со строками текста, описывающими состояние (state) этих файлов. Состоянием по умолчанию является Ехр (экспериментальное). Среди прочих распространенных вариантов - Stab (стабильное) и Rel (завершенное). Эти слова определяются пользователем и не имеют специального внутреннего значения в RCS. Некоторые значения ключевых слов включают строки состояния. Кроме того, существует возможность передачи состояний в качестве аргументов параметров команд ci, со, res и rlog.

Стандартные параметры и переменные окружения
В RCS определяется переменная окружения RCSINIT, используемая для настройки параметров по умолчанию для команд RCS. Список параметров
(перечисляемых через пробел), содержащийся в этой переменной, будет
предварять параметры любой выполняемой команды RCS. В RCSINIT полезно включать три параметра: -q, —V и —х. Эти параметры можно назвать стандартными, поскольку они принимаются большинством команд RCS. Обратите внимание, что параметр —V является новым для версии RCS 5, а параметр -х появился в версии 5.6.
-q[R]
Тихий режим, без диагностики действий. Аргумент R определяет версию файла.
-Щп]
Эмуляция указанной (га) версии RCS. Параметр полезен при обмене файлами с системами, использующими другие версии RCS. га может принимать значения 3, 4 или 5. Если номер версии не указан, отображается текущая версия RCS.

—xsuffixes
Указать альтернативный список суффиксов suffixes фел " >-
фиксы разделяются символом /. В системах Unix файлы ы ш?.- -за-
канчиваются символами ,v. Параметр -х предоставляет в} л "о t < v-менить суффикс для тех систем, в которых запятая (,) в т допустима.
—z[zone]
Указать формат даты для подстановки ключевых слов. Параметр аргумента приводит к выводу времени в формате UTC без указания часового пояса. Если указан аргумент LT, на пользуется местный часовой пояс для вывода времени в формате ISO 8601 с указанием разницы с UTC-вре-менем. Можно также определить численную разницу с UTC. Например, результатом задания — z+4:30 будет строка типа: 1998-11-24 02:30:00+4:30.
Например, при помещении рабочего файла в файл RCS команда:
ci -x,v/ ch01 (второй суффикс является пустым)
производит поиск файлов RCS в следующем порядке:
RCS/chOI,v ch01,v RCS/chOI

Алфавитный перечень команд RCS
Подробную информацию о синтаксисе ключевых слов, номерах версий, датах, состояниях и стандартных параметрах можно найти в предыдущих делах.

ci [options] files
Добавление версий, ci сохраняет содержимое указанных рабочих файлов flies в соответствующих файлах RCS. Обычно ci удаляет рабочий файл после его добавления. Если RCS-файл не существует, тогда рабочий файл является начальной версией. В этом случае создается RCS-файл, а пользователю предлагается ввести описание файла. Если RCS-файл существует, ci увеличивает номер версии и предлагает ввести текст, описывающий последние сделанные изменения.
Начиная с RCS версии 5.6, при добавлении неизмененного
файла версия остается прежней. В RCS предшествующих версий существует возможность добавить новую версию, ничем не отличающуюся от предыдущей.
Чаще всего используются взаимоисключающие параметры -и, и Параметр позволяет сохранить копию рабочего

<< Назад         В начало         Далее >>

Библиотека программиста. 2009.
Администратор: admin@programmer-lib.ru