Kugar - A report creation tool for KDE.

Current version: 1.2

The current maintainer and the author of Kugar Report Designer
can be reached via Email: cloudtemple@mksat.net
or visit http://www.thekompany.com/projects/kugar

The former maintainer and author of Kugar report viewer and konqueror
part can be reached via Email: phil@river-bank.demon.co.uk

The original author can be reached via Email: keidav@mutinybaysoftware.com
or visit http://www.mutinybaysoftware.com.  The original name of the package
was Metaphrast.


ABOUT KUGAR:

Current features:

* KDE GUI report designer
* Qt report viewer widget for previewing reports from within a Qt application
  (WYSIWYG).
* KDE report viewer widget that utilizes KDE print dialog
* KDE report viewer utility.
* KPart report viewer component - view reports from within Konqueror.
* Report printing in Postscript.
* Database/datasource neutral, data is supplied to the report engine in XML.
* Open report definition files, report layout is stored in XML.
* Report Header/Footer.
* Page Header/Footer.
* Detail Section.
* Detail Header/Footer.
* Multiple Detail levels (unlimited).
* Grand totals: count, sum, average, variance and standard deviation.
* Report print progress and cancellation.
* Report rendering progress and cancellation.
* Complete implementation of (Qt) printer setup options.
* Additional formatting (negative numbers, currency, commas for numbers and
  dates).


DOCUMENTATION:

The first draft of the user documentation can be found in ./docs.


REQUIREMENTS:

The following items must be installed prior to building Kugar:

1. Qt version 3.0+		- http://www.trolltech.com
2. KDE 3.0.0+			- http://www.kde.org


BUILDING KUGAR:

Basically:

	./configure
	make
	make install

See the INSTALL file for details.


RUNNING A SAMPLE REPORT WITH KUGAR:

There are tree sample templates and matching datafiles in ./samples.

The kugar program takes two commandline arguments:
	-d <xml data file>
	-r <xml report template URL>

Example: kugar -d samples/sample1.kud -r samples/sample1.kut

If the template file is omitted then any template specified in the data file
will be used.

To use Konqueror to display a sample, just click on the data file (with the
.kud extension) from within Konqueror.

To create template file run Kugar Report Designer program (kudesigner).
To add report items and sections use toolbuttons and menus,
to edit their properties just right-click on them,
to delete - middle-click.
