diff doc/manual/manual_bindings.tex @ 467:b47168dacba6

manual: - adding aggregate passing and returning info for x64 (win and sysv, however, *only* w/ respect to types supported by dyncall) - python binding text cleanup and sync with current binding version - added suite_aggrs description and cleaned up other test suite descriptions a bit - update list of calling convention modes - cleanup and minor other fixes (e.g. changed \newpage in many places to \clearpage to avoid hitting float limit, crlf->cr, ...)
author Tassilo Philipp
date Fri, 04 Feb 2022 23:54:42 +0100
parents 32736025371f
children 17287342e273
line wrap: on
line diff
--- a/doc/manual/manual_bindings.tex	Wed Feb 02 18:30:44 2022 +0100
+++ b/doc/manual/manual_bindings.tex	Fri Feb 04 23:54:42 2022 +0100
@@ -17,7 +17,7 @@
 %
 %//////////////////////////////////////////////////////////////////////////////
 
-\newpage
+\clearpage
 \section{Bindings to programming languages}
 
 Through binding of the \product{dyncall} library into a scripting environment,
@@ -234,31 +234,31 @@
 \subsection{Python language bindings}
 
 The python module {\tt pydc} implements the Python language bindings,
-namely {\tt load}, {\tt find}, {\tt free}, {\tt call}.
+namely {\tt load}, {\tt find}, {\tt free}, {\tt call}, {\tt new\_callback}, {\tt free\_callback}.
 
 \begin{table}[h]
 \begin{center}
 \begin{tabular*}{0.75\textwidth}{lll}
 Signature character & accepted Python 2 types & accepted Python 3 types \\
 \hline
-\sigchar{v}              & no return type                 & no return type                    \\
-\sigchar{B}              & bool                           & bool                              \\
-\sigchar{c}, \sigchar{C} & int, string (with single char) & int, string (with single char)    \\
-\sigchar{s}, \sigchar{S} & int                            & int                               \\
-\sigchar{i}, \sigchar{I} & int                            & int                               \\
-\sigchar{j}, \sigchar{J} & int                            & int                               \\
-\sigchar{l}, \sigchar{L} & int, long                      & int                               \\
-\sigchar{f}              & float                          & float                             \\
-\sigchar{d}              & double                         & double                            \\
-\sigchar{p}              & bytearray, int, long           & bytearray (mutable in C), int     \\
-\sigchar{Z}              & string, unicode, bytearray     & string, bytearray (all immutable) \\
+\sigchar{v}              & no return type                                     & no return type                                \\
+\sigchar{B}              & bool                                               & bool                                          \\
+\sigchar{c}, \sigchar{C} & int, string (with single char)                     & int, string (with single char)                \\
+\sigchar{s}, \sigchar{S} & int                                                & int                                           \\
+\sigchar{i}, \sigchar{I} & int                                                & int                                           \\
+\sigchar{j}, \sigchar{J} & int                                                & int                                           \\
+\sigchar{l}, \sigchar{L} & int, long                                          & int                                           \\
+\sigchar{f}              & float                                              & float                                         \\
+\sigchar{d}              & float                                              & float                                         \\
+\sigchar{p}              & bytearray, int, long, None, (PyCObject, PyCapsule) & bytearray, int, None, (PyCObject, PyCapsule)  \\
+\sigchar{Z}              & string, unicode, bytearray                         & string, bytes, bytearray                      \\
 \end{tabular*}
 \caption{Type signature encoding for Python bindings}
 \label{Pysigchar}
 \end{center}
 \end{table}
 
-For more details, refer to the README.txt file of the binding.
+This is a very brief description that omits many details. For more, refer to the README.txt file of the binding.
 
 \pagebreak