.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "dpt-packagecheck 1" .TH dpt-packagecheck 1 "2023-02-24" "pkg-perl-tools 0.75" "Debian Perl packaging Tools" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" dpt\-packagecheck \-\- check package source for group policy consistency .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBdpt packagecheck\fR \-c \fIcheck-option\fR... .PP \&\fBdpt packagecheck\fR \-p \fIpackage\fR \fItop-directory\fR \fIcheck-option\fR... .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBdpt packagecheck\fR performs various checks of package sources and tries to correct them in accordance with the policies of the Debian Perl Group. .SS "Package selection options" .IX Subsection "Package selection options" \&\fBdpt packagecheck\fR can operate either on a single package, or on all packages maintained by the group. .PP To run the checks on all group packages, use the \fB\-c\fR option with working directory containing \fIpackages/\fR directory. .PP To run the checks on individual package, use \fB\-p\fR \fIpackage\fR \fItop-directory\fR, where \fItop-directory\fR is the directory containing the \fIpackages/\fR directory. .SS "Repository interaction" .IX Subsection "Repository interaction" If the \fB\-a\fR option is given, changes are committed to the repository by calling \f(CW\*(C`mr commit\*(C'\fR. .PP If the \fB\-n\fR option is given, no changes are committed. .PP If neither option is given, \fBdpt packagecheck\fR asks for confirmation before calling \f(CW\*(C`mr commit\*(C'\fR. .PP Note that \f(CW\*(C`mr commit\*(C'\fR also pushes the changes to the remote repository. .SS "Check selection options" .IX Subsection "Check selection options" .IP "\fB\-A\fR" 4 .IX Item "-A" Run all the checks. .IP "\fB\-V\fR" 4 .IX Item "-V" Add/fix \f(CW\*(C`Vcs\-Git\*(C'\fR and \f(CW\*(C`Vcs\-Browser\*(C'\fR fields in \fIdebian/control\fR and remove \&\f(CW\*(C`XS\-Vcs\-(Svn|Git|Browser)\*(C'\fR fields. .IP "\fB\-H\fR" 4 .IX Item "-H" Add \f(CW\*(C`Homepage\*(C'\fR field to \fIdebian/control\fR and remove \f(CW\*(C`Homepage\*(C'\fR pseudo-field. .IP "\fB\-M\fR" 4 .IX Item "-M" Check the \f(CW\*(C`Maintainer\*(C'\fR field of \fIdebian/control\fR and make sure it is \&\f(CW\*(C`Debian Perl Group \*(C'\fR. .IP "\fB\-D\fR" 4 .IX Item "-D" \&\fIdebian/control\fR: add \f(CW\*(C`${misc:Depends}\*(C'\fR to \f(CW\*(C`Depends\*(C'\fR. .IP "\fB\-d\fR" 4 .IX Item "-d" \&\fIdebian/copyright\fR: Substitute \f(CW\*(C`Format\-Specification\*(C'\fR \s-1URL\s0 for \s-1DEP\-5\s0 revisions to anonscm.debian.org \s-1URL.\s0 .IP "\fB\-P\fR" 4 .IX Item "-P" \&\fIdebian/control\fR: substitute occurrences of dependencies like \&\f(CW\*(C`perl (>= 5.6.0\-{12,16})\*(C'\fR with dependencies on \f(CW\*(C`perl\*(C'\fR without a version. .IP "\fB\-O\fR" 4 .IX Item "-O" \&\fIdebian/control\fR: replace \f(CW\*(C`perl\-modules\*(C'\fR with \f(CW\*(C`perl\*(C'\fR .IP "\fB\-W\fR" 4 .IX Item "-W" \&\fIdebian/watch\fR: change \s-1CPAN\s0 URLs to and update to ignore developer releases .IP "\fB\-C\fR" 4 .IX Item "-C" If \fB\-W\fR is given, create \fIdebian/watch\fR if it does not exist .IP "\fB\-R\fR" 4 .IX Item "-R" \&\fIdebian/rules\fR: rmdir /usr/\e{lib,share\e}/perl5 only if they exist; switch \f(CW\*(C`dh \-\-with foo \e$@\*(C'\fR to \f(CW\*(C`dh \e$@ \-\-with foo\*(C'\fR .IP "\fB\-Q\fR" 4 .IX Item "-Q" add \fIdebian/README.source\fR pointing to \fBquilt\fR\|(1)'s \fI\s-1README\s0.source\fR if the package uses quilt .SH "COPYRIGHT & LICENSE" .IX Header "COPYRIGHT & LICENSE" .IP "Copyright 2011\-2013, Salvatore Bonaccorso carnil@debian.org" 4 .IX Item "Copyright 2011-2013, Salvatore Bonaccorso carnil@debian.org" .PD 0 .IP "Copyright 2007, 2008, 2009, 2011 gregor herrmann gregoa@debian.org" 4 .IX Item "Copyright 2007, 2008, 2009, 2011 gregor herrmann gregoa@debian.org" .IP "Copyright 2007, 2008 Damyan Ivanov dmn@debian.org" 4 .IX Item "Copyright 2007, 2008 Damyan Ivanov dmn@debian.org" .IP "Copyright 2007 David Paleino d.paleino@gmail.com" 4 .IX Item "Copyright 2007 David Paleino d.paleino@gmail.com" .PD .PP Released under the terms of the \s-1GNU GPL\s0 version 2