aemv - Online in de cloud

PROGRAMMA:

NAAM

aegis-bestand verplaatsen - hernoem een ​​of meer bestanden als onderdeel van een wijziging

KORTE INHOUD

aegis -Verplaats_bestand [ optie...] oude naam nieuwe naam [ old1 new1 [ old2 new2 ] ]
aegis -Verplaats_bestand -Lijst [ optie...]
aegis -Verplaats_bestand -Helpen

PRODUCTBESCHRIJVING

De aegis -Verplaats_bestand commando wordt gebruikt om een ​​bestand naar een wijziging te kopiëren en de naam ervan te wijzigen
dezelfde tijd.

De benoemde bestanden worden gekopieerd vanaf de basislijn (oud-bestand) in de ontwikkeling
map (nieuw bestand), en toegevoegd aan de lijst met bestanden in de change.

Waarschuwing: als er al bestanden in de ontwikkeldirectory van een van de oude naam or
de nieuwe naam ze worden overschreven.

De oud-bestand in de ontwikkelingsmap bevat 1 KB willekeurige tekst. Het willekeurige
text is voldoende weerzinwekkend dat de meeste compilers foutmeldingen zullen geven, mocht de
bestand per ongeluk wordt verwezen. Dit is vaak erg handig bij het verplaatsen van include-bestanden.

U kunt mappen hernoemen. Alle bestanden in de oude naam mappenboom zal worden hernoemd
onder de zijn nieuwe naam directory boom.

Dien in Naam Interpretatie
Het aegis-programma zal proberen de projectbestandsnamen te bepalen uit de bestandsnamen
gegeven op de opdrachtregel. Alle bestandsnamen worden binnen aegis-projecten als relatief opgeslagen
naar de hoofdmap van de basismapstructuur. De ontwikkelmap en de
integratiemap zijn schaduwen van deze basismap, en dus zijn deze relatieve namen
ook hier toepassen. Bestanden die op de opdrachtregel worden genoemd, worden eerst geconverteerd naar absolute paden
indien nodig. Ze worden vervolgens vergeleken met het basispad, de ontwikkelingsdirectory
pad en het pad van de integratiedirectory om een ​​relatieve naam aan de basislijn te bepalen. Het is
een fout als het genoemde bestand zich buiten een van deze directorystructuren bevindt.

De -BAse_RElatief optie kan worden gebruikt om ervoor te zorgen dat relatieve bestandsnamen worden geïnterpreteerd als
ten opzichte van het basislijnpad; absolute bestandsnamen worden nog steeds vergeleken met de verschillende
paden om een ​​basislijn-relatieve naam te bepalen.

De relatieve_bestandsnaam_voorkeur in het gebruikersconfiguratiebestand kan worden gebruikt om te wijzigen
dit standaardgedrag. Zien aeuconf(5) voor meer informatie.

Proces Kant Effecten
Deze opdracht annuleert alle build- of testregistraties, omdat een ander bestand wordt toegevoegd
maakt ze logischerwijs ongeldig.

Wanneer de wijzigingsbestanden worden weergegeven (aegis -Lijst Wijzig_Bestanden -TERZ) de nieuwe bestanden (nieuwe-
naam) verschijnt in de lijst en de verwijderde bestanden (oude naam) Zal niet verschijnen in de
beknopte lijst. Evenzo wanneer de projectbestanden worden weergegeven met een expliciete wijziging
nummer (aegis -Lijst Project_Bestanden -TERZ -Verandering N) geen van de wijzigingsbestanden, inclusief
zowel de nieuwe als de verwijderde bestanden verschijnen in de beknopte lijst. Deze twee kenmerken zijn
erg handig bij het aanroepen van aegis vanuit een DMT om de lijst met bronbestanden te genereren.

Kennisgeving
De nieuw_bestandscommando en remove_file_commando in het project config bestand worden uitgevoerd, indien ingesteld.
De project_file_commando wordt ook uitgevoerd, indien ingesteld en als er een integratie heeft plaatsgevonden
onlangs. Zien aepconf(5) voor meer informatie.

WIT-OUT

Aegis biedt u wat vaak een "kijkpad" wordt genoemd dat wijst op ontwikkeling
tools (compilers, build-systemen, etc) kijk eerst in de ontwikkelmap, dan in
de basislijn van de vertakking, enzovoort tot aan de basislijn van de stam.

Het probleem met weergavepaden is dat je, om bestanden te verwijderen, een soort van
"whiteout" om te zeggen "stop met zoeken, het is verwijderd."

Wanneer u de aerm(1) of aemv(1) commando's, dit betekent "informatie aan deze wijziging toevoegen"
waarmee het bestand van de basislijn wordt verwijderd wanneer deze wijziging is geïntegreerd". D.w.z en
de verandering zit in de wezen ontwikkelde staat, wordt het bestand alleen "verwijderd" in de ontwikkeling
directory - het is nog steeds aanwezig in de basislijn en zal dat zijn totdat de wijziging is
succesvol geïntegreerd.

Wanneer u gebruik maken van de aerm(1) of aemv(1) commando's, zal Aegis een 1K-bestand maken om op te treden als de
wit weg. De inhoud is nogal lelijk, zodat als u de "verwijderd" compileert of opneemt
bestand per ongeluk, krijg je een fatale fout. Dit zal u eraan herinneren om verouderde te verwijderen
gevonden.

Wanneer de wijziging is geïntegreerd, is het verwijderde bestand niet gekopieerd/gekoppeld van de basislijn naar
de integratiedirectory, en is niet gekopieerd uit de ontwikkelmap. Op deze
keer dat het fysiek weg is (geen white-out). Aangenomen wordt dat vanwege de fout
het induceren van white-out alle oude referenties werden gevonden en gerepareerd terwijl de wijziging in de . was
wezen ontwikkelde staat.

Dien in Manifesten
Bij het genereren van een lijst met bestanden die moeten worden gecompileerd of gekoppeld, is het belangrijk dat het bestand
manifest worden gegenereerd op basis van informatie die bekend is bij Aegis, in plaats van uit het bestandssysteem.
Dit heeft verschillende redenen:

(a) Aegis weet precies welke (bron)bestanden waar zijn, terwijl al het andere is
het afleiden van de kennis van Aegis; en

(b) zoeken in het bestandssysteem is moeilijk wanneer het weergavepad langer is dan 2 mappen
(en de vertakkingsmethode van Aegis kan het willekeurig lang maken); en

(c) De whiteout-bestanden en al het andere dat "rondslingert", zal elke methode verwarren
die het bestandssysteem ondervraagt.

De gemakkelijkste manier om de bestandskennis van Aegis te gebruiken, is met zoiets als een awk(1) schrift
het verwerken van de Aegis-bestandslijsten. U kunt dit bijvoorbeeld doen met maken(1) als volgt:
# genereer het bestandsmanifest
manifest.make.inc: manifest.make.awk
(aegis -l cf -ter; auspiciën -l pf -ter) | \
awk -f manifest.make.awk > manifest.make.inc
# voeg nu het bestandsmanifest toe
omvatten manifest.make.inc
Opmerking: dit zou inefficiënt zijn als u het één keer per map deed, maar er is niets
stoppen met het schrijven van tal van opdrachten in de manifest.make.inc bestand, alles in één
voorbij lopen.

Het is mogelijk om hetzelfde te doen met de rapportgenerator van Aegis (zie Aer(1) voor meer
informatie), maar dit is meer betrokken dan de awk(1) schrift. Echter, met de
informatie als het ware "recht uit de mond van het paard" kan het ook veel slimmer.

Dit bestandsmanifest zou verouderd raken zonder een koppeling met het bestand van Aegis
operaties commando's. Door gebruik te maken van de project-bestand_commando en change_file_commando velden van
het project config bestand (zie aepconf(5) voor meer informatie), kunt u dit bestand verwijderen
op strategische momenten.
/* uitvoeren wanneer het manifest van het wijzigingsbestand is gewijzigd */
change_file_command = "rm -f manifest.make.inc";
/* uitvoeren wanneer het manifest van het projectbestand is gewijzigd */
project_file_command = "rm -f manifest.make.inc";
Het nieuwe bestandsmanifest zal dus opnieuw worden opgebouwd tijdens de volgende AEB(1) opdracht.

Opties en voorkeuren
Er is een -Geen-Wit Uit optie, die kan worden gebruikt om whiteout-bestanden te onderdrukken wanneer u
de aerm(1) en aemv(1) commando's. Er is een overeenkomstige -Wit Uit optie, dat is
meestal de standaard.

Er is een whiteout_voorkeur veld in het gebruikersvoorkeurenbestand (zie aeuconf(5) voor
meer informatie) als u deze optie permanenter wilt instellen.

Whiteout Dien in Sjablonen
De whiteout_sjabloon gebied van het project config bestand kan worden gebruikt om taal-
specifieke foutbestanden. Als geen enkel whiteout-sjabloonitem overeenkomt, zal een erg lelijk bestand van 1 KB dat wel doen
worden geproduceerd - het zou compilerfouten moeten veroorzaken voor zowat elke taal.

Als u een meer voor mensen leesbare foutmelding wilt, kunt u items als:
whiteout_template =
[
{
patroon = [ "*.[ch]" ];
body = "#error Dit bestand is verwijderd.";
}
];
kan zeer effectief zijn (in dit voorbeeld wordt ervan uitgegaan dat gcc(1) wordt gebruikt).

Als het essentieel is dat geen whiteout-bestand worden geproduceerd, bijvoorbeeld voor C-bronbestanden, zou u kunnen:
gebruik een whiteout-sjabloon zoals
whiteout_template =
[
{ patroon = [ "*.c" ]; }
];
omdat een afwezige lichaam subveld betekent dat er helemaal geen whiteout-bestand wordt gegenereerd.

Mogelijk hebt u meer dan één whiteout-sjablooninvoer, maar houd er rekening mee dat de volgorde van de
inzendingen is belangrijk. De eerste invoer die overeenkomt, wordt gebruikt.

Kennisgeving
Na succesvolle voltooiing van deze opdracht, worden de meldingen meestal uitgevoerd door de
aerm(1) aenf(1) en aent(1) commando's worden uitgevoerd, indien van toepassing. Deze omvatten de
project_file_commando, nieuw_bestandscommando, nieuw_test_commando en remove_file_commando velden
van het project config het dossier. Zien aepconf(5) voor meer informatie.

OPTIES

De volgende opties worden begrepen:

-Verandering aantal
Deze optie kan worden gebruikt om een ​​bepaalde wijziging binnen een project te specificeren. Zien
aegis(1) voor een volledige beschrijving van deze optie.

-Helpen
Deze optie kan worden gebruikt om meer informatie te verkrijgen over het gebruik van de aegis
programma.

-Lijst
Deze optie kan worden gebruikt om een ​​lijst met geschikte onderwerpen voor deze opdracht te verkrijgen.
De lijst is mogelijk algemener dan verwacht.

-Niet_Loggen
Deze optie kan worden gebruikt om het automatisch loggen van uitvoer en fouten uit te schakelen naar:
een bestand. Dit is vaak handig wanneer verschillende aegis-commando's in een shell worden gecombineerd
scripts.

-Project naam
Deze optie kan worden gebruikt om het gewenste project te selecteren. wanneer nee? -Project
optie is opgegeven, de AEGIS_PROJECT omgevingsvariabele wordt geraadpleegd. Indien
die niet bestaat, die van de gebruiker $HOME/.aegisrc bestand wordt onderzocht op een standaard
projectveld (zie aeuconf(5) voor meer informatie). Als dat niet bestaat,
wanneer de gebruiker alleen aan wijzigingen binnen een enkel project werkt, wordt het project
naam is standaard voor dat project. Anders is het een fout.

-TERZ
Deze optie kan worden gebruikt om ervoor te zorgen dat vermeldingen het absolute minimum aan
informatie. Het is meestal handig voor shellscripts.

Verbaasd
Deze optie kan worden gebruikt om ervoor te zorgen dat aegis meer output produceert. Standaard aegis
produceert alleen output bij fouten. Bij gebruik met de -Lijst optie deze optie
zorgt ervoor dat kolomkoppen worden toegevoegd.

-Wachten Deze optie kan worden gebruikt om Aegis-commando's te laten wachten op toegangsvergrendelingen, als:
ze kunnen niet onmiddellijk worden verkregen. Standaard ingesteld op de gebruiker lock_wait_preference
indien niet gespecificeerd, zie aeuconf(5) voor meer informatie.

-Nee wacht
Deze optie kan worden gebruikt om te eisen dat Aegis-commando's een fatale fout afgeven als toegang:
sloten kunnen niet direct worden verkregen. Standaard ingesteld op de gebruiker
lock_wait_preference indien niet gespecificeerd, zie aeuconf(5) voor meer informatie.

-Wit Uit
Deze optie kan worden gebruikt om te verzoeken dat verwijderde bestanden worden vervangen door een "whiteout"
bestand in de ontwikkelmap. Het idee is dat het compileren van zo'n bestand
resulteren in een fatale fout, zodat alle referenties gevonden kunnen worden. Dit is
meestal de standaard.

-Geen_WhiteOut
Deze optie kan worden gebruikt om te verzoeken dat er geen “whiteout”-bestand in de
ontwikkelingsmap.

Zie ook aegis(1) voor opties die alle aegis-commando's gemeen hebben.

Alle opties kunnen worden afgekort; de afkorting is gedocumenteerd als de hoofdletters,
alle kleine letters en underscores (_) zijn optioneel. U moet opeenvolgend . gebruiken
reeksen van optionele letters.

Alle opties zijn niet hoofdlettergevoelig, u kunt ze typen in hoofdletters of kleine letters of a
combinatie van beide, case is niet belangrijk.

Bijvoorbeeld: de argumenten "-project, "-PROJ" en "-p" worden allemaal geïnterpreteerd als de
-Project optie. Het argument "-prj" wordt niet begrepen, omdat consecutief
optionele tekens zijn niet meegeleverd.

Opties en andere opdrachtregelargumenten kunnen willekeurig worden gemengd op de opdrachtregel,
na de functiekiezers.

De GNU lange optienamen worden begrepen. Aangezien alle optienamen voor aegis zijn lang,
dit betekent het negeren van de extra leidende '-'. De "--optie=waarde"conventie is ook"
begrepen.

AANBEVOLEN ALIAS

De aanbevolen alias voor deze opdracht is
csh% alias aemv 'aegis -mv \!* -v'
sh$ aemv(){aegis -mv "$@" -v}

FOUTEN

Het is een fout als de wijziging niet in de wezen ontwikkelde staat.
Het is een fout als de wijziging niet is toegewezen aan de huidige gebruiker.
Het is een fout als een van beide bestanden al in de wijziging zit.

EXIT STATUS

De aegis commando wordt afgesloten met een status van 1 bij elke fout. De aegis commando zal alleen
sluit af met een status van 0 als er geen fouten zijn.

MILIEU VARIABELEN

Bekijk aegis(1) voor een lijst met omgevingsvariabelen die van invloed kunnen zijn op deze opdracht. Zien
aepconf(5) voor de projectconfiguratiebestanden project_specifiek veld voor hoe in te stellen
omgevingsvariabelen voor alle opdrachten die door Aegis worden uitgevoerd.

Gebruik aemv online met behulp van onworks.net-services