| .TH dpkg\-gencontrol 1 "2011-08-14" "Debian Project" "dpkg utilities" |
| .SH NAME |
| dpkg\-gencontrol \- generate Debian control files |
| . |
| .SH SYNOPSIS |
| .B dpkg\-gencontrol |
| .RI [ option ...] |
| . |
| .SH DESCRIPTION |
| .B dpkg\-gencontrol |
| reads information from an unpacked Debian source tree and generates a |
| binary package control file (which defaults to debian/tmp/DEBIAN/control); |
| during this process it will simplify the relation fields. |
| .sp |
| Thus |
| .IR Pre\-Depends ", " Depends ", " Recommends " and " Suggests |
| are simplified in this |
| order by removing dependencies which are known to be true according to the |
| stronger dependencies already parsed. It will also remove any self-dependency |
| (in fact it will remove any dependency which evaluates to true given the |
| current version of the package as installed). Logically it keeps the |
| intersection of multiple dependencies on the same package. The order |
| of dependencies is preserved as best as possible: if any dependency |
| must be discarded due to another dependency appearing further |
| in the field, the superseding dependency will take the place of the |
| discarded one. |
| .sp |
| The other relation fields |
| .RI ( Enhances ", " Conflicts ", " Breaks ", " Replaces " and " Provides ) |
| are also simplified individually by computing the union of the various |
| dependencies when a package is listed multiple times in the field. |
| .sp |
| .B dpkg\-gencontrol |
| also adds an entry for the binary package to |
| .BR debian/files . |
| . |
| .SH OPTIONS |
| .TP |
| .BI \-v version |
| Sets the version number of the binary package which will be generated. |
| .TP |
| .BI \-V name = value |
| Set an output substitution variable. See \fBdeb\-substvars\fP(5) for |
| discussion of output substitution. |
| .TP |
| .BI \-T substvarsfile |
| Read substitution variables in |
| .IR substvarsfile ; |
| the default is |
| .BR debian/substvars . |
| This option can be used multiple times to read substitution variables from |
| multiple files. |
| .TP |
| .BI \-D field = value |
| Override or add an output control file field. |
| .TP |
| .BI \-U field |
| Remove an output control file field. |
| .TP |
| .BI \-c controlfile |
| Specifies the main source control file to read information from. The |
| default is |
| .BR debian/control . |
| .TP |
| .BI \-l changelogfile |
| Specifies the change log file to read information from. The |
| default is |
| .BR debian/changelog . |
| .TP |
| .BI \-f fileslistfile |
| Read or write the list of files to be uploaded here, rather than using |
| .BR debian/files . |
| .TP |
| .BI \-F changelogformat |
| Specifies the format of the changelog. By default the format is read |
| from a special line near the bottom of the changelog or failing that |
| defaults to the debian standard format. |
| .TP |
| .BI \-p package |
| Generate information for the binary package |
| .IR package . |
| If the source control file lists only one binary package then this |
| option may be omitted; otherwise it is essential to select which |
| binary package's information to generate. |
| .TP |
| .BI \-n filename |
| Assume the filename of the package will be |
| .I filename |
| instead of the normal package_version_arch.deb filename. |
| .TP |
| .BR \-is ", " \-ip ", " \-isp |
| These options are ignored for compatibility with older versions of |
| dpkg\-dev but are now deprecated. Previously they were used to tell |
| dpkg\-gencontrol to include the Section and Priority fields in the |
| control file. This is now the default behaviour. If you want to |
| get the old behaviour you can use the |
| .B \-U |
| option to delete the fields from the control file. |
| .TP |
| .BI \-P packagebuilddir |
| Tells |
| .B dpkg\-source |
| that the package is being built in |
| .I packagebuilddir |
| instead of |
| .BR debian/tmp . |
| This value is used to find the default value of the |
| .B Installed\-Size |
| substitution variable and control file field (using |
| .BR du ), |
| and for the default location of the output file. |
| .TP |
| .B \-O |
| Print the control file to standard output, rather than to |
| .B debian/tmp/DEBIAN/control |
| (or |
| .IB packagebuilddir /DEBIAN/control |
| if |
| .B \-P |
| was used). |
| .TP |
| .BR \-h ", " \-\-help |
| Show the usage message and exit. |
| .TP |
| .BR \-\-version |
| Show the version and exit. |
| . |
| .SH FILES |
| .TP |
| .B debian/control |
| The main source control information file, giving version-independent |
| information about the source package and the binary packages it can |
| produce. |
| .TP |
| .B debian/files |
| The list of generated files which are part of the upload being |
| prepared. |
| .B dpkg\-gencontrol |
| adds the presumed filenames of binary packages whose control files it |
| generates here. |
| . |
| .SH AUTHORS |
| Copyright \(co 1995-1996 Ian Jackson |
| .br |
| Copyright \(co 2000 Wichert Akkerman |
| .br |
| Copyright \(co 2007-2008 Rapha\[:e]l Hertzog |
| .sp |
| This is free software; see the GNU General Public Licence version 2 or later |
| for copying conditions. There is NO WARRANTY. |
