aemv - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

aegis move file - benennen Sie eine oder mehrere Dateien als Teil einer Änderung um

ZUSAMMENFASSUNG

Ägide -Datei bewegen [ zu erhalten... ] alte Bezeichnung neuer Name [ old1 new1 [ old2 new2 ] ]
Ägide -Datei bewegen -Aufführen [ zu erhalten... ]
Ägide -Datei bewegen -Hilfe

BESCHREIBUNG

Das Ägide -Datei bewegen Befehl wird verwendet, um eine Datei in eine Änderung zu kopieren und ihren Namen zu ändern bei
die selbe Zeit.

Die benannten Dateien werden von der Baseline kopiert (alte-Datei) in die Entwicklung
Verzeichnis (neue Datei) und zur Liste der Dateien in der Änderung hinzugefügt.

Warnung: Wenn sich bereits Dateien im Entwicklungsverzeichnis eines der alte Bezeichnung or
neuer Name sie werden überschrieben.

Das alte-Datei im Entwicklungsverzeichnis enthält 1 KB zufälligen Text. Der Zufall
Text ist so abstoßend, dass die meisten Compiler Fehlermeldungen ausgeben, falls die
Datei versehentlich referenziert werden. Dies ist oft sehr hilfreich beim Verschieben von Include-Dateien.

Sie können Verzeichnisse umbenennen. Alle Dateien im alte Bezeichnung Verzeichnisbaum wird umbenannt
unter dem sein neuer Name Verzeichnisbaum.

Reichen Sie das Name und Vorname Dolmetschen
Das Programm aegis versucht, die Projektdateinamen aus den Dateinamen zu ermitteln
auf der Kommandozeile angegeben. Alle Dateinamen werden innerhalb von aegis-Projekten als relativ gespeichert
zum Stamm des Basisverzeichnisbaums. Das Entwicklungsverzeichnis und die
Integrationsverzeichnis sind Schatten dieses Basisverzeichnisses, daher diese relativen Namen
auch hier bewerben. In der Befehlszeile benannte Dateien werden zuerst in absolute Pfade konvertiert
Falls benötigt. Sie werden dann mit dem Baseline-Pfad, dem Entwicklungsverzeichnis, verglichen
path und den Integrationsverzeichnispfad, um einen baselinerelativen Namen zu bestimmen. es ist
ein Fehler, wenn sich die benannte Datei außerhalb einer dieser Verzeichnisbäume befindet.

Das -BAse_RElativ Option kann verwendet werden, um relative Dateinamen zu interpretieren als
relativ zum Basislinienpfad; absolute Dateinamen werden trotzdem mit den verschiedenen verglichen
Pfade, um einen baseline-relativen Namen zu ermitteln.

Das relativer_dateiname_präferenz in der Benutzerkonfigurationsdatei kann zum Ändern verwendet werden
dieses Standardverhalten. Sehen euconf(5) für weitere Informationen.

Prozess Seite Effekte
Dieser Befehl bricht alle Build- oder Testregistrierungen ab, da eine weitere Datei hinzugefügt wird
macht sie logisch ungültig.

Wenn die Änderungsdateien aufgelistet sind (Ägide -Aufführen Change_Files -Knapp) die neuen Dateien (Neu-
Name) erscheint in der Liste und die entfernten Dateien (alte Bezeichnung) Wird nicht erscheint in der
knappe Auflistung. Ebenso, wenn die Projektdateien mit einer expliziten Änderung aufgeführt sind
Nummer (Ägide -Aufführen Projekt_Dateien -Knapp -Veränderung N) keine der Änderungsdateien, einschließlich
sowohl die neuen als auch die entfernten Dateien werden in der knappen Liste angezeigt. Diese beiden Funktionen sind
sehr hilfreich beim Aufrufen von aegis aus einem DMT heraus, um die Liste der Quelldateien zu generieren.

Benachrichtigung
Das neuer_Dateibefehl und Remove_file_command im Projekt Config Datei ausgeführt werden, falls gesetzt.
Das project_file_command wird auch ausgeführt, wenn gesetzt, und wenn eine Integration stattgefunden hat
vor kurzem. Sehen aepconf(5) für weitere Informationen.

WEISS

Aegis stellt Ihnen einen sogenannten „Sichtpfad“ zur Verfügung, der auf Entwicklung hinweist
Tools (Compiler, Build-Systeme, etc) zuerst im Entwicklungsverzeichnis suchen, dann in
der Zweig-Basislinie und so weiter bis zur Stamm-Basislinie.

Das Problem mit Ansichtspfaden besteht darin, dass Sie zum Entfernen von Dateien eine Art von
"whiteout", um zu sagen "Hör auf zu suchen, es wurde entfernt."

Wenn Sie das verwenden aerm(1) oder aemv(1) Befehle, dies bedeutet "Informationen zu dieser Änderung hinzufügen"
wodurch die Datei aus der Baseline entfernt wird, wenn diese Änderung integriert wird". Ie während
die änderung ist in der Sein entwickelt Zustand, die Datei wird erst in der Entwicklung "entfernt"
Verzeichnis - es ist immer noch in der Baseline vorhanden und wird es bleiben, bis die Änderung erfolgt
erfolgreich integriert.

Wenn Sie die aerm(1) oder aemv(1) Befehle erstellt Aegis eine 1K-Datei, die als
Whiteout. Der Inhalt ist ziemlich hässlich, so dass beim Kompilieren oder Einbinden der "entfernten"
Datei versehentlich, erhalten Sie einen schwerwiegenden Fehler. Dies wird Sie daran erinnern, veraltete . zu entfernen
Verweise.

Wenn die Änderung integriert ist, ist die entfernte Datei nicht kopiert/verknüpft von der Baseline zu
das Integrationsverzeichnis und ist nicht aus dem Entwicklungsverzeichnis kopiert. Bei diesem
Zeit ist es physisch weg (kein Whiteout). Es wird angenommen, dass wegen des Fehlers
Induzieren eines Whiteouts Alle alten Referenzen wurden gefunden und behoben, während die Änderung im
Sein entwickelt Zustand.

Reichen Sie das Manifeste
Beim Generieren einer Liste der zu kompilierenden oder zu verknüpfenden Dateien ist es wichtig, dass die Datei
manifest aus Informationen generiert werden, die Aegis bekannt sind, und nicht aus dem Dateisystem.
Dies hat mehrere Gründe:

(a) Aegis weiß genau, welche (Quell-)Dateien wo sind, während alles andere ist
Ableiten von Aegis' Wissen; und

(b) das Suchen im Dateisystem ist schwierig, wenn der Ansichtspfad länger als 2 Verzeichnisse ist
(und die Verzweigungsmethode von Aegis kann sie beliebig lang machen); und

(c) Die Whiteout-Dateien und alles andere, was „herumliegen“ ist, wird jede Methode verwirren
die das Dateisystem abfragt.

Der einfachste Weg, das Dateiwissen von Aegis zu nutzen, ist mit so etwas wie einem awk(1) Skript
Verarbeitung der Aegis-Dateilisten. Das kannst du zum Beispiel mit um(1) wie folgt:
# das Dateimanifest generieren
manifest.make.inc: manifest.make.awk
( aegis -l cf -ter ; aegis -l pf -ter ) | \
awk -f manifest.make.awk > manifest.make.inc
# füge jetzt das Dateimanifest ein
Manifest.make.inc einschließen
Hinweis: Dies wäre ineffizient, wenn Sie es einmal pro Verzeichnis tun würden, aber es gibt nichts
Sie daran hindern, zahlreiche Aufgaben in die manifest.make.inc Datei, alles in einem
bestehen.

Dasselbe ist mit dem Berichtsgenerator von Aegis möglich (siehe aer(1) für mehr
Informationen), aber dies ist komplizierter als die awk(1) Skript. Allerdings mit dem
Informationen "direkt aus dem Maul des Pferdes", es kann auch viel schlauer sein.

Dieses Dateimanifest würde ohne eine Sperre für die Datei von Aegis veraltet sein
Betriebsbefehle. Durch die Verwendung der Projektdateibefehl und change_file_command Felder von
das Projekt Config Datei (siehe aepconf(5) für weitere Informationen), können Sie diese Datei löschen
zu strategischen Zeiten.
/* ausführen, wenn das Manifest der Änderungsdatei geändert wird */
change_file_command = "rm -f manifest.make.inc";
/* ausgeführt, wenn das Manifest der Projektdatei geändert wird */
project_file_command = "rm -f manifest.make.inc";
Das neue Dateimanifest wird daher im nächsten aeb(1) Befehl.

Optionen und Voreinstellungen
Da ist ein -No-WhiteOut Option, die verwendet werden kann, um Whiteout-Dateien zu unterdrücken, wenn Sie
aerm(1) und aemv(1) Befehle. Es gibt eine entsprechende -WhiteOut Option, die ist
normalerweise die Standardeinstellung.

Da ist ein whiteout_preference Feld in der Datei mit den Benutzereinstellungen (siehe euconf(5) für
mehr Informationen), wenn Sie diese Option dauerhafter einstellen möchten.

Tipp-Ex Reichen Sie das Template
Das whiteout_template Bereich des Projekts Config Datei kann verwendet werden, um Sprach-
bestimmte Fehlerdateien. Wenn kein Eintrag in der Whiteout-Vorlage übereinstimmt, wird eine sehr hässliche 1-KB-Datei
produziert werden - es sollte für fast jede Sprache Compilerfehler verursachen.

Wenn Sie eine besser lesbare Fehlermeldung wünschen, können Sie Einträge wie
whiteout_template =
[
{
Muster = [ "*.[ch]" ];
body = "#error Diese Datei wurde entfernt.";
}
];
kann sehr effektiv sein (in diesem Beispiel wird davon ausgegangen) gcc(1) wird verwendet).

Wenn es wichtig ist, dass nicht Whiteout-Datei erzeugt werden, sagen wir für C-Quelldateien, könnten Sie
Verwenden Sie eine Whiteout-Vorlage wie
whiteout_template =
[
{ Muster = [ "*.c" ]; }
];
weil ein abwesender Körper Unterfeld bedeutet, dass überhaupt keine Whiteout-Datei generiert wird.

Möglicherweise haben Sie mehr als einen Whiteout-Vorlageneintrag, aber beachten Sie, dass die Reihenfolge der
Einträge sind wichtig. Der erste Eintrag, der zutrifft, wird verwendet.

Benachrichtigung
Bei erfolgreicher Ausführung dieses Befehls werden die Benachrichtigungen, die normalerweise von der
aerm(1) aenf(1) und nicht(1) Befehle werden nach Bedarf ausgeführt. Dazu gehören die
project_file_command, neuer_Dateibefehl, neuer_test_befehl und Remove_file_command Felder
von dem Projekt Config Datei. Sehen aepconf(5) für weitere Informationen.

OPTIONAL

Folgende Optionen werden verstanden:

-Veränderung Anzahl
Diese Option kann verwendet werden, um eine bestimmte Änderung innerhalb eines Projekts anzugeben. Sehen
Ägide(1) für eine vollständige Beschreibung dieser Option.

-Hilfe
Diese Option kann verwendet werden, um weitere Informationen zur Verwendung des Ägide


-Aufführen
Diese Option kann verwendet werden, um eine Liste geeigneter Themen für diesen Befehl zu erhalten.
Die Liste ist möglicherweise allgemeiner als erwartet.

-Not_Logging
Diese Option kann verwendet werden, um die automatische Protokollierung von Ausgaben und Fehlern zu deaktivieren
eine Datei. Dies ist oft nützlich, wenn mehrere aegis-Befehle in einer Shell zusammengefasst sind
Skripte.

-Projekt Name
Diese Option kann verwendet werden, um das gewünschte Projekt auszuwählen. Wenn nein -Projekt
Option angegeben ist, die AEGIS_PROJEKT Umgebungsvariable wird konsultiert. Wenn
die nicht existiert, die des Benutzers $HOME/.aegisrc Datei wird auf einen Standard untersucht
Projektfeld (siehe euconf(5) für weitere Informationen). Wenn das nicht existiert,
Wenn der Benutzer nur an Änderungen innerhalb eines einzelnen Projekts arbeitet, wird das Projekt
Der Name ist standardmäßig auf dieses Projekt eingestellt. Andernfalls handelt es sich um einen Fehler.

-Knapp
Diese Option kann verwendet werden, um zu veranlassen, dass Listings das absolute Minimum an
Information. Es ist normalerweise für Shell-Skripte nützlich.

-Ausführlich
Diese Option kann verwendet werden, um aegis zu veranlassen, mehr Ausgabe zu erzeugen. Standardmäßig aegis
erzeugt nur bei Fehlern eine Ausgabe. Bei Verwendung mit dem -Aufführen Option diese Option
bewirkt, dass Spaltenüberschriften hinzugefügt werden.

-Warten Diese Option kann verwendet werden, um zu verlangen, dass Aegis-Befehle auf Zugriffssperren warten, wenn
sie sind nicht sofort erhältlich. Standardmäßig die des Benutzers lock_wait_preference
wenn nicht angegeben, siehe euconf(5) für weitere Informationen.

-Nein_Warten
Diese Option kann verwendet werden, um zu verlangen, dass Aegis-Befehle einen schwerwiegenden Fehler ausgeben, wenn Zugriff
Schlösser sind nicht sofort erhältlich. Standardmäßig die des Benutzers
lock_wait_preference wenn nicht angegeben, siehe euconf(5) für weitere Informationen.

-WhiteOut
Diese Option kann verwendet werden, um zu verlangen, dass gelöschte Dateien durch ein „Whiteout“ ersetzt werden.
Datei im Entwicklungsverzeichnis. Die Idee ist, dass das Kompilieren einer solchen Datei
zu einem fatalen Fehler führen, damit alle Referenzen gefunden werden können. Das ist
normalerweise die Standardeinstellung.

-No_WhiteOut
Diese Option kann verwendet werden, um anzufordern, dass keine „Whiteout“-Datei in die Datei eingefügt wird
Entwicklungsverzeichnis.

[VORLÄUFIGE VOLLAUTOMATISCHE TEXTÜBERSETZUNG - muss noch überarbeitet werden. Wir bitten um Ihr Verständnis.] Ägide(1) für Optionen, die allen aegis-Befehlen gemeinsam sind.

Alle Optionen können abgekürzt werden; die Abkürzung wird als Großbuchstaben dokumentiert,
alle Kleinbuchstaben und Unterstriche (_) sind optional. Sie müssen aufeinanderfolgend verwenden
Folgen von optionalen Buchstaben.

Bei allen Optionen wird die Groß-/Kleinschreibung nicht beachtet, Sie können sie in Groß- oder Kleinschreibung oder a . eingeben
Kombination von beiden, Groß-/Kleinschreibung ist nicht wichtig.

Zum Beispiel: Die Argumente "-project, "-PROJ" und "-p" werden alle so interpretiert, dass sie die
-Projekt Möglichkeit. Das Argument "-prj" wird nicht verstanden, da aufeinanderfolgend
optionale Zeichen wurden nicht angegeben.

Optionen und andere Befehlszeilenargumente können auf der Befehlszeile beliebig gemischt werden,
nach den Funktionswählern.

Die langen Optionsnamen von GNU werden verstanden. Da alle Optionsnamen für Ägide sind lang,
Dies bedeutet, dass das zusätzliche führende '-' ignoriert wird. Die "--zu erhalten=Wert"Konvention ist auch
verstanden.

EMPFOHLEN ALIAS

Der empfohlene Alias ​​für diesen Befehl ist
csh% alias aemv 'aegis -mv \!* -v'
sh$ aemv(){aegis -mv "$@" -v}

FEHLER

Es ist ein Fehler, wenn die Änderung nicht im Sein entwickelt Zustand.
Es ist ein Fehler, wenn die Änderung nicht dem aktuellen Benutzer zugewiesen ist.
Es ist ein Fehler, wenn eine der Dateien bereits in der Änderung enthalten ist.

EXIT STATUS

Das Ägide Der Befehl wird bei jedem Fehler mit dem Status 1 beendet. Die Ägide Befehl wird nur
mit dem Status 0 beenden, wenn keine Fehler vorliegen.

VARIABLEN

See Ägide(1) für eine Liste von Umgebungsvariablen, die diesen Befehl beeinflussen können. Sehen
aepconf(5) für die Projektkonfigurationsdatei projektspezifisch Feld für die Einstellung
Umgebungsvariablen für alle von Aegis ausgeführten Befehle.

Verwenden Sie aemv online mit den onworks.net-Diensten