<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>ANTLR3C: Navigating the C Runtime Documentation</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.3 -->
<div id="top">
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">ANTLR3C <span id="projectnumber">3.1.2</span></div>
</td>
</tr>
</tbody>
</table>
</div>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li class="current"><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li><a href="dirs.html"><span>Directories</span></a></li>
</ul>
</div>
</div>
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
initNavTree('runtime.html','');
</script>
<div id="doc-content">
<div class="header">
<div class="headertitle">
<h1>Navigating the C Runtime Documentation </h1> </div>
</div>
<div class="contents">
<div class="textblock"><p>If you are familiar with Doxygen generated documentation, then the layout of the files, typedefs and so on will be familiar to you.</p>
<p>However there is also additional structure applied that helps the programmer to see how the runtime is made up.</p>
<h2><a class="anchor" id="modules"></a>
Modules</h2>
<p>Under the Modules menu tree you will find the entry API Classes. This section is further divided into typedefs and structs and the standard runtime supplied interface implementation methods.</p>
<p>The typedefs are the types that you declare in your code and which are returned by the 'constructors' such as <a class="el" href="antlr3filestream_8c.html#a449abcf6642288f35bacc3aae39c0ff6" title="Use the contents of an operating system file as the input for an input stream.">antlr3AsciiFileStreamNew()</a>. The underlying structures document the data elements of the type and what a function pointer installed in any particular slot should do.</p>
<p>The default implementations are the static methods within the default implementation file for a 'class', which are installed by the runtime when a default instance of one the typedefs (classes) is created.</p>
<p>When navigating the source code, find the typedef you want to consult and inspect the documentation for its function pointers, then look at the documentation for the default methods that implement that 'method'.</p>
<p>For example, under "API Typedefs and Structs" you will find "Base Recognizer Definition", which tells you all the methods that belong to this interface. Under "API Implementation Functions", you will find "Base Recognizer Implementation", which documents the actual functions that are installed to implement the class methods.</p>
<p>From here, the documentation should be obvious. If it is not, then you could try reading the actual source code, but please don;t email the author directly, but use the ANTLR Interest email group, which you should probably have signed up for if you have read this far into the C runtime documentation. </p>
</div></div>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="main.html">ANTLR3 C Runtime API and Usage Guide.</a> </li>
<li class="footer">Generated on Tue Feb 8 2011 for ANTLR3C by 
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </li>
</ul>
</div>
</body>
</html>
