co - Online nel cloud

PROGRAMMA:

NOME

co - controlla le revisioni RCS

SINOSSI

co [Opzioni] filetto ...

DESCRIZIONE

co recupera una revisione da ogni file RCS e la memorizza nella lavorazione corrispondente
file.

I nomi di file che corrispondono a un suffisso RCS denotano file RCS; tutti gli altri indicano file di lavoro. nomi
sono accoppiati come spiegato in ci(1).

Le revisioni di un file RCS possono essere ritirate bloccate o sbloccate. Blocco di una revisione
impedisce la sovrapposizione degli aggiornamenti. Una revisione estratta per la lettura o l'elaborazione (ad es.
compilazione) non deve essere bloccato. Una revisione ritirata per la modifica e il successivo check-in deve
normalmente essere bloccato. Il checkout con blocco non riesce se la revisione da estrarre è
attualmente bloccato da un altro utente. (Un lucchetto può essere rotto con RCS(1).) Acquista con
il blocco richiede anche che il chiamante sia nell'elenco di accesso del file RCS, a meno che non lo sia
il proprietario del file o il superutente o l'elenco di accesso è vuoto. Acquista senza
il blocco non è soggetto a restrizioni sulla lista di accesso e non è influenzato dalla presenza di
serrature.

Una revisione è selezionata dalle opzioni per revisione o numero di filiale, data/ora di check-in,
autore o stato. Quando le opzioni di selezione vengono applicate in combinazione, co recupera il
ultima revisione che li soddisfa tutti. Se nessuna delle opzioni di selezione è
specificato, co recupera l'ultima revisione sul ramo predefinito (normalmente il tronco, vedi
, il -b possibilità di RCS(1)). È possibile allegare una revisione o un numero di filiale a uno qualsiasi dei
Opzioni -f, -I, -l, -M, -p, -q, -r, o -u. Le opzioni -d (Data), -s (stato), e -w
(autore) recuperare da un singolo ramo, il selezionato branch, che è specificato da
uno di -f, ..., -uo il ramo predefinito.

A co Il comando applicato a un file RCS senza revisioni crea un file di lavoro di lunghezza zero.
co esegue sempre la sostituzione delle parole chiave (vedi sotto).

VERSIONI

-r[rev]
recupera l'ultima revisione il cui numero è minore o uguale a rev. Se rev
indica un ramo piuttosto che una revisione, l'ultima revisione su quel ramo è
recuperato. Se rev è omesso, l'ultima revisione sul ramo predefinito (vedi il
-b possibilità di RCS(1)) viene recuperato. Se rev is $, co determina il numero di revisione
dai valori delle parole chiave nel file di lavoro. Altrimenti, una revisione è composta da uno
o più campi numerici o simbolici separati da punti. Se rev inizia con a
punto, quindi il ramo predefinito (normalmente il tronco) viene anteposto ad esso. Se rev is
un numero di filiale seguito da un punto, quindi l'ultima revisione su quel ramo è
Usato. L'equivalente numerico di un campo simbolico è specificato con il -n opzione
dei comandi ci(1) e RCS(1).

-l[rev]
stesso -r, tranne per il fatto che blocca anche la revisione recuperata per il chiamante.

-u[rev]
stesso -r, tranne per il fatto che sblocca la revisione recuperata se è stata bloccata dal
chiamante. Se rev è omesso, -u recupera la revisione bloccata dal chiamante, se
c'è uno; in caso contrario, recupera l'ultima revisione sul ramo predefinito.

-f[rev]
forza la sovrascrittura del file di lavoro; utile in relazione a -q. Vedi anche
MODALITÀ FILE di seguito.

-kv Genera stringhe di parole chiave utilizzando il modulo predefinito, ad es $Revisione: 5.9.4 $ per l'
Revisione parola chiave. Il nome di un armadietto viene inserito nel valore del testata, Ide
armadietto stringhe di parole chiave solo mentre un file viene bloccato, ad esempio da ci -l ed co -l.
Questo è l'impostazione predefinita.

-kvl Come -kv, tranne che il nome di un armadietto viene sempre inserito se la revisione data è
attualmente bloccato.

-kk Genera solo nomi di parole chiave nelle stringhe di parole chiave; tralasciare i loro valori. Vedi PAROLA CHIAVE
SOSTITUZIONE sotto. Ad esempio, per Revisione parola chiave, genera la stringa
$ Revision $ invece di $Revisione: 5.9.4 $. Questa opzione è utile da ignorare
differenze dovute alla sostituzione delle parole chiave quando si confrontano diverse revisioni di a
file. I messaggi di registro vengono inseriti dopo $Registro$ parole chiave anche se -kk è specificato,
poiché questo tende ad essere più utile quando si uniscono le modifiche.

-ko Genera la vecchia stringa di parole chiave, presente nel file di lavoro appena prima che fosse
effettuato il check-in. Ad esempio, per il Revisione parola chiave, genera la stringa $Revisione:
1.1 $ invece di $Revisione: 5.9.4 $ se è così che è apparsa la stringa quando il
il file è stato archiviato. Questo può essere utile per i formati di file che non possono tollerarne nessuno
modifiche alle sottostringhe che assumono la forma di stringhe di parole chiave.

-kb Genera un'immagine binaria della vecchia stringa di parole chiave. Questo agisce come -ko, tranne esso
esegue tutto l'input e l'output del file di lavoro in modalità binaria. Questo fa poco
differenza su host Posix e Unix, ma su host simili a DOS si dovrebbe usare RCS -i -kb
per inizializzare un file RCS destinato ad essere utilizzato per file binari. Inoltre, su tutti
padroni di casa, rcmerge(1) normalmente si rifiuta di unire i file quando -kb è in vigore.

-kv Genera solo valori di parole chiave per le stringhe di parole chiave. Ad esempio, per Revisione
parola chiave, genera la stringa 5.9.4 invece di $Revisione: 5.9.4 $. Questo può aiutare
generare file in linguaggi di programmazione in cui è difficile eliminare le parole chiave
delimitatori come $Revisione: $ da una stringa. Tuttavia, ulteriore sostituzione delle parole chiave
non può essere eseguita una volta rimossi i nomi delle parole chiave, quindi questa opzione dovrebbe essere
usato con cura. A causa del pericolo di perdere le parole chiave, questa opzione non può essere
combinato con -le l'autorizzazione di scrittura del proprietario del file di lavoro è disattivata;
per modificare il file in un secondo momento, controlla di nuovo senza -kv.

-p[rev]
stampa la revisione recuperata sullo standard output invece di memorizzarla nel
file di lavoro. Questa opzione è utile quando co fa parte di un tubo.

-q[rev]
modalità silenziosa; la diagnostica non viene stampata.

-I[rev]
modalità interattiva; l'utente viene sollecitato e interrogato anche se lo standard input è
non un terminale.

-dquando recupera l'ultima revisione sul ramo selezionato la cui data/ora di check-in è
minore o uguale a quando. La data e l'ora possono essere fornite in formato libero. Il
fuso orario LT indica l'ora locale; altri nomi comuni di fusi orari sono compresi.
Ad esempio, il seguente quandos sono equivalenti se l'ora locale è l'11 gennaio 1990,
8:XNUMX Pacific Standard Time, otto ore a ovest del Coordinated Universal Time (UTC):

8:00 pm lt
4:00 SONO, Gennaio 12 1990 l'impostazione predefinita è UTC
1990-01-12 04:00:00+00 ISO 8601 (UTC)
1990-01-11 20: 00: 00-08 ISO 8601 (ora locale)
1990/01/12 04:00:00 formato RCS tradizionale
Gio. Gen 11 20:00:00 1990 LT uscita di ctempo(3)+ LT
Gio. Gen 11 20:00:00 PST 1990 uscita di quando(1)
Ven. Gen 12 04:00:00 GMT 1990
Gio 11 Gen 1990 20:00:00 all'0800 ottobre Internet RFC 822
12 gennaio 1990, 04:00 BAGNATO

La maggior parte dei campi della data e dell'ora possono essere predefiniti. Il fuso orario predefinito è
normalmente UTC, ma questo può essere sovrascritto dal -z opzione. Le altre impostazioni predefinite sono
determinato nell'ordine anno, mese, giorno, ora, minuto e secondo (dal più al meno
significativo). È necessario fornire almeno uno di questi campi. Per i campi omessi
che sono di maggiore importanza rispetto al campo fornito più alto, il fuso orario
si assumono i valori attuali. Per tutti gli altri campi omessi, il più basso possibile
si assumono valori. Ad esempio, senza -z, l'appuntamento 20 10:30 il valore predefinito è
10:30:00 UTC del 20 del mese e dell'anno correnti del fuso orario UTC. Il
la data/ora deve essere citata se contiene spazi.

-M[rev]
Imposta l'ora di modifica sul nuovo file di lavoro come data di recupero
revisione. Usa questa opzione con cautela; può confondere make(1).

-sstato
recupera l'ultima revisione sul ramo selezionato il cui stato è impostato su stato.

-S permettere stesso modalità. In questa modalità, il proprietario di un lucchetto non è importante, solo che
esiste. In effetti, questo significa che l'utente non può controllare la stessa revisione
due volte.

-T Conserva il tempo di modifica sul file RCS anche se il file RCS cambia perché
viene aggiunto o rimosso un blocco. Questa opzione può sopprimere la ricompilazione estesa
causato da a make(1) dipendenza di qualche altra copia del file di lavoro su RCS
file. Usa questa opzione con cautela; può sopprimere la ricompilazione anche quando lo è
necessario, ovvero quando la modifica del blocco significherebbe una modifica alle stringhe di parole chiave nel
altro file di lavoro.

-w[accesso]
recupera l'ultima revisione sul ramo selezionato che è stato archiviato dal
utente con nome di accesso accesso. Se l'argomento accesso viene omesso, il login del chiamante
è assunto.

-jlista di partecipazione
genera una nuova revisione che è l'unione delle revisioni su lista di partecipazione. Questo
opzione è in gran parte obsoleta da rcmerge(1) ma viene trattenuto per all'indietro
la compatibilità.

I lista di partecipazione è un elenco separato da virgole di coppie della forma rev2:rev3, where rev2
ed rev3 sono numeri di revisione (simbolici o numerici). Per l'iniziale tale coppia,
rev1 denota la revisione selezionata dalle opzioni di cui sopra -f, ..., -w. Per tutti gli altri
coppie, rev1 denota la revisione generata dalla coppia precedente. (Così, l'uscita
di un join diventa l'input per il successivo.)

Per ogni coppia, co si unisce alle revisioni rev1 ed rev3 rispetto a rev2. Questo significa
che tutti i cambiamenti che trasformano rev2 ai miglioramenti rev1 sono applicati a una copia di rev3. Questo
è particolarmente utile se rev1 ed rev3 sono le estremità di due rami che hanno rev2
come un antenato comune. Se rev1<rev2<rev3 sullo stesso ramo, l'unione genera a
nuova revisione che è come rev3, ma con tutti i cambiamenti che portano da rev1 a rev2
annullato. Se cambia da rev2 a rev1 sovrapposizione con modifiche da rev2 a rev3, co
i rapporti si sovrappongono come descritto in unire(1).

Per la coppia iniziale, rev2 può essere omesso. L'impostazione predefinita è l'antenato comune. Se
uno qualsiasi degli argomenti indica rami, le ultime revisioni su quei rami sono
presunto. Le opzioni -l ed -u bloccare o sbloccare rev1.

-V Stampa il numero di versione di RCS.

-Vn Emula versione RCS n, where n può essere 3, 4, o 5. Questo può essere utile quando
scambiare file RCS con altri che eseguono versioni precedenti di RCS. Vedere
quale versione di RCS è in esecuzione sui tuoi corrispondenti, chiedi loro di invocare RCS -V; Questo
funziona con le versioni più recenti di RCS. Se non funziona, fallo invocare log su una
file RCS; se nessuna delle prime righe di output contiene la stringa ramo: è
versione 3; se gli anni delle date hanno solo due cifre, è la versione 4; altrimenti, è
è la versione 5. Un file RCS generato durante l'emulazione della versione 3 perde il suo valore predefinito
ramo. Una revisione RCS generata durante l'emulazione della versione 4 o precedente ha un tempo
francobollo scaduto fino a 13 ore. Una revisione estratta durante l'emulazione della versione
4 o precedente contiene date abbreviate del modulo yy/mm/dd e può anche contenere
diversi spazi bianchi e prefissi di riga nella sostituzione di $Registro$.

-xsuffissi
Usa il suffissi per caratterizzare i file RCS. Vedere ci(1) per i dettagli.

-zzona specifica il formato di output della data nella sostituzione delle parole chiave e specifica il valore predefinito
fuso orario per quando nel -dquando opzione. Il zona dovrebbe essere vuoto, un UTC numerico
offset, o la stringa speciale LT per l'ora locale. Il valore predefinito è vuoto zona,
che utilizza il tradizionale formato RCS di UTC senza alcuna indicazione di fuso orario e
con barre che separano le parti della data; in caso contrario, i tempi vengono emessi in ISO
Formato 8601 con indicazione del fuso orario. Ad esempio, se l'ora locale è l'11 gennaio
1990, 8:XNUMX Pacific Standard Time, otto ore a ovest di UTC, quindi l'ora viene emessa
come segue:

opzione tempo produzione
-z 1990/01/12 04:00:00 (Default)
-zLT 1990-01-11 20: 00: 00-08
-z+05:30 1990-01-12 09:30:00+05:30

I -z L'opzione non ha effetto sulle date memorizzate nei file RCS, che sono sempre UTC.

PAROLA CHIAVE SOSTITUZIONE

Stringhe della forma $parola chiave$ ed $parola chiave:...$ incorporati nel testo vengono sostituiti con
stringhe della forma $parola chiave:APPREZZIAMO$ where parola chiave ed APPREZZIAMO sono le coppie elencate di seguito.
Le parole chiave possono essere incorporate in stringhe letterali o commenti per identificare una revisione.

Inizialmente, l'utente immette stringhe della forma $parola chiave$. Al momento del pagamento, co sostituisce questi
stringhe con stringhe della forma $parola chiave:APPREZZIAMO$. Se una revisione contenente stringhe di
quest'ultimo modulo viene ricontrollato, i campi dei valori verranno sostituiti durante il prossimo
guardare. Pertanto, i valori delle parole chiave vengono aggiornati automaticamente al momento del pagamento. Questo automatico
la sostituzione può essere modificata dal -k opzioni.

Parole chiave e loro valori corrispondenti:

$Autore$
Il nome di accesso dell'utente che ha effettuato il check-in nella revisione.

$Data$ La data e l'ora in cui la revisione è stata archiviata. Con -zzona un fuso orario numerico
viene aggiunto offset; in caso contrario, la data è UTC.

$Intestazione$
Un'intestazione standard contenente il nome completo del file RCS, il numero di revisione, la data
e ora, l'autore, lo stato e l'armadietto (se bloccato). Insieme a -zzona un numerico
l'offset del fuso orario viene aggiunto alla data; in caso contrario, la data è UTC.

$ Id $ Uguale a $Intestazione$, tranne che il nome del file RCS è senza la directory
componenti.

$armadietto$
Il nome di accesso dell'utente che ha bloccato la revisione (vuoto se non bloccato).

$Registro$ Il messaggio di log fornito durante il check-in, preceduto da un'intestazione contenente l'RCS
nome del file, il numero di revisione, l'autore e la data e l'ora. Insieme a -zzona a
viene aggiunto l'offset numerico del fuso orario; in caso contrario, la data è UTC. Registro esistente
i messaggi sono non sostituito. Il nuovo messaggio di log viene invece inserito dopo
$Registro:...$. Ciò è utile per accumulare un registro completo delle modifiche in un file di origine.

Ogni riga inserita è preceduta dalla stringa che precede il $Registro$ linea. Per
esempio, se il $Registro$ la linea è "// $Registro: abbronzatura.cc $”, RCS antepone ogni riga del
accedere con "// ”. Questo è utile per le lingue con commenti che vanno alla fine di
la linea. La convenzione per altre lingue è di usare un " * ” prefisso all'interno di a
commento multilinea. Ad esempio, il commento di log iniziale di un programma C
convenzionalmente è della forma seguente:

/∗
* $Registro$
∗/

Per la retrocompatibilità con le versioni precedenti di RCS, se il prefisso del registro è /∗ or
(∗ circondato da uno spazio bianco facoltativo, le righe di registro inserite contengono invece uno spazio
of / or (; tuttavia, questo utilizzo è obsoleto e non dovrebbe essere invocato.

$Nome$ Il nome simbolico utilizzato per verificare la revisione, se presente. Per esempio, co -r Joe
genera $Nome: Joe $. Semplice co genera solo $Nome: $.

$fileRCS$
Il nome del file RCS senza i componenti della directory.

$ Revision $
Il numero di revisione assegnato alla revisione.

$Fonte$
Il nome completo del file RCS.

$Stato$
Lo stato assegnato alla revisione con il -s possibilità di RCS(1) o ci(1).

I seguenti caratteri nei valori delle parole chiave sono rappresentati da sequenze di escape da mantenere
stringhe di parole chiave ben formate.

serbatoio fuga sequenza
linguetta \t
nuova linea \n
spazio \dieci
$ \dieci
\ \\

RISORSE MODALITA '

Il file di lavoro eredita i permessi di lettura ed esecuzione dal file RCS. In
Inoltre, il permesso di scrittura del proprietario è attivato, a meno che -kv è impostato o il file è
estratto sbloccato e il blocco è impostato su rigoroso (vedi RCS(1)).

Se esiste già un file con il nome del file di lavoro e dispone dei permessi di scrittura, co
interrompe il checkout, chiedendo in anticipo se possibile. Se il file di lavoro esistente non lo è
scrivibile o -f è dato, il file di lavoro viene cancellato senza chiedere.

Usa co online utilizzando i servizi onworks.net