man/deb-origin.pod

   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 =encoding utf8
  20
  21 =head1 NAME
  22
  23 deb-origin - Vendor-specific information files
  24
  25 =head1 SYNOPSIS
  26
  27 B<%PKGCONFDIR%/origins/>I<filename>
  28
  29 =head1 DESCRIPTION
  30
  31 The files in B<%PKGCONFDIR%/origins> can provide information about
  32 various vendors who are providing Debian packages.
  33
  34 They contain a number of fields, or comments when the line starts with
  35 ‘B<#>’.
  36 Each field begins with a tag, such as B<Vendor> or B<Parent>,
  37 followed by a colon and the body of the field.
  38 Fields are delimited only by field tags.
  39 In other words, field text may be multiple lines
  40 in length, but the tools will join lines when processing the body of
  41 the field.
  42
  43 The file should be named according to the vendor name.
  44 The usual convention is to name the vendor file using the vendor name
  45 in all lowercase, but some variation is permitted.
  46
  47 Namely (since dpkg 1.21.10), first, non-alphanumeric characters
  48 (‘B<[^A-Za-z0-9]>’) are mapped to dashes (‘B<->’), then the resulting
  49 name will be tried in sequence by lower-casing it, keeping it as is,
  50 lower-casing then capitalizing it (that is upper-casing the first character),
  51 and only capitalizing it.
  52
  53 In addition, for historical and backwards compatibility, the name will
  54 be tried keeping it as is without non-alphanumeric characters remapping,
  55 then the resulting name will be tried in sequence by lower-casing it,
  56 keeping it as is, lower-casing then capitalizing it, and only capitalizing it.
  57 And finally the name will be tried by remapping spaces to dashes (‘B<->’),
  58 then the resulting name will be tried in sequence by lower-casing it,
  59 keeping it as is, lower-casing then capitalizing it, and only capitalizing it.
  60
  61 But these backwards compatible module lookups will be removed during the
  62 dpkg 1.22.x release cycle.
  63
  64 =head1 FIELDS
  65
  66 =over
  67
  68 =item B<Vendor:> I<vendor-name> (required)
  69
  70 The value of this field determines the vendor name.
  71
  72 =item B<Vendor-URL:> I<vendor-url>
  73
  74 The value of this field determines the vendor URL.
  75
  76 =item B<Bugs:> I<bug-url>
  77
  78 The value of this field determines the type and address of the bug
  79 tracking system used by this vendor.
  80 It can be a mailto URL or a
  81 debbugs URL (e.g., debbugs://bugs.debian.org/).
  82
  83 =item B<Parent:> I<vendor-name>
  84
  85 The value of this field determines the vendor name of the vendor that
  86 this vendor derives from.
  87
  88 =back
  89
  90 =head1 EXAMPLE
  91
  92  Vendor: Debian
  93  Vendor-URL: https://www.debian.org/
  94  Bugs: debbugs://bugs.debian.org
  95
  96 =head1 SEE ALSO
  97
  98 L<dpkg-vendor(1)>.