minimal documentation or usefulness of new package -- teleport?

[Jan Nieuwenhuizen <janneke@gnu.org>]

Does Debian have guidelines for minimal usefullnes or documentation of
a new package?  Colour me /clueless, but triggered by DWN, I tried
teleport, without much avail:

    13:16:04 janneke@elchorro:~
    $ apt-cache search teleport gtk
    teleport - moves GTK applications between displays

Woohoo!  Moving the Emacs*) between work and home, is that really
possible?  Lets see...

    13:18:11 janneke@elchorro:~
    $ sudo apt-get install teleport
    [..]
    13:20:43 janneke@elchorro:~
    $ l /usr/share/doc/teleport/
    total 8
    -rw-r--r--    1 root     root          572 Sep 27 12:42 copyright
    -rw-r--r--    1 root     root          170 Sep 27 12:44 changelog.Debian.gz

Hmm, no (Debian) docs.

    13:20:52 janneke@elchorro:~
    $ info --apropos teleport
    info: No available info files have "teleport" in their indices.

Hmm, no info pages.

    13:21:08 janneke@elchorro:~
    $ man teleport
    Reformatting teleport(1x), please wait...
    teleport(1x)                                             teleport(1x)

    NAME
           teleport - move applications between displays

    SYNOPSIS
           teleport

    DESCRIPTION
    
           teleport allows running applications to be moved between X
           displays, without closing and restarting them. It uses X
           properties to request that applications which support the
           display migration protocol move to another display.

    SEE ALSO
           tp-keygen(1)

    AUTHOR
           teleport was written by Philip Blundell <philb@gnu.org>.

    version 0.31.1                    Jul 16 2003                     teleport(1x)

Hmm, useless manpage.

    13:21:15 janneke@elchorro:~
    $ teleport --help

    (teleport:27023): Gtk-CRITICAL **: file gtkcombo.c: line 1116 (gtk_combo_set_popdown_strings): assertion `strings != NULL' failed
    GPE-ERROR: Invalid display name

    (teleport:27023): GLib-GObject-CRITICAL **: file gobject.c: line 1338 (g_object_unref): assertion `object->ref_count > 0' failed

    (teleport:27023): GLib-GObject-CRITICAL **: file gobject.c: line 1320 (g_object_ref): assertion `object->ref_count > 0' failed

    (teleport:27023): GLib-GObject-CRITICAL **: file gobject.c: line 1320 (g_object_ref): assertion `object->ref_count > 0' failed
    Segmentation fault

Hmm, --help does not display help, nor does -h.  App dumps core.
Cool.

Jan.

  *) the Emacs can be compiled to use GTK+ toolkit
 
-- 
Jan Nieuwenhuizen <janneke@gnu.org> | GNU LilyPond - The music typesetter
http://www.xs4all.nl/~jantien       | http://www.lilypond.org