debian man page for stag-join

STAG-JOIN(1p)						User Contributed Perl Documentation					     STAG-JOIN(1p)

NAME
       stag-join - joins two stag files together based around common key

SYNOPSIS
	 stag-join  -w xml country/city_id=capital/capital_id countries.xml capitals.xml

	 stag-join  -w itext gene/tax_id=species/tax_id genedb.itext speciesdb.itext

DESCRIPTION
       Performs a relational-style INNER JOIN between two stag trees; this effectively merges two files together, based on some kind of ID in the
       file

ARGUMENTS
       -p|parser FORMAT
	   FORMAT is one of xml, sxpr or itext, or the name of a perl module

	   xml assumed as default

       -w|writer FORMAT
	   FORMAT is one of xml, sxpr or itext, or the name of a perl module

LIMITATIONS
       currently not event based, so may not be memory efficicent. could be easily rewritten to be event based

SEE ALSO
       Data::Stag

       This script is a wrapper for the method

	 Data::Stag->ijoin()

perl v5.10.0							    2008-12-23							     STAG-JOIN(1p)