NAME

       genreflex - Generates the LCG dictionary file for each header file

SYNOPSIS

       genreflex headerfile1.h [headerfile2.h] [options] [preprocesor options]

DESCRIPTION

       Generates the LCG dictionary file for each header file

OPTIONS

       -s file, --selection_file=file
              Class  selection file to specify for which classes the dictionary will be generated
              Format (XML):

              <lcgdict>
                [<selection>]
                  <class [name="classname"] [pattern="wildname"]
                         [file_name="filename"] [file_pattern="wildname"]
                         [id="xxxx"] [type="vector"]/>
                  <class name="classname" >
                    <field name="m_transient" transient="true"/>
                    <field name="m_anothertransient" transient="true"/>
                    <properties prop1="value1" [prop2="value2"]/>
                  </class>
                  <function [name="funcname"] [pattern="wildname"] />
                  <enum [name="enumname"] [patter="wildname"] />
                  <variable [name="varname"] [patter="wildname"] />
                [</selection>]
                <exclusion>
                  <class [name="classname"] [pattern="wildname"]>
                    <method name="unwanted" />
                  </class>
                </exclusion>
                ...
              </lcgdict>

       See also the section SELECTION FILE SYNTAX below.

       -o file, --output file
              Output file name. If an existing directory is specified instead of a file,  then  a
              filename  will  be build using the name of the input file and will be placed in the
              given directory. <headerfile>_rflx.cpp

       --pool Generate minimal dictionary required for POOL persistence

       --deep Generate dictionary for all dependend classes

       --split (OBSOLETE)
              Generate separate file for stub functions. Option sometimes needed on Windows.

       --reflex (OBSOLETE)
              Generate Reflex dictionaries.

       --comments
              Add end-of-line comments in  data  and  functions  members  as  a  property  called
              "comment"

       --no_membertypedefs
              Disable the definition of class member typedefs

       --fail_on_warnings
              The genreflex command fails (retuns the value 1) if any warning message is issued

       --gccxmlpath=path
              Path  path  where the gccxml(1) tool is installed. If not defined the standard PATH
              environ variable is used

       -c file, --capabilities=file
              Generate the capabilities file to be used by the SEAL  Plugin  Manager.  This  file
              lists the names of all classes for which the reflection is formation is provided.

       --rootmap=file
              Generate the rootmap file to be used by ROOT/CINT. This file lists the names of all
              classes for which the reflection is formation is provided.

       --rootmap-lib=library
              Library name for the rootmap file.

       --debug
              Print extra debug information while processing. Keep intermediate files

       --quiet
              No not print informational messages

       -h, --help
              Print help

       Try "genreflex --help" for more information.

SELECTION FILE SYNTAX

   <lcgdict>
       Sub elements:
              <selection> <exclusion> <class> <function>

       Attributes:
              none

       The root element of the xml file. It has to be present.

   <selection>
       Sub elements:
              <class> <function>

       Attributes:
              none

       The selection element is only mandatory if the <exclusion> element is  used  in  the  same
       file.  Otherwise  all  sub-elements  of  <lcgdict>  are  supposed  to  be  included in the
       dictionary.

   <exclusion>
       Sub elements:
              <class> <function>

       Attributes:
              none

       If a <selection> element is present it is also possible to  exclude  types  following  the
       same patterns as for selection

   <class>
       Sub elements:
              <field> <properties> <method>

       Attributes:

              name
                     The  exact  name of the class to be filtered pattern    A pattern matching a
                     set of classes

              file_name
                     The exact file name to be filtered. All classes contained in the  file  will
                     be selected

              file_pattern
                     A pattern matching a set of files

              id     The class ID (used for POOL persistence)

              type
                     The class type (used for POOL persistence)

       All  classes  matching the patterns or names in the attributes will be selected. The name,
       pattern, file_name, and file_pattern attributes are mutual exclusive.

   <function>
       Sub elements:
              none

       Attributes:

              name   The exact name of the function

              pattern
                     A pattern matching a set of functions

       All function matching the  attributes  of  the  function  element  will  be  selected  and
       dictionaries will be created for them. The nameandpattern attributes are mutual exclusive.

   <field>
       Sub elements:
              none

       Attributes:

              name   The exact name of the field

              transient
                     If set to true a property (transient/true) will be set for this member (used
                     for POOL persistence)

       The <field> element is mainly used for POOL persistence  to  mark  if  some  of  the  data
       members of a class shall be skipped when the class is written to a persistent medium

   <method>
       Sub elements:
              none

       Attributes:

       name   The name of the method to be excluded

       The <method> element is used to exclude the dictionary generation from classes which match
       the given attributes.

SEE ALSO

       root(1), rootcint(1), gccxml(1)

       See also the ROOT webpages: http://root.cern.ch ⟨http://root.cern.ch⟩

ORIGINAL AUTHORS

       The ROOT team (see web page above):
              Rene Brun and Fons Rademakers

COPYRIGHT

       This library is free software; you can redistribute it and/or modify it under the terms of
       the GNU Lesser General Public License as published by the Free Software Foundation; either
       version 2.1 of the License, or (at your option) any later version.

       This library is distributed in the hope that it will be useful, but WITHOUT ANY  WARRANTY;
       without  even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
       See the GNU Lesser General Public License for more details.

       You should have received a copy of the GNU Lesser General Public License along  with  this
       library; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
       Boston, MA  02110-1301  USA

AUTHOR

       This manual page was written by Christian Holm Christensen <cholm@nbi.dk>, for the  Debian
       GNU/Linux system (but may be used by others).