aerm - Online in de cloud

PROGRAMMA:

NAAM

aegis verwijder bestand - voeg te verwijderen bestanden toe aan een wijziging

KORTE INHOUD

aegis -Bestand verwijderen bestandsnaam... [ optie...]
aegis -Bestand verwijderen -Lijst [ optie...]
aegis -Bestand verwijderen -Helpen

PRODUCTBESCHRIJVING

De aegis -Bestand verwijderen commando wordt gebruikt om bestanden die moeten worden verwijderd aan een wijziging toe te voegen. Het bestand
wordt toegevoegd aan de lijst met bestanden in de wijziging en wordt verwijderd uit de basislijn
op het moment van integratie.

Deze opdracht kan worden gebruikt om tests te verwijderen, niet alleen bronbestanden. Tests worden gewoon behandeld
zoals elk ander bronbestand, en zijn onderworpen aan hetzelfde proces.

Er wordt een bestand gemaakt in de ontwikkelmap met 1 KB willekeurige tekst. De
willekeurige tekst is zo weerzinwekkend dat de meeste compilers foutmeldingen zullen geven,
mocht er per ongeluk naar het bestand worden verwezen. Dit is vaak erg handig bij het verwijderen
bestanden opnemen.

U kunt een directorynaam specificeren om alle bestanden in de genoemde directorystructuur te verwijderen. Het is
een fout als er geen relevante bestanden zijn.

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 het toevoegen van een bestand logisch is
maakt ze ongeldig.

Wanneer de wijzigingsbestanden worden weergegeven (aegis -Lijst Wijzig_Bestanden -TERZ) de verwijderde bestanden zullen
verschijnen niet in de beknopte lijst. Evenzo, wanneer de projectbestanden worden weergegeven met een
expliciet wijzigingsnummer (aegis -Lijst Project_Bestanden -TERZ -Verandering N) geen van de wijzigingen
bestanden, inclusief de verwijderde bestanden, verschijnen niet in de beknopte lijst. Deze twee
functies zijn erg handig bij het aanroepen van aegis vanuit een DMT om de lijst met
bronbestanden.

De wereld de Type of a Dien in
Als u het type bestand wilt wijzigen (bijvoorbeeld van een testbestand naar een bronbestand, of vice
versa) je zou het als twee wijzigingen kunnen doen, door eerst te gebruiken aerm(1) in één verandering en dan
gebruik aenf(1) of aent(1) in een tweede wijziging, of u kunt beide stappen in dezelfde combineren
verandering. Vergeet niet om de te gebruiken aerm -geenwituit optie of je krijgt een zeer eigenaardige nieuwe
bestandssjabloon.

Kennisgeving
De remove_file_commando in het project config bestand wordt uitgevoerd, indien ingesteld. De project_bestand_‐
commando wordt ook uitgevoerd, indien ingesteld, en als er recentelijk een integratie heeft plaatsgevonden. 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.

Dien in Actie Aanpassing
Wanneer deze opdracht wordt uitgevoerd, worden eerst de wijzigingsbestanden vergeleken met de projectbestanden. Indien
er inconsistenties zijn, worden de bestandsacties als volgt aangepast:

create Als een bestand wordt aangemaakt, maar een andere wijzigingsset is geïntegreerd die ook
het bestand maakt, is de bestandsactie in de wijzigingsset die nog wordt ontwikkeld:
aangepast naar "wijzigen".

wijzigen Als een bestand wordt gewijzigd, maar een andere wijzigingsset is geïntegreerd die verwijdert
het bestand, de bestandsactie in de wijzigingsset die nog wordt ontwikkeld, is:
aangepast naar "creëren".

verwijderen Als een bestand wordt verwijderd, maar een andere wijzigingsset is geïntegreerd die verwijdert
het bestand, wordt het bestand verwijderd uit de wijzigingsset die nog wordt ontwikkeld.

OPTIES

De volgende opties worden begrepen:

-BAse_RElatief
Deze optie kan worden gebruikt om ervoor te zorgen dat relatieve bestandsnamen worden beschouwd als relatief ten opzichte van
de basis van de bronboom. Zien aeuconf(5) voor de corresponderende gebruiker
voorkeur.

-CUrrent_RElatief
Deze optie kan worden gebruikt om ervoor te zorgen dat relatieve bestandsnamen worden beschouwd als relatief ten opzichte van
de huidige map. Dit is meestal de standaardinstelling. Zien aeuconf(5) voor de
overeenkomstige gebruikersvoorkeur.

-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 aerm 'aegis -rm \!* -v'
sh$ aerm(){aegis -rm "$@" -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 het bestand niet bestaat in de baseline.
Het is een fout als het bestand al deel uitmaakt van de wijziging.

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 aerm online met onworks.net-services