patlog – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

pat - Patch-Generator-Tools

ZUSAMMENFASSUNG

Klaps [ -ahmnV ] [ Dateiliste ]
patcil [ -abfhnpqsV ] [ Dateiliste ]
Patdiff [ -ahnV ] [ Dateiliste ]
Patbase [ -ahV ] [ Dateiliste ]
Patlog [ -hnruV ]
Patmake [ -hV ]
patsenden [ -hiquV ] [ Patchliste ] [ Empfänger ]
patnotifizieren [ -hquV ] [ Empfänger ]
Patpost [ -hrV ] Patchliste Newsgroups
patftp [ -hV ] [ Patchliste ]
Patname [ -ahnmV ] -v Version [ Dateiliste ]
Patsnap [ -ahV ] [ -o Schnappschuss ] [ Dateiliste ]
Patkol [ -achnmsCV ] [ -d Verzeichnis ] [ -f Hände ] [ -S schnappen ] [ Dateiliste ]
sauber machen [ -ahnmV ] [ Dateiliste ]
Patindex

BESCHREIBUNG

Klaps und die zugehörigen Programme generieren Patches für jedes gespeicherte Paket
unter RCS. Diese Programme verbergen viele Details von RCS, die Ihnen im Weg stehen, wenn
Aufbau und Pflege eines Pakets. Alles, was Sie tun müssen, um einen neuen Patch zu erstellen, ist
Bearbeiten Sie Ihre Dateien, führen Sie pat aus und geben Sie RCS und im generierten Patch einige Beschreibungen an
Datei. Details wie z. B. wie eine neue RCS-Datei initialisiert wird, was die Kommentarzeichenfolge sein soll
sein, wie man einen neuen Branch erstellt, wie man mit Unterverzeichnissen umgeht, wie man Diffs macht und wie man
Organisieren der Patch-Datei werden automatisch gehandhabt.

Bevor Sie eines der pat-Programme verwenden, müssen Sie Ihr Paket initialisieren, indem Sie packinit . ausführen
im obersten Verzeichnis Ihres Pakets. Dies erzeugt eine .package-Datei, die alle
dist-Programme nutzen.

In jedem der Programme, die eine Dateiliste wünschen, wenn Sie angeben -a stattdessen alle Dateien in
MANIFEST.new wird verarbeitet. In allen Programmen, die eine Patchliste benötigen, ist eine Null
patchlist bezeichnet den aktuellen Patch. Sie können Bindestriche, Kommas und Leerzeichen zum Trennen verwenden
Patch-Nummern. Wenn die rechte Seite eines Bindestrichs der Null-String ist, wird der aktuelle Patchlevel
wird als Maximalwert angenommen. Alle Programme aufgerufen mit -h druckt einen kleinen verbrauch
Nachricht mit der Bedeutung der einzelnen verfügbaren Optionen. Die -V Option gibt den Strom
Versionsnummer.

Pat selbst ist ein Wrapper-Programm, das patcil, patdiff und patmake aufruft. Normalerweise kannst du
Rufen Sie einfach pat auf und ignorieren Sie alle anderen. Pat aktualisiert die MANIFEST-Datei, wenn
notwendig (es wird eine exakte Kopie der Datei MANIFEST.new sein, vorausgesetzt, dass ein MANIFEST
bereits existierte), schließlich patcil darauf aufrufen.

Wenn Sie angeben -n statt einer Dateiliste findet pat alle Dateien, die neuer sind als
patchlevel.h, bringen Sie in einen Editor, um die Liste zu verkleinern, und verwenden Sie dann diese Dateiliste. Wenn
jede Datei der Liste wird entfernt, Klaps wird abgebrochen.

Patcil wird verwendet, um ein ci -l für alle aufgelisteten Dateien auszuführen. (Es wird davon ausgegangen, dass Sie immer wollen
Lassen Sie Ihre Dateien ausgecheckt.) Zusätzlich zu den -a Schalter, da ist ein -b Schalter, der
führt ein schnelles Einchecken einer Reihe von Dateien durch. Anstatt rcs für jede Datei aufzurufen, ruft es rcs . auf
auf der gesamten Liste der Dateien. Dies ist nützlich, um eine Trunk-Revision einzuchecken. Wenn du
eine neue Trunk-Revision einchecken möchten, möchten Sie vielleicht auch die verwenden -s Flagge, die wird
Entfernen Sie alte RCS Log-Einträge aus der vorherigen Revision, damit Sie neu beginnen können.
Sie sollten wahrscheinlich auch a . verwenden -f die an die ci weitergegeben wird, um unverändert zu erzwingen
Dateien einzuchecken. Um eine neue Trunk-Revision einzuchecken, sage ich

patcil -s -f -a

Patcil wird nach dem Log-Eintrag fragen, anstatt ci machen zu lassen, und hat einen kleinen Prompter
eingebaut, mit dem Sie die Nachricht auf verschiedene Weise manipulieren können. Geben Sie h für eine Auflistung von ein
was du tun kannst. Eines der schönsten Dinge ist, dass Sie in einen Editor eintauchen können,
optional mit einer Diff-Auflistung der Änderungen seit dem letzten Patch, falls du
vergessen, was du geändert hast. Wenn Sie als erstes ein CR eingeben, enthält es das vorherige
Log-Nachricht. Beenden Sie den Prompter mit einem CR.

Es gibt zwei verschiedene Möglichkeiten, patcil zu verwenden. Sie können patcil entweder selbst anrufen oder lassen
ruf es für dich an. Es spielt keine Rolle, wie oft Sie patcil aufrufen, bevor Sie pat ausführen,
da patdiff weiß, womit die letzte Patch-Basis zu vergleichen ist. Patcil kann einberufen werden
eines Ihrer Verzeichnisse; die anderen Programme müssen in Ihrem Top-Level-Verzeichnis aufgerufen werden (oder
in Bugs, wenn sinnvoll).

Wenn Sie eine neue Datei auf einem bestimmten Patchlevel erstellen, müssen Sie sie mit dem -p
Möglichkeit. Andernfalls wird es einfach als neue Trunk-Revision eingecheckt. Der Name des
Datei wird der MANIFEST.new hinzugefügt, falls sie nicht bereits darin vorkommt. Wenn der Name ist
zusammen mit einer Beschreibung gefunden wird, wird diese Beschreibung an rcs weitergeleitet, um richtig zu sein
Initialisieren Sie die RCS-Datei.

Patbase kann verwendet werden, um die Patch-Basis nach dem Verschrotten auf die aktuelle Version zurückzusetzen
die vorherige Patch-Sequenz und erstellen ein neues Distributions-Kit. Was es wirklich tut ist
an rcs -Nlastpat:REV, wobei REV die aktuelle Revision ist. Wenn Patdiff explodiert und du willst
Um die Patch-Basis auf eine frühere Version zurückzusetzen, müssen Sie rcs -Nlastpat:REV . aufrufen
dich selber.

Patdiff macht tatsächlich die Diffs, die in den Patch einfließen, und vergleicht jede Version
-Nlastpat zeigt auf die zuletzt eingecheckte Version. Es aktualisiert dann -Nlastpat
um auf die aktuelle Version zu verweisen. Es lässt das Diff im Unterverzeichnis bugs für
patmake zum abholen. Es kann entweder rcsdiff oder einen Diff-Befehl Ihrer Wahl verwenden
wenn Sie packinit ausführen, falls Ihr Diff besser als rcsdiff ist.

Patlog wird aufgerufen von Patmake normalerweise, um die . zu aktualisieren ChangeLog Datei (oder wie auch immer das heißt)
Datei wurde beim Ausführen gegeben packinit). Es sammelt Protokollnachrichten und startet ein
Editor, damit Sie die erforderlichen Aktualisierungen vornehmen können. Wenn Sie Ihr Paket auch so konfiguriert haben
RCS-Protokolle in die ChangeLog, wird auch für diese eine weitere Editor-Sitzung gestartet.
Schließlich wird ein endgültiges Protokoll als Kandidateneintrag für . erstellt ChangeLog, die Sie auch können
nach Belieben ändern.

Wenn Sie a . nicht konfiguriert haben ChangeLog Datei, Patlog sammelt nur die informationen
es muss weitergegeben werden an Patmake und wird aussteigen. Wenn Sie es selbst nennen möchten, müssen Sie
mach das nach mindestens einem erfolgreichen Patdiff Lauf. Ich empfehle die Verwendung -n Option die
das erste Mal, und verwenden Sie dann die -u Option zusammen mit -n bei nachfolgenden Durchläufen, um Dateien neu zu erstellen
nur bei Bedarf. Die -r Option (die ersetzt) -u) verhindert Patlog von der Wiederherstellung eines
vorhandene Datei, auch wenn sie veraltet ist.

Patlog werde anrufen patcil und Patdiff auf Ihrem ChangeLog Datei (nachdem die
Kandidatenlog-Eintrag, den Sie oben in der Datei bearbeitet haben), es sei denn, dies wird durch die
-n Möglichkeit. Dies bedeutet, dass der veröffentlichte Patch aktualisiert wird ChangeLog mit aktuellem Patch
Informationen, wie Sie es erwarten würden.

Patmake kombiniert alle Teile des Patches in einer Datei und ruft einen Editor auf, damit Sie
kann den Betreff und die Beschreibung hinzufügen. Es wirft alle Ihre Protokollnachrichten als Betreff ein und
als Beschreibung, unter der Annahme, dass es einfacher ist, das zu löschen, was Sie nicht möchten, als
um sich an alles zu erinnern, was du getan hast. Sie möchten auch jeden Artikel in der Beschreibung erweitern
Sie wiederholen also nicht nur die Betreffzeilen. Wenn du eine hast ChangeLog Datei, diese muss haben
schon fertig, oder Ihr ChangeLog wird nicht genau das darstellen, was in beschrieben ist
der Patch, da er bereits aktualisiert wurde, wenn Patmake fügt alles zusammen
Stücke (siehe Hinweis zu Patlog über).

Große Patches werden aufgeteilt, um die Größe jedes Patches auf einer vernünftigen Größe zu halten. Dies
wird automatisch verarbeitet, sodass Sie sich nicht darum kümmern müssen. Die Priorität jedes Patches
wird nur angeschaut von Patmake, unter der Annahme, dass kleine Veränderungen eine große Wirkung haben
Priorität.

Patsend, patpost und patftp werden verwendet, um Ihre Patches weltweit zu verteilen. Patentsende
sendet eine Reihe von Patches an eine Reihe von Empfängern. Die -u switch fügt alle aktuellen hinzu
registrierte Benutzer, die um Zusendung von Patches gebeten haben, sowie die
während der Ausführung festgelegte Empfänger packinitdem „Vermischten Geschmack“. Seine -i Schalter enthält Informationen mit dem
Patch darüber, wie sich der Benutzer selbst abmelden kann, damit er keine zukünftigen Patches erhält
automatisch; dies ist auch die Standardeinstellung, wenn die -u Schalter verwendet wird. Patpost postet ein Set
von Patches zu einer Reihe von Newsgroups. Patftp kopiert den Patch lediglich in Ihr öffentliches FTP
Verzeichnis.

patnotify benachrichtigt Benutzer einfach, dass ein neuer Patch veröffentlicht wurde, damit sie dies tun können
selbst von einer Archivseite oder bei Interesse per E-Mail abrufen. Die
-u switch kann verwendet werden, um alle aktuell registrierten Benutzer einzuschließen, die nachgefragt haben
eine solche Benachrichtigung. Die Nachricht enthält die Patch-Priorität und -Beschreibung sowie
Anweisungen zum automatischen Anfordern des Patches (das funktioniert nur, wenn Sie
Postagent Eingerichtet).

Beide patsenden und patnotifizieren lassen Sie die Adressliste bearbeiten, bevor Sie etwas senden,
es sei denn, du fügst die hinzu -q .

Patname kann verwendet werden, um eine Reihe von Dateien mit einem symbolischen Namen zu versehen (angegeben mit -v). Dies
legt den Namen für die neueste Revision jeder Datei fest.

Patsnap erhält einen Snapshot Ihrer Veröffentlichung, indem Sie eine SNAPSHOT-Datei erstellen (Name kann
geändert über -o) listet die Dateinamen und die neueste RCS-Revisionsnummer für diese Datei auf.
Solche Snapshots können verwendet werden, um die Veröffentlichung auf einem zufälligen Patchlevel zu identifizieren und dann
Sie können es später abrufen, indem Sie die Snapshot-Datei an Patkol.

Patcol checkt eine gesperrte Version einer Datei aus, eventuell in einem anderen Verzeichnis
(angegeben mit -d, wodurch der Verteilungsbaum gespiegelt wird). Alle Dateien, die keine haben
RCS-Gegenstück (zB patchlevel.h) wird einfach von patcol kopiert. Dies wird verwendet von
makedist, um die Distribution zu fälschen, bevor die Kits hergestellt werden. Standardmäßig funktioniert patcol nicht
die Verarbeitung der Urheberrechtserweiterung, aber Kunden mögen machendist erzwinge es, indem du es verwendest -C
Möglichkeit. Alternativ können Sie das Kopieren der ausgecheckten Version in ein Verzeichnis erzwingen
mit dem -c Schalter in Verbindung mit -d (oder dieser frühere Schalter wird einfach ignoriert).

Patcol kann seine Dateiliste auch aus einer SNAPSHOT-Datei über die -S wechseln, in diesem Fall
es checkt die Dateien mit der RCS-Version aus, die in der Snapshot-Datei angegeben ist, wie z
eine erstellt von Patsnap. Sie können stattdessen angeben -a, -m or -n um jeweils alle zu verwenden
Dateien in MANIFEST.new, alle geänderten Dateien (die patciled) oder alle
die Dateien neuer als patchlevel.h.

Patclean entfernt die Arbeitsdateien, nachdem alle Änderungen eingecheckt wurden. Du darfst
stellt Ihre Arbeitsdateien mithilfe von patcol wieder her.

Patindex kann aus dem Top-Level-Verzeichnis oder innerhalb des Bugs Verzeichnis. Es wird
Liste alle Patches und ihre Thema: Linien. Dieses Programm kennt komprimierte Patches
und dekomprimiert sie während der Erstellung des Listings.

RCS LAYER

Dieser Abschnitt beschreibt die RCS-Schicht, falls etwas in den Werkzeugen kaputt geht, damit Sie
kann Ihre RCS-Dateien reparieren und den Vorgang neu starten.

Alle Patch-Tools holen die Hauptrevisionsnummer des RCS-Trunks aus Ihrem .Paket Dateien, sagen wir
es ist 2.5. Dann, zu der Zeit, als du gelaufen bist packinit, Sie haben einen Zweig für Patches gewählt,
normalerweise Nummer 1, was bedeutet, dass alle Ihre Änderungen auf dem 2.5.1 RCS gespeichert werden
Zweig. Die Tools werden die Verzweigung für Sie erstellen, wenn die Zeit gekommen ist.

Jede letzte veröffentlichte Revision ist mit einem RCS . gekennzeichnet letztes pat Symbol. Wenn der Patch erstellt ist
by Patdiff, die neueste Version im 2.5.1-Zweig wird mit der als . markierten Version verglichen
letztes pat. Aus diesem Grund können Sie sicher mehrere ausgeben patcil vor der Veröffentlichung des Patches
und habe immer noch alles ausgearbeitet. Natürlich Patdiff wird das verschieben letztes pat Tag zum
neueste Zweigrevision nach der Verarbeitung einer bestimmten Datei.

Alle Protokollnachrichten und die geänderten Dateien werden in Ihrem gespeichert Bugs Verzeichnis, versteckt
Dateien (Name beginnt mit einem Punkt). Diese Protokolle werden gesammelt, wenn der Patch veröffentlicht wird
und die geänderten Dateien werden verwendet von Klaps's -m Schalter.

Patdiff sammelt seine Patch-Hunks unter dem Bugs Verzeichnis, in Dateien, die mit a . enden .nn
Erweiterung, wo nn stellt den aktuellen Patch-Level + 1 dar. (Was der nächste sein wird
Patchlevel, wann der Patch erstellt wird von Patmake, es sei denn, es ist zu groß, um in eines zu passen
Datei).

Patlog bereitet eine Reihe von Dateien vor für Patmake: das .verstopfen Datei sammelt die Informationen, die
wird in den Abschnitt Beschreibung: innerhalb des Patches gehen, und .xlog die sammeln die
ChangeLog Kandidateneintrag. Schließlich, .rlog Dateien speichern die RCS-Informationen, die
inbegriffen in ChangeLog, Wenn benötigt. Beachten Sie, dass die obersten drei Zeilen Müll sind und
werden von allen Tools ignoriert, die diese Dateien verarbeiten.

Um eine neue Baseline zu starten (dh die Revisionsnummer des RCS-Trunks zu ändern), müssen Sie
muss wieder laufen packinit und ändere diese Nummer. Dann eine neue ausgeben patcil, wahrscheinlich mit dem
-s, -a und -f Optionen...

Nutzen Sie Patlog online über die Dienste von onworks.net