Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   31170 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

STAG-SPLITTER(1)      User Contributed Perl Documentation     STAG-SPLITTER(1)

NAME
       stag-splitter.pl - splits a stag file into multiple files

SYNOPSIS
	 stag-splitter.pl -split person -name social_security_no file.xml

DESCRIPTION
       Splits a file using a user specified parser (default xml) around a
       specified split node, naming each file according to the name argument

       the files will be named anonymously, unless the '-name' switch is
       specified; this will use the value of the specified element as the
       filename

       eg; if we have

	 <top>
	   <a>
	     <b>foo</b>
	     <c>yah</c>
	     <d>
	       <e>xxx</e>
	     </d>
	   </a>
	   <a>
	     <b>bar</b>
	     <d>
	       <e>wibble</e>
	     </d>
	   </a>
	 </top>

       if we run

	 stag-splitter.pl -split a -name b

       it will generate two files, "foo.xml" and "bar.xml"

       input format can be 'xml', 'sxpr' or 'itext' - if this is left blank
       the format will be guessed from the file suffix

       the output format defaults to the same as the input format, but another
       can be chosen.

       files go in the current directory, but this can be overridden with the
       '-dir' switch

USAGE
	  stag-splitter.pl [-split <ELEMENT-NAME>] [-name <ELEMENT-NAME>] [-dir <DIR>] [-format <INPUT-FORMAT>] [-outformat <OUTPUT-FORMAT>] <FILENAMES>

       -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

       -split|s NODE
	   node to split on

       -name|n NODE
	   field/element to use when naming files

	   will use surrogate IDs if this argument not specified

       -dir|d DIR
	   write files to this directory

perl v5.14.1			  2003-12-11		      STAG-SPLITTER(1)

Vote for polarhome