GENREFLEX(1)

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).