Debian's policy is to keep the changelog entries pretty short. Debian changelogs are frequently just lots of 'Updated upstream version' entries, 'Closes bug' entries when there's a Debian bug that's patched because it's not fixed upstream yet, and packaging change notes. 'git log' or 'Docs/changelog' would be too verbose. The correct thing to do according to Debian policy would be to have a short 'Updated upstream version' entry and ship the docs/ChangeLog file so a more complete history can be found in the doc folder.<div>
<br><div><div><div><div>freeswitch/build/next-release.txt is pretty good at generating a version for Git versions, and I'd say sufficient.</div><div><br></div><div>The issue for me is specifically when tarball releases are rolled. I believe there's a script that's run to generate them? Could that update the debian/changelog file too? Submitting ChangeLog entries against a tarball won't work unless the developers are willing to recreate the tarball. If it only gets committed to Git then it's not going to make it into a tarball until the next release, at which point it'll be out of date.</div>
<div><br></div><div>-Steve</div><div><br><div><br></div><div><br><br><div class="gmail_quote">On 12 March 2013 14:37, Ken Rice <span dir="ltr"><<a href="mailto:krice@freeswitch.org" target="_blank">krice@freeswitch.org</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div>
<font face="Monaco, Courier New"><span style="font-size:11pt">There are 2 change logs already that can be used to update debian/changelog<br>
<br>
</span></font><ol><li><font face="Monaco, Courier New"><span style="font-size:11pt">git log (yes I know not really a changelog but it can be derived from there)
</span></font></li><li><font face="Monaco, Courier New"><span style="font-size:11pt">docs/ChangeLog this is the main changelog. Its not always 100% up to date but its there<br>
</span></font></li></ol><font face="Monaco, Courier New"><span style="font-size:11pt"><br>
If you wish to contribute patches to the ChangeLog please do so they are welcomed the main committers don’t always have time to update these things...<br>
<br>
One of the biggest things the project as a whole needs is dedicated documenters that will help with these things.<br>
<br>
K<div><div><br>
<br>
<br>
On 3/12/13 7:15 AM, "Steven Ayre" <<a href="http://steveayre@gmail.com" target="_blank">steveayre@gmail.com</a>> wrote:<br>
<br>
</div></div></span></font><blockquote><div><div><font face="Monaco, Courier New"><span style="font-size:11pt">Another big problem you're likely to get is that pbuilder expects debian/changelog to be kept updated. That's not practical for the number of commits Git gets, hence generating a new entry from next-release.txt + the date.<br>
<br>
IMO the release tarballs should get the debian/changelog updated for version releases - there is a Jira on that: <a href="http://jira.freeswitch.org/browse/FS-4778" target="_blank">http://jira.freeswitch.org/browse/FS-4778</a><br>
<br>
-Steve<br>
<br>
<br>
<br>
<br>
On 12 March 2013 12:59, Steven Ayre <<a href="http://steveayre@gmail.com" target="_blank">steveayre@gmail.com</a>> wrote:<br>
</span></font><blockquote><blockquote><font face="Monaco, Courier New"><span style="font-size:11pt">The second problem is that the build resulted in nearly 100 different *.deb files This also poses somewhat of an annoyance in automated deployment environments, for example saltstack, where the configuration would have to list each individual FreeSWITCH module. It also feels very untidy. I understand that certain packages (such as libfreeswitch, libfreeswitch-dev, freeswitch-server etc) should be separated. But having a package for each module, the only use I could think of for this, would be if the Debian package compiles absolutely every module possible, and is then linked dynamically, rather than compiled static. This means enabling/disabling modules would be a matter of simply adding/removing a package. However I'm not entirely convinced if this is what it is doing.. when compiling absolutely every package possible, FreeSWITCH will usually fail to compile, due to collision etc.<br>
</span></font></blockquote><font face="Monaco, Courier New"><span style="font-size:11pt"><br>
That's exactly what it's trying to do. It attempts to build every package, allowing you to install only what you need.<br>
<br>
Modules are created as .so packages that are loaded dynamically when FreeSWICH loads the module. They're all linked against the shared libfreeswitch library which provides the core API. Modules such as mod_sofia link statically against that library (so libsofia is in mod_sofia.so not freeswitch itself). Any system libraries used may be linked by the module dynamically (libjpeg by mod_spandsp etc).<br>
<br>
If you want to limit the modules built create a debian/modules.conf file and list them in there (same format as modules.conf). The debian/bootstrap.sh script reads that file and generates the packaging from that.<br>
<br>
<br>
</span></font><blockquote><font face="Monaco, Courier New"><span style="font-size:11pt">2) Are there any reasons to not be using pbuilder?<br>
</span></font></blockquote><font face="Monaco, Courier New"><span style="font-size:11pt"><br>
The debian/bootstrap.sh is probably the primary reason it doesn't play well with pbuilder - debian tools will often assume the packaging is usable without any bootstrap step.<br>
<br>
The bootstrap is necessary for two reasons: 1) it allows the module build list to be customised by the builder 2) it makes that list manageable by automating the package generation.<br>
<br>
<br>
-Steve<br>
<br>
<br>
<br>
On 12 March 2013 12:44, Cal Leeming [Simplicity Media Ltd] <<a href="http://cal.leeming@simplicitymedialtd.co.uk" target="_blank">cal.leeming@simplicitymedialtd.co.uk</a>> wrote:<br>
</span></font><blockquote><font face="Monaco, Courier New"><span style="font-size:11pt">Hey,<br>
<br>
So today I went to go and create a Debian package for FreeSWITCH using the existing packaging structure;<br>
<br>
<a href="https://github.com/traviscross/freeswitch/blob/master/debian/" target="_blank">https://github.com/traviscross/freeswitch/blob/master/debian/</a><br>
<a href="http://wiki.freeswitch.org/wiki/Debian_packages_buildscript" target="_blank">http://wiki.freeswitch.org/wiki/Debian_packages_buildscript</a><br>
<br>
The first problem is that neither the helper or the debian/ dir have been configured for compatibility with pbuilder, which makes it untidy/non-sane to place this onto an automated production build system (it also impacts security slightly due to untrusted external code being ran outside of a chroot - but that's possibly an entirely different debate).<br>
<br>
The second problem is that the build resulted in nearly 100 different *.deb files This also poses somewhat of an annoyance in automated deployment environments, for example saltstack, where the configuration would have to list each individual FreeSWITCH module. It also feels very untidy. I understand that certain packages (such as libfreeswitch, libfreeswitch-dev, freeswitch-server etc) should be separated. But having a package for each module, the only use I could think of for this, would be if the Debian package compiles absolutely every module possible, and is then linked dynamically, rather than compiled static. This means enabling/disabling modules would be a matter of simply adding/removing a package. However I'm not entirely convinced if this is what it is doing.. when compiling absolutely every package possible, FreeSWITCH will usually fail to compile, due to collision etc.<br>
<br>
So I have a couple of questions;<br>
<br>
1) Why are the modules separated into individual files? <br>
<br>
2) Are there any reasons to not be using pbuilder?<br>
<br>
I have also CC'd Travis Cross who appears to a major contributor on the Debian packaging code.<br>
<br>
Thanks<br>
<font color="#888888"><br>
Cal<br>
</font><br>
_________________________________________________________________________<br>
Professional FreeSWITCH Consulting Services:<br>
<a href="http://consulting@freeswitch.org" target="_blank">consulting@freeswitch.org</a><br>
<a href="http://www.freeswitchsolutions.com" target="_blank">http://www.freeswitchsolutions.com</a><br>
<br>
FreeSWITCH-powered IP PBX: The CudaTel Communication Server<br>
<a href="http://www.cudatel.com" target="_blank">http://www.cudatel.com</a><br>
<br>
Official FreeSWITCH Sites<br>
<a href="http://www.freeswitch.org" target="_blank">http://www.freeswitch.org</a><br>
<a href="http://wiki.freeswitch.org" target="_blank">http://wiki.freeswitch.org</a><br>
<a href="http://www.cluecon.com" target="_blank">http://www.cluecon.com</a><br>
<br>
FreeSWITCH-users mailing list<br>
<a href="http://FreeSWITCH-users@lists.freeswitch.org" target="_blank">FreeSWITCH-users@lists.freeswitch.org</a><br>
<a href="http://lists.freeswitch.org/mailman/listinfo/freeswitch-users" target="_blank">http://lists.freeswitch.org/mailman/listinfo/freeswitch-users</a><br>
UNSUBSCRIBE:<a href="http://lists.freeswitch.org/mailman/options/freeswitch-users" target="_blank">http://lists.freeswitch.org/mailman/options/freeswitch-users</a><br>
<a href="http://www.freeswitch.org" target="_blank">http://www.freeswitch.org</a><br>
<br>
</span></font></blockquote><font face="Monaco, Courier New"><span style="font-size:11pt"><br>
</span></font></blockquote></div></div><font face="Monaco, Courier New"><span style="font-size:11pt"><br>
<br>
<hr align="CENTER" size="3" width="95%"></span></font><div><font><font face="Consolas, Courier New, Courier"><span style="font-size:10pt">_________________________________________________________________________<br>
Professional FreeSWITCH Consulting Services:<br>
<a href="http://consulting@freeswitch.org" target="_blank">consulting@freeswitch.org</a><br>
<a href="http://www.freeswitchsolutions.com" target="_blank">http://www.freeswitchsolutions.com</a><br>
<br>
FreeSWITCH-powered IP PBX: The CudaTel Communication Server<br>
<a href="http://www.cudatel.com" target="_blank">http://www.cudatel.com</a><br>
<br>
Official FreeSWITCH Sites<br>
<a href="http://www.freeswitch.org" target="_blank">http://www.freeswitch.org</a><br>
<a href="http://wiki.freeswitch.org" target="_blank">http://wiki.freeswitch.org</a><br>
<a href="http://www.cluecon.com" target="_blank">http://www.cluecon.com</a><br>
<br>
FreeSWITCH-users mailing list<br>
<a href="http://FreeSWITCH-users@lists.freeswitch.org" target="_blank">FreeSWITCH-users@lists.freeswitch.org</a><br>
<a href="http://lists.freeswitch.org/mailman/listinfo/freeswitch-users" target="_blank">http://lists.freeswitch.org/mailman/listinfo/freeswitch-users</a><br>
UNSUBSCRIBE:<a href="http://lists.freeswitch.org/mailman/options/freeswitch-users" target="_blank">http://lists.freeswitch.org/mailman/options/freeswitch-users</a><br>
<a href="http://www.freeswitch.org" target="_blank">http://www.freeswitch.org</a><br>
</span></font></font></div></blockquote><span><font color="#888888"><font><font face="Consolas, Courier New, Courier"><span style="font-size:10pt"><br>
</span></font></font><font face="Monaco, Courier New"><span style="font-size:11pt">-- <br>
Ken<br>
<font color="#0000FF"><u><a href="http://www.FreeSWITCH.org" target="_blank">http://www.FreeSWITCH.org</a><br>
<a href="http://www.ClueCon.com" target="_blank">http://www.ClueCon.com</a><br>
<a href="http://www.OSTAG.org" target="_blank">http://www.OSTAG.org</a><br>
</u></font><a href="http://irc.freenode.net" target="_blank">irc.freenode.net</a> #freeswitch<br>
</span></font>
</font></span></div>
<br>_________________________________________________________________________<br>
Professional FreeSWITCH Consulting Services:<br>
<a href="mailto:consulting@freeswitch.org" target="_blank">consulting@freeswitch.org</a><br>
<a href="http://www.freeswitchsolutions.com" target="_blank">http://www.freeswitchsolutions.com</a><br>
<br>
FreeSWITCH-powered IP PBX: The CudaTel Communication Server<br>
<a href="http://www.cudatel.com" target="_blank">http://www.cudatel.com</a><br>
<br>
Official FreeSWITCH Sites<br>
<a href="http://www.freeswitch.org" target="_blank">http://www.freeswitch.org</a><br>
<a href="http://wiki.freeswitch.org" target="_blank">http://wiki.freeswitch.org</a><br>
<a href="http://www.cluecon.com" target="_blank">http://www.cluecon.com</a><br>
<br>
FreeSWITCH-users mailing list<br>
<a href="mailto:FreeSWITCH-users@lists.freeswitch.org" target="_blank">FreeSWITCH-users@lists.freeswitch.org</a><br>
<a href="http://lists.freeswitch.org/mailman/listinfo/freeswitch-users" target="_blank">http://lists.freeswitch.org/mailman/listinfo/freeswitch-users</a><br>
UNSUBSCRIBE:<a href="http://lists.freeswitch.org/mailman/options/freeswitch-users" target="_blank">http://lists.freeswitch.org/mailman/options/freeswitch-users</a><br>
<a href="http://www.freeswitch.org" target="_blank">http://www.freeswitch.org</a><br>
<br></blockquote></div><br></div></div></div></div></div>
</div>