patpost - En ligne dans le Cloud

PROGRAMME:

Nom

pat - outils générateurs de correctifs

SYNOPSIS

caresse [ -ahmnV ] [ liste de fichiers ]
patcil [ -abfhnpqsV ] [ liste de fichiers ]
patiff [ -ahnV ] [ liste de fichiers ]
base de données [ -ahV ] [ liste de fichiers ]
journal de configuration [ -hnruV ]
patfaire [ -hV ]
envoi de brevet [ -hiquV ] [ liste de correctifs ] [ destinataires ]
notifier [ -hquV ] [ destinataires ]
patpost [ -hrV ] liste de correctifs groupes de discussion
patftp [ -hV ] [ liste de correctifs ]
nom de famille [ -ahnmV ] -v version [ liste de fichiers ]
claquement [ -ahV ] [ -o instantané ] [ liste de fichiers ]
patcol [ -achnmsCV ] [ -d annuaire ] [ -f mains ] [ -S casser ] [ liste de fichiers ]
nettoyer [ -ahnmV ] [ liste de fichiers ]
index paternel

DESCRIPTION

Pat et ses programmes associés génèrent des correctifs pour tout paquet qui a été stocké
sous RCS. Ces programmes cachent de nombreux détails de RCS qui vous gênent lorsque
construire et maintenir un paquet. Tout ce que vous avez à faire pour créer un nouveau patch est de
éditez vos fichiers, exécutez pat et fournissez des descriptions à RCS et dans le patch généré
déposer. Détails tels que comment initialiser un nouveau fichier RCS, ce que la chaîne de commentaire doit
be, comment créer une nouvelle branche, comment gérer les sous-répertoires, comment faire des différences et comment
organiser le fichier de correctif sont gérées automatiquement.

Avant d'utiliser l'un des programmes pat, vous devez initialiser votre package en exécutant packinit
dans le répertoire de niveau supérieur de votre package. Cela produit un fichier .package que tous les
les programmes dist utilisent.

Dans l'un des programmes qui veulent une liste de fichiers, si vous spécifiez -a à la place, tous les fichiers dans
MANIFEST.new sera traité. Dans tous les programmes qui veulent une liste de correctifs, un null
patchlist signifie le patch actuel. Vous pouvez utiliser des tirets, des virgules et des espaces pour délimiter
numéros de patch. Si le côté droit d'un trait d'union est la chaîne nulle, le niveau de patch actuel
est considérée comme la valeur maximale. Tous les programmes invoqués avec -h imprimera une petite utilisation
message avec la signification de chacune des options disponibles. Les -V option donne le courant
numéro de version.

Pat lui-même est un programme wrapper qui appelle patcil, patdiff et patmake. Habituellement, vous pouvez
invoquez simplement pat et ignorez tous les autres. Pat mettra à jour le fichier MANIFEST, si
nécessaire (ce sera une copie exacte du fichier MANIFEST.new, à condition qu'un MANIFEST
existait déjà), éventuellement en appelant patcil dessus.

Si vous spécifiez -n au lieu d'une liste de fichiers, pat trouvera tous les fichiers plus récents que
patchlevel.h, placez-vous dans un éditeur pour réduire la liste, puis utilisez cette liste de fichiers. Si
chaque fichier de la liste est supprimé, caresse sera avorté.

Patcil est utilisé pour faire un ci -l sur tous les fichiers répertoriés. (On suppose que vous voulez toujours
gardez vos fichiers extraits.) En plus de la -a interrupteur, il y a un -b interrupteur qui
effectue un archivage rapide d'un ensemble de fichiers. Au lieu d'appeler rcs sur chaque fichier, il appelle rcs
sur toute la liste des fichiers. Ceci est utile pour archiver une révision de tronc. Lorsque vous
enregistrez une nouvelle révision du tronc, vous pouvez également utiliser le -s drapeau qui
supprimez les anciennes entrées du journal RCS de la révision précédente afin que vous puissiez recommencer à zéro.
Vous devriez probablement aussi utiliser un -f qui est transmis au ci pour forcer inchangé
fichiers à archiver. Pour archiver une nouvelle révision de tronc, je dis

patcil -s -f -a

Patcil demandera l'entrée de journal au lieu de laisser ci le faire, et a un petit prompteur
intégré qui vous permet de manipuler le message de différentes manières. Tapez h pour une liste de
ce que tu peux faire. L'une des plus belles choses est que vous pouvez apparaître dans un éditeur,
éventuellement avec une liste diff des changements depuis le dernier patch, au cas où vous auriez
oublié ce que vous avez changé. Si vous tapez un CR comme première chose, il inclut le précédent
message de journal. Quittez le prompteur avec un CR.

Il y a deux façons différentes d'utiliser patcil. Vous pouvez soit appeler patcil vous-même, soit laisser
pat l'appeler pour toi. Peu importe combien de fois vous appelez patcil avant de lancer pat,
puisque patdiff sait avec quoi la dernière base de correctifs doit être comparée. Patcil peut être appelé
l'un de vos répertoires ; les autres programmes doivent être appelés dans votre répertoire racine (ou
dans les bogues, lorsqu'ils sont significatifs).

Lorsque vous créez un nouveau fichier à un niveau de patch donné, vous devez le patcher avec le -p
option. Sinon, il sera simplement enregistré en tant que nouvelle révision de tronc. Le nom du
sera ajouté au MANIFEST.new s'il n'y figure pas déjà. Si le nom est
trouvé avec une description, cette description sera transmise à rcs pour correctement
initialiser le fichier RCS.

Base de données peut être utilisé pour réinitialiser la base de correctifs à la version actuelle lorsque vous avez supprimé
la séquence de patch précédente et préparent un nouveau kit de distribution. Ce qu'il fait vraiment, c'est
un rcs -Nlastpat:REV, où REV est la révision actuelle. Si Patdiff explose et que tu veux
pour rétablir la base de correctifs sur une version précédente, vous devez appeler rcs -Nlastpat:REV
toi même.

Patrick fait réellement les différences qui entrent dans le patch, en comparant n'importe quelle version
-Nlastpat pointe vers la version la plus récemment enregistrée. Il met ensuite à jour -Nlastpat
pour pointer vers la version actuelle. Il laisse le diff assis dans le sous-répertoire bugs pour
patmake à ramasser. Il peut soit utiliser rcsdiff, soit une commande diff de votre choix spécifiée
lorsque vous exécutez packinit, au cas où votre diff est meilleur que rcsdiff.

Journal de configuration est invoqué par patfaire généralement, pour mettre à jour le ChangeLog fichier (ou quel que soit le nom qui
fichier a été donné lorsque vous avez exécuté emballer). Il rassemblera les messages de journal et lancera un
éditeur pour que vous puissiez effectuer les mises à jour nécessaires. Si vous avez configuré votre package pour également
inclure les journaux RCS dans le ChangeLog, une autre session d'éditeur sera lancée pour eux aussi.
Enfin, un journal final est construit en tant qu'entrée candidate pour ChangeLog, que vous pouvez également
modifier comme vous le souhaitez.

Lorsque vous n'avez pas configuré de ChangeLog fichier, journal de configuration ne recueillera que les informations
il doit passer à patfaire et sortira. Si vous souhaitez l'appeler vous-même, vous devez
le faire après au moins un succès patiff Cours. Je recommande d'utiliser le -n l'option le
la première fois, puis utilisez le -u option avec -n lors des exécutions suivantes pour recréer des fichiers
seulement en cas de besoin. Les -r option (qui remplace -u) empêche journal de configuration de recréer un
fichier existant, même s'il est obsolète.

Journal de configuration appellera patcil et votre patiff sur vos ChangeLog fichier (après avoir bourré le
entrée du journal des candidats que vous avez modifiée en haut du dossier), à moins que le
-n option. Cela signifie que le correctif publié sera mis à jour ChangeLog avec le patch actuel
informations, comme vous vous en doutez.

Patmake combine tous les éléments du correctif dans un seul fichier et invoque un éditeur afin que vous
pouvez ajouter le sujet et la description. Il jette tous vos messages de journal en tant que sujets et
comme Description, en supposant qu'il est plus facile de supprimer ce que vous ne voulez pas que
pour se souvenir de tout ce que vous avez fait. Vous voudrez également développer chaque élément dans la description
afin qu'ils ne se contentent pas de répéter les lignes Objet. Si tu as un ChangeLog fichier, cela doit avoir
déjà été fait, ou votre ChangeLog ne représentera pas avec exactitude ce qui est décrit dans
le correctif, étant donné qu'il a déjà été mis à jour lorsque patfaire rassemble tous les
pièces (voir la note sur journal de configuration au dessus de).

Les gros patchs seront divisés afin de garder la taille de chaque patch à une taille raisonnable. Cette
est géré automatiquement, vous n'avez donc pas à vous en soucier. La priorité de chaque patch
est simplement intuitif par patfaire, étant donné l'hypothèse que de petits changements ont une grande
priorité.

Patsend, patpost et patftp sont utilisés pour distribuer vos correctifs dans le monde. Envoi de brevet
envoie par courrier un ensemble de correctifs à un ensemble de destinataires. Les -u le commutateur ajoute tous les
utilisateurs enregistrés qui ont demandé que des correctifs leur soient envoyés, ainsi que les
destinataires spécifiés lors de l'exécution emballerL’ -i commutateur comprend des informations avec le
patch sur la façon dont l'utilisateur peut se désinscrire afin qu'il ne reçoive pas les futurs patchs
automatiquement ; c'est également la valeur par défaut lorsque le -u l'interrupteur est utilisé. Patpost publie un ensemble
de correctifs à un ensemble de groupes de discussion. Patftp copie simplement le patch dans votre ftp public
répertoire.

Patnotifier informe simplement les utilisateurs qu'un nouveau correctif a été publié afin qu'ils puissent
le récupérer par eux-mêmes sur un site d'archives ou par e-mail s'ils sont intéressés. Les
-u switch peut être utilisé pour inclure tous les utilisateurs actuellement enregistrés qui ont demandé
une telle notification. Le message inclut la priorité et la description du correctif, ainsi que
instructions sur la façon de demander automatiquement le correctif (qui ne fonctionnera que si vous avez
agent de messagerie installée).

Le envoi de brevet et votre notifier vous permet de modifier la liste d'adresses avant d'envoyer quoi que ce soit,
à moins que vous n'ajoutiez le -q option.

Nom de famille peut être utilisé pour marquer un ensemble de fichiers avec un nom symbolique (spécifié avec -v). Ce
définira le nom de la révision la plus récente de chaque fichier.

Patsnap obtiendra un instantané de votre version en créant un fichier SNAPSHOT (le nom peut être
changé via -o) répertoriant les noms de fichiers et le dernier numéro de révision RCS pour ce fichier.
De tels instantanés peuvent être utilisés pour identifier la version à un niveau de correctif aléatoire, puis
plus tard, vous pourrez le récupérer en alimentant le fichier d'instantané dans patcol.

patcol extraira une version verrouillée d'un fichier, éventuellement dans un autre répertoire
(spécifié avec -d, reflétant ainsi l'arbre de distribution). Tous les fichiers qui n'ont pas
L'homologue RCS (par exemple patchlevel.h) sera simplement copié par patcol. Ceci est utilisé par
makedist pour truquer la distribution avant de faire les kits. Par défaut, patcol ne fera pas
le traitement de l'extension du droit d'auteur, mais les clients aiment maquereau le forcer en utilisant son -C
option. Alternativement, vous pouvez forcer la copie de la version extraite dans un répertoire
En utilisant le -c interrupteur en conjonction avec -d (ou cet ancien commutateur est simplement ignoré).

patcol peut également prendre sa liste de fichiers à partir d'un fichier SNAPSHOT via le -S commutateur, auquel cas
il extraira les fichiers à l'aide de la version RCS spécifiée par le fichier d'instantané, telle que
un créé par claquement. Vous pouvez à la place spécifier -a, -m or -n d'utiliser respectivement tous les
fichiers dans MANIFEST.new, tous les fichiers modifiés (celui qui a été patciled), ou tout
les fichiers plus récents que patchlevel.h.

patclean supprimera les fichiers de travail après avoir vérifié toutes les modifications. Tu peux
restaure vos fichiers de travail en utilisant patcol.

Patindex peut être utilisé à partir du répertoire de niveau supérieur ou dans le bogues annuaire. Ce sera
lister tous les patchs et leurs Sujet: lignes. Ce programme connaît les correctifs compressés
et les décompressera lors de la production de la liste.

RCS COUCHE

Cette section décrit la couche RCS, au cas où quelque chose dans les outils se casse, afin que vous
peut réparer vos fichiers RCS et redémarrer l'opération.

Tous les outils de correctifs obtiennent le numéro de révision principal du tronc RCS de votre .paquet fichiers, disons
c'est 2.5. Puis, au moment où tu as couru emballer, vous avez choisi une branche pour les patchs,
généralement le numéro 1, ce qui signifie que toutes vos modifications seront stockées sur le RCS 2.5.1
branche. Les outils créeront la branche pour vous le moment venu.

Chaque dernière révision publiée est étiquetée avec un RCS dernier coup symbole. Quand le patch est construit
by patiff, la dernière version sur la branche 2.5.1 est comparée à celle étiquetée comme
dernier coup. C'est pourquoi vous pouvez émettre en toute sécurité plusieurs patcil avant de publier le patch
et encore tout arrangé. Bien sûr patiff va déplacer le dernier coup tag à la
dernière révision de branche après traitement d'un fichier donné.

Tous les messages du journal et les fichiers modifiés sont conservés dans votre bogues répertoire, en caché
fichiers (nom commençant par un point). Ces journaux seront collectés lorsque le correctif sera publié
et les fichiers modifiés sont utilisés par caresse's -m interrupteur.

Patrick rassemble ses morceaux de patch sous le bogues répertoire, dans les fichiers se terminant par un .nn
rallonge, où nn représente le niveau de patch actuel + 1. (qui sera le prochain
patchlevel quand le patch sera fait par patfaire, à moins qu'il ne soit trop grand pour tenir dans un seul
fichier).

Journal de configuration prépare un ensemble de fichiers pour patfaire: la .sabot fichier recueille les informations qui
ira sous la section Description: dans le patch, et .xlog ceux collectent les
ChangeLog entrée du candidat. Finalement, .rlog les fichiers stockent les informations RCS qui doivent être
inclus dans le ChangeLog, si demandé. Notez que les trois lignes les plus hautes sont des ordures et
sont ignorés par tous les outils gérant ces fichiers.

Pour démarrer une nouvelle ligne de base (c'est-à-dire pour changer le numéro de révision du tronc RCS), vous
besoin de réexécuter emballer et changer ce numéro. Ensuite, lancez un nouveau patcil, probablement avec le
-s, -a et votre -f choix...

Utilisez patpost en ligne en utilisant les services onworks.net