.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35) .\" .\" 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 "Config::Model::models::Dpkg 3pm" .TH Config::Model::models::Dpkg 3pm "2019-02-20" "perl v5.28.1" "User Contributed Perl Documentation" .\" 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" Config::Model::models::Dpkg \- Configuration class Dpkg .SH "DESCRIPTION" .IX Header "DESCRIPTION" Configuration classes used by Config::Model .PP Model of Debian source package files (e.g debian/control, debian/copyright...) .SH "Elements" .IX Header "Elements" .SS "my_config" .IX Subsection "my_config" This element contains a set of parameters to tune the behavior of this dpkg editor. You can for instance specify e\-mail replacements. These parameters are stored in ~/.dpkg\-meta.yml or ~/.local/share/.dpkg\-meta.yml. These parameters can be applied to all Debian packages you maintain in this unix account. \fI Optional. Type node of class Dpkg::Meta . \fR .SS "compat" .IX Subsection "compat" compat file defines the debhelper compatibility level. \fI Optional. Type integer. \fR .SS "control" .IX Subsection "control" Package control file. Specifies the most vital (and version-independent) information about the source package and about the binary packages it creates. \fI Optional. Type node of class Dpkg::Control . \fR .SS "rules \- package build rules" .IX Subsection "rules - package build rules" debian/rules is a makefile containing all instructions required to build a debian package. \fI Optional. Type string. \fR .IP "default value :" 4 .IX Item "default value :" #!/usr/bin/make \-f # See \fBdebhelper\fR\|(7) (uncomment to enable) # output every command that modifies files on the build system. #DH_VERBOSE = 1 .Sp # see \s-1EXAMPLES\s0 in \fBdpkg\-buildflags\fR\|(1) and read /usr/share/dpkg/* \&\s-1DPKG_EXPORT_BUILDFLAGS\s0 = 1 include /usr/share/dpkg/default.mk .Sp # see \s-1FEATURE AREAS\s0 in \fBdpkg\-buildflags\fR\|(1) #export \s-1DEB_BUILD_MAINT_OPTIONS\s0 = hardening=+all .Sp # see \s-1ENVIRONMENT\s0 in \fBdpkg\-buildflags\fR\|(1) # package maintainers to append \s-1CFLAGS\s0 #export \s-1DEB_CFLAGS_MAINT_APPEND\s0 = \-Wall \-pedantic # package maintainers to append \s-1LDFLAGS\s0 #export \s-1DEB_LDFLAGS_MAINT_APPEND\s0 = \-Wl,\-\-as\-needed .Sp # main packaging script based on dh7 syntax \&\f(CW%:\fR dh $@ .SS "changelog" .IX Subsection "changelog" Dummy changelog entry with a dummy date. Don't forget to change the version number. Use dch command to update. \fI Optional. Type string. \fR .PP Note: changelog is computed with .PP .Vb 1 \& $pkg_name (0.001\-1) UNRELEASED; urgency=medium \& \& * ... \& \& \-\- $name <$mail> Wed, 18 Jan 2017 18:28:23 +0100 .Ve .PP and with: .IP "\(bu" 4 \&\f(CW$mail\fR => \f(CW\*(C`! my_config email\*(C'\fR .IP "\(bu" 4 \&\f(CW$name\fR => \f(CW\*(C`! my_config fullname\*(C'\fR .IP "\(bu" 4 \&\f(CW$pkg_name\fR => \f(CW\*(C`! control source Source\*(C'\fR .SS "scan-copyright-patterns" .IX Subsection "scan-copyright-patterns" This parameter is used by \*(L"cme update dpkg-copyright\*(R". This command scans all source files to get copyright and license information. By default, the decision whether to scan a file or not is left to licensecheck. You can override this behavior using this parameter. .PP See \*(L"electing or ignoring files to scan\*(R" in Dpkg::Copyright::Scanner for more details. \fI Optional. Type node of class Dpkg::Copyright::ScanPatterns . \fR .SS "fill-copyright-blanks \- Provides missing copyright info for cme update" .IX Subsection "fill-copyright-blanks - Provides missing copyright info for cme update" This parameter is used by \*(L"cme update dpkg-copyright command\*(R". .PP Sometimes, upstream coders are not perfect: some source files cannot be parsed correctly or some legal information is missing. A file without copyright and license information is skipped. On the other hand, a file with either copyright or license missing will be used. Unfortunately, this will prevent a correct grouping and merging of copyright entries. Instead of patching upstream source files to fill the blank, you can specify the missing information in a special file. \fI Optional. Type node of class Dpkg::Copyright::FillBlanks . \fR .SS "fix.scanned.copyright" .IX Subsection "fix.scanned.copyright" Instructions to alter or set specific copyright entries in \&\*(L"debian/fix.scanned.copyright\*(R" file. Each line of this file follows the syntax described in Config::Model::Loader to modify copyright information. .PP See \*(L"Tweak copyright entries\*(R" in Config::Model::Dpkg::Copyright for more details. \fI Optional. Type string. \fR .SS "copyright \- copyright and license information" .IX Subsection "copyright - copyright and license information" copyright and license information of all files contained in this package. \fI Optional. Type node of class Dpkg::Copyright . \fR .SS "install" .IX Subsection "install" List the files to install into each package and the directory they should be installed to. \fI Optional. Type hash of node of class Dpkg::Install . \fR .SS "not-installed" .IX Subsection "not-installed" List the files that are deliberately not installed in any binary package. Paths listed in this file are (only) ignored by the check done via \-\-list\-missing (or \-\-fail\-missing). However, it is not a method to exclude files from being installed. Please use \-\-exclude for that. .PP Please keep in mind that dh_install will not expand wildcards in this file. \&\fI Optional. Type list of uniline. \fR .SS "source" .IX Subsection "source" \&\fI Optional. Type node of class Dpkg::Source . \fR .SS "clean \- list of files to clean" .IX Subsection "clean - list of files to clean" list of files to remove when dh_clean is run. Files names can include wild cards. For instance: .PP .Vb 4 \& build.log \& Makefile.in \& */Makefile.in \& */*/Makefile.in .Ve .PP \&\fI Optional. Type list of uniline. \fR .SS "bugfiles" .IX Subsection "bugfiles" \&\fI Optional. Type hash of node of class Dpkg::BugFiles . \fR .SS "package-scripts" .IX Subsection "package-scripts" \&\fI Optional. Type hash of node of class Dpkg::PackageScripts . \fR .SS "patches \- Debian patches applied to original sources" .IX Subsection "patches - Debian patches applied to original sources" Series of patches applied by Debian. Note that you cannot change the order of patches in the series. Use quilt for this task. Comments in series file are skipped and not shown in annotation. \fI Optional. Type hash of node of class Dpkg::Patch . \fR .SS "dirs \- Extra directories" .IX Subsection "dirs - Extra directories" This file specifies any directories which we need but which are not created by the normal installation procedure (make install DESTDIR=... invoked by dh_auto_install). This generally means there is a problem with the Makefile. .PP Files listed in an install file don't need their directories created first. .PP It is best to try to run the installation first and only use this if you run into trouble. There is no preceding slash on the directory names listed in the dirs file. \fI Optional. Type list of uniline. \fR .SS "docs" .IX Subsection "docs" This file specifies the file names of documentation files we can have \fBdh_installdocs\fR\|(1) install into the temporary directory for us. .PP By default, it will include all existing files in the top-level source directory that are called \s-1BUGS,\s0 README*, \s-1TODO\s0 etc. \fI Optional. Type list of uniline. \fR .SS "watch" .IX Subsection "watch" watch file used by uscan to monitor upstream sources. \fI Optional. Type string. \fR .SS "tests" .IX Subsection "tests" Debian \s-1CI\s0 test suite specification. See \s-1README\s0.package\-tests.rst for more details. \fI Optional. Type warped_node of class Dpkg::Tests . \fR .SH "SEE ALSO" .IX Header "SEE ALSO" .IP "\(bu" 4 cme .IP "\(bu" 4 Config::Model::models::Dpkg::BugFiles .IP "\(bu" 4 Config::Model::models::Dpkg::Control .IP "\(bu" 4 Config::Model::models::Dpkg::Copyright .IP "\(bu" 4 Config::Model::models::Dpkg::Copyright::FillBlanks .IP "\(bu" 4 Config::Model::models::Dpkg::Copyright::ScanPatterns .IP "\(bu" 4 Config::Model::models::Dpkg::Install .IP "\(bu" 4 Config::Model::models::Dpkg::Meta .IP "\(bu" 4 Config::Model::models::Dpkg::PackageScripts .IP "\(bu" 4 Config::Model::models::Dpkg::Patch .IP "\(bu" 4 Config::Model::models::Dpkg::Source .IP "\(bu" 4 Config::Model::models::Dpkg::Tests .SH "AUTHOR" .IX Header "AUTHOR" .IP "Dominique Dumont" 4 .IX Item "Dominique Dumont" .SH "COPYRIGHT" .IX Header "COPYRIGHT" .PD 0 .IP "2010\-2015 Dominique Dumont" 4 .IX Item "2010-2015 Dominique Dumont" .PD .SH "LICENSE" .IX Header "LICENSE" .IP "\s-1LGPL2\s0" 4 .IX Item "LGPL2"