Files
cdesktop/cde/doc/C/guides/man/man5/Dt.sgm

114 lines
3.8 KiB
Plaintext

<!-- $XConsortium: Dt.sgm /main/6 1996/09/08 19:58:20 rws $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->
<![ %CDE.C.CDE; [<RefEntry Id="CDEMX.XCDI.MAN318.rsml.1">]]>
<![ %CDE.C.XO; [<RefEntry Id="XCDI.MAN318.rsml.1">]]>
<RefMeta>
<RefEntryTitle>Dt/Dt.h</RefEntryTitle>
<ManVolNum>file formats</ManVolNum>
</RefMeta>
<RefNameDiv>
<RefName><Filename>Dt/Dt.h</Filename></RefName>
<RefPurpose>miscellaneous desktop definitions
</RefPurpose>
</RefNameDiv>
<!-- CDE Common Source Format, Version 1.0.0-->
<!-- (c) Copyright 1993, 1994, 1995 Hewlett-Packard Company-->
<!-- (c) Copyright 1993, 1994, 1995 International Business Machines Corp.-->
<!-- (c) Copyright 1993, 1994, 1995 Sun Microsystems, Inc.-->
<!-- (c) Copyright 1993, 1994, 1995 Novell, Inc.-->
<RefSynopsisDiv>
<Synopsis>#include &lt;Dt/Dt.h>
</Synopsis>
</RefSynopsisDiv>
<RefSect1>
<Title>DESCRIPTION</Title>
<Para>The
<Filename Role="Header">Dt/Dt.h</Filename> header contains miscellaneous public constant and function declaration
for the &str-XZ; library.
</Para>
<Para>The header defines several constants that can be used to determine
the version of the library used to compile an application
and the version of the library with which
an application is currently linked.
</Para>
<Para>The header defines the following constants
that represent the library compile-time version:
</Para>
<VariableList>
<VarListEntry>
<Term>DtVERSION</Term>
<ListItem>
<Para>An integer specifying the major version number
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>DtREVISION</Term>
<ListItem>
<Para>An integer specifying the minor version number
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>DtUPDATE_LEVEL</Term>
<ListItem>
<Para>An integer specifying the patch release level
</Para>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>DtVERSION_NUMBER</Term>
<ListItem>
<Para>An integer combining the major, minor and patch release numbers.
It is derived from the following formula:
</Para>
<InformalExample Remap="indent">
<ProgramListing>(10000&ensp;*&ensp;DtVERSION&ensp;+&ensp;100&ensp;*
DtRevision&ensp;+&ensp;DtUPDATE_LEVEL)
</ProgramListing>
</InformalExample>
</ListItem>
</VarListEntry>
<VarListEntry>
<Term>DtVERSION_STRING</Term>
<ListItem>
<Para>A string containing a description of the version
and the version number
</Para>
</ListItem>
</VarListEntry>
</VariableList>
<Para>The header defines the following constants
that represent the library run-time version:
</Para>
<Synopsis>extern int DtVersion
extern char *DtVersionString
</Synopsis>
<Para><Symbol>DtVersion</Symbol> is an integer equivalent to
<SystemItem Class="Constant">DtVERSION_NUMBER</SystemItem> at the time the library was created.
<Symbol>DtVersionString</Symbol> is a string equivalent to
<SystemItem Class="Constant">DtVERSION_STRING</SystemItem> at the time the library was created.
</Para>
<Para>The header declares the following as functions:
</Para>
<Synopsis>Boolean DtInitialize(Display *<Symbol Role="Variable">display</Symbol>,
Widget <Symbol Role="Variable">widget</Symbol>,
char *<Symbol Role="Variable">name</Symbol>,
char *<Emphasis>tool_class</Emphasis>)
Boolean DtAppInitialize(XtAppContext <Emphasis>app_context</Emphasis>,
Display *<Symbol Role="Variable">display</Symbol>,
Widget <Symbol Role="Variable">widget</Symbol>,
char *<Symbol Role="Variable">name</Symbol>,
char *<Emphasis>tool_class</Emphasis>)
</Synopsis>
</RefSect1>
</RefEntry>
<!--fickle 1.12 mancsf-to-docbook 1.2 08/07/95 23:18:47-->