71 lines
2.8 KiB
Text
71 lines
2.8 KiB
Text
The vendor system in APT is an experiment to help distributions ship a stock
|
|
apt release instead of applying documentation patches to it, increasing
|
|
maintenance burden for everyone and hiding 'interesting' patches in the mix.
|
|
|
|
The provided information is used in documentation like man pages and
|
|
example configuration files. If you have patches modifying additional
|
|
bits and pieces currently not covered by this system please contact us
|
|
so we can change this!
|
|
|
|
|
|
== Adding a new vendor
|
|
|
|
In the same directory you found this README in you should create a new
|
|
directory with the name of your distribution (as defined by dpkg-vendor,
|
|
e.g. via "dpkg-vendor --query Vendor"). The name is case-insensitive,
|
|
but ensure that the name is otherwise correct and the other fields in
|
|
your deb-origin(5) file are correct as well as our buildsystem relies on
|
|
this information.
|
|
|
|
If no information is found for the current vendor at buildtime, the system
|
|
looks for a vendor the current vendor is a derivative of, falling back to
|
|
Debian if all else fails.
|
|
|
|
The directory should include 2 files at the moment. It is best to look
|
|
at the files of other distributions to understand what values are to be
|
|
expected. Some additional notes about them can be found below.
|
|
|
|
If we happen to include new fields/files in this system, we will opt for
|
|
using a sensible default rather than failing the build or similar, so
|
|
you are recommend to watch this space.
|
|
Ensure also that your information is up-to-date!
|
|
|
|
Contributing a new vendor as well as updating a existing one is best done
|
|
by opening a bug in the Debian BTS against apt with a patch attached.
|
|
|
|
|
|
== apt-vendor.ent
|
|
|
|
The format used is the one DocBook XML uses. The file is included as an
|
|
entity file in the manpages xml source, so the syntax has to be valid!
|
|
|
|
The keyring-package setting is used as a dependency for apt.
|
|
|
|
The field current-codename is optional and can be used in sources.list.in.
|
|
|
|
The fields sourceslist-list-format and sourceslist-sources-format are used as
|
|
examples in the sources.list manpage and the first one is additionally
|
|
available in the sources.list.in template.
|
|
They should in general reflect the default sources of your distro.
|
|
|
|
== sources.list.in
|
|
|
|
An example for a sources.list which will be shipped in /usr/share/doc.
|
|
This file will NOT be installed in /etc or otherwise used by apt.
|
|
|
|
You can use some placeholders in this file, namely:
|
|
* &debian-stable-codename;
|
|
* &debian-oldstable-codename;
|
|
* &debian-testing-codename;
|
|
* &ubuntu-codename;
|
|
* &sourceslist-list-format;
|
|
with the value you would expect based on the name.
|
|
|
|
The placeholder ¤t-codename; is yours and can be set in apt-vendor.ent
|
|
|
|
|
|
== apt.conf-*
|
|
|
|
Files in your vendor directory following this naming scheme will be picked up
|
|
by the debian/rules file and installed in /etc/apt/apt.conf.d/ directory, with
|
|
"apt.conf-" removed from the beginning of the filename.
|