| 2 |
7u83 |
1 |
<!-- Crown Copyright (c) 1998 -->
|
|
|
2 |
<HTML>
|
|
|
3 |
<HEAD>
|
|
|
4 |
<TITLE>Use of the PL_TDF compiler</TITLE>
|
|
|
5 |
</HEAD>
|
|
|
6 |
<BODY TEXT="#000000" BGCOLOR="#FFFFFF" LINK="#0000FF" VLINK="#400080" ALINK="#FF0000">
|
|
|
7 |
<A NAME=S47>
|
|
|
8 |
<H1>PL_TDF Definition</H1>
|
|
|
9 |
<H3>January 1998</H3>
|
|
|
10 |
<IMG SRC="../images/no_next.gif" ALT="next section">
|
|
|
11 |
<A HREF="pl5.html">
|
|
|
12 |
<IMG SRC="../images/prev.gif" ALT="previous section"></A>
|
|
|
13 |
<A HREF="pl1.html"><IMG SRC="../images/top.gif" ALT="current document"></A>
|
|
|
14 |
<A HREF="../index.html"><IMG SRC="../images/home.gif" ALT="TenDRA home page">
|
|
|
15 |
</A>
|
|
|
16 |
<IMG SRC="../images/no_index.gif" ALT="document index"><P>
|
|
|
17 |
<HR>
|
|
|
18 |
<H1>5 Use of the PL_TDF compiler</H1>
|
|
|
19 |
Conventionally, PL_TDF programs are held in normal text files with
|
|
|
20 |
suffix .pl. The PL_TDF compiler is invoked by:<P>
|
|
|
21 |
<PRE>
|
|
|
22 |
pl [-v] [-Iinclude_path ...] [-g] [-V ] infile.pl outfile.j
|
|
|
23 |
</PRE>
|
|
|
24 |
This compiles infile.pl to TDF in outfile.j. This file can be linked
|
|
|
25 |
and loaded just as any other .j file using tcc.<P>
|
|
|
26 |
The -v option will produce a cut-down pretty print of the TDF for
|
|
|
27 |
the definitions and declarations of the tags, tokens and al_tags of
|
|
|
28 |
the program on the standard output.<P>
|
|
|
29 |
The -I options will defines the paths for any #include pre-processing
|
|
|
30 |
directives in the text.<P>
|
|
|
31 |
The -g option will put line number information into the TDF.<P>
|
|
|
32 |
The -V option will print version information of both pl and the TDF
|
|
|
33 |
it produces.<P>
|
|
|
34 |
Compile-time error reporting is rather rudimentary and error recovery
|
|
|
35 |
non-existent. Only the first error found will be reported on the standard
|
|
|
36 |
error channel. This will give some indication of the type of error,
|
|
|
37 |
together with the text line number and a print-out of the line, marking
|
|
|
38 |
the place within the line where the error was detected.<P>
|
|
|
39 |
Errors which can only be detected at translate-time are much more
|
|
|
40 |
difficult to correct. These are usually shape or alignment errors,
|
|
|
41 |
particularly in the construction of offsets. Try compiling and translating
|
|
|
42 |
with the -g option. On the error, the translator will output the source
|
|
|
43 |
filename and an approximate line-number corresponding to the position
|
|
|
44 |
of the error in the PL_TDF.<P>
|
|
|
45 |
Translating with the -g option may sometimes give warning messages
|
|
|
46 |
from the system assembler being used; some assemblers object to being
|
|
|
47 |
given line number information in anything else but the .text segment
|
|
|
48 |
of the program. The main intention of the -g option is to detect and
|
|
|
49 |
correct errors errors thrown up by the translators and not for run-time
|
|
|
50 |
de-bugging, so do not regard a warning like this as a bug in the system.<P>
|
|
|
51 |
<HR>
|
|
|
52 |
<P><I>Part of the <A HREF="../index.html">TenDRA Web</A>.<BR>Crown
|
|
|
53 |
Copyright © 1998.</I></P>
|
|
|
54 |
</BODY>
|
|
|
55 |
</HTML>
|