.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28) .\" .\" 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 turned on, 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 "EQUIVS-BUILD 1" .TH EQUIVS-BUILD 1 " " "19 Oct 2015" "Debian/GNU" .\" 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" equivs\-build \- make a Debian package to register local software .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBequivs-build [\-\-full|\-f] [\-\-arch=foo|\-a=foo] controlfile\fR .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBequivs-build\fR is a program that creates Debian packages which can be used to inform dpkg about locally installed packages and their dependencies. Also empty packages that just require other packages can be created with equivs. These can be used as \*(L"profile\*(R" packages which just mark other ones for installation. .PP Please note that this is a crude hack and if thoughtlessly used, it might possibly do damage to your packaging system. And please note as well that using it is not the recommended way of dealing with broken dependencies. Better file a bug report instead. .PP The control file has a structure like the control files in \*(L"real\*(R" Debian packages, but it doesn't have to define all keys, as default values will be used if you omit one. .PP There are several additional fields that can be used: .IP "Changelog:" 4 .IX Item "Changelog:" File to be used as the changelog .IP "Version:" 4 .IX Item "Version:" If you don't use a local changelog, equivs will create a dummy one. As the version of the package is defined in the changelog, equivs will assume the version 1.0. With this field, you can set an explicit version. .IP "Readme:" 4 .IX Item "Readme:" A file to be used as the \fI\s-1README\s0.Debian\fR file. You can use the strings \fB\f(CB@packagename\fB@\fR and \fB\f(CB@depends\fB@\fR to insert the package name and the dependency information used. .IP "Copyright:" 4 .IX Item "Copyright:" The copyright file to by used. If omitted, the \s-1GPL 2 \s0 will be used. .IP "Preinst: Postinst: Prerm: Postrm:" 4 .IX Item "Preinst: Postinst: Prerm: Postrm:" Maintainerscripts executed before/after installation/removal of the package. See the Debian developers reference for a description (package developers-reference). .IP "Multi-Arch:" 4 .IX Item "Multi-Arch:" Field specifying multiarch dependency status. Used exactly as in 'real' packages. Foreign: Satisfies dependencies for all architectures Same: Satisfies dependencies only for the same architecture Allowed: Can act as either Foreign or Same, as specified in the dependency .IP "Extra-Files:" 4 .IX Item "Extra-Files:" A comma-separated list of files to copy to the \&\fI/usr/share/doc/packagename\fR directory. .IP "Files:" 4 .IX Item "Files:" Files to be copied into some directory of the created package. Each line contains a source filename and a destination directory, space-separated. As with other multi-line headers, all lines but the first must be indented. Example: .Sp .Vb 2 \& Files: foo\-cron /etc/cron.d/ \& foo\-cron\-helper /usr/local/bin/ .Ve .IP "File:" 4 .IX Item "File:" Files to be copied into some directory of the created package, specified inline in the source control file. The field syntax is the name of the files to be created, followed by lines indented by 1 space denoting file content; leading space will be trimmed. An octal file mode may be specified after the filename; it defaults to 644, and will be normalised to 644 or 755. Example: .Sp .Vb 3 \& File: /usr/local/bin/true 755 \& #!/bin/sh \& exit 0 .Ve .PP See \fI/usr/share/doc/equivs/README.Debian\fR for more information. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\-\-full | \-f" 4 .IX Item "--full | -f" Do a complete build. \fBdebuild\fR will be called, that is, a full package will be built and signed, suitable for upload to the Debian servers. .Sp The \s-1ID\s0 used to signed is taken from, in that order, the user from the last entry of a supplied changelog, the Maintainer: field in the equivs control file, or the local username. .IP "\-\-arch | \-a" 4 .IX Item "--arch | -a" Build package for the specified architecture. Used e.g. for building packages for hurd under linux. \fBequivs-build\fR uses \&\fBdpkg-architecture\fR to provide this facility. .SH "DISTRIBUTION" .IX Header "DISTRIBUTION" Distribution is subject to the \s-1GNU\s0 public licence version 2. .SH "AUTHOR" .IX Header "AUTHOR" Martin Bialasinski .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fIequivs\-control\fR\|(1), /usr/share/doc/equivs/README.Debian