Debian Bug report logs - #704587
ITP: libtcod -- an API for roguelike developpers

Package: wnpp; Maintainer for wnpp is wnpp@debian.org;

Reported by: Etienne Millon <etienne.millon@gmail.com>

Date: Wed, 3 Apr 2013 10:15:01 UTC

Owned by: Etienne Millon <etienne.millon@gmail.com>

Severity: wishlist

Blocking fix for 698843: ITP: brogue -- Roguelike game by Brian Walker

Reply or subscribe to this bug.

Toggle useless messages

View this report as an mbox folder, status mbox, maintainer mbox


Report forwarded to debian-bugs-dist@lists.debian.org, debian-devel@lists.debian.org, debian-devel-games@lists.debian.org, wnpp@debian.org:
Bug#704587; Package wnpp. (Wed, 03 Apr 2013 10:15:06 GMT) Full text and rfc822 format available.

Acknowledgement sent to Etienne Millon <etienne.millon@gmail.com>:
New Bug report received and forwarded. Copy sent to debian-devel@lists.debian.org, debian-devel-games@lists.debian.org, wnpp@debian.org. (Wed, 03 Apr 2013 10:15:06 GMT) Full text and rfc822 format available.

Message #5 received at submit@bugs.debian.org (full text, mbox):

From: Etienne Millon <etienne.millon@gmail.com>
To: Debian Bug Tracking System <submit@bugs.debian.org>
Subject: ITP: libtcod -- an API for roguelike developpers
Date: Wed, 3 Apr 2013 12:10:55 +0200
Package: wnpp
Severity: wishlist
Owner: Etienne Millon <etienne.millon@gmail.com>

* Package name    : libtcod
  Version         : 1.5.1
  Upstream Author : Jice & Mingos
* URL             : http://doryen.eptalys.net/libtcod/
* License         : BSD-3
  Programming Lang: C, C++
  Description     : cross-platform C/C++ library for roguelike developers

A free, fast, portable and uncomplicated API for roguelike developpers
providing an advanced true color console, input, and lots of other
utilities frequently used in roguelikes.
  - keyboard and mouse input
  - true color console
  - antialiased bitmap font support
  - Sub-cell resolution & SDL callback
  - unicode support
  - high quality pseudo-random number generator
  - advanced plain text configuration file parser
  - bmp and png images support
  - Perlin noise toolkit
  - heightmap toolkit
  - field of view toolkit
  - path finding toolkit
  - BSP toolkit
  - Flexible name generator

--

I intend to maintain this package within the Games Team ; this is a
dependency for brogue (ITP #698843).

-- 
Etienne Millon



Information forwarded to debian-bugs-dist@lists.debian.org, wnpp@debian.org, Etienne Millon <etienne.millon@gmail.com>:
Bug#704587; Package wnpp. (Wed, 03 Apr 2013 18:12:07 GMT) Full text and rfc822 format available.

Acknowledgement sent to Oohara Yuuma <oohara@libra.interq.or.jp>:
Extra info received and forwarded to list. Copy sent to wnpp@debian.org, Etienne Millon <etienne.millon@gmail.com>. (Wed, 03 Apr 2013 18:12:07 GMT) Full text and rfc822 format available.

Message #10 received at 704587@bugs.debian.org (full text, mbox):

From: Oohara Yuuma <oohara@libra.interq.or.jp>
To: 704587@bugs.debian.org
Cc: oohara@libra.interq.or.jp
Subject: Re: Bug#704587: ITP: libtcod -- an API for roguelike developpers
Date: Thu, 04 Apr 2013 02:21:27 +0900 (JST)
The upstream makefile says:

> libtcod.so : $(TEMP)/libtcod/release $(LIBOBJS_C_RELEASE)
> 	gcc -shared -Wl,-soname,$@ -o $@ $(LIBOBJS_C_RELEASE) $(ZLIB_LIBS) $(PNG_LIBS) $(SDL_LIBS) $(CFLAGS) $(OPENGL_LIB)

Please discuss the SONAME version with the upstream before packaging.

-- 
Oohara Yuuma <oohara@libra.interq.or.jp>




Information forwarded to debian-bugs-dist@lists.debian.org, wnpp@debian.org:
Bug#704587; Package wnpp. (Thu, 04 Apr 2013 07:48:04 GMT) Full text and rfc822 format available.

Acknowledgement sent to Etienne Millon <etienne.millon@gmail.com>:
Extra info received and forwarded to list. Copy sent to wnpp@debian.org. (Thu, 04 Apr 2013 07:48:04 GMT) Full text and rfc822 format available.

Message #15 received at 704587@bugs.debian.org (full text, mbox):

From: Etienne Millon <etienne.millon@gmail.com>
To: Oohara Yuuma <oohara@libra.interq.or.jp>, 704587@bugs.debian.org
Subject: Re: Bug#704587: ITP: libtcod -- an API for roguelike developpers
Date: Thu, 4 Apr 2013 09:44:33 +0200
* Oohara Yuuma <oohara@libra.interq.or.jp> [130404 09:26]:
> The upstream makefile says:
> 
> > libtcod.so : $(TEMP)/libtcod/release $(LIBOBJS_C_RELEASE)
> > 	gcc -shared -Wl,-soname,$@ -o $@ $(LIBOBJS_C_RELEASE) $(ZLIB_LIBS) $(PNG_LIBS) $(SDL_LIBS) $(CFLAGS) $(OPENGL_LIB)
> 
> Please discuss the SONAME version with the upstream before packaging.

Sure. I just used "0" in my preliminary packaging work but the lack of
soname may be a problem. I'm afraid that it won't be easy to
convince upstream as the library has an history of API breakage [1].

Do you know if we have a comprehensive "how-to" / "why" document to
explain these problems ? The upstream guide [2] mentions a library
guide [3], and there's also [4] but everything is good to be
forwarded.

If upstream is not interested, I believe that the best solution is to
package a static library (or embed it into the brogue source package)
but I'd like to avoid that.

Thanks

[1]: http://upstream-tracker.org/versions/libtcod.html
[2]: http://wiki.debian.org/UpstreamGuide
[3]: http://davidz25.blogspot.fr/2011/07/writing-c-library-part-5.html#abi-api-versioning
[4]: http://semver.org/

-- 
Etienne Millon



Information forwarded to debian-bugs-dist@lists.debian.org, wnpp@debian.org, Etienne Millon <etienne.millon@gmail.com>:
Bug#704587; Package wnpp. (Fri, 05 Apr 2013 05:09:04 GMT) Full text and rfc822 format available.

Acknowledgement sent to Oohara Yuuma <oohara@libra.interq.or.jp>:
Extra info received and forwarded to list. Copy sent to wnpp@debian.org, Etienne Millon <etienne.millon@gmail.com>. (Fri, 05 Apr 2013 05:09:04 GMT) Full text and rfc822 format available.

Message #20 received at 704587@bugs.debian.org (full text, mbox):

From: Oohara Yuuma <oohara@libra.interq.or.jp>
To: 704587@bugs.debian.org
Cc: oohara@libra.interq.or.jp
Subject: Re: Bug#704587: ITP: libtcod -- an API for roguelike developpers
Date: Fri, 05 Apr 2013 11:50:57 +0900 (JST)
On Thu, 4 Apr 2013 09:44:33 +0200,
Etienne Millon <etienne.millon@gmail.com> wrote:
[upstream SONAME without version]
> Do you know if we have a comprehensive "how-to" / "why" document to
> explain these problems ? The upstream guide [2] mentions a library
> guide [3], and there's also [4] but everything is good to be
> forwarded.

The library packaging guide [5] may help:
| It is quite important that Debian does not lose binary compatibility
| with other distributions, so changing the SONAME specifically
| for Debian is generally a bad idea.

[5] http://www.netfort.gr.jp/~dancer/column/libpkg-guide/libpkg-guide.html

-- 
Oohara Yuuma <oohara@libra.interq.or.jp>




Information forwarded to debian-bugs-dist@lists.debian.org, wnpp@debian.org:
Bug#704587; Package wnpp. (Sun, 07 Apr 2013 14:15:19 GMT) Full text and rfc822 format available.

Acknowledgement sent to Etienne Millon <etienne.millon@gmail.com>:
Extra info received and forwarded to list. Copy sent to wnpp@debian.org. (Sun, 07 Apr 2013 14:15:19 GMT) Full text and rfc822 format available.

Message #25 received at 704587@bugs.debian.org (full text, mbox):

From: Etienne Millon <etienne.millon@gmail.com>
To: Oohara Yuuma <oohara@libra.interq.or.jp>, 704587@bugs.debian.org
Subject: Re: Bug#704587: ITP: libtcod -- an API for roguelike developpers
Date: Sun, 7 Apr 2013 16:14:20 +0200
* Oohara Yuuma <oohara@libra.interq.or.jp> [130405 08:38]:
> The library packaging guide [5] may help:
> | It is quite important that Debian does not lose binary compatibility
> | with other distributions, so changing the SONAME specifically
> | for Debian is generally a bad idea.

Thanks. I might update the upstream guide with these links.

I had an answer from upstream ; they're aware of the problems it
caused in the past and now want to keep compatibility. As a matter of
fact, 1.5.2 was just added to UT and does not break API:

http://upstream-tracker.org/versions/libtcod.html

I'll prepare a patch for upstream setting the SONAME to 1 (same as the
major version).

-- 
Etienne Millon



Information forwarded to debian-bugs-dist@lists.debian.org, wnpp@debian.org:
Bug#704587; Package wnpp. (Tue, 07 May 2013 13:09:07 GMT) Full text and rfc822 format available.

Acknowledgement sent to Etienne Millon <etienne.millon@gmail.com>:
Extra info received and forwarded to list. Copy sent to wnpp@debian.org. (Tue, 07 May 2013 13:09:07 GMT) Full text and rfc822 format available.

Message #30 received at 704587@bugs.debian.org (full text, mbox):

From: Etienne Millon <etienne.millon@gmail.com>
To: 704587@bugs.debian.org
Subject: Re: Bug#704587: ITP: libtcod -- an API for roguelike developpers
Date: Tue, 7 May 2013 15:06:44 +0200
Small update :

I'm working with upstream to enable library versioning and proper
symbol visibility support (it's funny how you miss libtool when it's
not there).

My work is visible there, I'll copy it to alioth when it's released:

https://github.com/emillon/libtcod-debian

-- 
Etienne Millon



Added indication that bug 704587 blocks 698843 Request was from Etienne Millon <etienne.millon@gmail.com> to control@bugs.debian.org. (Sat, 01 Jun 2013 10:21:29 GMT) Full text and rfc822 format available.

Send a report that this bug log contains spam.


Debian bug tracking system administrator <owner@bugs.debian.org>. Last modified: Sun Apr 20 00:48:11 2014; Machine Name: beach.debian.org

Debian Bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.