pkgkde-vcs - Online in de Cloud

PROGRAMMA:

NAAM

pkgkde-vcs - een hulpprogramma voor Debian pkg-kde VCS-repository's.

KORTE INHOUD

pkgkde-vcs [-jij] subcommando [ SUBCOMMANDO OPTIES ] [ -- EXTERNE TOOL OPTIES ]

pkgkde-git [-jij] subcommando [ SUBCOMMANDO OPTIES ] [ -- EXTERNE TOOL OPTIES ]

PRODUCTBESCHRIJVING

pkgkde-vcs is een hulpmiddel dat tot doel heeft een aantal bijbehorende routinetaken te vereenvoudigen
met verpakkingsbeheer in repository's van versiebeheersystemen (VCS). pkgkde-vcs
ondersteunt op transparante wijze VCS'en die worden gebruikt door Debian Qt/KDE-onderhoudsgroepen die verschillende VCS inpakken
gerelateerde opdrachtreeksen in een handige CLI-interface. Houd er rekening mee dat deze helper
dwingt de best practices en verpakkingsconventies af die zijn aangenomen door de Qt/KDE-onderhouder van Debian
groepen en daarom mag het niet worden beschouwd als een verpakkingshulpmiddel voor algemene doeleinden.

pkgkde-vcs moet worden uitgevoerd vanuit de volledig uitgecheckte verpakkingsrepository van het pakket waarin het zich bevindt
hoort te handelen. Ten eerste probeert het een VCS te detecteren die voor het specifieke gebruik wordt gebruikt
packing in de werkmap. Houd er rekening mee dat de detectie mogelijk mislukt als
onderliggende VCS-hulpprogramma's zijn niet geïnstalleerd. Als u een specifieke VCS wilt of moet forceren
type, voer de opdracht uit als pkgkde-$vcsBijvoorbeeld pkgkde-git.

Als de detectie succesvol is, pkgkde-vcs voert taken uit zoals gedefinieerd voor het opgegeven doel
subcommando (bijvoorbeeld label). Voor elke VCS en elke VCS kunnen verschillende sets subopdrachten worden gedefinieerd
van hen zou een andere set kunnen accepteren SUBCOMMANDO OPTIES (zie hieronder). Allemaal lokaal
niet-herkende subopdrachtopties (of degene die zijn opgegeven als EXTERNE TOOL OPTIES na --)
wordt doorgegeven aan de externe VCS-tool(s) die pkgkde-vcs uitvoert om het werk te doen.

pkgkde-vcs accepteert er een paar gemeenschappelijk opties die op de helper als geheel van toepassing zijn of zijn
gemeenschappelijk voor alle VCS'en die het ondersteunt. Ze zouden eerder moeten worden gepasseerd subcommando om te zijn
erkend.

Zelfs als pkgkde-vcs voert uitgebreide gezondheidschecks uit voordat hij iets doet, een onderliggende
opdracht die het uitvoert, kan nog steeds mislukken. Dan pkgkde-vcs wordt mogelijk onmiddellijk beëindigd
de repository in een inconsistente staat achterlatend. Het is aan een gebruiker om hiervan te herstellen
mislukking.

Op het moment, pkgkde-vcs ondersteunt alleen Git VCS.

OPTIES

Gemeen opties
-y Standaard wordt de eerste externe opdracht uitgevoerd die wijzigingen aanbrengt in het
repository moet expliciet door de gebruiker worden bevestigd. Als deze optie echter wel bestaat
opgegeven, wordt de eerste opdracht zonder bevestiging uitgevoerd.

-n Voer geen externe opdrachten uit die wijzigingen in de repository aanbrengen. Handig bij
-v om te zien welke opdrachten met welke opties zouden worden uitgevoerd.

-v Wees uitgebreider (toon bijvoorbeeld externe opdrachten terwijl ze worden uitgevoerd).

-- EXTERNE TOOL OPTIES
Pass extra EXTERNE TOOL OPTIES naar de externe commando's pkgkde-vcs wordt uitgevoerd
om de taak te volbrengen. Zie documentatie van de specifieke subcommando meer
details.

ONDERSTEUNDE VERSIE CONTROL SYSTEMS EN SUBCOMMANDO'S

Git
Om te kunnen gebruiken pkgkde-vcs met Git, git(1) moet beschikbaar zijn in PATH. Kale Git
repository's worden niet ondersteund en de Git-repository zou de status volledig uitgecheckt moeten hebben
(behalve klonen). De volgende subopdrachten voor Git-opslagplaatsen worden ondersteund op de
moment:

klonen Kloon de opgegeven pkg-kde git-repository. Dit subcommando moet worden gespecificeerd door
VCS dwingen naar git, dat wil zeggen door te draaien pkgkde-git commando in plaats van pkgkde-vcs.

De repository moet relatief ten opzichte van de root van de officiële pkg-kde worden opgegeven
opslagboom. Zodra de bewerking is voltooid, wordt de gekloonde repository geplaatst
dezelfde relatieve locatie op het lokale bestandssysteem en update-config (Zie hieronder)
zal daarop worden uitgevoerd.

Om bijvoorbeeld de kde4libs-repository te klonen van kde-sc, akonadi-repository
vanaf kde-req en pkg-kde-tools repository vanuit de root tree, voer het volgende uit:

$ pkgkde-git kloon kde-sc/kde4libs

$ pkgkde-git kloon kde-req/akonadi

$ pkgkde-git kloon pkg-kde-tools

label Tag de huidige verpakkingsstatus (HEAD) als upload naar het Debian-archief. Repository werkt
tree moet schoon zijn voordat deze subopdracht wordt uitgevoerd. Huidige pakketversie en
doelverdeling worden automatisch bepaald debian/changelog.
De distributie moet een geldige Debian-suite zijn om te voorkomen dat de distributie niet voltooid is
(ook bekend als UNRELEASED) herzieningen.

Het subcommando zal een geannoteerde Git-tag aanmaken onder de naamruimte "debian/". De
subcommando zelf accepteert geen extra opties. Alle EXTERNE TOOL OPTIES
(indien gespecificeerd) en wordt doorgegeven aan git label aanroeping. Het wordt aanbevolen om te ondertekenen
tags door op te geven -s optie.

De tag gemaakt door pkgkde-vcs label zal aan de volgende eisen voldoen:

· De tag krijgt de naam "debian/ " waar is een volledige debian
pakketversie zonder tijdperk. Alle exemplaren van het teken ~ in
zal vervangen worden door het - karakter omdat Git dit niet ondersteunt
~ teken in tagnamen.

· De tag krijgt het bericht toegewezen met inhoud zoals
/ " waar is een volledige debian-versie van het
pakket (zonder enige wijzigingen, inclusief tijdperk) en is
de distributie waarin dit pakket is geüpload.

Een standaard bijvoorbeeld pkgkde-vcs label zal het volgende onder de motorkap uitvoeren
(ervan uitgaande dat de versie 1:2.3.4-5 is en de distributie experimenteel is):

$ git tag debian/2.3.4-5 -m "1:2.3.4-5/experimenteel"

update-config
Voer een algemene configuratie uit in de uitgecheckte verpakkingsrepository. Bij de
moment voert het subcommando het volgende uit:

· Stel masterbranch- en debian-tags in voor pushen. -f optie kan worden opgegeven
om een ​​update van de push-configuratie te forceren, zelfs als er wat wordt gepusht
configuratie bestaat al.

· Stel de gebruikersnaam en het e-mailadres van de repository in op de waarden van de DEBVOLLE NAAM
en DEBEMAIL omgevingsvariabelen respectievelijk. -f optie kan worden opgegeven
om de waarden te overschrijven, zelfs als er in de repository al enkele zijn opgegeven.

Gebruik pkgkde-vcs online met behulp van onworks.net-services