dpkg (1.18.25) stretch; urgency=medium
[dpkg] / man / deb-origin.man
CommitLineData
1479465f
GJ
1.\" dpkg manual page - deb-origin(5)
2.\"
3.\" Copyright © 2011 Matt Kraai <kraai@ftbfs.org>
4.\" Copyright © 2011 Guillem Jover <guillem@debian.org>
5.\"
6.\" This is free software; you can redistribute it and/or modify
7.\" it under the terms of the GNU General Public License as published by
8.\" the Free Software Foundation; either version 2 of the License, or
9.\" (at your option) any later version.
10.\"
11.\" This is distributed in the hope that it will be useful,
12.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
13.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14.\" GNU General Public License for more details.
15.\"
16.\" You should have received a copy of the GNU General Public License
17.\" along with this program. If not, see <https://www.gnu.org/licenses/>.
18.
19.TH deb\-origin 5 "%RELEASE_DATE%" "%VERSION%" "dpkg suite"
20.nh
21.SH NAME
22deb\-origin \- Vendor-specific information files
23.SH SYNOPSIS
24.BI %PKGCONFDIR%/origins/ filename
25.SH DESCRIPTION
26The files in \fB%PKGCONFDIR%/origins\fP can provide information about
27various vendors who are providing Debian packages.
28
29They contain a number of fields, or comments when the line starts with
30‘\fB#\fP’.
31Each field begins with a tag, such as \fBVendor\fP or \fBParent\fP,
32followed by a colon and the body of the field. Fields are delimited
33only by field tags. In other words, field text may be multiple lines
34in length, but the tools will join lines when processing the body of
35the field.
36
37The file should be named according to the vendor name.
38The usual convention is to name the vendor file using the vendor name
39in all lowercase, but some variation is permitted.
40Namely, spaces are mapped to dashes (‘\fB\-\fP’), and the file
41can have the same casing as the value in \fBVendor\fP field, or it can
42be capitalized.
43.SH FIELDS
44.TP
45.BR Vendor: " \fIvendor-name\fP (required)"
46The value of this field determines the vendor name.
47.TP
48.BI Vendor\-URL: " vendor-url"
49The value of this field determines the vendor URL.
50.TP
51.BI Bugs: " bug-url"
52The value of this field determines the type and address of the bug
53tracking system used by this vendor. It can be a mailto URL or a
54debbugs URL (e.g., debbugs://bugs.debian.org/).
55.TP
56.BI Parent: " vendor-name"
57The value of this field determines the vendor name of the vendor that
58this vendor derives from.
59.SH EXAMPLE
60.nf
61Vendor: Debian
62Vendor\-URL: https://www.debian.org/
63Bugs: debbugs://bugs.debian.org
64.fi
65.SH SEE ALSO
66.BR dpkg\-vendor (1)