freeswitch/debian
Travis Cross 9b79922a51 Retry updating base image
If updating the base image fails, retry a few times.  If that doesn't
work, simply move on; the update usually fails because Debian is
updating its mirrors; it's not important that we be absolutely up to
date.
2012-06-25 08:55:48 +00:00
..
source debian: add new and vastly improved packaging for Debian 2012-05-05 11:54:05 +00:00
.gitignore debian: remove remnants of slimplayer as we're now packaging this under contrib 2012-05-11 02:03:58 +00:00
README.Debian debian: add instructions on how to quickly setup a demo system 2012-05-05 23:43:39 +00:00
README.source debian: document a better way to build packaging 2012-05-24 17:27:34 +00:00
bootstrap.sh debian: don't build mod_managed 2012-06-02 03:07:12 +00:00
changelog debian: version bump 2012-05-24 17:27:28 +00:00
compat debian: add new and vastly improved packaging for Debian 2012-05-05 11:54:05 +00:00
control-modules debian: package mod_say_fa (Say for Persian) 2012-05-23 23:42:36 +00:00
copyright debian: improve policy compliance on debian/copyright 2012-05-25 02:45:00 +00:00
docs debian: add new and vastly improved packaging for Debian 2012-05-05 11:54:05 +00:00
freeswitch-doc.docs debian: add new and vastly improved packaging for Debian 2012-05-05 11:54:05 +00:00
freeswitch-doc.install debian: add new and vastly improved packaging for Debian 2012-05-05 11:54:05 +00:00
freeswitch-mod-java.install.tmpl debian: install freeswitch.jar with mod_java 2012-05-15 07:19:51 +00:00
freeswitch-mod-pocketsphinx.install.tmpl debian: add new and vastly improved packaging for Debian 2012-05-05 11:54:05 +00:00
freeswitch-systemd.freeswitch.service debian: add new and vastly improved packaging for Debian 2012-05-05 11:54:05 +00:00
freeswitch-systemd.install debian: add new and vastly improved packaging for Debian 2012-05-05 11:54:05 +00:00
freeswitch-sysvinit.freeswitch.default debian: add new and vastly improved packaging for Debian 2012-05-05 11:54:05 +00:00
freeswitch-sysvinit.freeswitch.init debian: add remote_fs and required-stop to init 2012-05-06 19:13:49 +00:00
freeswitch.install debian: don't install scripts/ with freeswitch 2012-05-15 07:18:50 +00:00
freeswitch.postinst debian: whitespace 2012-05-06 22:46:36 +00:00
freeswitch.postrm debian: whitespace 2012-05-06 22:46:36 +00:00
freeswitch.preinst debian: whitespace 2012-05-06 22:46:36 +00:00
freeswitch.prerm debian: massage the prerm script to pass lintian 2012-05-07 16:17:11 +00:00
gbp.conf debian: don't force-create the orig tarball 2012-05-28 16:35:00 +00:00
libfreeswitch-dev.install debian: don't distribute .la file with libfreeswitch-dev 2012-05-09 23:15:03 +00:00
libfreeswitch1.install debian: separate out libfreeswitch1 2012-05-09 23:15:02 +00:00
rules debian: Add mechanism to set C/C++ compiler 2012-06-24 08:49:59 +00:00
util.sh Retry updating base image 2012-06-25 08:55:48 +00:00

README.source

FreeSWITCH for Debian
--------------

You may be reading this because you're wondering where all the files
are in debian/, such as control.

Because FreeSWITCH has so many modules it was necessary to create a
system to autogenerate the majority of the packaging.  This in done
mostly in the file debian/bootstrap.sh.  This bootstrap needs to run
before any other step of the packaging, though we do try to
autogenerate it when possible.

The build dependencies, runtime dependencies, and other details about
modules can be configured in the debian/control-modules file.  Even
though this file looks a bit like a debian control file and has a
similar format, we are parsing this file ourselves so the format is a
bit more restricted.

debian/control-modules currently supports the following fields:

  # lines that begin with the hash character are comments
  #
  # every block must start with a Module field
  Module: <category>/<module_name>
  Description: <short description>
   <long description> # empty lines with "."s are not yet supported
  Build-Depends: <build deps for this module>
  Depends: <runtime deps for this module>
  Recommends: <recommended packages>
  Suggests: <suggested packages>
  Distro-Conflicts: <distributions on which this module should not be built> # not yet implemented

During bootstrap we build a file control-modules.gen.  If the
control-modules file is properly formatted, this generated file should
be identical.  This is a sanity check mechanism for our parsing, as
well as a way to automatically reorganize the file.

If the file debian/modules.conf is present, we read that file and only
build and package the files listed there.  Otherwise, we build every
module except the ones that either should not be packaged, or for
which we don't yet have good packaging.

The format of debian/modules.conf is:

  ## comments should start with two hash characters
  <category>/<module_name>

To build this package, I recommend running the following from the root
directory of your FS git working tree:

  distro=sid
  ver="$(cat build/next-release.txt | sed -e 's/-/~/g')~n$(date +%Y%m%dT%H%M%SZ)-1~${distro}+1"
  git clean -fdx && git reset --hard HEAD
  ./build/set-fs-version.sh "$ver"
  git add configure.in && git commit -m "bump to custom v$ver"
  (cd debian && ./bootstrap.sh -c $distro)
  dch -b -m -v "$ver" --force-distribution -D "$suite" "Custom build."
  git-buildpackage -b -us -uc \
    --git-verbose \
    --git-pbuilder --git-dist=$distro \
    --git-compression-level=1v --git-compression=xz
  git reset --hard HEAD^

 -- Travis Cross <tc@traviscross.com>, Thu, 24 May 2012 16:35:57 +0000