1 <!-- 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. -->
13 ><meta name="MSSmartTagsPreventParsing" content="TRUE">
16 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
19 TITLE="The eCos Component Writer's Guide"
20 HREF="cdl-guide.html"><LINK
22 TITLE="CDL Language Specification"
23 HREF="reference.html"><LINK
26 HREF="ref.include-dir.html"><LINK
29 HREF="ref.legal-values.html"></HEAD
40 SUMMARY="Header navigation table"
52 > Component Writer's Guide</TH
60 HREF="ref.include-dir.html"
74 HREF="ref.legal-values.html"
85 NAME="REF.INCLUDE-FILES"><SPAN
99 > -- List the header files that are exported by a package.</DIV
101 CLASS="REFSYNOPSISDIV"
113 >cdl_package <name> {
114 include_files <file1> …
129 >Most packages export one or more header files defining their public
130 interface. For example the C library exports header files such as
139 If the package follows the <A
140 HREF="package.html#PACKAGE.HIERARCHY"
142 layout conventions</A
143 > then the exported header files will normally
144 be found in the package's
149 packages which do not follow these conventions, typically simple ones
150 for which a complicated sub-directory hierarchy is undesirable, there
151 has to be an alternative way of specifying which header file or files
152 define the public interface. The <SPAN
158 >By default, if a package does not have an
162 > subdirectory and it
163 does not have an <SPAN
166 > property then all files with a suffix
181 public header files. However some of these may be private files
182 containing implementation details. If there is an
186 > property then only the files listed in that property
189 >If a package should not export any header files but does contain
190 private implementation headers, an <SPAN
194 arguments should be used.</P
210 CLASS="PROGRAMLISTING"
211 >cdl_package <SOME_PACKAGE> {
213 include_dir <some directory>
214 include_files interface.h
217 cdl_package <ANOTHER_PACKAGE> {
234 HREF="ref.include-dir.html"
241 HREF="ref.cdl-package.html"
253 SUMMARY="Footer navigation table"
264 HREF="ref.include-dir.html"
273 HREF="cdl-guide.html"
282 HREF="ref.legal-values.html"
301 HREF="reference.html"