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

ROOT Version 5 GENREFLEX(1)