[Pkg-crosswire-devel] Sword packaging status 2008-01-24

[Jonathan Marsden]

We're at end of day one.  Here is our status as I see it.

I've built and uploaded 4 (!) versions of an updated Sword package to my
PPA.  All of them build fine.  I think I've addressed all
comments/issues raised by my first attempt, except that I have left ICU
in there until we make a firm decision on whether or not it should
really be there.

Of Peter Kaehne's original list of items that brought this team into
existence:

> 1) libsword is at 1.5.11 - if you wait a couple of weeks probably at
> 1.5.12.  You keep 1.5.9. 1.5.9 is nearly 2 years old. The functional
> increase is massive.

Fixed: new package is based on 1.5.11

> 2) libsword should be compiled with ICU to allow it full function. It is
> not.

Fixed, but now somewhat disputed, this needs further discussion.

> 3) you should not maintain sword modules as all our programmes have a
> module manager which will download modules directly. Installing modules
> via apt-get renders the module manager non-functional as the modules are
> installed by apt-get into non user writable areas (/usr/share/sword
> instead of ~/.sword)

Disagreed with.  This is a module manager bug, it can't handle modules
installed in places it has no write access to -- it doesn't ask for sudo
permissions when it could do so to obtain such access.  And since
/usr/share/sword is stated by docs in the upstream tarball as being one
standard location for modules, installing them there cannot be a
packaging issue :)

> 4) diatheke is a commandline utility which can if carefully handled also
> be used as a base for CGI script. The example CGI code coming along with
> it is not meant to be exposed to the internet - at least not in this
> form.  Therefore the dependency on Apache is wrong. Most users will use
> diatheke only as commandline routine, never as CGI.

Fixed.  CGI code moved to examples, description of diatheke binary
package updated, Recommends: removed.

> 5) Gnomesword is ancient history. All bug reports you have on file for
> GS are sorted in upodated versions. Our last release was 2.4.1. we are
> currently moving towards the next release - a week or two.

Not yet updated.  This is out of scope until we have a working sword
package... and personally, I'm rather hoping someone else on the
packaging team will step up and take the lead on updating the GnomeSword
package anyway!

In response to my "first attempt" new Sword package, Daniel Glassey
helpfully commented:

> debian/rules
> DEB_DH_MAKESHLIBS_ARGS_libsword6 := -V"libsword7 (>= 1.5.11-1)"
> DEB_SHLIBDEPS_INCLUDE_libsword6 := debian/tmp/usr/lib
> 
> that should be DEB*_libsword7

Done.

> I think one of the complaints somewhere was that the lib wasn't built
> with icu support enabled so let's add the configure option --with-icu
> which is off by default

Done but now disputed... under discussion :)

> debian/diatheke.README.Debian

Added.

> package libsword7 should 'Replaces' libsword6

Not done because I don't think it really does, both should be able to
coexist.  Awaiting feedback on this.

> diatheke - let's change the Recommends of apache2|https to Suggests

Removed entirely in ~jmarsden4, since we don't install anything that
uses a web server now.

> debian/copyright
> let's update the copyright date to 2009

Done.

> debian/diatheke.dirs
> we can remove usr/lib/cgi-bin since we aren't installing anything there now

Done (and then some... I simplified by removing all unnecessary .dirs
entries).

> debian/libsword7.shlibs
> I think that should be
> libsword 7 libsword7 (>= 1.5.11-1)

File removed as duplicative; debian/rules has stuff in it that creates
this file or its equivalent.

> debian/libsword-dev.dirs
> I think these dirs should be added
> usr/include
> usr/include/sword
> usr/lib/pkgconfig

File removed when removing unnecessary .dirs entries.

TODO:

(1) Testing -- we need more people to build and test this package.

(2) Man pages!  I'm hoping for some man pages for all the little cli
tools that we install, so that we can get this package lintian-clean in
the next couple of days or so.

(3) We should resolve the "icu-or-not" question soon, if we can.

Changelog entries for all 4 package attempts enclosed below.

Thanks all, we're on our way!  And I'm on my way to bed... goodnight!

Jonathan

----------------------------------------------------------------------

sword (1.5.11-1ubuntu1~jmarsden4) jaunty; urgency=low

  * Remove Recommends of a web server for diatheke.
  * Edit description of diatheke removing references to web/CGI.

 -- Jonathan Marsden <jmarsden at fastmail.fm>  Sat, 24 Jan 2009 22:28:33 -0800

sword (1.5.11-1ubuntu1~jmarsden3) intrepid; urgency=low

  * Use chrpath on installed binaries to get rid of lintian warnings.

 -- Jonathan Marsden <jmarsden at fastmail.fm>  Sat, 24 Jan 2009 17:12:41 -0800

sword (1.5.11-1ubuntu1~jmarsden2) intrepid; urgency=low

  * debian/rules: Update libsword6 to libsword7 in a couple more places.
  * Add debian/diatheke.README.Debian explaining move of CGI scripts.
  * Build against libicu for better i18n support.
  * Minimize unnecessary debian/*.dirs files and entries in them.
  * Remove unnecessary debian/libsword7.shlibs file.

 -- Jonathan Marsden <jmarsden at fastmail.fm>  Sat, 24 Jan 2009 15:24:38 -0800

sword (1.5.11-1ubuntu1~jmarsden1) intrepid; urgency=low

  * New upstream tarball.
  * debian/rules:
    - Switch to using more normal CDBS/autotools not tarball in tarball.
  * Bump SONAME to 7.
    - Rename debian/libsword6.* appropriately.
    - Change 6 to 7 in several scripts including debian/rules
      and debian/control
  * Remove most patches as being unnecessary now.
  * Simplify debian/patches/02_libver.diff to only edit the version-info.
  * Move CGI scripts to install as examples, for security reasons.
  * Update diatheke one-line description (cli tool not CGI script).
  * Add ${misc:Depends} to Depends of binary packages.
  * Bump Standards-Version to 3.8.0.
  * Add Homepage: tag in debian/control.

 -- Jonathan Marsden <jmarsden at fastmail.fm>  Sat, 24 Jan 2009 10:08:04 -0800