Link with C++ linker
[oweals/cde.git] / cde / programs / dtdocbook / README
1 /* $XConsortium: README /main/2 1996/07/15 14:08:58 drk $ */
2 This directory and its subdirectories contain the sources for
3 dtdocbook, the DocBook to SDL converter.
4
5 The directories here are:
6
7     doc2sdl
8
9         docbook.cmap - character mappings, used by "instant"
10         docbook.tcl  - Tcl code for conversion actions, used by "instant"
11         docbook.ts   - translation spec to be read by "instant"
12         docbook.tss  - base SDL style sheet (augmented by docbook.tcl)
13         dtdocbook    - the driver script for the dtdocbook passes
14        *catalog.sh   - a script to build symbolic links to PUBLIC ids
15        *env.csh      - csh code to be sourced to set environment vars
16        *env.sh       - sh/ksh code to be sourced to set environment vars
17
18        [The files with an asterisk are to be modified to customize the
19         environment of dtdocbook for a particular system and directory
20         structure.  See the files themselves for comments regarding
21         their modification.]
22
23     instant
24
25        [C source code for the program "instant" which reads the output
26         of sgmls (the element structure information set, or ESIS),
27         builds a tree structure from that output and provides a set of
28         commands to walk that tree and emit text or interpret the code
29         in docbook.tcl to accomplish the DocBook to SDL conversion.
30         The program "instant" will be called by dtdocbook passing it a
31         set of commands in the file docbook.ts (translation
32         specification).]
33
34     lib
35
36        tptregexp
37
38             [A regular expression parser library to be linked into
39             "instant".]
40
41         sgml
42
43             docbook.2.2.1.dtd - the document type definition for DocBook
44             docbook.sgml      - an SGML declaration for DocBook
45             iso-box.gml       - ISO box and line drawing entities
46             iso-dia.gml       - ISO diacritical marks
47             iso-grk1.gml      - ISO greek alphabet 1
48             iso-grk3.gml      - ISO greek alphabet 3
49             iso-lat1.gml      - ISO latin 1 alphabet
50             iso-lat2.gml      - ISO latin 2 alphabet
51             iso-num.gml       - ISO numeric entities
52             iso-pub.gml       - ISO publishing entities
53             iso-tech.gml      - ISO technical entities
54
55             [The contents of this directory are provided for
56              convenience during the snapshot only.  These files will
57              eventually be put in a location common to both dtinfo and
58              dtdocbook.]
59
60     sgmls
61
62         [C source code for the program "sgmls", an SGML parser.]
63
64     tcl
65
66         [C source code for the Tool Command Language (Tcl) library,
67          libtcl.a, to be linked into "instant".]