jyapayne/swig
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Correct links in html documentation using new version of makechap.py

Browse source 
Corrects position of heading text within A and H1, H2, ... elements.
This commit is contained in:
William S Fulton 2015-12-22 07:54:57 +00:00
commit 8288ac15a0
41 changed files with 1262 additions and 1262 deletions
Download patch file Download diff file Expand all files Collapse all files

108
Doc/Manual/SWIG.html
View file

@ -6,7 +6,7 @@
</head>
<body bgcolor="#ffffff">
<H1><a name="SWIG"></a>5 SWIG Basics</H1>
<H1><a name="SWIG">5 SWIG Basics</a></H1>
<!-- INDEX -->
<div class="sectiontoc">
<ul>
@ -94,7 +94,7 @@ Specific details about each target language are described in later
chapters.
</p>
<H2><a name="SWIG_nn2"></a>5.1 Running SWIG</H2>
<H2><a name="SWIG_nn2">5.1 Running SWIG</a></H2>
<p>
@ -156,7 +156,7 @@ can be obtained by typing <tt>swig -help</tt> or <tt>swig
</pre></div>
<H3><a name="SWIG_nn3"></a>5.1.1 Input format</H3>
<H3><a name="SWIG_nn3">5.1.1 Input format</a></H3>
<p>
@ -203,7 +203,7 @@ semantics in SWIG is analogous to that of the declarations section
used in input files to parser generation tools such as yacc or bison.
</p>
<H3><a name="SWIG_output"></a>5.1.2 SWIG Output</H3>
<H3><a name="SWIG_output">5.1.2 SWIG Output</a></H3>
<p>
@ -263,7 +263,7 @@ as the output directory for the language files is the same directory as the
generated C/C++ file if not overridden with <tt>-outdir</tt>.
</p>
<H3><a name="SWIG_nn5"></a>5.1.3 Comments</H3>
<H3><a name="SWIG_nn5">5.1.3 Comments</a></H3>
<p>
@ -273,7 +273,7 @@ documentation files. However, this feature is currently under repair
and will reappear in a later SWIG release.
</p>
<H3><a name="SWIG_nn6"></a>5.1.4 C Preprocessor</H3>
<H3><a name="SWIG_nn6">5.1.4 C Preprocessor</a></H3>
<p>
@ -297,7 +297,7 @@ make it more powerful than the normal C preprocessor. These
extensions are described in the "<a href="Preprocessor.html#Preprocessor">Preprocessor</a>" chapter.
</p>
<H3><a name="SWIG_nn7"></a>5.1.5 SWIG Directives</H3>
<H3><a name="SWIG_nn7">5.1.5 SWIG Directives</a></H3>
<p>
@ -328,7 +328,7 @@ included in C header files using conditional compilation like this:
it is parsing an input file.
</p>
<H3><a name="SWIG_nn8"></a>5.1.6 Parser Limitations</H3>
<H3><a name="SWIG_nn8">5.1.6 Parser Limitations</a></H3>
<p>
@ -426,7 +426,7 @@ does not utilize a separate <em>typedef-name</em> terminal symbol as
described on p. 234 of K&amp;R).
</p>
<H2><a name="SWIG_nn9"></a>5.2 Wrapping Simple C Declarations</H2>
<H2><a name="SWIG_nn9">5.2 Wrapping Simple C Declarations</a></H2>
<p>
@ -489,7 +489,7 @@ environments, and semantics, it is not always possible to do so. The
next few sections describe various aspects of this mapping.
</p>
<H3><a name="SWIG_nn10"></a>5.2.1 Basic Type Handling</H3>
<H3><a name="SWIG_nn10">5.2.1 Basic Type Handling</a></H3>
<p>
@ -614,7 +614,7 @@ will use the same internal representation (e.g., UCS-2 vs. UCS-4).
You may need to write some special conversion functions.
</p>
<H3><a name="SWIG_nn11"></a>5.2.2 Global Variables</H3>
<H3><a name="SWIG_nn11">5.2.2 Global Variables</a></H3>
<p>
@ -669,7 +669,7 @@ Earlier versions of SWIG incorrectly handled <tt>const</tt> and created
constants instead.
</p>
<H3><a name="SWIG_nn12"></a>5.2.3 Constants</H3>
<H3><a name="SWIG_nn12">5.2.3 Constants</a></H3>
<p>
@ -758,7 +758,7 @@ is only used when you want to add constants to the scripting language
interface that are not defined in the original header file.
</p>
<H3><a name="SWIG_nn13"></a>5.2.4 A brief word about <tt>const</tt></H3>
<H3><a name="SWIG_nn13">5.2.4 A brief word about <tt>const</tt></a></H3>
<p>
@ -860,7 +860,7 @@ const int spam = 42;
</pre>
</div>
<H3><a name="SWIG_nn14"></a>5.2.5 A cautionary tale of <tt>char *</tt></H3>
<H3><a name="SWIG_nn14">5.2.5 A cautionary tale of <tt>char *</tt></a></H3>
<p>
@ -899,7 +899,7 @@ input values. However, it must be noted that you could change the behavior of
using <a href="Typemaps.html#Typemaps">typemaps</a>.
</p>
<H2><a name="SWIG_nn15"></a>5.3 Pointers and complex objects</H2>
<H2><a name="SWIG_nn15">5.3 Pointers and complex objects</a></H2>
<p>
@ -907,7 +907,7 @@ Most C programs manipulate arrays, structures, and other types of objects. This
discusses the handling of these datatypes.
</p>
<H3><a name="SWIG_nn16"></a>5.3.1 Simple pointers</H3>
<H3><a name="SWIG_nn16">5.3.1 Simple pointers</a></H3>
<p>
@ -973,7 +973,7 @@ simplified and less prone to error.
</li>
</ul>
<H3><a name="SWIG_nn17"></a>5.3.2 Run time pointer type checking</H3>
<H3><a name="SWIG_nn17">5.3.2 Run time pointer type checking</a></H3>
<p>
@ -995,7 +995,7 @@ as sentinel values or to denote a missing/empty value. Therefore,
SWIG leaves NULL pointer checking up to the application.
</p>
<H3><a name="SWIG_nn18"></a>5.3.3 Derived types, structs, and classes</H3>
<H3><a name="SWIG_nn18">5.3.3 Derived types, structs, and classes</a></H3>
<p>
@ -1052,7 +1052,7 @@ In this case <tt>f1</tt>, <tt>f2</tt>, and <tt>buffer</tt> are all
opaque objects containing C pointers. It doesn't matter what value
they contain--our program works just fine without this knowledge.</p>
<H3><a name="SWIG_nn19"></a>5.3.4 Undefined datatypes</H3>
<H3><a name="SWIG_nn19">5.3.4 Undefined datatypes</a></H3>
<p>
@ -1112,7 +1112,7 @@ The only way to fix this problem is to make sure you properly declare type names
<!-- We might want to add an error reporting flag to swig -->
<H3><a name="SWIG_nn20"></a>5.3.5 Typedef</H3>
<H3><a name="SWIG_nn20">5.3.5 Typedef</a></H3>
<p>
@ -1201,7 +1201,7 @@ The corresponding wrapper function will accept arguments of
type <tt>unsigned int *</tt> or <tt>size_t *</tt>.
</p>
<H2><a name="SWIG_nn21"></a>5.4 Other Practicalities</H2>
<H2><a name="SWIG_nn21">5.4 Other Practicalities</a></H2>
<p>
@ -1211,7 +1211,7 @@ more difficult to map to a scripting language interface. This section describes
some of these issues.
</p>
<H3><a name="SWIG_nn22"></a>5.4.1 Passing structures by value</H3>
<H3><a name="SWIG_nn22">5.4.1 Passing structures by value</a></H3>
<p>
@ -1242,7 +1242,7 @@ to Vectors instead of Vectors. For the most part, this transformation
is transparent so you might not notice.
</p>
<H3><a name="SWIG_nn23"></a>5.4.2 Return by value</H3>
<H3><a name="SWIG_nn23">5.4.2 Return by value</a></H3>
<p>
@ -1297,7 +1297,7 @@ don't work correctly if <tt>Vector</tt> doesn't define a default
constructor. The section on SWIG and C++ has more information about this case.
</p>
<H3><a name="SWIG_nn24"></a>5.4.3 Linking to structure variables</H3>
<H3><a name="SWIG_nn24">5.4.3 Linking to structure variables</a></H3>
<p>
@ -1329,7 +1329,7 @@ C++ classes must supply a properly defined copy constructor in order for
assignment to work correctly.
</p>
<H3><a name="SWIG_nn25"></a>5.4.4 Linking to <tt>char *</tt></H3>
<H3><a name="SWIG_nn25">5.4.4 Linking to <tt>char *</tt></a></H3>
<p>
@ -1458,7 +1458,7 @@ value is not released.
<H3><a name="SWIG_nn26"></a>5.4.5 Arrays</H3>
<H3><a name="SWIG_nn26">5.4.5 Arrays</a></H3>
<p>
@ -1594,7 +1594,7 @@ void pathname_set(char *value) {
In the target language, the value can be set like a normal variable.
</p>
<H3><a name="SWIG_readonly_variables"></a>5.4.6 Creating read-only variables</H3>
<H3><a name="SWIG_readonly_variables">5.4.6 Creating read-only variables</a></H3>
<p>
@ -1668,10 +1668,10 @@ generate a warning message. Simply change the directives to <tt>%immutable;</t
<tt>%mutable;</tt> to silence the warning. Don't forget the extra semicolon!
</p>
<H3><a name="SWIG_rename_ignore"></a>5.4.7 Renaming and ignoring declarations</H3>
<H3><a name="SWIG_rename_ignore">5.4.7 Renaming and ignoring declarations</a></H3>
<H4><a name="SWIG_nn29"></a>5.4.7.1 Simple renaming of specific identifiers</H4>
<H4><a name="SWIG_nn29">5.4.7.1 Simple renaming of specific identifiers</a></H4>
<p>
@ -1769,7 +1769,7 @@ This directive is still supported, but it is deprecated and should probably be a
directive is more powerful and better supports wrapping of raw header file information.
</p>
<H4><a name="SWIG_advanced_renaming"></a>5.4.7.2 Advanced renaming support</H4>
<H4><a name="SWIG_advanced_renaming">5.4.7.2 Advanced renaming support</a></H4>
<p>
@ -1971,7 +1971,7 @@ are exactly equivalent and <tt>%rename</tt> can be used to selectively ignore
multiple declarations using the previously described matching possibilities.
</p>
<H4><a name="SWIG_limiting_renaming"></a>5.4.7.3 Limiting global renaming rules</H4>
<H4><a name="SWIG_limiting_renaming">5.4.7.3 Limiting global renaming rules</a></H4>
<p>
@ -2069,7 +2069,7 @@ wrap C++ overloaded functions and methods or C++ methods which use default argum
</p>
<H4><a name="SWIG_chosen_unignore"></a>5.4.7.4 Ignoring everything then wrapping a few selected symbols</H4>
<H4><a name="SWIG_chosen_unignore">5.4.7.4 Ignoring everything then wrapping a few selected symbols</a></H4>
<p>
@ -2111,7 +2111,7 @@ members of the class, so when the chosen class is unignored, all of its methods
</div>
<H3><a name="SWIG_default_args"></a>5.4.8 Default/optional arguments</H3>
<H3><a name="SWIG_default_args">5.4.8 Default/optional arguments</a></H3>
<p>
@ -2148,7 +2148,7 @@ Please refer to the section on <a href="SWIGPlus.html#SWIGPlus_default_args">def
in the C++ chapter for further details.
</p>
<H3><a name="SWIG_nn30"></a>5.4.9 Pointers to functions and callbacks</H3>
<H3><a name="SWIG_nn30">5.4.9 Pointers to functions and callbacks</a></H3>
<p>
@ -2301,7 +2301,7 @@ See the <a href="Typemaps.html#Typemaps">Typemaps chapter</a> for more about typ
and individual target language chapters for more on callbacks and the 'director' feature.
</p>
<H2><a name="SWIG_nn31"></a>5.5 Structures and unions</H2>
<H2><a name="SWIG_nn31">5.5 Structures and unions</a></H2>
<p>
@ -2383,7 +2383,7 @@ delete_Vector(v)
However, most of SWIG's language modules also provide a high-level interface that is more convenient. Keep reading.
</p>
<H3><a name="SWIG_nn32"></a>5.5.1 Typedef and structures</H3>
<H3><a name="SWIG_nn32">5.5.1 Typedef and structures</a></H3>
<p>
@ -2429,7 +2429,7 @@ vector_struct</tt>, SWIG knows that this is the same as
<tt>Vector</tt> and it generates the appropriate type-checking code.
</p>
<H3><a name="SWIG_nn33"></a>5.5.2 Character strings and structures</H3>
<H3><a name="SWIG_nn33">5.5.2 Character strings and structures</a></H3>
<p>
@ -2476,7 +2476,7 @@ Note: If the <tt>-c++</tt> option is used, <tt>new</tt> and <tt>delete</tt> are
perform memory allocation.
</p>
<H3><a name="SWIG_nn34"></a>5.5.3 Array members</H3>
<H3><a name="SWIG_nn34">5.5.3 Array members</a></H3>
<p>
@ -2498,7 +2498,7 @@ discussed in a later chapter. In many cases, the warning message is
harmless.
</p>
<H3><a name="SWIG_structure_data_members"></a>5.5.4 Structure data members</H3>
<H3><a name="SWIG_structure_data_members">5.5.4 Structure data members</a></H3>
<p>
@ -2604,7 +2604,7 @@ class, or union. This is unlikely to break existing code. However, if you need
datatype is really a struct, simply use a forward struct declaration such as <tt>"struct Foo;"</tt>.
</p>
<H3><a name="SWIG_nn36"></a>5.5.5 C constructors and destructors</H3>
<H3><a name="SWIG_nn36">5.5.5 C constructors and destructors</a></H3>
<p>
@ -2693,7 +2693,7 @@ the target languages, and it is highly recommended you don't use them.
</p>
<H3><a name="SWIG_adding_member_functions"></a>5.5.6 Adding member functions to C structures</H3>
<H3><a name="SWIG_adding_member_functions">5.5.6 Adding member functions to C structures</a></H3>
<p>
@ -2966,7 +2966,7 @@ be used to extend a structure with more than just methods, a more suitable
directive name has been chosen.
</p>
<H3><a name="SWIG_nested_structs"></a>5.5.7 Nested structures</H3>
<H3><a name="SWIG_nested_structs">5.5.7 Nested structures</a></H3>
<p>
@ -3050,7 +3050,7 @@ Finally, note that nesting is handled differently in C++ mode,
see <a href="SWIGPlus.html#SWIGPlus_nested_classes">Nested classes</a>.
</p>
<H3><a name="SWIG_nn39"></a>5.5.8 Other things to note about structure wrapping</H3>
<H3><a name="SWIG_nn39">5.5.8 Other things to note about structure wrapping</a></H3>
<p>
@ -3112,7 +3112,7 @@ interface described here, most of SWIG's language modules use it in
some way or another.
</p>
<H2><a name="SWIG_nn40"></a>5.6 Code Insertion</H2>
<H2><a name="SWIG_nn40">5.6 Code Insertion</a></H2>
<p>
@ -3122,7 +3122,7 @@ additional C code to perform initialization or other operations.
There are four common ways to insert code, but it's useful to know how the
output of SWIG is structured first.</p>
<H3><a name="SWIG_nn41"></a>5.6.1 The output of SWIG</H3>
<H3><a name="SWIG_nn41">5.6.1 The output of SWIG</a></H3>
<p>
@ -3158,7 +3158,7 @@ the module upon loading.
</li>
</ul>
<H3><a name="SWIG_nn42"></a>5.6.2 Code insertion blocks</H3>
<H3><a name="SWIG_nn42">5.6.2 Code insertion blocks</a></H3>
<p>
@ -3236,7 +3236,7 @@ static Vector *new_Vector() {
Vector *new_Vector();
</pre></div>
<H3><a name="SWIG_nn43"></a>5.6.3 Inlined code blocks</H3>
<H3><a name="SWIG_nn43">5.6.3 Inlined code blocks</a></H3>
<p>
@ -3263,7 +3263,7 @@ declaration. Since the code inside an <tt>%inline %{ ... %}</tt> block
is given to both the C compiler and SWIG, it is illegal to include any
SWIG directives inside a <tt>%{ ... %}</tt> block.</p>
<H3><a name="SWIG_nn44"></a>5.6.4 Initialization blocks</H3>
<H3><a name="SWIG_nn44">5.6.4 Initialization blocks</a></H3>
<p>
@ -3278,7 +3278,7 @@ initialization on module loading, you could write this:
%}
</pre></div>
<H2><a name="SWIG_nn45"></a>5.7 An Interface Building Strategy</H2>
<H2><a name="SWIG_nn45">5.7 An Interface Building Strategy</a></H2>
<p>
@ -3286,7 +3286,7 @@ This section describes the general approach for building interfaces
with SWIG. The specifics related to a particular scripting language
are found in later chapters.</p>
<H3><a name="SWIG_nn46"></a>5.7.1 Preparing a C program for SWIG</H3>
<H3><a name="SWIG_nn46">5.7.1 Preparing a C program for SWIG</a></H3>
<p>
@ -3340,7 +3340,7 @@ to the <a href="http://www.swig.org/mail.html">swig-devel mailing list</a> or to
<a href="http://www.swig.org/bugs.html">SWIG bug tracker</a>.
</p>
<H3><a name="SWIG_nn47"></a>5.7.2 The SWIG interface file</H3>
<H3><a name="SWIG_nn47">5.7.2 The SWIG interface file</a></H3>
<p>
@ -3393,7 +3393,7 @@ The main advantage of this approach is minimal maintenance of an interface file
In more complex projects, an interface file containing numerous <tt>%include</tt> and <tt>#include</tt> statements like this is one of the most common approaches to interface file design due to lower maintenance overhead.
</p>
<H3><a name="SWIG_nn48"></a>5.7.3 Why use separate interface files?</H3>
<H3><a name="SWIG_nn48">5.7.3 Why use separate interface files?</a></H3>
<p>
@ -3422,7 +3422,7 @@ and immediately see what is available without having to dig it out of
header files.
</ul>
<H3><a name="SWIG_nn49"></a>5.7.4 Getting the right header files</H3>
<H3><a name="SWIG_nn49">5.7.4 Getting the right header files</a></H3>
<p>
@ -3442,7 +3442,7 @@ include certain header files by using a <tt>%{,%}</tt> block like this:
...
</pre></div>
<H3><a name="SWIG_nn50"></a>5.7.5 What to do with main()</H3>
<H3><a name="SWIG_nn50">5.7.5 What to do with main()</a></H3>
<p>