User`s manual

52 digi.com Language
4.24 Function Description Headers
Each user-callable function in a Dynamic C library has a descriptive header preceding the function to
describe the function. Function headers are extracted by Dynamic C to provide on-line help messages.
The header is a specially formatted comment, such as the following example.
If this format is followed, user-created library functions will show up in the Function Lookup <Ctrl+H>
feature if the library is listed in lib.dir or its replacement. Note that these sections are scanned in only
when Dynamic C starts.
4.25 Support Files
Dynamic C has several support files that are necessary in building an application. These files are listed
below.
/* START FUNCTION DESCRIPTION **********************
WrIOport <IO.LIB>
SYNTAX: void WrIOport(int portaddr, int value);
DESCRIPTION:
Writes data to the specified I/O port.
PARAMETER1: portaddr - register address of the port.
PARAMETER2: value - data to be written to the port.
RETURN VALUE: None
KEY WORDS: parallel port
SEE ALSO: RdIOport
END DESCRIPTION ***********************************/
Table 4-5. Dynamic C Support Files
File Name Purpose of File
DCW.CFG Contains configuration data for the target controller.
DC.HH
Contains prototypes, basic type definitions, #define, and default modes for
Dynamic C. This file can be modified by the programmer.
DEFAULT.H
Contains a set of #use directives for each control product that Rabbit ships. This
file can be modified.
LIB.DIR
Contains pathnames for all libraries that will be known to Dynamic C. The
programmer can add or remove libraries from this list. The factory default is for this
file to contain all the libraries on the Dynamic C distribution disk. Any library that is
to be used in a Dynamic C program must be listed in the file LIB.DIR, or another
*.DIR file specified by the user.
PROJECT.DCP
DEFAULT.DCP
These files hold the default compilation environment that is shipped from the factory.
DEFAULT.DCP may be modified, but not PROJECT.DCP. See Chapter 16 for
details on project files.