git.maemo.org Git - mafwsubrenderer/blob - gst-plugins-base-subtitles0.10/debian/HACKING.Debian

   1 Hacking GStreamer for Debian
   2 ============================
   3
   4 An addition to the README.Debian that has Debian package hacking notes.
   5
   6 Everything should now be versioned.
   7
   8 - To update dependencies edit debian/build-deps.in
   9
  10 - To rebuild package files from .in files:
  11
  12   debian/rules maint
  13
  14 - After a version update to check for missing files run:
  15
  16   debian/maint missing
  17   debian/maint missing-libs
  18   debian/maint missing-so
  19
  20 - To update package files edit gstreamer-foo then rebuild package files.  This
  21   will generate the gstreamerX.Y-foo file.  Also update debian/rules and
  22   debian/control.in as needed.
  23
  24 - The packaging tries to stay close of upstream choice. gstreamerX.Y-misc has
  25   most of the files, extra packages are made for the sinks and by group of
  26   depends (gnome, x, ...)
  27
  28 - Provide gstreamerX.Y-videosink and gstreamerX.Y-audiosink as needed.
  29
  30 - All interfaces and generic libraries go in libgstreamer-plugins, libraries
  31   with external dependencies have their own package such as libgstreamer-gconf.
  32
  33 - Applications go in gstreamerX.Y-plugins-base-apps
  34
  35
  36 File listing
  37 ------------
  38
  39 build-deps:
  40   - generated from "build-deps.in" in "rules
  41     debian/build-deps:":
  42     * "build-deps.in" lists build-depends for Debian main packages
  43   - serves generation with "control.in" and "mk.control" of "control" in
  44     "rules debian/control::"
  45 build-deps.in:
  46   - lists build-depends for Debian main packages
  47   - serves generation with "extra deps" of "build-deps" in "rules
  48     debian/build-deps:"
  49 changelog: handled classically
  50 compat: handled classically
  51 control:
  52   - generated for "rules maint"
  53   - generated from "control.in" and "build-deps" in "rules debian/control::":
  54     * "build-deps" lists build-depends to be inserted in "control
  55       Build-Depends:"
  56     * "control.in" serves of template for package descriptions of Debian main
  57       packages and makes use of special stanzas enclosed in "@" such as
  58       "@GST_ABI" which are replaced via sed in "rules debian/control::"
  59 control.in:
  60   - serves generation of "control" in "rules debian/control::" via "mk.control"
  61     called in "rules debian/control::"
  62   - template for package descriptions of Debian main packages and makes use of
  63     special stanzas enclosed in "@" such as "@GST_ABI" which are replaced via
  64     sed in "rules debian/control::"
  65 copyright: handled classically
  66 gstreamer-$plugin.install:
  67   - serves the generation of $gst_pkgname-$plugin.install (for example
  68     gstreamer-alsa.install serves the generation of gstreamerX.Y-alsa.install) in
  69     "rules pre-build::" via dynamic "@"-enclosed variables replacement
  70   - some plugins are handled specially and some special variables are available
  71 gstreamer-plugins-base-apps.install: this isn't really a plugin, but the
  72                                     gstreamerX.Y-plugins-base-apps package
  73 gstreamer-plugins-base-apps.manpages: man pages for the gstreamerX.Y-plugins-base-apps
  74                                 package
  75 HACKING.Debian: this file
  76 libgstreamer-plugins-base-dev.install libgstreamer-plugins-base.install: handled similarly has gstreamerX.Y-plugins-base-apps
  77 maint: makefile wrapping some targets of "rules" with some sh filtering
  78 mk.control:
  79   - Perl script serving the generation of "control" which reads "build-deps"
  80     and "control.in", and replaces the "BUILDDEPS" stanza with the build-deps
  81 patches: handled classically
  82 README.Debian: handled classically
  83 rules: handled classically, with special targets "maint:", and
  84        "debian/build-deps:"
  85 watch: handled classically
  86
  87 This file is the initial work of:
  88 David I. Lehn <dlehn@debian.org>  Tue, 13 Apr 2004 21:28:55 -0400
  89 and had some additions by:
  90 Loic Minier <lool@dooz.org>  Sun, 19 Jun 2005 19:04:58 +0200
  91 Sebastien Bacher <seb128@debian.org>  Wed, 14 Dec 2005 17:00:21 +0100