ci - Online na nuvem

PROGRAMA:

NOME

ci - verificar as revisões do RCS

SINOPSE

ci [opções] lima ...

DESCRIÇÃO

ci armazena novas revisões em arquivos RCS. Cada nome de arquivo correspondente a um sufixo RCS é levado para
ser um arquivo RCS. Todos os outros são considerados arquivos de trabalho contendo novas revisões. ci
deposita o conteúdo de cada arquivo de trabalho no arquivo RCS correspondente. Se apenas um
arquivo de trabalho é fornecido, ci tenta encontrar o arquivo RCS correspondente em um subdiretório RCS
e, em seguida, no diretório do arquivo de trabalho. Para obter mais detalhes, consulte NOME DE ARQUIVOS abaixo.

Escolha ci para funcionar, o login do chamador deve estar na lista de acesso, exceto se a lista de acesso
está vazio ou o chamador é o superusuário ou o proprietário do arquivo. Para anexar um novo
revisão para um ramo existente, a revisão de ponta nesse ramo deve ser bloqueada pelo
chamador. Caso contrário, apenas uma nova ramificação pode ser criada. Esta restrição não é aplicada
para o dono do arquivo se o bloqueio não estrito for usado (veja RCS(1)). Uma fechadura realizada por
outra pessoa pode ser quebrada com o RCS comando.

A menos que o -f opção é dada, ci verifica se a revisão a ser depositada difere de
o anterior. Caso contrário, em vez de criar uma nova revisão ci reverte para o anterior
XNUMX. Para reverter, normal ci remove o arquivo de trabalho e qualquer bloqueio; ci -l mantém e ci -u
remove qualquer bloqueio e, em seguida, ambos geram um novo arquivo de trabalho como se co -l or co -u
foi aplicada à revisão anterior. Ao reverter, qualquer -n e -s opções se aplicam
à revisão anterior.

Para cada revisão depositada, ci solicita uma mensagem de log. A mensagem de log deve
resumir a mudança e deve ser encerrado no final do arquivo ou por uma linha contendo . by
em si. Se vários arquivos forem registrados ci pergunta se deve reutilizar o registro anterior
mensagem. Se a entrada padrão não for um terminal, ci suprime o prompt e usa o
mesma mensagem de log para todos os arquivos. Veja também -m.

Se o arquivo RCS não existir, ci cria e deposita o conteúdo do trabalho
arquivo como a revisão inicial (número padrão: 1.1) A lista de acesso é inicializada para
vazio. Em vez da mensagem de log, ci solicita um texto descritivo (ver -t abaixo).

O número rev da revisão depositada pode ser dada por qualquer uma das opções -f, -i, -I,
-j, -k, -l, -M, -q, -rou -u. rev pode ser simbólico, numérico ou misto. Nomes simbólicos em
rev já deve estar definido; Veja o -n e -N opções para atribuir nomes durante o check-in.
If rev is $, ci determina o número de revisão dos valores de palavra-chave no arquivo de trabalho.

If rev começa com um ponto, então o ramal padrão (normalmente o tronco) é adicionado ao
isto. Se rev é um número de filial seguido por um ponto, então a última revisão desse
ramo é usado.

If rev é um número de revisão, deve ser maior do que o último no ramo para o qual
rev pertence ou deve iniciar um novo ramo.

If rev é um ramo em vez de um número de revisão, a nova revisão é anexada a esse
filial. O número do nível é obtido incrementando o número de revisão da ponta daquele
filial. Se rev indica um ramo não existente, esse ramo é criado com o
revisão numerada rev.1.

If rev é omitido, ci tenta derivar o novo número de revisão do último bloqueio do chamador.
Se o chamador bloqueou a revisão de ponta de um branch, a nova revisão é anexada a
esse ramo. O novo número de revisão é obtido incrementando o número de revisão da ponta.
Se o chamador bloqueou uma revisão não tipificada, um novo branch é iniciado nessa revisão por
incrementando o número de filial mais alto naquela revisão. O branch inicial padrão e
os números dos níveis são 1.

If rev é omitido e o chamador não tem bloqueio, mas possui o arquivo e o bloqueio não está definido para
rigoroso, então a revisão é anexada ao ramo padrão (normalmente o tronco; consulte o
-b opção de RCS(1)).

Exceção: no tronco, as revisões podem ser anexadas ao final, mas não inseridas.

OPÇÕES

-rrev Fazer check-in da revisão rev.

-r O nu -r opção (sem qualquer revisão) tem um significado incomum em ci. Com outro
Comandos RCS, um simples -r opção especifica a revisão mais recente do padrão
ramo, mas com ci, um nu -r opção restabelece o comportamento padrão de
liberar um bloqueio e remover o arquivo de trabalho, e é usado para substituir qualquer padrão
-l or -u opções estabelecidas por aliases de shell ou scripts.

-l[rev]
funciona como -r, exceto que executa um adicional co -l para a revisão depositada.
Assim, a revisão depositada é imediatamente registrada novamente e bloqueada. Isto é
útil para salvar uma revisão, embora se queira continuar a editá-la após o
check-in.

-u[rev]
funciona como -l, exceto que a revisão depositada não está bloqueada. Isso permite
leia o arquivo de trabalho imediatamente após o check-in.

A -l, nu -r e -u as opções são mutuamente exclusivas e substituem silenciosamente cada
de outros. Por exemplo, ci -u -r é equivalente a ci -r porque nu -r Substitui -u.

-f[rev]
força um depósito; a nova revisão é depositada mesmo que não seja diferente da
anterior.

-k[rev]
pesquisa o arquivo de trabalho em busca de valores de palavra-chave para determinar seu número de revisão,
data de criação, estado e autor (ver co(1)), e atribui esses valores ao
revisão depositada, em vez de computá-los localmente. Também gera um
mensagem de login padrão informando o login do chamador e a data de check-in real.
Esta opção é útil para distribuição de software. Uma revisão que é enviada para
vários sites devem ser verificados com o -k opção nesses sites para preservar
o número original, data, autor e estado. Os valores de palavra-chave extraídos e o
a mensagem de registro padrão pode ser substituída com as opções -d, -m, -s, -w, e qualquer
opção que carrega um número de revisão.

-q[rev]
modo silencioso; a saída de diagnóstico não é impressa. Uma revisão que não é diferente
do anterior não é depositado, a menos que -f é dada.

-i[rev]
check-in inicial; relatar um erro se o arquivo RCS já existir. Isso evita corrida
condições em certas aplicações.

-j[rev]
apenas faça check-in e não inicialize; relatar um erro se o arquivo RCS não
já existe.

-I[rev]
modo interativo; o usuário é solicitado e questionado, mesmo se a entrada padrão for
não é um terminal.

-d[dados]
usos dados para a data e hora de check-in. o dados é especificado em formato livre como
explicado em co(1). Isso é útil para mentir sobre a data de check-in e para -k if
nenhuma data está disponível. Se dados está vazio, o tempo do último arquivo de trabalho
modificação é usada.

-M[rev]
Defina a hora de modificação em qualquer novo arquivo de trabalho para ser a data do recuperado
revisão. Por exemplo, ci -d -M -u f não altera fhora de modificação, mesmo que
fO conteúdo de muda devido à substituição de palavras-chave. Use esta opção com cuidado; pode
confundir fazer(1).

-m[msg]
usa a corda msg como a mensagem de registro para todas as revisões registradas. Se msg is
omitido, o padrão é "*** mensagem de log vazia ***". Por convenção, mensagens de log
que começa com # são comentários e são ignorados por programas como o GNU Emacs vc
pacote. Além disso, mensagens de log que começam com {nome de clump} (seguido por espaço em branco)
devem ser agrupados, se possível, mesmo se estiverem associados a
arquivos diferentes; a {nome de clump} rótulo é usado apenas para aglutinar, e não é
considerada parte da própria mensagem de log.

-nnome atribui o nome simbólico nome para o número da revisão registrada. ci impressões
uma mensagem de erro se nome já está atribuído a outro número.

-Nnome mesma -n, exceto que substitui uma atribuição anterior de nome.

-sestado
define o estado da revisão com check-in para o identificador estado. O padrão
estado é Exp.

-tlima escreve um texto descritivo a partir do conteúdo do nomeado lima no arquivo RCS,
deletando o texto existente. o lima não pode começar com -.

-t-corda
Escreva um texto descritivo do corda no arquivo RCS, excluindo o existente
texto.

A -t opção, em ambas as formas, tem efeito apenas durante um check-in inicial; isto é
silenciosamente ignorado de outra forma.

Durante o check-in inicial, se -t não é dado, ci obtém o texto do padrão
entrada, terminado por fim de arquivo ou por uma linha contendo . por si próprio. O usuário é
solicitado o texto se a interação for possível; Vejo -I.

Para compatibilidade com versões anteriores do RCS, um -t opção é ignorada.

-T Defina a hora de modificação do arquivo RCS para a hora da nova revisão se o anterior
precede a última e há uma nova revisão; preservar o arquivo RCS
hora de modificação caso contrário. Se você bloqueou uma revisão, ci normalmente atualiza o
Da hora de modificação do arquivo RCS para a hora atual, porque o bloqueio é armazenado no
O arquivo RCS e a remoção do bloqueio requerem a alteração do arquivo RCS. Isso pode criar um
Arquivo RCS mais novo do que o arquivo de trabalho de uma das duas maneiras: primeiro, ci -M pode criar um
arquivo de trabalho com data anterior à hora atual; segundo, ao reverter para o
revisão anterior, o arquivo RCS pode ser alterado enquanto o arquivo de trabalho permanece inalterado.
Esses dois casos podem causar recompilação excessiva causada por um fazer(1) dependência de
o arquivo de trabalho no arquivo RCS. o -T opção inibe esta recompilação por
mentindo sobre a data do arquivo RCS. Use esta opção com cuidado; pode suprimir
recompilação, mesmo quando um check-in de um arquivo de trabalho deve afetar outro trabalho
arquivo associado ao mesmo arquivo RCS. Por exemplo, suponha que a hora do arquivo RCS
é 01:00, o tempo do arquivo de trabalho (alterado) é 02:00, alguma outra cópia do
o arquivo de trabalho tem um horário de 03:00 e o horário atual é 04:00. Então ci -d -T
define a hora do arquivo RCS para 02:00 em vez das 04:00 usuais; isso causa fazer(1)
pensar (incorretamente) que a outra cópia é mais recente que o arquivo RCS.

-wentrar
usos entrar para o campo do autor da revisão depositada. Útil para mentir sobre
o autor, e para -k se nenhum autor estiver disponível.

-V Imprime o número da versão do RCS.

-Vn Emular versão RCS n. Ver co(1) para obter detalhes.

-xsufixos
especifica os sufixos para arquivos RCS. Um sufixo não vazio corresponde a qualquer nome de arquivo
terminando com o sufixo. Um sufixo vazio corresponde a qualquer nome de arquivo do formulário RCS /frag
or fragmento1/ RCS /fragmento2. A -x opção pode especificar uma lista de sufixos separados por /.
Por exemplo, -x, v / especifica dois sufixos: ,v e o sufixo vazio. Se dois ou mais
os sufixos são especificados, eles são testados em ordem ao procurar um arquivo RCS; a
o primeiro que funciona é usado para esse arquivo. Se nenhum arquivo RCS for encontrado, mas um RCS
arquivo pode ser criado, os sufixos são testados a fim de determinar o novo RCS
nome do arquivo. O padrão para sufixos depende da instalação; normalmente é
, v / para hosts como o Unix que permitem vírgulas em nomes de arquivos e está vazio (ou seja, apenas
o sufixo vazio) para outros hosts.

-zzona especifica o formato de saída de data na substituição de palavra-chave e especifica o padrão
fuso horário para dados no -ddados opção. O zona deve estar vazio, um UTC numérico
deslocamento, ou a string especial LT para a hora local. O padrão é um vazio zona,
que usa o formato RCS tradicional de UTC sem qualquer indicação de fuso horário e
com barras separando as partes da data; caso contrário, os tempos são impressos em ISO
Formato 8601 com indicação de fuso horário. Por exemplo, se a hora local for 11 de janeiro,
1990, 8h do horário padrão do Pacífico, oito horas a oeste do UTC, a hora é impressa
como se segue:

opção tempo saída
-z 1990/01/12 04:00:00 (Padrão)
-zLT 1990-01-11 20: 00: 00-08
-z + 05: 30 1990-01-12 09:30:00+05:30

A -z A opção não afeta as datas armazenadas em arquivos RCS, que são sempre UTC.

ARQUIVO NOMEAÇÃO

Pares de arquivos RCS e arquivos de trabalho podem ser especificados de três maneiras (veja também o exemplo
seção).

1) O arquivo RCS e o arquivo de trabalho são fornecidos. O nome do arquivo RCS tem o formato
fragmento1/arquivo de trabalho X e o nome do arquivo de trabalho está no formato fragmento2/arquivo de trabalho onde fragmento1/ e
fragmento2/ são nomes de arquivos (possivelmente diferentes ou vazios), arquivo de trabalho é um nome de arquivo, e X é um
Sufixo RCS. Se X está vazia, fragmento1/ deve começar com RCS / ou deve conter / RCS /.

2) Apenas o arquivo RCS é fornecido. Em seguida, o arquivo de trabalho é criado no diretório atual
e seu nome é derivado do nome do arquivo RCS removendo fragmento1/ e o sufixo X.

3) Apenas o arquivo de trabalho é fornecido. Então ci considera cada sufixo RCS X por sua vez, olhando
para um arquivo RCS do formulário fragmento2/ RCS /arquivo de trabalho X ou (se o primeiro não for encontrado e X is
não vazio) fragmento2/arquivo de trabalhoX.

Se o arquivo RCS for especificado sem um nome de arquivo em 1) e 2), ci procura o arquivo RCS
primeiro no diretório ./RCS e então no diretório atual.

ci relata um erro se uma tentativa de abrir um arquivo RCS falhar por um motivo incomum, mesmo que
o nome do arquivo RCS é apenas uma das várias possibilidades. Por exemplo, para suprimir o uso de
Comandos RCS em um diretório d, crie um arquivo normal chamado d/ RCS de modo que tentativas casuais
usar comandos RCS em d falhar porque d/ RCS não é um diretório.

EXEMPLOS

Suponha ,v é um sufixo RCS e o diretório atual contém um subdiretório RCS com um
Arquivo RCS io.c, v. Em seguida, cada um dos seguintes comandos verifica uma cópia do io.c para dentro
RCS / io.c, v como a última revisão, removendo io.c.

ci io.c; ci RCS / io.c, v; ci io.c, v;
ci io.c RCS / io.c, v; ci io.c io.c, v;
ci RCS / io.c, v io.c; ci io.c, v io.c;

Suponha, em vez disso, que o sufixo vazio seja um sufixo RCS e o diretório atual contenha
um subdiretório RCS com um arquivo RCS io.c. Cada um dos seguintes comandos verifica em um
nova revisão.

ci io.c; ci RCS / io.c;
ci io.c RCS / io.c;
ci RCS / io.c io.c;

ARQUIVO MODOS

Um arquivo RCS criado por ci herda as permissões de leitura e execução do arquivo de trabalho.
Se o arquivo RCS já existe, ci preserva suas permissões de leitura e execução. ci sempre
desativa todas as permissões de gravação de arquivos RCS.

Use ci online usando serviços onworks.net