Package: tabble Version: 0.43-1 Severity: wishlist Tags: patch The man pages have a couple of very minor POD problems (such as a "head1" without leading "="), but more importantly they are distinctly overenthusiastic with their claims that there are no OPTIONS and no FILES.
In fact tabble does takes a -c <config> option - though the tabble-wrapper script needs a slight amendment to pass on "$@". -- System Information: Debian Release: wheezy/sid APT prefers testing APT policy: (990, 'testing'), (50, 'unstable') Architecture: i386 (i686) Kernel: Linux 3.2.0-2-686-pae (SMP w/1 CPU core) Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8) Shell: /bin/sh linked to /bin/dash Versions of packages tabble depends on: ii libc6 2.13-27 ii libgdk-pixbuf2.0-0 2.24.1-1 ii libglib2.0-0 2.30.2-6 ii libgtk2.0-0 2.24.10-1 ii psmisc 22.16-1 tabble recommends no packages. tabble suggests no packages. -- no debconf information -- JBR Ankh kak! (Ancient Egyptian blessing)
diff -ru tabble-0.43.pristine/debian/tabble.1.pod tabble-0.43/debian/tabble.1.pod --- tabble-0.43.pristine/debian/tabble.1.pod 2012-03-07 06:01:20.000000000 +0000 +++ tabble-0.43/debian/tabble.1.pod 2012-03-22 15:47:05.943392690 +0000 @@ -44,20 +44,31 @@ =head1 SYNOPSIS - tabble +B<tabble> [B<-c> I<E<lt>configE<gt>>] =head1 DESCRIPTION -Tabble is a small alternative X shell which presents your programs in -tabs for easy launch. It is not meant to replace a window manager, +Tabble is a small alternative GTK shell which presents your programs +in tabs for easy launch. It is not meant to replace a window manager, just complement it. Light window managers benefit the most from tabble. The idea is that tabble is 'always on top' so multiple launches can be made without re-navigating a menu hierarchy or clearing the desktop. -head1 OPTIONS +As a first step after launching tabble, hold down 'shift' and +right-click on one of the buttons that appears. -None. +=head1 OPTIONS + +One short option is accepted. + +=over 4 + +=item B<-c> I<E<lt>configE<gt>> + +Use non-default configuration file (see L</FILES>). + +=back =head1 ENVIRONMENT @@ -65,11 +76,13 @@ =head1 FILES -None. +Configuration is written to F<~/.tabble> by default. =head1 SEE ALSO -fpanel(1) +fpanel(1), tabble-wrapper(1) + +A guide is available at L<http://www.rillion.net/tabble>. =head1 AUTHORS @@ -78,7 +91,7 @@ This manual page was written by Jari Aalto <[email protected]> for the Debian GNU system (but may be used by others). Released under license GNU GPL version 2 or (at your option) any later version. For -more information about license, visit +more information about this license, visit <http://www.gnu.org/copyleft/gpl.html>. =cut diff -ru tabble-0.43.pristine/debian/tabble-wrapper tabble-0.43/debian/tabble-wrapper --- tabble-0.43.pristine/debian/tabble-wrapper 2012-03-07 06:01:20.000000000 +0000 +++ tabble-0.43/debian/tabble-wrapper 2012-03-22 15:42:03.991392596 +0000 @@ -4,7 +4,7 @@ Main () { if [ "$LOGNAME" ]; then - killall -50 -u $LOGNAME tabble || tabble & + killall -50 -u $LOGNAME tabble || tabble "$@" & else echo "[ERROR] can't restart tabble. LOGNAME not defined." >&2 return 1 diff -ru tabble-0.43.pristine/debian/tabble-wrapper.1.pod tabble-0.43/debian/tabble-wrapper.1.pod --- tabble-0.43.pristine/debian/tabble-wrapper.1.pod 2012-03-07 06:01:20.000000000 +0000 +++ tabble-0.43/debian/tabble-wrapper.1.pod 2012-03-22 15:46:41.755392900 +0000 @@ -44,20 +44,22 @@ =head1 SYNOPSIS - tabble-wrapper +B<tabble-wrapper> =head1 DESCRIPTION -After you have added new entries, this program kills exixting tabble -and restarts it. +B<tabble-wrapper> is a simple shell script which either launches a new +B<tabble> or (if one is already running, maybe in a 'hidden' state) +sends it a signal telling it to restart, re-reading its configuration +file for any new entries. head1 OPTIONS -None. +Any command-line parameters are passed on to the invoked B<tabble>. =head1 ENVIRONMENT -The tabble owned by LOGNAME is killed. +The B<tabble> owned by LOGNAME is killed. =head1 FILES @@ -74,7 +76,7 @@ This manual page was written by Jari Aalto <[email protected]> for the Debian GNU system (but may be used by others). Released under license GNU GPL version 2 or (at your option) any later version. For -more information about license, visit +more information about the license, visit <http://www.gnu.org/copyleft/gpl.html>. =cut
