sabcmd

sabcmd(1)							    sabcmd(1)



NAME
       sabcmd - a command line interface to Sablotron XSLT processor

SYNOPSIS
       sabcmd [options] <stylesheet> [<input> [<output>]] [assignments]
       sabcmd	[options]   -batch-xml	 <input>  [<stylesheet>	 [<output>]]+
       [assignments]
       sabcmd  [options]  -batch-xsl   <stylesheet>   [<input>	 [<output>]]+
       [assignments]

DESCRIPTION
       sabcmd  is  a  command line interface to Sablotron XSLT processor. You
       can use is to transform XML files with XSLT stylesheets.

       The only required parameter is a stylesheet; this is a URI of an	 XSLT
       stylesheet  to  be used for the transformation process. If you omit an
       input file, the standard input is used. In addition, you	 can  specify
       an  output file. If no output file is given, the output is sent to the
       standard output.

       sabcmd can also run in a batch mode to process single input file	 with
       multiple	 stylesheets (--batch-xml) or to apply a stylesheet to multi-
       ple input files (--batch-xsl).

       Assignments allow to pass parameters and named buffers to the  proces-
       sor. The assignments have always the form of

	      name1=value1 name2=value2 ...

       where  name  is	either	an ASCII string for named buffers or an ASCII
       string with the leading ’$’ sign for parameters. (Note that  you	 need
       to use the right quotes to prevent the shell interpreter from perform-
       ing an expansion of variables).

OPTIONS
       Option can be of two forms - short or long. If some options have	 val-
       ues,  the values are separated with a whitespace for short options and
       with a equal sign (’=’) for long options.

	      -L mylog.log

       is the same as

	      --log-file=mylog.log

   COMMON OPTIONS
       -x, --batch-xml
	      multiple stylesheets, single input file

       -s, --batch-xsl
	      multiple input files, single stylesheet

       -b, --base=NAME
	      set the hard base URI to NAME

       --debug-options
	      display the information on debugging options

       -?, --help
	      display this help message

       -L, --log-file=NAME
	      set the log file, turns logging on

       -m, --measure
	      measure the time of processing

       -v, --version
	      display the version information

   DEBUG OPTIONS
       --debug
	      display results of the command line parse

       -t, --times=COUNT
	      run sabcmd the specified number of times

       -f, --flags
	      pass flags given to SablotSetOptions()

       -F, --use-SPF
	      use SablotProcessFiles()

       -S, --use-SPS
	      use SablotProcessStrings(). Give 2  args	(stylesheet,  input).
	      Precede each by @.

       --use-SPS-on-files
	      use  SablotProcessStrings() on the contents of the given files.

ENVIRONMENT
       When the <xsl:sort> instruction is used without the ’lang’  attribute,
       common locale related environment variables apply..

BUGS
       There  are no known bugs related to sabcmd currently. Most of bugs you
       can meet are related to Sablotron processor itself. In  such  a	case,
       please  take a look at Sablotron’s home website (www.gingerall.org) or
       contact us at <sab-bugs@gingerall.cz>.


AUTHOR
       Pavel Hlavnicka <pavel@gingerall.cz>



				June 17, 2002			    sabcmd(1)