Copyright
=========

   gLabels - a GNOME-based label and business card creation program

   Copyright (C) 2001-2003 Jim Evins

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2 of the License, or
   (at your option) any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

   For more details see the file COPYING.



What is gLabels
===============

gLabels is a small stand-alone program for creating labels and business
cards using a laser or ink-jet printer.


System Requirements
===================

GTK+-2.0.x
LIBGNOMEUI-2.0.x
LIBXML-2.4.x
LIBGNOMEPRINT-2.2.x
LIBGNOMEPRINTUI-2.2.x
LIBGNOMECANVAS-2.0.x

All of these libraries are available as part of Gnome 2.2

Usage notes:
============
gLabels is still in its early stages of development and thus lacks any
"real" documentation.  Most folks have found it fairly easy to use, at
least for its simple composition features.  Beginning with version 0.4.x,
gLabels has a document-merge capability that might not be as intuitive
as these other features.

The first step to performing a document merge is to prepare a source
document that contains your merge data. This data could be mailing
addresses or any other data that you wish to create unique labels or
cards for.  Currently only a simple back-end for text files exists --
others are planned.  The currently supported text-file format is very
simple:  each line is a record; fields are delimited by tabs,
commas, or colons; and newlines can be embedded into fields by using
the "\n" entity.  This file could be created using any text editor or
could be created by another program or script.

A label must then be configured to "point at" this data file.  This is
accomplished with the "merge properties" dialog.  This dialog is used
to select the exact data file format and file name (location).

Finally, once the label has been configured for a data file, field keys
can be inserted into text and barcode objects in their property dialogs.

Now that your label is configured, gLabels will print a unique label for
each record in your source document -- substituting fields from each
record for field keys in the all text and barcode objects.

Beginning with 0.4.3, a simple CLI front-end called "glabels-batch" is
provided to print previously created glabels files from a shell,
other programs or scripts.  Do a "glabels-batch --help" for usage
information.

Author and Acknowledgments:
===========================

See the AUTHORS file.


Website
=======

http://glabels.sourceforge.net/