Bug#250810: marked as done (glabels: Package should come with a man page, at the very least)

Debian Bug Tracking System owner@bugs.debian.org
Sat, 14 Aug 2004 20:18:07 -0700


Your message dated Sat, 14 Aug 2004 23:02:06 -0400
with message-id <E1BwBHa-0007NO-00@newraff.debian.org>
and subject line Bug#250810: fixed in glabels 2.0.0-1
has caused the attached Bug report to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what I am
talking about this indicates a serious mail system misconfiguration
somewhere.  Please contact me immediately.)

Debian bug tracking system administrator
(administrator, Debian Bugs database)

--------------------------------------
Received: (at submit) by bugs.debian.org; 25 May 2004 04:59:45 +0000
>From lockner@cse.psu.edu Mon May 24 21:59:45 2004
Return-path: <lockner@cse.psu.edu>
Received: from rccy-001-217.dialup.iowatelecom.net (warlock.locknet) [69.66.67.217] 
	by spohr.debian.org with esmtp (Exim 3.35 1 (Debian))
	id 1BSU2Q-00067p-00; Mon, 24 May 2004 21:59:43 -0700
Received: by warlock.locknet (Postfix, from userid 1000)
	id 3744F70C0E3; Mon, 24 May 2004 23:59:40 -0500 (CDT)
Content-Type: multipart/mixed; boundary="===============0302706345=="
MIME-Version: 1.0
From: "Matthew J. Lockner" <lockner@cse.psu.edu>
To: Debian Bug Tracking System <submit@bugs.debian.org>
Subject: glabels: Package should come with a man page, at the very least
X-Mailer: reportbug 2.58
Date: Mon, 24 May 2004 23:59:40 -0500
Message-Id: <20040525045940.3744F70C0E3@warlock.locknet>
X-BadReturnPath: lockne89@warlock.locknet rewritten as lockner@cse.psu.edu
  using "From" header
Delivered-To: submit@bugs.debian.org
X-Spam-Checker-Version: SpamAssassin 2.60-bugs.debian.org_2004_03_25 
	(1.212-2003-09-23-exp) on spohr.debian.org
X-Spam-Status: No, hits=-8.0 required=4.0 tests=BAYES_00,HAS_PACKAGE 
	autolearn=no version=2.60-bugs.debian.org_2004_03_25
X-Spam-Level: 

This is a multi-part MIME message sent by reportbug.

--===============0302706345==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

Package: glabels
Version: 1.93.3-1
Severity: minor


It appears that gLabels suffers from the common malady of nonexistant
documentation. Most distressingly, it has no man page. I have written
one (attached) that at least provides enough instruction to clear up
some things that confused me about using this program.

-- System Information:
Debian Release: testing/unstable
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: i386 (i686)
Kernel: Linux 2.4.20
Locale: LANG=C, LC_CTYPE=C

Versions of packages glabels depends on:
ii  libart-2.0-2                2.3.16-5     Library of functions for 2D graphi
ii  libatk1.0-0                 1.4.1-1      The ATK accessibility toolkit
ii  libaudiofile0               0.2.6-3      Open-source version of SGI's audio
ii  libbonobo2-0                2.4.3-1      Bonobo CORBA interfaces library
ii  libbonoboui2-0              2.4.3-2      The Bonobo UI library
hi  libc6                       2.3.2.ds1-12 GNU C Library: Shared libraries an
ii  libesd-alsa0 [libesd0]      0.2.29-1     Enlightened Sound Daemon (ALSA) - 
ii  libfontconfig1              2.2.2-2      generic font configuration library
ii  libfreetype6                2.1.7-2      FreeType 2 font engine, shared lib
ii  libgconf2-4                 2.4.0.1-4    GNOME configuration database syste
ii  libgcrypt1                  1.1.12-4     LGPL Crypto library - runtime libr
ii  libglade2-0                 1:2.0.1-13   Library to load .glade files at ru
ii  libglib2.0-0                2.2.3-1      The GLib library of C routines
ii  libgnome2-0                 2.4.0-11     The GNOME 2 library - runtime file
ii  libgnomecanvas2-0           2.4.0-3      A powerful object-oriented display
ii  libgnomeprint2.2-0          2.4.2-6      The GNOME 2.2 print architecture -
ii  libgnomeprintui2.2-0        2.4.2-2      The GNOME 2.2 print architecture U
ii  libgnomeui-0                2.4.0.1-12   The GNOME 2 libraries (User Interf
ii  libgnomevfs2-0              2.4.1-5      The GNOME virtual file-system libr
ii  libgnomevfs2-common         2.4.1-5      The GNOME virtual file-system libr
ii  libgnutls7                  0.8.12-5     GNU TLS library - runtime library
ii  libgtk2.0-0                 2.2.4-3      The GTK+ graphical user interface 
ii  libice6                     4.3.0-7      Inter-Client Exchange library
ii  libjpeg62                   6b-9         The Independent JPEG Group's JPEG 
ii  liborbit2                   1:2.8.3-2    libraries for ORBit2 - a CORBA ORB
ii  libpango1.0-0               1.2.5-4      Layout and rendering of internatio
ii  libpopt0                    1.7-4        lib for parsing cmdline parameters
ii  libsm6                      4.3.0-7      X Window System Session Management
ii  libtasn1-0                  0.1.2-1      Manage ASN.1 structures (runtime)
ii  libx11-6                    4.3.0-7      X Window System protocol client li
ii  libxml2                     2.6.9-1      GNOME XML library
ii  scrollkeeper                0.3.14-8     A free electronic cataloging syste
ii  xlibs                       4.3.0-7      X Window System client libraries m
ii  zlib1g                      1:1.2.1-5    compression library - runtime

-- no debconf information

--===============0302706345==
Content-Type: text/troff; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment; filename="glabels.1"

.TH glabels 1 "May 24, 2004" "GLabels" "User Commands"
.SH NAME
glabels - Label and business card creation program for GNOME
.SH SYNOPSIS
.B glabels
[labels-file] ...
.SH DESCRIPTION
gLabels is a lightweight program for creating labels and business cards for
the GNOME desktop environment. It is designed to work with various
laser/ink-jet peel-off label and business card sheets that you'll find at most
office supply stores. There is also a template designer for adding new label
sheets according to user specifications.
.PP
Labels may be populated with text, rudimentary shapes, images, and barcodes.
5-digit and 9-digit POSTNET barcode encoding is supported. A merge facility,
using simple delimited text files (e.g., CSV) as a data source, provides for
quickly generating multiple labels.
.SH OPTIONS
.TP
\-\-help
Display a summary of available (GNOME-provided) command-line options
.PP
One or more existing gLabels filenames may be provided as arguments; each of
these is then opened in its own gLabels window.
.SH CREATING LABELS
To create a new label or business card, press the button labelled "New" under
the menu bar. From there, you can select from a variety of predefined sheet
templates, alphabetically in order of brand name. Note also that a paper size
can be selected from the drop-down list; specifically, user-defined templates
will be listed under whichever paper size was used to create the template.
.PP
To open existing labels, use the "Open" button directly to the right of "New".
Existing gLabels files are saved with an extension of ".glabels" by default.
.PP
Once one of the above is completed, a label editing mode appears, containing a
toolbar with buttons for label objects. In general, press one of these object
buttons, and then add it to the label by left-clicking where you want it to
appear on the label. Each object has properties, which can be manipulated via
the tabbed pane to the right of the graphical label editing area.
.SH USING MERGE
One frequent application of this program is likely the creation of a full sheet
or sheets of address labels, each having a different address printed upon it.
Under gLabels, one uses the merge feature to accomplish this task. Simply
create a delimited text file (select from comma-, colon-, or tab-delimited
text) in which each line corresponds to one record (the record in this case is
probably one label). 
.PP
Use the Edit Merge Properties button on the object toolbar to bring up the file
import window. Select the file format you used, and then select the data file
using the Location bar provided. If the import is successful, you should be
able to preview its interpretation in the bottom pane (in which each record is
given its own expand/elide arrow tool). Press the OK button if you are
satisfied with the import.
.PP
Back in the label editor, you can now associate fields from the data file with
objects on your label. The objects you are most likely to want to associate
with file data are text objects, in which variable placeholders will appear
inside the text, and barcodes, which you probably want to associate with a
field holding a ZIP code. The way to make these associations is to specify
"key" fields in the object properties pane. gLabels numbers the keys starting
from 1, ascending left-to-right.
.PP
It is a wise idea to get a notion of how your labels are going to turn out with
the merge substitutions in effect; use the Print Preview facility for this
(which itself is reached via the Print button on the main toolbar).
.SH TEMPLATE DESIGNER
If the label sheet in use is not found amongst those supplied with gLabels, it
is probably best to design a template for it using the Template Designer. You
may access this feature under the File menu.
.PP
There is some perhaps strange vocabulary in effect here, although the graphical
previews in the right-hand pane are generally sufficient to help you feel out
what is being done. Nevertheless, the astute reader may refer to the
documentation on the project website (see the SEE ALSO section below) for
further details on template design.
.PP
Finally, consider sending your new template to
<glabels-templates@lists.sourceforge.net> so the whole world may benefit from
your tireless labours.
.SH PRINTING
gLabels uses a fairly standard dialog box with well-known printing options for
the most part; just bear in mind that if the labels graphic is all white (none
of the sheet's labels are highlighted), then there is probably something
holding up generating what you expected. Experience has shown that this is
often the result of a file getting outdated with a merge data file it sources
(i.e., the data file for merging has been moved). Just reapply change the file
location under the merging dialog box in this case.
.SH FILES
The $HOME/.glabels directory contains all user-defined templates.
.SH SEE ALSO
The gLabels homepage at <http://glabels.sourceforge.net/>.
.SH AUTHOR
Jim Evins <evins@snaught.com>

--===============0302706345==--

---------------------------------------
Received: (at 250810-close) by bugs.debian.org; 15 Aug 2004 03:08:10 +0000
>From katie@ftp-master.debian.org Sat Aug 14 20:08:10 2004
Return-path: <katie@ftp-master.debian.org>
Received: from newraff.debian.org [208.185.25.31] (mail)
	by spohr.debian.org with esmtp (Exim 3.35 1 (Debian))
	id 1BwBNS-000602-00; Sat, 14 Aug 2004 20:08:10 -0700
Received: from katie by newraff.debian.org with local (Exim 3.35 1 (Debian))
	id 1BwBHa-0007NO-00; Sat, 14 Aug 2004 23:02:06 -0400
From: Andrew Lau <netsnipe@users.sourceforge.net>
To: 250810-close@bugs.debian.org
X-Katie: $Revision: 1.51 $
Subject: Bug#250810: fixed in glabels 2.0.0-1
Message-Id: <E1BwBHa-0007NO-00@newraff.debian.org>
Sender: Archive Administrator <katie@ftp-master.debian.org>
Date: Sat, 14 Aug 2004 23:02:06 -0400
Delivered-To: 250810-close@bugs.debian.org
X-Spam-Checker-Version: SpamAssassin 2.60-bugs.debian.org_2004_03_25 
	(1.212-2003-09-23-exp) on spohr.debian.org
X-Spam-Status: No, hits=-6.0 required=4.0 tests=BAYES_00,HAS_BUG_NUMBER 
	autolearn=no version=2.60-bugs.debian.org_2004_03_25
X-Spam-Level: 
X-CrossAssassin-Score: 4

Source: glabels
Source-Version: 2.0.0-1

We believe that the bug you reported is fixed in the latest version of
glabels, which is due to be installed in the Debian FTP archive:

glabels_2.0.0-1.diff.gz
  to pool/main/g/glabels/glabels_2.0.0-1.diff.gz
glabels_2.0.0-1.dsc
  to pool/main/g/glabels/glabels_2.0.0-1.dsc
glabels_2.0.0-1_i386.deb
  to pool/main/g/glabels/glabels_2.0.0-1_i386.deb
glabels_2.0.0.orig.tar.gz
  to pool/main/g/glabels/glabels_2.0.0.orig.tar.gz



A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to 250810@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Andrew Lau <netsnipe@users.sourceforge.net> (supplier of updated glabels package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@debian.org)


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Format: 1.7
Date: Wed, 11 Aug 2004 18:44:51 +1000
Source: glabels
Binary: glabels
Architecture: source i386
Version: 2.0.0-1
Distribution: unstable
Urgency: medium
Maintainer: Andrew Lau <netsnipe@users.sourceforge.net>
Changed-By: Andrew Lau <netsnipe@users.sourceforge.net>
Description: 
 glabels    - Label and business card creation program for GNOME
Closes: 227886 231850 250810 264864
Changes: 
 glabels (2.0.0-1) unstable; urgency=medium
 .
   * New upstream version.
     (closes: #264864)
     - Properly handles old templates
       (closes: #227886)
     - Release critical 64-bit fixes
       (closes: #231850)
     - Manpage now included
       (closes: #250810)
   * Patches regenerated:
     - 00_relibtoolize.patch
   * debian/rules: defuse desktop-file-utils [done by Aaron M. Ucko
     <ucko@debian.org>, who is sponsoring this upload.]
Files: 
 0626437594f10febe868258ad5761cd7 1494 gnome optional glabels_2.0.0-1.dsc
 77a421ee35b64f01a0fbf5ada5944add 1408734 gnome optional glabels_2.0.0.orig.tar.gz
 c0ca704cf7686c3406ccc859f527d49e 75397 gnome optional glabels_2.0.0-1.diff.gz
 db6bbf4e202fe3bc6163421e89c08a36 735596 gnome optional glabels_2.0.0-1_i386.deb

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.5 (GNU/Linux)

iD8DBQFBHs+BWNCxsidXLEcRAo7uAKCm49lYo7qREXnfe4BZSPUk03q/hQCgjmc4
UL3uPiP6YEBOxo53wH3sONY=
=iM6S
-----END PGP SIGNATURE-----