dpkg-gensymbols -- should(n't) version where symbol was introduced remain when SONAME changes?
Dear library package(s) maintenance experts,
I am updating libfreenect package to fresh upstream 0.2.0 (from 0.1.2).
library SOVERSION changed to 0.2 and I have renamed libfreenect0.1 to
libfreenect0.2 and its .symbols file. Now updating it with
dpkg-gensymbols -v1:0.2.0 -plibfreenect0.2 -Odebian/libfreenect0.2.symbols
NB debian package version has epoch 1:
but that boosts versions for all the entries, not only for the new ones...
Most probably (didn't check) that is because libraries SONAMEs went e.g. from
libfreenect.so.0.1 to libfreenect.so.0.2, and then such a change kinda makes
sense since there were no 1:0.2.0 version of libfreenect.so.0.1. But
wanted to ask -- wouldn't it be more sensible to keep a version of the
library where symbol was introduced altogether? shouldn't dpkg-gensymbols do
that automagically?
Here is a word diff for the update of .symbols produced by above command
diff --git a/debian/libfreenect0.2.symbols b/debian/libfreenect0.2.symbols
index b86aaf3..598fc31 100644
--- a/debian/libfreenect0.2.symbols
+++ b/debian/libfreenect0.2.symbols
@@ -1,75 +1,54 @@
[-libfreenect.so.0.1 libfreenect0.1-]{+libfreenect.so.0.2 libfreenect0.2+} #MINVER#[-(optional)fn_log@Base 1:0.1.1-]
[- (optional)fnusb_close_subdevices@Base 1:0.1.1-]
[- (optional)fnusb_control@Base 1:0.1.1-]
[- (optional)fnusb_init@Base 1:0.1.1-]
[- (optional)fnusb_list_device_attributes@Base 1:0.1.2-]
[- (optional)fnusb_num_devices@Base 1:0.1.1-]
[- (optional)fnusb_open_subdevices@Base 1:0.1.1-]
[- (optional)fnusb_process_events@Base 1:0.1.1-]
[- (optional)fnusb_process_events_timeout@Base 1:0.1.2-]
[- (optional)fnusb_shutdown@Base 1:0.1.1-]
[- (optional)fnusb_start_iso@Base 1:0.1.1-]
[- (optional)fnusb_stop_iso@Base 1:0.1.1-]
[- (optional)freenect_apply_depth_to_mm@Base 1:0.1.2-]
[- (optional)freenect_apply_registration@Base 1:0.1.2-]
[- (optional)freenect_camera_init@Base 1:0.1.2-]
[- (optional)freenect_camera_teardown@Base 1:0.1.2-]
freenect_camera_to_world@Base [-1:0.1.2-]{+1:0.2.0+}
freenect_close_device@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_copy_registration@Base [-1:0.1.2-]{+1:0.2.0+}
freenect_destroy_registration@Base [-1:0.1.2-]{+1:0.2.0+}
{+ freenect_enabled_subdevices@Base 1:0.2.0+}
freenect_find_depth_mode@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_find_video_mode@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_free_device_attributes@Base [-1:0.1.2-]{+1:0.2.0+}
freenect_get_current_depth_mode@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_get_current_video_mode@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_get_depth_mode@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_get_depth_mode_count@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_get_mks_accel@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_get_tilt_degs@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_get_tilt_state@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_get_tilt_status@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_get_user@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_get_video_mode@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_get_video_mode_count@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_init@Base [-1:0.1.1-]
[- (optional)freenect_init_registration@Base 1:0.1.2-]{+1:0.2.0+}
freenect_list_device_attributes@Base [-1:0.1.2-]{+1:0.2.0+}
freenect_num_devices@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_open_device@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_open_device_by_camera_serial@Base [-1:0.1.2-]{+1:0.2.0+}
freenect_process_events@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_process_events_timeout@Base [-1:0.1.2-]{+1:0.2.0+}
freenect_select_subdevices@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_set_depth_buffer@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_set_depth_callback@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_set_depth_mode@Base [-1:0.1.1-]{+1:0.2.0+}
{+ freenect_set_flag@Base 1:0.2.0+}
freenect_set_led@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_set_log_callback@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_set_log_level@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_set_tilt_degs@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_set_user@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_set_video_buffer@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_set_video_callback@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_set_video_mode@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_shutdown@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_start_depth@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_start_video@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_stop_depth@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_stop_video@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_supported_subdevices@Base [-1:0.1.2-]{+1:0.2.0+}
freenect_update_tilt_state@Base [-1:0.1.1-]
[- (optional)parameter_coefficient@Base 1:0.1.2-]
[- (optional)pixel_size_factor@Base 1:0.1.2-]
[- (optional)shift_scale@Base 1:0.1.2-]
[- (optional)supported_depth_modes@Base 1:0.1.1-]
[- (optional)supported_video_modes@Base 1:0.1.1-]
[- (optional)unpack_8_pixels@Base 1:0.1.2-]
[-libfreenect_sync.so.0.1 libfreenect0.1-]{+1:0.2.0+}
{+libfreenect_sync.so.0.2 libfreenect0.2+} #MINVER#
freenect_sync_get_depth@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_sync_get_tilt_state@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_sync_get_video@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_sync_set_led@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_sync_set_tilt_degs@Base [-1:0.1.1-]{+1:0.2.0+}
freenect_sync_stop@Base [-1:0.1.1-]{+1:0.2.0+}
--
Yaroslav O. Halchenko, Ph.D.
http://neuro.debian.net http://www.pymvpa.org http://www.fail2ban.org
Senior Research Associate, Psychological and Brain Sciences Dept.
Dartmouth College, 419 Moore Hall, Hinman Box 6207, Hanover, NH 03755
Phone: +1 (603) 646-9834 Fax: +1 (603) 646-1419
WWW: http://www.linkedin.com/in/yarik
Reply to: