co - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

co - schau dir die RCS-Revisionen an

ZUSAMMENFASSUNG

co [Optionen] Datei ...

BESCHREIBUNG

co ruft eine Revision aus jeder RCS-Datei ab und speichert sie in der entsprechenden Arbeitsdatei
Datei.

Dateinamen, die einem RCS-Suffix entsprechen, bezeichnen RCS-Dateien; alle anderen bezeichnen Arbeitsdateien. Namen
sind wie in erklärt gepaart ci(1).

Revisionen einer RCS-Datei können gesperrt oder entsperrt ausgecheckt werden. Eine Revision sperren
verhindert überlappende Updates. Eine zum Lesen oder Verarbeiten ausgecheckte Revision (z. B.
Kompilieren) müssen nicht gesperrt werden. Eine Revision muss zum Bearbeiten ausgecheckt und später eingecheckt werden
normalerweise gesperrt sein. Auschecken mit Sperren schlägt fehl, wenn die auszucheckende Revision . ist
derzeit von einem anderen Benutzer gesperrt. (Ein Schloss kann mit gebrochen werden rcs(1).) Zur Kasse mit
Das Sperren erfordert auch, dass sich der Anrufer in der Zugriffsliste der RCS-Datei befindet, es sei denn, er ist
der Eigentümer der Datei oder der Superuser, oder die Zugriffsliste ist leer. Kasse ohne
Das Sperren unterliegt keinen Beschränkungen der Zugriffsliste und wird nicht durch das Vorhandensein von
Schlösser.

Eine Revision wird durch Optionen für Revisions- oder Zweigstellennummer, Eincheckdatum/-uhrzeit,
Autor oder Staat. Wenn die Auswahloptionen in Kombination angewendet werden, co holt die
neueste Revision, die alle von ihnen erfüllt. Wenn keine der Auswahlmöglichkeiten ist
spezifizierten, co ruft die neueste Revision des Standardzweigs ab (normalerweise der Trunk, siehe
-b Option rcs(1)). Jedem der . kann eine Revisions- oder Zweignummer hinzugefügt werden
Optionen -f, -I, -l, -M, -p, -q, -r, oder -u. Die Optionen -d (Datum), -s (Staat), und -w
(Autor) aus einem einzelnen Zweig abrufen, der ausgewählt Zweig, der entweder angegeben wird durch
eine -f... -u, oder die Standardverzweigung.

A co Der auf eine RCS-Datei ohne Revisionen angewendete Befehl erstellt eine Arbeitsdatei der Länge Null.
co führt immer eine Schlüsselwortersetzung durch (siehe unten).

OPTIONAL

-r[Umdrehung]
ruft die neueste Revision ab, deren Nummer kleiner oder gleich ist Umdrehung. Wenn Umdrehung
zeigt eher eine Verzweigung als eine Revision an, die neueste Revision dieser Verzweigung ist
abgerufen. Wenn Umdrehung weggelassen wird, die neueste Revision des Standardzweigs (siehe die
-b Option rcs(1)) abgerufen wird. Wenn Umdrehung is $, co bestimmt die Revisionsnummer
aus Schlüsselwortwerten in der Arbeitsdatei. Andernfalls besteht eine Revision aus einem
oder mehrere numerische oder symbolische Felder, die durch Punkte getrennt sind. Wenn Umdrehung beginnt mit a
Zeitraum, dann wird ihm der Standardzweig (normalerweise der Trunk) vorangestellt. Wenn Umdrehung is
eine Zweigstellennummer gefolgt von einem Punkt, dann ist die letzte Revision dieser Zweigstelle
Gebraucht. Das numerische Äquivalent eines symbolischen Feldes wird mit dem . angegeben -n zu erhalten
der Befehle ci(1) und rcs(1).

-l[Umdrehung]
wie -r, außer dass es auch die abgerufene Revision für den Aufrufer sperrt.

-u[Umdrehung]
wie -r, außer dass die abgerufene Revision entsperrt wird, wenn sie vom
Anrufer. Wenn Umdrehung wurde weggelassen, -u ruft die vom Aufrufer gesperrte Revision ab, wenn
da ist einer; andernfalls ruft es die neueste Revision im Standardzweig ab.

-f[Umdrehung]
erzwingt das Überschreiben der Arbeitsdatei; nützlich in Verbindung mit -q. Siehe auch
DATEIMODI unten.

-kkv Generieren Sie Keyword-Strings mit dem Standardformular, z. B. $Überarbeitung: 5.9.4 $ für die
Änderungsstand Stichwort. Der Name eines Schließfachs wird in den Wert des eingefügt Kopfzeile, Id und
Locker Schlüsselwort-Strings nur, wenn eine Datei gesperrt wird, dh durch ci -l und co -l.
Dies ist der Standardwert.

-kkvl Like -kkv, außer dass der Name eines Schließfachs immer eingefügt wird, wenn die angegebene Revision . ist
derzeit gesperrt.

-kk Generieren Sie nur Schlüsselwortnamen in Schlüsselwort-Strings; ihre Werte weglassen. Siehe SCHLÜSSELWORT
ERSATZ unten. Zum Beispiel für die Änderungsstand Schlüsselwort, generieren Sie die Zeichenfolge
$ Revision $ statt $Überarbeitung: 5.9.4 $. Diese Option ist sinnvoll zu ignorieren
Unterschiede aufgrund der Keyword-Ersetzung beim Vergleich verschiedener Versionen von a
Datei. Protokollnachrichten werden eingefügt nach $Protokoll$ Stichworte, auch wenn -kk angegeben,
da dies beim Zusammenführen von Änderungen in der Regel nützlicher ist.

-ko Generieren Sie die alte Schlüsselwortzeichenfolge, die in der Arbeitsdatei kurz bevor sie vorhanden war
eingecheckt. Zum Beispiel für die Änderungsstand Schlüsselwort, generieren Sie die Zeichenfolge $Überarbeitung:
1.1 $ statt $Überarbeitung: 5.9.4 $ wenn die Zeichenfolge so erschienen ist, als die
Datei eingecheckt wurde. Dies kann bei Dateiformaten nützlich sein, die keine vertragen
Änderungen an Teilzeichenfolgen, die zufällig die Form von Schlüsselwortzeichenfolgen annehmen.

-kb Generieren Sie ein binäres Bild der alten Schlüsselwortzeichenfolge. Das wirkt wie -ko, außer es
führt alle Ein- und Ausgaben von Arbeitsdateien im Binärmodus durch. Das macht wenig
Unterschied auf Posix- und Unix-Hosts, aber auf DOS-ähnlichen Hosts sollte man verwenden rcs -i -kb
um eine RCS-Datei zu initialisieren, die für Binärdateien verwendet werden soll. Auch auf alle
Gastgeber, zusammenführen(1) weigert sich normalerweise, Dateien zusammenzuführen, wenn -kb ist in Kraft.

-kv Generieren Sie nur Schlüsselwortwerte für Schlüsselwortzeichenfolgen. Zum Beispiel für die Änderungsstand
Schlüsselwort, generieren Sie die Zeichenfolge 5.9.4 statt $Überarbeitung: 5.9.4 $. Das kann helfen
Generieren Sie Dateien in Programmiersprachen, in denen es schwierig ist, Schlüsselwörter zu entfernen
Trennzeichen wie $Überarbeitung: $ aus einer Schnur. Jedoch weitere Keyword-Ersetzung
kann nicht ausgeführt werden, nachdem die Schlüsselwortnamen entfernt wurden, daher sollte diese Option aktiviert sein
mit Sorgfalt verwendet. Wegen der Gefahr, Keywords zu verlieren, kann diese Option nicht verwendet werden
kombiniert mit -l, und die Schreibberechtigung des Eigentümers für die Arbeitsdatei ist deaktiviert;
Um die Datei später zu bearbeiten, überprüfen Sie sie erneut ohne -kv.

-p[Umdrehung]
druckt die abgerufene Revision auf der Standardausgabe, anstatt sie im
Arbeitsdatei. Diese Option ist nützlich, wenn co ist Teil eines Rohres.

-q[Umdrehung]
Ruhemodus; Diagnosen werden nicht gedruckt.

-I[Umdrehung]
interaktiver Modus; der Benutzer wird aufgefordert und gefragt, auch wenn die Standardeingabe ist
kein Terminal.

-dDatum ruft die neueste Revision der ausgewählten Filiale ab, deren Check-in-Datum/-Uhrzeit ist
Gleich oder kleiner als Datum. Datum und Uhrzeit können im freien Format angegeben werden. Die
Zeitzone LT steht für Ortszeit; andere gebräuchliche Zeitzonennamen werden verstanden.
Zum Beispiel die folgenden Datums sind äquivalent, wenn die Ortszeit der 11. Januar 1990 ist,
8:XNUMX Uhr Pacific Standard Time, acht Stunden westlich der koordinierten Weltzeit (UTC):

8:00 pm lt
4:00 BIN, Januar 12, 1990 Standard ist UTC
1990-01-12 04:00:00+00 ISO 8601 (UTC)
1990-01-11 20: 00: 00-08 ISO 8601 (Ortszeit)
1990/01/12 04:00:00 traditionelles RCS-Format
Do Januar 11 20:00:00 1990 LT Ausgabe von ctime(3) + LT
Do Januar 11 20:00:00 PST 1990 Ausgabe von Datum(1)
Fr Januar 12 04:00:00 GMT 1990
Do, 11 Januar 1990 20:00:00 -0800 Internet-RFC 822
12. Januar 1990, 04:00 NASS

Die meisten Felder in Datum und Uhrzeit können als Standardwerte verwendet werden. Die Standardzeitzone ist
normalerweise UTC, dies kann jedoch durch die -z Möglichkeit. Die anderen Standardeinstellungen sind
bestimmt in der Reihenfolge Jahr, Monat, Tag, Stunde, Minute und Sekunde
wesentlich). Mindestens eines dieser Felder muss angegeben werden. Für ausgelassene Felder
die von höherer Bedeutung sind als das höchste angegebene Feld, die Zeitzonen
Es werden aktuelle Werte angenommen. Für alle anderen ausgelassenen Felder die kleinstmögliche
Werte angenommen. Zum Beispiel ohne -z, das Datum 20, 10:30 Standardmäßig ist
10:30:00 UTC des 20. des aktuellen Monats und Jahres der UTC-Zeitzone. Die
Datum/Uhrzeit müssen in Anführungszeichen gesetzt werden, wenn es Leerzeichen enthält.

-M[Umdrehung]
Stellen Sie die Änderungszeit der neuen Arbeitsdatei auf das Datum der abgerufenen Datei ein
Revision. Verwenden Sie diese Option mit Bedacht; es kann verwirren um(1).

-sZustand
ruft die neueste Revision des ausgewählten Zweigs ab, dessen Status auf gesetzt ist Zustand.

-S Ermöglichen selbiges Modus. In diesem Modus ist der Besitzer eines Schlosses unwichtig, nur das
Es existiert. Effektiv bedeutet dies, dass der Benutzer nicht dieselbe Revision auschecken kann
zweimal.

-T Behalten Sie die Änderungszeit der RCS-Datei bei, auch wenn sich die RCS-Datei ändert, weil
eine Sperre wird hinzugefügt oder entfernt. Diese Option kann eine umfangreiche Neukompilierung unterdrücken
verursacht durch a um(1) Abhängigkeit einer anderen Kopie der Arbeitsdatei vom RCS
Datei. Verwenden Sie diese Option mit Bedacht; es kann die Neukompilierung unterdrücken, selbst wenn es ist
erforderlich, dh wenn die Änderung der Sperre eine Änderung der Schlüsselwort-Strings im
andere Arbeitsdatei.

-w[login]
ruft die neueste Revision des ausgewählten Zweigs ab, die vom eingecheckt wurde
Benutzer mit Login-Name login. Wenn die Argumentation login entfällt, die Anmeldung des Anrufers
wird angenommen.

-jBeitrittsliste
erzeugt eine neue Revision, die die Verbindung der Revisionen auf . ist Beitrittsliste. Dies
Option ist weitgehend obsolet durch zusammenführen(1) wird aber für rückwärts beibehalten
Kompatibilität.

Das Beitrittsliste ist eine durch Kommas getrennte Liste von Paaren der Form rev2:rev3, woher rev2
und rev3 sind (symbolische oder numerische) Revisionsnummern. Für das erste solche Paar gilt:
rev1 bezeichnet die Revision, die durch die obigen Optionen ausgewählt wurde -f... -w. Für alle anderen
Paare, rev1 bezeichnet die vom vorherigen Paar generierte Revision. (Also die Ausgabe
eines Joins wird zur Eingabe des nächsten.)

Für jedes Paar, co schließt sich Revisionen an rev1 und rev3 in Bezug auf rev2. Das heisst
dass alle Veränderungen, die sich verwandeln rev2 in rev1 werden auf eine Kopie von angewendet rev3. Dies
ist besonders nützlich, wenn rev1 und rev3 sind die Enden von zwei Zweigen, die haben rev2
als gemeinsamer Vorfahre. Wenn rev1<rev2<rev3 im selben Zweig erzeugt das Verbinden a
neue Überarbeitung, die ist wie rev3, aber mit allen Veränderungen, die davon führen rev1 zu rev2
rückgängig gemacht. Wenn sich von ändert rev2 zu rev1 überschneiden sich mit Änderungen von rev2 zu rev3, co
Berichte überschneiden sich wie in beschrieben fusionieren(1).

Für das Anfangspaar gilt rev2 kann ausgelassen werden. Der Standardwert ist der gemeinsame Vorfahre. Wenn
Jedes der Argumente weist auf Branches hin, die neuesten Überarbeitungen dieser Branches sind
vermutet. Die Optionen -l und -u sperren oder entsperren rev1.

-V Drucken Sie die Versionsnummer von RCS.

-Vn Emulieren Sie die RCS-Version n, woher n kann sein 3, 4, oder 5. Dies kann nützlich sein, wenn
Austausch von RCS-Dateien mit anderen, die ältere Versionen von RCS ausführen. Sehen
welche Version von RCS Ihre Korrespondenten ausführen, lassen Sie sie aufrufen rcs -V; Dies
funktioniert mit neueren Versionen von RCS. Wenn es nicht funktioniert, lassen Sie sie aufrufen rlog auf ein
RCS-Datei; wenn keine der ersten Ausgabezeilen die Zeichenfolge enthält Ast: es ist
Version 3; wenn die Jahreszahlen der Datumsangaben nur zweistellig sind, handelt es sich um Version 4; ansonsten ist es
ist Version 5. Eine RCS-Datei, die beim Emulieren von Version 3 generiert wurde, verliert ihre Standardeinstellung
Zweig. Eine RCS-Revision, die beim Emulieren von Version 4 oder früher generiert wurde, hat eine Zeit
Stempel, der um bis zu 13 Stunden verspätet ist. Eine Revision, die beim Emulieren der Version extrahiert wurde
4 oder früher enthält abgekürzte Daten des Formulars yy/mm/dd und kann auch enthalten
unterschiedliche Leerzeichen und Zeilenpräfixe bei der Ersetzung von $Protokoll$.

-xSuffixe
Verwenden Sie die Suffixe um RCS-Dateien zu charakterisieren. Sehen ci(1) für Details.

-zZone gibt das Datumsausgabeformat bei der Schlüsselwortersetzung an und gibt den Standardwert an
Zeitzone für Datum der -dDatum Option. Die Zone sollte leer sein, eine numerische UTC
offset oder die spezielle Zeichenfolge LT für Ortszeit. Die Vorgabe ist ein leeres Zone,
das das traditionelle RCS-Format von UTC ohne Zeitzonenangabe verwendet und
mit Schrägstrichen, die die Teile des Datums trennen; andernfalls werden Zeiten in ISO ausgegeben
8601-Format mit Zeitzonenanzeige. Wenn die Ortszeit beispielsweise der 11. Januar ist.
1990, 8 Uhr Pacific Standard Time, acht Stunden westlich UTC, dann wird die Uhrzeit ausgegeben
wie folgt:

zu erhalten Zeit Möglichkeiten für das Ausgangssignal:
-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

Das -z Option wirkt sich nicht auf Daten aus, die in RCS-Dateien gespeichert sind, die immer UTC sind.

STICHWORT AUSWECHSLUNG

Zeichenfolgen der Form $Stichwort$ und $Stichwort:...$ im Text eingebettet werden durch ersetzt
Zeichenfolgen der Form $Stichwort:Wert$ woher Stichwort und Wert sind die unten aufgeführten Paare.
Schlüsselwörter können in Literalstrings oder Kommentare eingebettet werden, um eine Revision zu identifizieren.

Zunächst gibt der Benutzer Zeichenfolgen der Form ein $Stichwort$. An der Kasse, co ersetzt diese
Strings mit Strings der Form $Stichwort:Wert$. Wenn eine Revision mit Strings der
letzteres Formular wird wieder eingecheckt, die Wertefelder werden beim nächsten ersetzt
Auschecken. Somit werden die Keyword-Werte beim Checkout automatisch aktualisiert. Diese Automatik
Substitution kann geändert werden durch die -k Optionen.

Schlüsselwörter und ihre entsprechenden Werte:

$Autor$
Der Anmeldename des Benutzers, der die Revision eingecheckt hat.

$Datum$ Datum und Uhrzeit des Eincheckens der Revision. Mit -zZone eine numerische Zeitzone
Offset wird angehängt; andernfalls ist das Datum UTC.

$Kopfzeile$
Eine Standardkopfzeile mit dem vollständigen RCS-Dateinamen, der Revisionsnummer, dem Datum
und Zeit, der Autor, der Zustand und das Schließfach (falls gesperrt). Mit -zZone eine Zahl
Zeitzonen-Offset wird an das Datum angehängt; andernfalls ist das Datum UTC.

$ Id $ Das gleiche wie $Kopfzeile$, außer dass der RCS-Dateiname ohne das Verzeichnis ist
Komponenten.

$Schließfach$
Der Anmeldename des Benutzers, der die Revision gesperrt hat (leer, wenn nicht gesperrt).

$Protokoll$ Die beim Einchecken bereitgestellte Protokollnachricht, der ein Header mit dem RCS vorangestellt ist
Dateiname, Revisionsnummer, Autor, Datum und Uhrzeit. Mit -zZone a
numerischer Zeitzonen-Offset wird angehängt; andernfalls ist das Datum UTC. Vorhandenes Protokoll
Nachrichten sind nicht ersetzt. Stattdessen wird die neue Log-Nachricht eingefügt nach
$Protokoll:...$. Dies ist nützlich, um ein vollständiges Änderungsprotokoll in einer Quelldatei zu sammeln.

Jeder eingefügten Zeile wird die Zeichenfolge vorangestellt, die dem vorangestellt ist $Protokoll$ Leitung. Zum
Beispiel, wenn die $Protokoll$ Zeile ist „// $Protokoll: tan.cc $”, RCS stellt jeder Zeile des
melde dich mit "// “. Dies ist nützlich für Sprachen mit Kommentaren, die bis zum Ende von gehen
die Linie. Die Konvention für andere Sprachen ist die Verwendung eines „ * ” Präfix innerhalb von a
mehrzeiliger Kommentar. Zum Beispiel der anfängliche Protokollkommentar eines C-Programms
konventionell hat die folgende Form:

/∗
* $Protokoll$
/

Für Abwärtskompatibilität mit älteren RCS-Versionen, wenn das Protokollpräfix . ist /∗ or
(∗ umgeben von optionalem Leerraum, eingefügte Protokollzeilen enthalten stattdessen ein Leerzeichen
of / or (; Diese Verwendung ist jedoch veraltet und sollte nicht verlassen werden.

$Name$ Der symbolische Name, der zum Auschecken der Revision verwendet wird, falls vorhanden. Zum Beispiel, co -rJoe
erzeugt $Name: Joe $. Einfach co erzeugt nur $Name: $.

$RCSfile$
Der RCS-Dateiname ohne Verzeichniskomponenten.

$ Revision $
Die der Revision zugewiesene Revisionsnummer.

$Quelle$
Der vollständige RCS-Dateiname.

$Staat$
Der der Revision zugewiesene Zustand mit dem -s Option rcs(1) oder ci(1).

Die folgenden Zeichen in Schlüsselwortwerten werden durch Escape-Sequenzen dargestellt, die beibehalten werden müssen
Keyword-Strings wohlgeformt.

verkohlen Flucht Reihenfolge
Tab \t
Neue Zeile \n
Raum \ 040
$ \ 044
\ \\

FILE MODI

Die Arbeitsdatei erbt die Lese- und Ausführungsberechtigungen von der RCS-Datei. In
Darüber hinaus ist die Schreibberechtigung des Eigentümers aktiviert, es sei denn -kv ist gesetzt oder die Datei ist
ausgecheckt entsperrt und Sperre ist auf strikt gesetzt (siehe rcs(1)).

Wenn bereits eine Datei mit dem Namen der Arbeitsdatei existiert und Schreibrechte besitzt, co
bricht den Checkout ab und fragt nach Möglichkeit vorher. Ist die vorhandene Arbeitsdatei nicht
beschreibbar oder -f gegeben ist, wird die Arbeitsdatei ohne Nachfrage gelöscht.

Verwenden Sie co online mit den onworks.net-Diensten