cpan2dscp - En ligne dans le Cloud

PROGRAMME:

Nom

dh-make-perl - Créer des paquets source Debian à partir de modules Perl

SYNOPSIS

dh-make-perl [faire] {SOURCE_DIR | --cpan MODULE|DISTRIBUTION} choix...
dh-make-perl rafraîchissement {--seul } [répertoire]
dh-make-perl localiser Foo::Bar ...
cache d'actualisation dh-make-perl
dh-make-perl dump-config
aide de dh-make-perl
cpan2deb MODULE|DISTRIBUTION choix...
cpan2dsc MODULE|DISTRIBUTION choix...

DESCRIPTION

dh-faire-perl créera les fichiers requis pour construire un paquet source Debian à partir d'un Perl
module ou distribution CPAN. Cela fonctionne pour la plupart des packages simples et est également utile pour
démarrer avec l'empaquetage des modules Perl.

Vous pouvez spécifier un nom de module ou de distribution avec le commutateur --cpan et dh-faire-perl sera
téléchargez-le pour vous à partir d'un miroir CPAN, ou vous pouvez spécifier le répertoire avec le déjà
sources décompressées. Si ni --cpan ni un répertoire n'est donné en argument, dh-faire-perl
essaie de créer un package Perl à partir des données du répertoire courant.

Vous pouvez compiler et installer le paquet binaire Debian en utilisant "--build" et "--install"
commutateurs de ligne de commande.

If dh-faire-perl s'appelle comme

cpan2deb Foo::Bar

il se comporte comme

dh-make-perl faire --build --cpan Foo::Bar

If dh-faire-perl s'appelle comme

cpan2dsc Foo::Bar

il se comporte comme

dh-make-perl faire --build-source --cpan Foo::Bar

L'utilisation de ce programme n'est pas une excuse pour ne pas lire la documentation du développeur Debian,
y compris la politique Debian, la politique Debian Perl, le manuel d'empaquetage et ainsi de suite.

COMMANDES
a prendre une
Commande par défaut si aucune commande n'est donnée. Crée une débianisation à partir de zéro. Échoue
avec une erreur si debian/ répertoire existe déjà.

rafraîchir [répertoire]
Pour rafraîchir un paquet. "répertoire" par défaut le répertoire de travail actuel.
Rénovations debian/droit d'auteur, debian/règles, debian/compat en utilisant les modèles actuels.
Avant toute modification de ces fichiers, une copie de sauvegarde est créée avec un .bak
suffixe.

Ceci est utile lorsque debian/règles a été créé à l'aide d'anciens modèles et ne contient pas
beaucoup de personnalisations. Comme toujours, vous êtes fortement encouragé à vérifier si debian/règles
semble sain d'esprit.

"refresh" essaie également de mettre à jour les listes de dépendances dans debian / contrôle de META.yml. Il
crochets courtepointe(1) dans debian/règles et crée debian/README.source

Lors de la mise à jour debian/droit d'auteur dh-make-perl essaie d'être intelligent pour se souvenir des e-mails
adresses. Il obtient la liste des détenteurs de droits d'auteur et leurs e-mails pour debian/* de
les lignes de déconnexion dans debian/journal des modifications. Cependant pour autoriser les adresses e-mail
changeant, il recherche les lignes de changement de la forme

* Changement d'email : Debbie Devlin -> [email protected]

Alors maintenant "Debbie Devlin[email protected]>" sera utilisé dans le copyright au lieu de
"Debbie Devlin[email protected]>".

--seul | -o contrôle|droit d'auteur|docs|exemples|règles
Cette option permet de ne mettre à jour qu'un ou plusieurs fichier(s) dans le répertoire debian/
quand dh-faire-perl est exécuté en mode "rafraîchissement". Les noms de fichiers sont séparés par une virgule. Les
L'option peut être donnée plusieurs fois, en accumulant les arguments.

localiser MODULE
Essaie de localiser le paquet qui contient le Perl donné MODULEs.

Mise en situation :

dh-make-perl localise IPC::Run3 XML::Tidy

rafraîchir-cache
dh-faire-perl analyse les fichiers de contenu, récupérés par fichier apt(1) et stocke le résultat
dans une cachette. Le cache est actualisé automatiquement s'il est plus ancien que n'importe quel contenu
déposer. Cependant, si vous exécutez fichier apt(1) dans votre tâche cron nocturne, la première fois que vous exécutez
dh-faire-perl dans la journée, vous devrez attendre que la cache soit reconstituée. Avec
cette option, vous pouvez déplacer la recréation du cache vers la tâche cron, juste après "apt-file
mettre à jour".

Ne fait rien si le cache est plus récent que les fichiers de contenu.

dump-config
La configuration actuelle, y compris les paramètres par défaut, est imprimée sur le
sortie standard.

Utile pour remplir le fichier dh-make-perl.conf.

vous aider
Affiche de brèves informations d'utilisation.

OPTIONS
--apt-contents-dir dir
Emplacement du répertoire de contenu du fichier apt. La valeur par défaut est /var/cache/apt/apt-fichier

--cambre tout | tous
Cela permet de basculer entre les packages dépendants de l'architecture et les packages indépendants de l'architecture. Si --cambre n'est pas
utilisé, dh-faire-perl utilise des algorithmes relativement efficaces pour décider seul de cela.

--sauvegardes | --pas de sauvegardes
En mode "rafraîchir", créez des sauvegardes de debian/droit d'auteur ainsi que debian/règles avant
les écraser. Activé par défaut.

--basepkgs
Donne explicitement une liste de packages séparés par des virgules pour considérer les packages "de base" (c'est-à-dire
paquets qui devraient toujours être disponibles dans les systèmes Debian). Cette option est par défaut
"perl,perl-base" - il est utilisé pour vérifier les dépendances des modules. Si un module nécessaire est
dans le "basepkgs", il ne sera pas mentionné dans le champ "depends:" de "debian/control".

Si cette option est spécifiée, les packages par défaut mentionnés ci-dessus ne seront pas inclus
(mais seront mentionnés comme des dépendances explicites dans le package résultant). Vous pouvez, de
bien sûr, mentionnez vos propres modules et spécifiez explicitement les valeurs par défaut.

Notez que cette option doit être utilisée avec parcimonie et avec précaution, car elle peut conduire à
les packages ne peuvent pas être reconstruits en raison de dépendances non satisfaites.

--bdépend LA CONSTRUCTION DÉPEND
Spécifiez manuellement la chaîne à utiliser pour les dépendances de construction du module (c'est-à-dire,
les packages et leurs versions qui doivent être installés pour réussir
construire le paquet). Gardez à l'esprit que les packages générés par dh-faire-perl exigent
debhelper à spécifier en tant que dépendance de build. Même remarque que pour --depends s'applique
ici - à n'utiliser qu'en cas de besoin.

--bdependsi BUILD-DÉPEND-INDEP
Spécifiez manuellement la chaîne à utiliser pour les dépendances de construction du module pour
constructions indépendantes de l'architecture. Mêmes notes que pour les --depends et --bdepends
les options s'appliquent ici.

Notez que pour --depends, --bdepends et --bdependsi vous pouvez également spécifier que le
ne doit pas apparaître dans debian/rules (si vous le pensez vraiment, bien sûr ;-) ) par
en lui donnant une chaîne vide comme argument.

--construire
Construit le package binaire (c'est-à-dire le fichier .deb) après avoir configuré le répertoire du package.

NB : Cela ne construit qu'un paquet binaire (en appelant "fakeroot debian/rules binary") et
ne signe pas le colis. Il est destiné à une installation locale rapide d'un paquet, pas pour
créer un paquet prêt à être soumis à l'archive Debian.

--build-source
Construit le paquet source (c'est-à-dire les fichiers .dsc et .debian.tar.gz) après avoir défini le
répertoire de paquets vers le haut.

NB : Ceci ne construit qu'un paquet source (en appelant "dpkg-source -b") et ne signe pas
le paquet. Il est destiné à une installation locale rapide d'un paquet source à lancer
dans, par exemple, un pbuilder, pas pour créer un paquet source prêt à être soumis au
Archives Debian.

--se ferme BUG ITP
Spécifiez manuellement le numéro de bogue ITP que ce package ferme. S'il n'est pas donné, dh-faire-
perl essaiera de se connecter à bugs.debian.org pour récupérer le numéro de bogue approprié, en utilisant
WWW::Mécaniser.

--core-ok
Permet de construire des modules Perl de base. Par défaut, dh-faire-perl ne permettra pas de construire un
module fourni avec la bibliothèque Perl standard ; en précisant ce
option, dh-faire-perl les construira de toute façon.

Notez que, bien que cela ne soit pas probable, cela pourrait casser des éléments non liés dans votre
système - si une version plus récente d'un module principal casse l'API, toutes sortes de démons
ça risque de s'énerver ;-)

--cpan MODULE|DISTRIBUTION
Instruit dh-faire-perl pour récupérer et extraire le module ou la distribution CPAN donné.
Fonctionne à la fois avec "Foo::Bar" et "Foo-Bar".

--cpan-miroir MIROIR
Spécifie un site CPAN à utiliser comme miroir.

--data-dir ANNUAIRE
Utilisez un autre répertoire de données, au lieu du répertoire par défaut, "/usr/share/dh-make-perl"

Le répertoire de données est dh-faire-perl recherche ses règles par défaut.* modèles. Il est
similaire à --home-dir, mais ne modifie pas l'emplacement du cache de contenu APT
déposer. Si les deux sont donnés, --home-dir a la priorité.

--dépend DÉPEND
Spécifiez manuellement la chaîne à utiliser pour les dépendances du module. Cela devrait être
utilisé lors de la construction de modules où dh-faire-perl ne peut pas deviner les dépendances de Perl (comme
en tant que modules construits à l'aide de Module::Install), ou lorsque le code Perl dépend de non-Perl
binaires ou bibliothèques. D'habitude, dh-faire-perl déterminera les dépendances en
lui-même. Si vous devez passer dh-faire-perl informations de dépendance, vous devez le faire en utilisant
le format de paquet Debian. c'est à dire

dh-make-perl -- dépend de libtest-more-perl

--desc SHORT DESCRIPTION
Utilise l'argument --desc comme brève description du package.

--dh VERSION
Définissez le niveau de compatibilité debhelper souhaité. La valeur par défaut est 8 pour l'architecture-
les packages indépendants et 9 pour les packages dépendants de l'architecture (XS).

Depuis la version 0.77, dh-faire-perl ne prend en charge que les niveaux de compatibilité debhelper > = 8.

See debhelper (1).

--dist DISTRIBUTION
Limitez les distributions dont les fichiers "Contents" sont analysés. L'argument est un
nom de diffusion.

Par défaut : vide, ce qui signifie aucun filtrage.

Mise en situation :
dh-make-perl --dist gravure

--e-mail | -e E-MAIL
Spécifiez manuellement l'adresse e-mail du responsable à utiliser dans debian/control et dans
debian/journal des modifications.

--exclure | -i [REGEX]
Cela vous permet de spécifier un PCRE pour exclure certains fichiers de la recherche de docs et
des trucs comme ça. Si aucun argument n'est donné (mais le commutateur est spécifié - sans spécifier
le commutateur inclura tout), il utilise par défaut les valeurs par défaut de dpkg-source.

--installer
Installe le package fraîchement construit. Spécifier --install implique --build - Le paquet
ne sera pas installé à moins qu'il n'ait été construit (évidemment ;-) )

--intrusif
Lors de la détermination des dépendances de module, si Module::Depends échoue, réessaye avec
Module::Dépend::Intrusif. M:D:I charge tous les fichiers .pm, interceptant le chargement des autres
modules, exécutant efficacement du code non fiable en votre nom. Utiliser avec précaution.

--réseau
Permet d'interroger les listes Debian WNPP pour ITP et les bogues similaires. Activé par défaut,
utilisez "--no-network" pour désactiver.

--note
Cette option pour ne pas exécuter le test automatique du module dans le cadre de la construction
le script a été supprimé en 0.54. Veuillez mettre nocheck dans le DEB_BUILD_OPTIONS
variable d'environnement si vous souhaitez ignorer les tests lors de la construction d'un package.

--home-dir ANNUAIRE
Où sont stockés les contenus APT et autres caches.

Valeur par défaut: ~/.dh-make-perl

--nom du paquet | -p NOM DU PAQUET
Spécifiez manuellement le nom du package, utile lorsque le module a des tirets dans son nom.

--pkg-perl
Utile lors de la préparation d'un paquet pour le groupe Debian Perl
<http://pkg-perl.alioth.debian.org>.

Définit les champs "Maintainer", "Uploaders", "Vcs-Git" et "Vcs-Browser" dans debian / contrôle
par conséquent. De plus, lorsque "--vcs git" est utilisé (valeur par défaut), configure une télécommande Git
pointant au bon endroit sur git.debian.org.

--recursive
Valable uniquement en mode "make" avec "--cpan" ou annuaire arguments. Fait en sorte que dh-make-perl
essayez de créer des packages (et éventuellement de compiler et d'installer les packages si "--build" et
Les options "--install" sont également fournies) pour toutes les dépendances qui manquent de packages.

Cela fonctionne comme ceci : lorsque le package 'principal' est construit, tous les packages manquants sont
mis dans une liste, puis la procédure de debianisaion est exécutée tour à tour sur chacun d'eux,
récursivement.

--requiredeps
Échec si un package Perl de dépendance n'a pas été trouvé (le suivi des dépendances nécessite l'apt-
package de fichiers installé et mis à jour)

--format-source le format
Lors de la création ou de l'actualisation de l'emballage, utilisez le format source spécifié. Par défaut à
"3.0 (couette)".

--liste-sources DOSSIER
Demander à l'analyseur de fichiers "Contents" d'utiliser ceci filet pour déterminer si un fichier donné
doit être analysé ou non. Fichiers de contenu ne correspondant à aucune ligne dans sources.list ne sont pas
analysé afin de vous faire gagner du temps en analysant les anciens fichiers des miroirs que vous n'utilisez plus.

Par défaut : valeur par défaut d'apt.

--vcs VCS
In --pkg-perl mode, utilisez le système de contrôle de version spécifié dans le Vcs-*
des champs. La valeur par défaut est "git".

If VCS est "git", "dh-make-perl" va configurer un dépôt Git avec trois branches :

en amont
La branche initiale contenant les sources en amont

maître
La branche où se fait le conditionnement, bifurquée "en amont" et avec le contenu de
le répertoire "debian/" a été ajouté.

goudron vierge
Une branche à garder goudron vierge(1) données.

If --pkg-perl est également donné, une télécommande "origine" est ajoutée pointant vers le référentiel sur
git.debian.org.

--verbeux | --non-verbeux
Imprimez des informations supplémentaires pendant le traitement.

--verbose est activé par défaut en mode "make", désactivé dans le cas contraire.

--version VERSION
Spécifie la version du package résultant.

Utilisez cpan2dscp en ligne à l'aide des services onworks.net