1GENREFLEX(1) General Commands Manual GENREFLEX(1)
2
3
4
6 genreflex - Generates the LCG dictionary file for each header file
7
9 genreflex headerfile1.h [headerfile2.h] [options] [preprocesor options]
10
12 Generates the LCG dictionary file for each header file
13
15 -s file, --selection_file=file
16 Class selection file to specify for which classes the dictionary
17 will be generated Format (XML):
18
19 <lcgdict>
20 [<selection>]
21 <class [name="classname"] [pattern="wildname"]
22 [file_name="filename"] [file_pattern="wildname"]
23 [id="xxxx"] [type="vector"]/>
24 <class name="classname" >
25 <field name="m_transient" transient="true"/>
26 <field name="m_anothertransient" transient="true"/>
27 <properties prop1="value1" [prop2="value2"]/>
28 </class>
29 <function [name="funcname"] [pattern="wildname"] />
30 <enum [name="enumname"] [patter="wildname"] />
31 <variable [name="varname"] [patter="wildname"] />
32 [</selection>]
33 <exclusion>
34 <class [name="classname"] [pattern="wildname"]>
35 <method name="unwanted" />
36 </class>
37 </exclusion>
38 ...
39 </lcgdict>
40
41 See also the section SELECTION FILE SYNTAX below.
42
43 -o file, --output file
44 Output file name. If an existing directory is specified instead
45 of a file, then a filename will be build using the name of the
46 input file and will be placed in the given directory. <header‐
47 file>_rflx.cpp
48
49 --pool Generate minimal dictionary required for POOL persistence
50
51 --deep Generate dictionary for all dependend classes
52
53 --split (OBSOLETE)
54 Generate separate file for stub functions. Option sometimes
55 needed on Windows.
56
57 --reflex (OBSOLETE)
58 Generate Reflex dictionaries.
59
60 --comments
61 Add end-of-line comments in data and functions members as a
62 property called "comment"
63
64 --no_membertypedefs
65 Disable the definition of class member typedefs
66
67 --fail_on_warnings
68 The genreflex command fails (retuns the value 1) if any warning
69 message is issued
70
71 --gccxmlpath=path
72 Path path where the gccxml(1) tool is installed. If not defined
73 the standard PATH environ variable is used
74
75 -c file, --capabilities=file
76 Generate the capabilities file to be used by the SEAL Plugin
77 Manager. This file lists the names of all classes for which the
78 reflection is formation is provided.
79
80 --rootmap=file
81 Generate the rootmap file to be used by ROOT/CINT. This file
82 lists the names of all classes for which the reflection is for‐
83 mation is provided.
84
85 --rootmap-lib=library
86 Library name for the rootmap file.
87
88 --debug
89 Print extra debug information while processing. Keep intermedi‐
90 ate files
91
92 --quiet
93 No not print informational messages
94
95 -h, --help
96 Print help
97
98 Try "genreflex --help" for more information.
99
101 <lcgdict>
102 Sub elements:
103 <selection> <exclusion> <class> <function>
104
105 Attributes:
106 none
107
108 The root element of the xml file. It has to be present.
109
110 <selection>
111 Sub elements:
112 <class> <function>
113
114 Attributes:
115 none
116
117 The selection element is only mandatory if the <exclusion> element is
118 used in the same file. Otherwise all sub-elements of <lcgdict> are sup‐
119 posed to be included in the dictionary.
120
121 <exclusion>
122 Sub elements:
123 <class> <function>
124
125 Attributes:
126 none
127
128 If a <selection> element is present it is also possible to exclude
129 types following the same patterns as for selection
130
131 <class>
132 Sub elements:
133 <field> <properties> <method>
134
135 Attributes:
136
137 name
138 The exact name of the class to be filtered pattern A
139 pattern matching a set of classes
140
141 file_name
142 The exact file name to be filtered. All classes contained
143 in the file will be selected
144
145 file_pattern
146 A pattern matching a set of files
147
148 id The class ID (used for POOL persistence)
149
150 type
151 The class type (used for POOL persistence)
152
153 All classes matching the patterns or names in the attributes will be
154 selected. The name, pattern, file_name, and file_pattern attributes are
155 mutual exclusive.
156
157 <function>
158 Sub elements:
159 none
160
161 Attributes:
162
163 name The exact name of the function
164
165 pattern
166 A pattern matching a set of functions
167
168 All function matching the attributes of the function element will be
169 selected and dictionaries will be created for them. The nameandpattern
170 attributes are mutual exclusive.
171
172 <field>
173 Sub elements:
174 none
175
176 Attributes:
177
178 name The exact name of the field
179
180 transient
181 If set to true a property (transient/true) will be set
182 for this member (used for POOL persistence)
183
184 The <field> element is mainly used for POOL persistence to mark if some
185 of the data members of a class shall be skipped when the class is writ‐
186 ten to a persistent medium
187
188 <method>
189 Sub elements:
190 none
191
192 Attributes:
193
194 name The name of the method to be excluded
195
196 The <method> element is used to exclude the dictionary generation from
197 classes which match the given attributes.
198
199
201 root(1), rootcint(1), gccxml(1)
202
203 See also the ROOT webpages: http://root.cern.ch
204
206 The ROOT team (see web page above):
207 Rene Brun and Fons Rademakers
208
210 This library is free software; you can redistribute it and/or modify it
211 under the terms of the GNU Lesser General Public License as published
212 by the Free Software Foundation; either version 2.1 of the License, or
213 (at your option) any later version.
214
215 This library is distributed in the hope that it will be useful, but
216 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
217 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
218 General Public License for more details.
219
220 You should have received a copy of the GNU Lesser General Public
221 License along with this library; if not, write to the Free Software
222 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301
223 USA
224
226 This manual page was written by Christian Holm Christensen
227 <cholm@nbi.dk>, for the Debian GNU/Linux system (but may be used by
228 others).
229
230
231
232ROOT Version 5 GENREFLEX(1)