swig/Doc/Manual
William S Fulton 07884f10ee Python - remove duplicate proxy method definitions for global function wrappers.
Global functions previously generated two definitions, eg:

  def foo():
      return _example.foo()
  foo = _example.foo

The first definition is replaced by the second definition and so the second definition
is the one used when the method is actually called. Now just the first definition is
generated by default and if the -fastproxy command line option is used, just the second
definition is generated. The second definition is faster as it avoids the proxy Python
method as it calls the low-level C wrapper directly. Using both -fastproxy and -olddefs
command line options will restore the previously generated code as it will generate both
method definitions.

With this change, the wrappers for global C/C++ functions and C++ class methods now work
in the same way wrt to generating just a proxy method by default and control via
-fastproxy/-olddefs options.

Closes #639.
2019-01-01 12:12:56 +00:00
..
Allegrocl.html Merge branch 'vadz-doxygen' 2018-06-07 08:13:10 +01:00
android-class.png Add Android docs - supporting screenshots 2011-12-10 17:03:50 +00:00
android-simple.png Add Android docs - supporting screenshots 2011-12-10 17:03:50 +00:00
Android.html Update html chapter numbering for added Doxygen chapter 2018-05-25 07:56:44 +01:00
Arguments.html Documentation refers to wrong chapter. 2018-10-17 13:00:04 +02:00
CCache.html Update html chapter numbering for added Doxygen chapter 2018-05-25 07:56:44 +01:00
ch2.1.png The great merge 2002-11-30 22:01:28 +00:00
chapters Update html chapter numbering for added Doxygen chapter 2018-05-25 07:56:44 +01:00
Chicken.html Update html chapter numbering for added Doxygen chapter 2018-05-25 07:56:44 +01:00
Contents.html Document all the Python command line options 2018-12-18 19:51:38 +00:00
Contract.html Add C++17 documentation chapter 2018-05-14 21:29:46 +01:00
CPlusPlus11.html Add docs for C++11 ref-qualifiers 2017-08-30 18:17:04 +01:00
CPlusPlus17.html Add missing CPlusPlus17.html file 2018-05-25 07:56:44 +01:00
CSharp.html Fix class having method Connect() creating a name collision with SwigDirectorConnect(). 2018-09-06 12:43:51 +03:00
Customization.html Add C++17 documentation chapter 2018-05-14 21:29:46 +01:00
D.html Update html chapter numbering for added Doxygen chapter 2018-05-25 07:56:44 +01:00
Doxygen.html Revert "JAVA_HOME nad tools.jar not needed for Java testing" 2018-06-09 00:40:26 +01:00
Extending.html Merge branch 'vadz-doxygen' 2018-06-07 08:13:10 +01:00
fixstyle.py HTML pdf doc generation fixes 2015-12-30 22:22:33 +00:00
Go.html Merge branch 'vadz-doxygen' 2018-06-07 08:13:10 +01:00
Guile.html Update html chapter numbering for added Doxygen chapter 2018-05-25 07:56:44 +01:00
index.html Update version number to 4.0 in docs 2017-09-14 07:39:16 +01:00
Introduction.html python -> Python in html docs 2018-08-21 22:41:02 +01:00
Java.html Merge branch 'vadz-doxygen' 2018-06-07 08:13:10 +01:00
Javascript.html Merge branch 'vadz-doxygen' 2018-06-07 08:13:10 +01:00
Library.html Add C++17 documentation chapter 2018-05-14 21:29:46 +01:00
linkchecker.config html links updates 2015-12-18 21:14:44 +00:00
Lisp.html Merge branch 'vadz-doxygen' 2018-06-07 08:13:10 +01:00
Lua.html python -> Python in html docs 2018-08-21 22:41:02 +01:00
makechap.py Fixes to makechap.py to detect ill-formed headers 2018-05-25 07:56:44 +01:00
Makefile Fix outdated info in Doc Makefile about pdf file generation 2016-11-25 07:39:06 +00:00
maketoc.py HTML fixes for documentation - add meta tag and loose.dtd 2015-12-30 22:22:32 +00:00
Modula3.html Update html chapter numbering for added Doxygen chapter 2018-05-25 07:56:44 +01:00
Modules.html Update html chapter numbering for added Doxygen chapter 2018-05-25 07:56:44 +01:00
Mzscheme.html Update html chapter numbering for added Doxygen chapter 2018-05-25 07:56:44 +01:00
Ocaml.html Update html chapter numbering for added Doxygen chapter 2018-05-25 07:56:44 +01:00
Octave.html Update html chapter numbering for added Doxygen chapter 2018-05-25 07:56:44 +01:00
Perl5.html Update html chapter numbering for added Doxygen chapter 2018-05-25 07:56:44 +01:00
Php.html Merge branch 'vadz-doxygen' 2018-06-07 08:13:10 +01:00
Pike.html Update html chapter numbering for added Doxygen chapter 2018-05-25 07:56:44 +01:00
Preface.html Misc. typos 2018-05-17 10:04:23 -04:00
Preprocessor.html Remove support for PHP5 2018-06-07 18:09:03 +12:00
Python.html Python - remove duplicate proxy method definitions for global function wrappers. 2019-01-01 12:12:56 +00:00
R.html Update html chapter numbering for added Doxygen chapter 2018-05-25 07:56:44 +01:00
README subject/verb agreement 2013-04-30 22:49:12 -03:00
Ruby.html Update html chapter numbering for added Doxygen chapter 2018-05-25 07:56:44 +01:00
Scilab.html HTML chapter numbering updates 2018-06-07 08:16:36 +01:00
Scripting.html Fix some typos in docs and examples and make the code look nicer. 2016-12-31 23:06:56 +08:00
Sections.html Update html chapter numbering for added Doxygen chapter 2018-05-25 07:56:44 +01:00
style.css HTML pdf doc generation fixes 2015-12-30 22:22:33 +00:00
SWIG.html Remove support for PHP5 2018-06-07 18:09:03 +12:00
swig16.png remove svn:executable property where applied incorrectly 2008-11-26 21:54:49 +00:00
SWIGPlus.html python -> Python in html docs 2018-08-21 22:41:02 +01:00
Tcl.html Update html chapter numbering for added Doxygen chapter 2018-05-25 07:56:44 +01:00
Typemaps.html Typemap %apply docs clarification 2018-10-24 19:53:31 +01:00
Varargs.html Add C++17 documentation chapter 2018-05-14 21:29:46 +01:00
Warnings.html HTML chapter numbering updates 2018-06-07 08:16:36 +01:00
Windows.html python -> Python in html docs 2018-08-21 22:41:02 +01:00

This directory contains the HTML for the SWIG users manual.

All of this HTML is hand-written.  However, section numbering, indices,
and the table of contents are generated automatically by the 'maketoc.py'
script. The Makefile has further information on how the various alternative
forms of the documentation are generated from the hand-written HTML.

There are 4 types of boxes that code or whatever can be inside:
  - <div class="shell">...</div>
    This is for text that shows the output of running commands on the shell.
  - <div class="code">...</div>
    This is for either C, C++, or SWIG code
  - <div class="targetlang">...</div>
    This is for code in a target scripting language
  - <div class="diagram">...</div>
    This is for text that is not code or a shell

The general format is
<div class="foo"><pre>
whatever here
</pre></div>