URL https://opencores.org/ocsvn/openrisc_2011-10-31/openrisc_2011-10-31/trunk

Subversion Repositories openrisc_2011-10-31

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [cdl-guide/] [ref.cdl-component.html] - Blame information for rev 369

Go to most recent revision | Details | Compare with Previous | View Log


<!-- Copyright (C) 2003 Red Hat, Inc.                                -->
<!-- This material may be distributed only subject to the terms      -->
<!-- and conditions set forth in the Open Publication License, v1.0  -->
<!-- or later (the latest version is presently available at          -->
<!-- http://www.opencontent.org/openpub/).                           -->
<!-- Distribution of the work or derivative of the work in any       -->
<!-- standard (paper) book form is prohibited unless prior           -->
<!-- permission is obtained from the copyright holder.               -->
<HTML
><HEAD
><TITLE
>cdl_component</TITLE
><meta name="MSSmartTagsPreventParsing" content="TRUE">
<META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="The eCos Component Writer's Guide"
HREF="cdl-guide.html"><LINK
REL="UP"
TITLE="CDL Language Specification"
HREF="reference.html"><LINK
REL="PREVIOUS"
TITLE="cdl_option"
HREF="ref.cdl-option.html"><LINK
REL="NEXT"
TITLE="cdl_package"
HREF="ref.cdl-package.html"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>The <SPAN
CLASS="APPLICATION"
>eCos</SPAN
> Component Writer's Guide</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="ref.cdl-option.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="ref.cdl-package.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="REF.CDL-COMPONENT"><TT
CLASS="LITERAL"
>cdl_component</TT
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN3091"
></A
><H2
>Name</H2
>Command <TT
CLASS="LITERAL"
>cdl_component</TT
>&nbsp;--&nbsp;Define a component, a collection of configuration options</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN3095"><H2
>Synopsis</H2
><TABLE
BORDER="5"
BGCOLOR="#E0E0F0"
WIDTH="70%"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>cdl_component &lt;name&gt; {
    &#8230;
}</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN3097"
></A
><H2
>Description</H2
><P
>A component is a configuration option that can contain additional
options and sub-components. The body of a <TT
CLASS="LITERAL"
>cdl_component</TT
> can contain
the same properties as that of a <TT
CLASS="LITERAL"
>cdl_option</TT
>. There is an additional
property, <SPAN
CLASS="PROPERTY"
>script</SPAN
> which allows configuration data to be split into
multiple files. It is also possible for a component body to include
<TT
CLASS="LITERAL"
>cdl_component</TT
>, <TT
CLASS="LITERAL"
>cdl_option</TT
> and <TT
CLASS="LITERAL"
>cdl_interface</TT
> entities that should
go below this component in the configuration hierarchy.</P
><P
><TT
CLASS="LITERAL"
>cdl_component</TT
> is implemented as a Tcl command that takes two
arguments, a name and a body. The name must be a valid C preprocessor
identifier: a sequence of upper or lower case letters, digits or
underscores, starting with a non-digit character; identifiers
beginning with an underscore should normally be avoided because they
may clash with system packages or with identifiers reserved for use by
the compiler. Within a single configuration, names must be unique. If
a configuration contained two packages which defined the same entity
<TT
CLASS="LITERAL"
>CYGIMP_SOME_OPTION</TT
>, any references to that entity
in a <SPAN
CLASS="PROPERTY"
>requires</SPAN
> property or any other expression would be ambiguous.
It is possible for a given name to be used by two different packages
if those packages should never be loaded into a single configuration.
For example, architectural HAL packages are allowed to re-use certain
names because a single configuration cannot target two different
architectures. For a recommended naming convention see <A
HREF="package.contents.html"
>the Section called <I
>Package Contents and Layout</I
> in Chapter 2</A
>.</P
><P
>The second argument to <TT
CLASS="LITERAL"
>cdl_component</TT
> is a body of properties and
other commands, typically surrounded by braces so that the Tcl
interpreter treats it as a single argument. This body will be
processed by a recursive invocation of the Tcl interpreter, extended
with additional commands for the various properties that are allowed
inside a <TT
CLASS="LITERAL"
>cdl_component</TT
>. The valid commands are:</P
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><A
HREF="ref.active-if.html"
><SPAN
CLASS="PROPERTY"
>active_if</SPAN
></A
></DT
><DD
><P
>Allow additional control over the active state of this component.</P
></DD
><DT
><A
HREF="ref.calculated.html"
><SPAN
CLASS="PROPERTY"
>calculated</SPAN
></A
></DT
><DD
><P
>The component's value is not directly user-modifiable, it is calculated
using a suitable CDL expression.</P
></DD
><DT
><A
HREF="ref.cdl-component.html"
><TT
CLASS="LITERAL"
>cdl_component</TT
></A
></DT
><DD
><P
>Define a sub-component.</P
></DD
><DT
><A
HREF="ref.cdl-interface.html"
><TT
CLASS="LITERAL"
>cdl_interface</TT
></A
></DT
><DD
><P
>Define an interface which should appear immediately below this
component in the configuration hierarchy.</P
></DD
><DT
><A
HREF="ref.cdl-option.html"
><TT
CLASS="LITERAL"
>cdl_option</TT
></A
></DT
><DD
><P
>Define a configuration option which should appear immediately below
this component in the configuration hierarchy.</P
></DD
><DT
><A
HREF="ref.compile.html"
><SPAN
CLASS="PROPERTY"
>compile</SPAN
></A
></DT
><DD
><P
>List the source files that should be built if this component is active
and enabled.</P
></DD
><DT
><A
HREF="ref.default-value.html"
><SPAN
CLASS="PROPERTY"
>default_value</SPAN
></A
></DT
><DD
><P
>Provide a default value for this component using a CDL expression.</P
></DD
><DT
><A
HREF="ref.define.html"
><SPAN
CLASS="PROPERTY"
>define</SPAN
></A
></DT
><DD
><P
>Specify additional <TT
CLASS="LITERAL"
>#define</TT
> symbols that should go
into the owning package's configuration header file.</P
></DD
><DT
><A
HREF="ref.define-format.html"
><SPAN
CLASS="PROPERTY"
>define_format</SPAN
></A
></DT
><DD
><P
>Control how the component's value will appear in the configuration header
file.</P
></DD
><DT
><A
HREF="ref.define-proc.html"
><SPAN
CLASS="PROPERTY"
>define_proc</SPAN
></A
></DT
><DD
><P
>Use a fragment of Tcl code to output additional data to
configuration header files.</P
></DD
><DT
><A
HREF="ref.description.html"
><SPAN
CLASS="PROPERTY"
>description</SPAN
></A
></DT
><DD
><P
>Provide a textual description for this component.</P
></DD
><DT
><A
HREF="ref.display.html"
><SPAN
CLASS="PROPERTY"
>display</SPAN
></A
></DT
><DD
><P
>Provide a short string describing this component.</P
></DD
><DT
><A
HREF="ref.doc.html"
><SPAN
CLASS="PROPERTY"
>doc</SPAN
></A
></DT
><DD
><P
>The location of on-line documentation for this component.</P
></DD
><DT
><A
HREF="ref.flavor.html"
><SPAN
CLASS="PROPERTY"
>flavor</SPAN
></A
></DT
><DD
><P
>Specify the nature of this component.</P
></DD
><DT
><A
HREF="ref.if-define.html"
><SPAN
CLASS="PROPERTY"
>if_define</SPAN
></A
></DT
><DD
><P
>Output a common preprocessor construct to a configuration header file. </P
></DD
><DT
><A
HREF="ref.implements.html"
><SPAN
CLASS="PROPERTY"
>implements</SPAN
></A
></DT
><DD
><P
>Enabling this component provides one instance of a more general
interface. </P
></DD
><DT
><A
HREF="ref.legal-values.html"
><SPAN
CLASS="PROPERTY"
>legal_values</SPAN
></A
></DT
><DD
><P
>Impose constraints on the possible values for this component.</P
></DD
><DT
><A
HREF="ref.make.html"
><SPAN
CLASS="PROPERTY"
>make</SPAN
></A
></DT
><DD
><P
>An additional custom build step associated with this component, resulting
in a target that should not go directly into a library.</P
></DD
><DT
><A
HREF="ref.make-object.html"
><SPAN
CLASS="PROPERTY"
>make_object</SPAN
></A
></DT
><DD
><P
>An additional custom build step associated with this component, resulting
in an object file that should go into a library.</P
></DD
><DT
><A
HREF="ref.no-define.html"
><SPAN
CLASS="PROPERTY"
>no_define</SPAN
></A
></DT
><DD
><P
>Suppress the normal generation of a preprocessor
<TT
CLASS="LITERAL"
>#define</TT
> symbol in a configuration header file.</P
></DD
><DT
><A
HREF="ref.parent.html"
><SPAN
CLASS="PROPERTY"
>parent</SPAN
></A
></DT
><DD
><P
>Control the location of this component in the configuration hierarchy. </P
></DD
><DT
><A
HREF="ref.requires.html"
><SPAN
CLASS="PROPERTY"
>requires</SPAN
></A
></DT
><DD
><P
>List constraints that the configuration should satisfy if this component is
active and enabled.</P
></DD
><DT
><A
HREF="ref.script.html"
><SPAN
CLASS="PROPERTY"
>script</SPAN
></A
></DT
><DD
><P
>Include additional configuration information from another
CDL script</P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN3255"
></A
><H2
>Example</H2
><P
><TABLE
BORDER="5"
BGCOLOR="#E0E0F0"
WIDTH="70%"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>cdl_component CYGDBG_USE_ASSERTS {
    display       "Use asserts"
    default_value 1
    description   "
        If this component is enabled, assertions in the code are
        tested at run-time. Assert functions (CYG_ASSERT()) are
        defined in 'include/cyg/infra/cyg_ass.h' within the 'install'
        tree. If the component is disabled, these result in no
        additional object code and no checking of the asserted
        conditions."
    script        assert.cdl
}</PRE
></TD
></TR
></TABLE
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN3259"
></A
><H2
>See Also</H2
><P
>Command <A
HREF="ref.cdl-option.html"
><TT
CLASS="LITERAL"
>cdl_option</TT
></A
>,
command <A
HREF="ref.cdl-package.html"
><TT
CLASS="LITERAL"
>cdl_package</TT
></A
>,
command <A
HREF="ref.cdl-interface.html"
><TT
CLASS="LITERAL"
>cdl_interface</TT
></A
>.</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="ref.cdl-option.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="cdl-guide.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="ref.cdl-package.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><TT
CLASS="LITERAL"
>cdl_option</TT
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="reference.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><TT
CLASS="LITERAL"
>cdl_package</TT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>

Line No.	Rev	Author	Line
1	28	unneback	`<!-- Copyright (C) 2003 Red Hat, Inc. -->`
2			`<!-- This material may be distributed only subject to the terms -->`
3			`<!-- and conditions set forth in the Open Publication License, v1.0 -->`
4			`<!-- or later (the latest version is presently available at -->`
5			`<!-- http://www.opencontent.org/openpub/). -->`
6			`<!-- Distribution of the work or derivative of the work in any -->`
7			`<!-- standard (paper) book form is prohibited unless prior -->`
8			`<!-- permission is obtained from the copyright holder. -->`
9			`<HTML`
10			`><HEAD`
11			`><TITLE`
12			`>cdl_component</TITLE`
13			`><meta name="MSSmartTagsPreventParsing" content="TRUE">`
14			`<META`
15			`NAME="GENERATOR"`
16			`CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+`
17			`"><LINK`
18			`REL="HOME"`
19			`TITLE="The eCos Component Writer's Guide"`
20			`HREF="cdl-guide.html"><LINK`
21			`REL="UP"`
22			`TITLE="CDL Language Specification"`
23			`HREF="reference.html"><LINK`
24			`REL="PREVIOUS"`
25			`TITLE="cdl_option"`
26			`HREF="ref.cdl-option.html"><LINK`
27			`REL="NEXT"`
28			`TITLE="cdl_package"`
29			`HREF="ref.cdl-package.html"></HEAD`
30			`><BODY`
31			`CLASS="REFENTRY"`
32			`BGCOLOR="#FFFFFF"`
33			`TEXT="#000000"`
34			`LINK="#0000FF"`
35			`VLINK="#840084"`
36			`ALINK="#0000FF"`
37			`><DIV`
38			`CLASS="NAVHEADER"`
39			`><TABLE`
40			`SUMMARY="Header navigation table"`
41			`WIDTH="100%"`
42			`BORDER="0"`
43			`CELLPADDING="0"`
44			`CELLSPACING="0"`
45			`><TR`
46			`><TH`
47			`COLSPAN="3"`
48			`ALIGN="center"`
49			`>The <SPAN`
50			`CLASS="APPLICATION"`
51			`>eCos</SPAN`
52			`> Component Writer's Guide</TH`
53			`></TR`
54			`><TR`
55			`><TD`
56			`WIDTH="10%"`
57			`ALIGN="left"`
58			`VALIGN="bottom"`
59			`><A`
60			`HREF="ref.cdl-option.html"`
61			`ACCESSKEY="P"`
62			`>Prev</A`
63			`></TD`
64			`><TD`
65			`WIDTH="80%"`
66			`ALIGN="center"`
67			`VALIGN="bottom"`
68			`></TD`
69			`><TD`
70			`WIDTH="10%"`
71			`ALIGN="right"`
72			`VALIGN="bottom"`
73			`><A`
74			`HREF="ref.cdl-package.html"`
75			`ACCESSKEY="N"`
76			`>Next</A`
77			`></TD`
78			`></TR`
79			`></TABLE`
80			`><HR`
81			`ALIGN="LEFT"`
82			`WIDTH="100%"></DIV`
83			`><H1`
84			`><A`
85			`NAME="REF.CDL-COMPONENT"><TT`
86			`CLASS="LITERAL"`
87			`>cdl_component</TT`
88			`></H1`
89			`><DIV`
90			`CLASS="REFNAMEDIV"`
91			`><A`
92			`NAME="AEN3091"`
93			`></A`
94			`><H2`
95			`>Name</H2`
96			`>Command <TT`
97			`CLASS="LITERAL"`
98			`>cdl_component</TT`
99			`> -- Define a component, a collection of configuration options</DIV`
100			`><DIV`
101			`CLASS="REFSYNOPSISDIV"`
102			`><A`
103			`NAME="AEN3095"><H2`
104			`>Synopsis</H2`
105			`><TABLE`
106			`BORDER="5"`
107			`BGCOLOR="#E0E0F0"`
108			`WIDTH="70%"`
109			`><TR`
110			`><TD`
111			`><PRE`
112			`CLASS="SYNOPSIS"`
113			`>cdl_component <name> {`
114			`…`
115			`}</PRE`
116			`></TD`
117			`></TR`
118			`></TABLE`
119			`></DIV`
120			`><DIV`
121			`CLASS="REFSECT1"`
122			`><A`
123			`NAME="AEN3097"`
124			`></A`
125			`><H2`
126			`>Description</H2`
127			`><P`
128			`>A component is a configuration option that can contain additional`
129			`options and sub-components. The body of a <TT`
130			`CLASS="LITERAL"`
131			`>cdl_component</TT`
132			`> can contain`
133			`the same properties as that of a <TT`
134			`CLASS="LITERAL"`
135			`>cdl_option</TT`
136			`>. There is an additional`
137			`property, <SPAN`
138			`CLASS="PROPERTY"`
139			`>script</SPAN`
140			`> which allows configuration data to be split into`
141			`multiple files. It is also possible for a component body to include`
142			`<TT`
143			`CLASS="LITERAL"`
144			`>cdl_component</TT`
145			`>, <TT`
146			`CLASS="LITERAL"`
147			`>cdl_option</TT`
148			`> and <TT`
149			`CLASS="LITERAL"`
150			`>cdl_interface</TT`
151			`> entities that should`
152			`go below this component in the configuration hierarchy.</P`
153			`><P`
154			`><TT`
155			`CLASS="LITERAL"`
156			`>cdl_component</TT`
157			`> is implemented as a Tcl command that takes two`
158			`arguments, a name and a body. The name must be a valid C preprocessor`
159			`identifier: a sequence of upper or lower case letters, digits or`
160			`underscores, starting with a non-digit character; identifiers`
161			`beginning with an underscore should normally be avoided because they`
162			`may clash with system packages or with identifiers reserved for use by`
163			`the compiler. Within a single configuration, names must be unique. If`
164			`a configuration contained two packages which defined the same entity`
165			`<TT`
166			`CLASS="LITERAL"`
167			`>CYGIMP_SOME_OPTION</TT`
168			`>, any references to that entity`
169			`in a <SPAN`
170			`CLASS="PROPERTY"`
171			`>requires</SPAN`
172			`> property or any other expression would be ambiguous.`
173			`It is possible for a given name to be used by two different packages`
174			`if those packages should never be loaded into a single configuration.`
175			`For example, architectural HAL packages are allowed to re-use certain`
176			`names because a single configuration cannot target two different`
177			`architectures. For a recommended naming convention see <A`
178			`HREF="package.contents.html"`
179			`>the Section called <I`
180			`>Package Contents and Layout</I`
181			`> in Chapter 2</A`
182			`>.</P`
183			`><P`
184			`>The second argument to <TT`
185			`CLASS="LITERAL"`
186			`>cdl_component</TT`
187			`> is a body of properties and`
188			`other commands, typically surrounded by braces so that the Tcl`
189			`interpreter treats it as a single argument. This body will be`
190			`processed by a recursive invocation of the Tcl interpreter, extended`
191			`with additional commands for the various properties that are allowed`
192			`inside a <TT`
193			`CLASS="LITERAL"`
194			`>cdl_component</TT`
195			`>. The valid commands are:</P`
196			`><P`
197			`></P`
198			`><DIV`
199			`CLASS="VARIABLELIST"`
200			`><DL`
201			`><DT`
202			`><A`
203			`HREF="ref.active-if.html"`
204			`><SPAN`
205			`CLASS="PROPERTY"`
206			`>active_if</SPAN`
207			`></A`
208			`></DT`
209			`><DD`
210			`><P`
211			`>Allow additional control over the active state of this component.</P`
212			`></DD`
213			`><DT`
214			`><A`
215			`HREF="ref.calculated.html"`
216			`><SPAN`
217			`CLASS="PROPERTY"`
218			`>calculated</SPAN`
219			`></A`
220			`></DT`
221			`><DD`
222			`><P`
223			`>The component's value is not directly user-modifiable, it is calculated`
224			`using a suitable CDL expression.</P`
225			`></DD`
226			`><DT`
227			`><A`
228			`HREF="ref.cdl-component.html"`
229			`><TT`
230			`CLASS="LITERAL"`
231			`>cdl_component</TT`
232			`></A`
233			`></DT`
234			`><DD`
235			`><P`
236			`>Define a sub-component.</P`
237			`></DD`
238			`><DT`
239			`><A`
240			`HREF="ref.cdl-interface.html"`
241			`><TT`
242			`CLASS="LITERAL"`
243			`>cdl_interface</TT`
244			`></A`
245			`></DT`
246			`><DD`
247			`><P`
248			`>Define an interface which should appear immediately below this`
249			`component in the configuration hierarchy.</P`
250			`></DD`
251			`><DT`
252			`><A`
253			`HREF="ref.cdl-option.html"`
254			`><TT`
255			`CLASS="LITERAL"`
256			`>cdl_option</TT`
257			`></A`
258			`></DT`
259			`><DD`
260			`><P`
261			`>Define a configuration option which should appear immediately below`
262			`this component in the configuration hierarchy.</P`
263			`></DD`
264			`><DT`
265			`><A`
266			`HREF="ref.compile.html"`
267			`><SPAN`
268			`CLASS="PROPERTY"`
269			`>compile</SPAN`
270			`></A`
271			`></DT`
272			`><DD`
273			`><P`
274			`>List the source files that should be built if this component is active`
275			`and enabled.</P`
276			`></DD`
277			`><DT`
278			`><A`
279			`HREF="ref.default-value.html"`
280			`><SPAN`
281			`CLASS="PROPERTY"`
282			`>default_value</SPAN`
283			`></A`
284			`></DT`
285			`><DD`
286			`><P`
287			`>Provide a default value for this component using a CDL expression.</P`
288			`></DD`
289			`><DT`
290			`><A`
291			`HREF="ref.define.html"`
292			`><SPAN`
293			`CLASS="PROPERTY"`
294			`>define</SPAN`
295			`></A`
296			`></DT`
297			`><DD`
298			`><P`
299			`>Specify additional <TT`
300			`CLASS="LITERAL"`
301			`>#define</TT`
302			`> symbols that should go`
303			`into the owning package's configuration header file.</P`
304			`></DD`
305			`><DT`
306			`><A`
307			`HREF="ref.define-format.html"`
308			`><SPAN`
309			`CLASS="PROPERTY"`
310			`>define_format</SPAN`
311			`></A`
312			`></DT`
313			`><DD`
314			`><P`
315			`>Control how the component's value will appear in the configuration header`
316			`file.</P`
317			`></DD`
318			`><DT`
319			`><A`
320			`HREF="ref.define-proc.html"`
321			`><SPAN`
322			`CLASS="PROPERTY"`
323			`>define_proc</SPAN`
324			`></A`
325			`></DT`
326			`><DD`
327			`><P`
328			`>Use a fragment of Tcl code to output additional data to`
329			`configuration header files.</P`
330			`></DD`
331			`><DT`
332			`><A`
333			`HREF="ref.description.html"`
334			`><SPAN`
335			`CLASS="PROPERTY"`
336			`>description</SPAN`
337			`></A`
338			`></DT`
339			`><DD`
340			`><P`
341			`>Provide a textual description for this component.</P`
342			`></DD`
343			`><DT`
344			`><A`
345			`HREF="ref.display.html"`
346			`><SPAN`
347			`CLASS="PROPERTY"`
348			`>display</SPAN`
349			`></A`
350			`></DT`
351			`><DD`
352			`><P`
353			`>Provide a short string describing this component.</P`
354			`></DD`
355			`><DT`
356			`><A`
357			`HREF="ref.doc.html"`
358			`><SPAN`
359			`CLASS="PROPERTY"`
360			`>doc</SPAN`
361			`></A`
362			`></DT`
363			`><DD`
364			`><P`
365			`>The location of on-line documentation for this component.</P`
366			`></DD`
367			`><DT`
368			`><A`
369			`HREF="ref.flavor.html"`
370			`><SPAN`
371			`CLASS="PROPERTY"`
372			`>flavor</SPAN`
373			`></A`
374			`></DT`
375			`><DD`
376			`><P`
377			`>Specify the nature of this component.</P`
378			`></DD`
379			`><DT`
380			`><A`
381			`HREF="ref.if-define.html"`
382			`><SPAN`
383			`CLASS="PROPERTY"`
384			`>if_define</SPAN`
385			`></A`
386			`></DT`
387			`><DD`
388			`><P`
389			`>Output a common preprocessor construct to a configuration header file. </P`
390			`></DD`
391			`><DT`
392			`><A`
393			`HREF="ref.implements.html"`
394			`><SPAN`
395			`CLASS="PROPERTY"`
396			`>implements</SPAN`
397			`></A`
398			`></DT`
399			`><DD`
400			`><P`
401			`>Enabling this component provides one instance of a more general`
402			`interface. </P`
403			`></DD`
404			`><DT`
405			`><A`
406			`HREF="ref.legal-values.html"`
407			`><SPAN`
408			`CLASS="PROPERTY"`
409			`>legal_values</SPAN`
410			`></A`
411			`></DT`
412			`><DD`
413			`><P`
414			`>Impose constraints on the possible values for this component.</P`
415			`></DD`
416			`><DT`
417			`><A`
418			`HREF="ref.make.html"`
419			`><SPAN`
420			`CLASS="PROPERTY"`
421			`>make</SPAN`
422			`></A`
423			`></DT`
424			`><DD`
425			`><P`
426			`>An additional custom build step associated with this component, resulting`
427			`in a target that should not go directly into a library.</P`
428			`></DD`
429			`><DT`
430			`><A`
431			`HREF="ref.make-object.html"`
432			`><SPAN`
433			`CLASS="PROPERTY"`
434			`>make_object</SPAN`
435			`></A`
436			`></DT`
437			`><DD`
438			`><P`
439			`>An additional custom build step associated with this component, resulting`
440			`in an object file that should go into a library.</P`
441			`></DD`
442			`><DT`
443			`><A`
444			`HREF="ref.no-define.html"`
445			`><SPAN`
446			`CLASS="PROPERTY"`
447			`>no_define</SPAN`
448			`></A`
449			`></DT`
450			`><DD`
451			`><P`
452			`>Suppress the normal generation of a preprocessor`
453			`<TT`
454			`CLASS="LITERAL"`
455			`>#define</TT`
456			`> symbol in a configuration header file.</P`
457			`></DD`
458			`><DT`
459			`><A`
460			`HREF="ref.parent.html"`
461			`><SPAN`
462			`CLASS="PROPERTY"`
463			`>parent</SPAN`
464			`></A`
465			`></DT`
466			`><DD`
467			`><P`
468			`>Control the location of this component in the configuration hierarchy. </P`
469			`></DD`
470			`><DT`
471			`><A`
472			`HREF="ref.requires.html"`
473			`><SPAN`
474			`CLASS="PROPERTY"`
475			`>requires</SPAN`
476			`></A`
477			`></DT`
478			`><DD`
479			`><P`
480			`>List constraints that the configuration should satisfy if this component is`
481			`active and enabled.</P`
482			`></DD`
483			`><DT`
484			`><A`
485			`HREF="ref.script.html"`
486			`><SPAN`
487			`CLASS="PROPERTY"`
488			`>script</SPAN`
489			`></A`
490			`></DT`
491			`><DD`
492			`><P`
493			`>Include additional configuration information from another`
494			`CDL script</P`
495			`></DD`
496			`></DL`
497			`></DIV`
498			`></DIV`
499			`><DIV`
500			`CLASS="REFSECT1"`

Browse

Tools

Subversion Repositories openrisc_2011-10-31

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [cdl-guide/] [ref.cdl-component.html] - Blame information for rev 369