 /**
 * @page ToolsIvCat ivCat tool
 *
 * @B ivcat @b - concatenates and converts Open Inventor files.
 *
 * @H3 SYNOPSIS: @h3
 *    @B ivCat  [ -bfht ] [ -o file] [file ... ] @b
 *
 * @H3 DESCRIPTION: @h3
 * @B ivcat @b reads each file in sequence and then writes each out. 
 * If no input file is given, or a filename of "-" is specified, ivcat reads from 
 * the standard input file. The input files must be valid Open Inventor 3D Interchange 
 * Format files (1.0, 2.0, 2.1, 8.0).
 *
 * @B ivCat @b is the simplest way to convert file to different header version file 
 * format, in order to get compatible files when converting back to 2.1 version for example,
 * or to get better performance by converting to new 8.0 file format.
 *
 * @H3 USAGE: @h3
 * The following command line options are allowed:
 *
 * @TABLE_1B
 * @TR -b           @TD Write out the files in binary Open Inventor format. The default is to write out the files in Open Inventor's ASCII format.
 * @TR -f           @TD Remove all SoFile nodes. This has the effect of condensing hierarchical files into a single file.
 * @TR -h           @TD	Print usage message.
 * @TR -o file 	    @TD	Send the output to the given file, instead of to the standard output.
 * @TR -s header    @TD allow to convert to a new or previous header string format.
 * @TR -t 	    @TD	Expand SoTexture2 nodes to explictly include the texture data rather than a file name.
 * @TABLE_END
 *
 * @H3 EXAMPLES @h3
 *
 * To convert from binary to ASCII Open Inventor:
 * @code
 *   ivcat binaryfile.iv > asciifile.iv
 * @endcode
 *
 * To convert from ASCII to binary Open Inventor:
 * @code
 *   ivcat -b asciifile.iv > binaryfile.iv
 * @endcode
 *
 * To convert to new 8.0 ASCII Open Inventor:
 * @code
 *   ivCat -s "#Inventor V8.0 binary" -o outputFile.iv inputFile.iv
 * @endcode
 *
 * To convert back to 2.1 ASCII Open Inventor:
 * @code
 *   ivCat -s "#Inventor V2.1 ascii" -o outputFile.iv inputFile.iv
 * @endcode
 *
 * @FILE_LIST
 * @UL
 * @LI tools/source/ivCat/ivCat.cxx @li
 * @LI tools/source/ivCat/getopt/getopt.c @li
 * @LI tools/source/ivCat/getopt/getopt.h @li
 * @ul
 *
 */
