man/deb-src-files.pod

   1 # dpkg manual page - deb-src-files(5)
   2 #
   3 # Copyright © 2016 Guillem Jover <guillem@debian.org>
   4 #
   5 # This is free software; you can redistribute it and/or modify
   6 # it under the terms of the GNU General Public License as published by
   7 # the Free Software Foundation; either version 2 of the License, or
   8 # (at your option) any later version.
   9 #
  10 # This is distributed in the hope that it will be useful,
  11 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 # GNU General Public License for more details.
  14 #
  15 # You should have received a copy of the GNU General Public License
  16 # along with this program.  If not, see <https://www.gnu.org/licenses/>.
  17
  18 =encoding utf8
  19
  20 =head1 NAME
  21
  22 deb-src-files - Debian distribute files format
  23
  24 =head1 SYNOPSIS
  25
  26 B<debian/files>
  27
  28 =head1 DESCRIPTION
  29
  30 This file contains the list of artifacts that are to be distributed via
  31 the B<.changes> control file.
  32
  33 The I<debian/files> file has a simple whitespace-delimited format.
  34
  35 =over
  36
  37 I<filename>
  38 I<section>
  39 I<priority>
  40 [
  41 I<keyword=value...>
  42 ]
  43
  44 =back
  45
  46 I<filename>
  47 is the name of the artifact to distribute.
  48
  49 I<section>
  50 and
  51 I<priority>
  52 correspond to the respective control fields available in the .deb.
  53 The allowed values are specific to each distribution archive.
  54
  55 I<keyword=value...>
  56 corresponds to an optional whitespace-delimited list of attributes for this
  57 entry.
  58 The only currently supported keyword is B<automatic> with value
  59 B<yes>, to mark automatically generated files.
  60
  61 =head1 NOTES
  62
  63 This file is not intended to be modified directly, please use one of
  64 B<dpkg-gencontrol> or B<dpkg-distaddfile> to add entries to it.
  65
  66 =head1 SEE ALSO
  67
  68 B<dpkg-genchanges>(1),
  69 B<dpkg-distaddfile>(1).